高级设置

 

● 屏蔽指定平台的请求

💡Tips

• TaKu SDK 版本要求：v6.3.40及以上
• 需要在load()之前调用
• network_firm_id 其中自定义平台id 可在TaKu后台 点击自定义平台获取

 

● 全局维度

List<String> networkFirmIdList = new ArrayList<>();
// 传入需要屏蔽的指定广告平台的平台id
// networkFilmIdList.add("network_firm_id");

//设置屏蔽指定平台id发起请求
ATSDK.setForbidNetworkFirmIdList(networkFirmIdList);

 

● 广告位维度

List<String> networkFirmIdList = new ArrayList<>();
// 传入需要屏蔽的指定广告平台id
// networkFilmIdList.add("network_firm_id");

// 设置对指定平台不发起请求
ATSDK.setFilterNetworkFirmIdList("your placement id", networkFirmIdList);

// 设置允许指定平台展示
ATSDK.setAllowedShowNetworkFimIdList("your placement id", networkFirmIdList);

// 设置指定平台不展示
ATSDK.setForbidShowNetworkFirmIdList("your placement id", networkFirmIdList);

-----------------------------------------------------------------------------------

List<String> adSourceIdList = new ArrayList<>();
// 传入需要屏蔽的指定广告源id
// adSourceIdList.add("ad_source_id");

// 设置对指定广告源不发起请求
ATSDK.setFilterAdSourceIdList("your placement id", adSourceIdList);

 

● 标记风险设备

💡Tips

• TaKu SDK 版本要求：v6.4.60及以上

/**
 * 标记风险设备，过滤掉指定广告平台
 * @param risk 风险标记（1=启用过滤，0=禁用过滤）
 * @param networkFirmIdList 广告平台ID
 */
ATSDK.setRiskFilterNetworkFirmIdList(int risk, List<String> networkFirmIdList);

• 请参考这里查询各广告平台ID

// 示例
// 开启过滤并过滤掉指定广告平台的请求
ATSDK.setRiskFilterNetworkFirmIdList(1, Arrays.asList("平台1", "平台2"));

// 开启过滤并过滤掉所有广告平台的请求
ATSDK.setRiskFilterNetworkFirmIdList(1, null);

 

● 自定义过滤规则

💡Tips

• TaKu SDK 版本要求：v6.4.60及以上

/**
 * 针对广告位添加自定义过滤规则
 * @param placementId 广告位ID
 * @param filter 过滤条件对象
 */
ATSDK.putFilter(String placementId, ATAdFilter filter)

• 请参考这里查询各广告平台ID

• filterNetworkIds, filterBidTypes, filterNetworkPlacementIds, filterAdPrice可根据实际需要自行组合成过滤规则

// 针对广告位移除自定义过滤规则
ATSDK.removeFilterWithPlacementId("your placement id");

// 移除所有自定义过滤规则
ATSDK.removeFilters();

 

● 示例1

过滤规则：需同时满足以下过滤条件：

1. 平台限制
• 目标平台ID：平台1、平台2
2. 竞价类型限制
• 过滤类型：竞价广告（C2S/S2S）、非竞价广告（NORMAL）（即同时排除实时竞价与非竞价广告类型）
3. 广告平台的广告位限制
• 目标平台的广告位ID：广告位1、广告位2
• （对应广告平台的NetworkPlacementId字段）
4. 价格区间限制（⚠️若将价格范围写成 ≤10 且 ≥50 则判为无效范围）

• • 货币单位：USD美元
  • 价格范围：≥10 且 ≤50

ATSDK.putFilter("your placement id", new ATWaterfallFilter()
        .filterNetworkIds(Arrays.asList("平台1", "平台2")) // 过滤掉指定平台id
        .filterBidTypes(Arrays.asList(ATWaterfallFilter.NORMAL, ATWaterfallFilter.C2S, ATWaterfallFilter.S2S)) //过滤掉竞价和非竞价类型
        .filterNetworkPlacementIds(Arrays.asList("广告平台的广告位1", "广告平台的广告位2")) // 过滤掉广告平台的广告位id
        .filterAdPrice(new ATWaterfallFilter.PriceInterval(ATAdConst.CURRENCY.USD) // 选择货币单位，过滤掉指定价格范围
                // 如下示例 过滤掉的价格范围为 [10，50]
                .moreThanPrice(10) // 大于等于10
                .lessThanPrice(50) // 小于等于50
        ) 
);

 

● 示例2

过滤规则：满足条件1 or 条件2即可 (💡各条件之间用.orFilter() 连接)

条件1

1. 平台限制
• 目标平台ID：平台1、平台2
2. 竞价类型限制
• 过滤类型：非竞价广告（NORMAL）
3. 广告平台的广告位限制
• 目标平台的广告位ID：广告位1、广告位2
• （对应广告平台的NetworkPlacementId字段）
4. 价格区间限制

• • 货币单位：RMB_CENT人民币分
  • 价格范围：≤5000

条件2

1. 平台限制
• 目标平台ID：平台3
2. 竞价类型限制
• 过滤类型：竞价广告（C2S/S2S）
3. 广告平台的广告位限制
• 目标平台的广告位ID：广告位1（对应广告平台的NetworkPlacementId字段）
4. 价格区间限制

• • 货币单位：RMB人民币元
  • 价格范围：≥10

ATSDK.putFilter("your placement id", new ATWaterfallFilter()
        // 条件1
        .filterNetworkIds(Arrays.asList("平台1", "平台2")) // 过滤掉指定平台id
        .filterBidTypes(Arrays.asList(ATWaterfallFilter.NORMAL)) //过滤掉非竞价类型
        .filterNetworkPlacementIds(Arrays.asList("广告平台的广告位1", "广告平台的广告位2")) // 过滤掉广告平台的广告位id
        .filterAdPrice(new ATWaterfallFilter.PriceInterval(ATAdConst.CURRENCY.RMB_CENT) // 选择货币单位 人民币分，过滤掉指定价格范围
                .lessThanPrice(5000) // 小于等于5000
        )
        .orFilter()
        // 条件2
        .filterNetworkIds(Arrays.asList("平台3")) // 过滤掉指定平台id
        .filterBidTypes(Arrays.asList(ATWaterfallFilter.C2S, ATWaterfallFilter.S2S)) //过滤掉竞价类型
        .filterNetworkPlacementIds(Arrays.asList("广告平台的广告位1")) // 过滤掉广告平台的广告位id
        .filterAdPrice(new ATWaterfallFilter.PriceInterval(ATAdConst.CURRENCY.RMB) // 选择货币单位 人民币元，过滤掉指定价格范围
                .moreThanPrice(10) // 大于等于10
        )
);