菜单

聚合管理的AB测试及流量分组管理

注意：接入Api前请先熟悉api签名机制（参考接口鉴权说明）, 即Api请求样例中的一些http请求头的来源

1. 获取指定广告位下的所有聚合分组

1.1 请求URL

https://openapi.toponad.com/v3/mediation_group/:placement_id

1.2 请求方式

GET

1.3 请求参数

无

1.4 返回参数

字段	类型	是否必传	备注
data	Object	Y	返回结果数据
data.mediation_group_id	Int	Y	聚合分组ID
data.mediation_group_name	String	Y	A/B测试分组名字
data.abtest_group_item_id	Int	Y	A/B测试分组ID
data.traffic_variation	Int	Y	A/B测试分组权重
data.is_pending	Bool	Y	是否待生效分组 false 测试中 true 待生效分组
data.timezone	Int	Y	开始时间的时区 -12~12 = 西12区 ~ 东12区待生效才会有值
data.start_time	Int	Y	开始时间，时间戳待生效才会有值

1.5 样例

请求样例：

curl --location --request GET 'https://openapi.toponad.com/v3/mediation_group/b60f6e9480e4ba' \
--header 'X-Up-Key: ee609bfc9112c50ca4936fdecc43713e7eaxxxx' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1626056011000' \
--header 'Content-Type: application/json' \
--data-raw ''

返回样例：

{
    "data": [
        {
            "mediation_group_id": 116112,
            "mediation_group_name": "A\u7ec4",
            "abtest_group_item_id": 10000080,
            "traffic_variation": 2,
            "is_pending": false,
            "time_zone": 0,
            "start_time": 0
        },
        {
            "mediation_group_id": 116113,
            "mediation_group_name": "B\u7ec4",
            "abtest_group_item_id": 10000081,
            "traffic_variation": 1,
            "is_pending": false,
            "time_zone": 0,
            "start_time": 0
        },
        {
            "mediation_group_id": 116114,
            "mediation_group_name": "C\u7ec4",
            "abtest_group_item_id": 10000082,
            "traffic_variation": 1,
            "is_pending": false,
            "time_zone": 0,
            "start_time": 0
        }
    ]
}

2. 获取指定聚合分组下的所有流量分组

注意：流量分组做了实验，同一个segment_id可能会有多条（对应不同的实验组abtest_group_item_id），文档暂时不体现，待升级

2.1 请求URL

https://openapi.toponad.com/v3/mediation_segment/:mediation_group_id

2.2 请求方式

GET

2.3 请求参数

无

2.4 返回参数

字段	类型	是否必传	备注
data	Array[Object]	Y	返回结果数据
data.segment_id	Int	Y	流量分组ID
data.segment_name	String	Y	流量分组名字
data.priority	Int	Y	流量分组权重
data.parallel_request_number	Int	Y	并发请求数
data.auto_load	Int	Y	默认0表示关，只能传0或正整数对于Banner，可以设置自动刷新时间，大于0表示自动刷新时间对于RV和插屏，仅控制自动请求的开关状态，非0表示开
data.hour_cap	Int	Y	展示上限（小时），-1 表示无限制
data.day_cap	Int	Y	展示上限（天），-1 表示无限制
data.pacing	Int	Y	展示间隔（秒），-1 表示无限制
data.rules	Array[Object]	Y	流量分组的规则列表
data.rules.type	Int	Y	规则类型，默认规则为地区，枚举值说明： 0: 地区（集合） 1: 时间（区间） 2: 天（星期）（集合） 3: 网络（集合） 4: 小时/1225/2203（区间） 5: 自定义规则（custom） 8: 应用版本号（集合） 9: SDK版本号（集合） 10: 设备类型（集合），注意：集合里内容必须是小写且前后不能包含空格，可选值如下：iphone,ipad 11: 设备品牌（集合） 12: 系统版本（集合） 16: 时区 (值，特殊处理) 17: 设备ID （集合） 20: 安装时间小时（值） 21: 安装时间天（值） 22: 安装时间周（值） 23: 渠道（集合），支持包括/不包括 24: 子渠道（集合），支持包括/不包括 25: IDFA状态（值），支持等于，可选值如下,1(有IDFA)；2(无IDFA) 26: 安装时间自然天（值）
data.rules.rule	Int	Y	具体规则，默认为包含，枚举值说明： 0: 包含（集合） 1: 不包含（集合） 2: 大于等于（值） 3: 小于等于（值） 4: 区间内（区间） 5: 区间外（区间） 6: 自定义规则（custom） 7: 大于（值） 8: 小于（值）
data.rules.content	Object	Y	规则内容，规则详见附录(流量分组规则数据格式)规范

2.5 样例

请求样例：

curl --location --request GET 'https://openapi.toponad.com/v3/mediation_segment/116112' \
--header 'X-Up-Key: 877f8ae9c6e9ca82c0===b5fff594c373axxx' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1626056011000' \
--header 'Content-Type: application/json' \
--data-raw ''

返回样例：

{
    "data": [
        {
            "segment_id": 600270,
            "segment_name": "sdk_and_brand",
            "priority": 8,
            "parallel_request_number": 1,
            "auto_load": 0,
            "hour_cap": -1,
            "day_cap": -1,
            "pacing": -1,
            "rules": [
                {
                    "type": 9,
                    "rule": 7,
                    "content": "5.2.1"
                },
                {
                    "type": 11,
                    "rule": 1,
                    "content": [
                        "apple",
                        "acer",
                        "advan"
                    ]
                }
            ]
        },
        {
            "segment_id": 600262,
            "segment_name": "sdk",
            "priority": 9,
            "parallel_request_number": 1,
            "auto_load": 20,
            "hour_cap": 2,
            "day_cap": 3,
            "pacing": 4,
            "rules": [
                {
                    "type": 9,
                    "rule": 7,
                    "content": "5.2.1"
                }
            ]
        },
        {
            "segment_id": 0,
            "segment_name": "Default Segment",
            "priority": 10,
            "parallel_request_number": 1,
            "auto_load": 0,
            "hour_cap": -1,
            "day_cap": -1,
            "pacing": -1,
            "rules": []
        }
    ]
}

3. 创建流量分组

3.1 请求URL

https://openapi.toponad.com/v3/mediation_segment

3.2 请求方式

POST

3.3 请求参数

字段	类型	是否必传	备注
app_id	String	Y	应用ID
placement_id	String	Y	广告位ID
mediation_group_id	Int	Y	聚合分组ID
segment_name	String	Y	流量分组名称
timezone	Int	N	流量分组时区，取值范围[-12,12]，分别代表[UTC-12,UTC+12]注意： 1.规则存在时区属性时（天/小时/安装时间自然天）不传默认为0时区（UTC+0） 2.规则不存在时区属性时，可不传
rules	Array[Object]	Y	流量分组规则信息列表
rules.type	Int	Y	规则类型，默认规则为地区，枚举值说明： 0: 地区（集合） 2: 天（星期）（集合） 3: 网络（集合），注意：集合里内容必须是小写且前后不能包含空格，可选值如下：2g,3g,4g,5g,wifi 4: 小时/1225/2203（区间） 5: 自定义规则（custom） 8: 应用版本号（集合） 9: SDK版本号（集合） 10: 设备类型（集合），注意：集合里内容必须是小写且前后不能包含空格，可选值如下：iphone,ipad 11: 设备品牌（集合），集合里可选值如下： Apple,Acer,Advan,Amazon,Asus,Blackshark,Coolpad, GIONEE,Google,Hisense,Honor,HTC,Huawei,Infinix, Lanix,LeEco,Lenovo,LGE,Meitu,Meizu,MetroPCS, Motorola,Nokia,Nubia,OnePlus,OPPO,Qcom,Realme, Redmi,Samsung,Sharp,Smartfren,Smartisan,Sony,TCL, Tecno,Verizon,Vivo,Xiaomi,ZTE,360 12: 系统版本（集合） 17: 设备ID （集合） 20: 安装时间小时（值） 21: 安装时间天（值） 22: 安装时间周（值） 23: 渠道（集合），支持包括/不包括 24: 子渠道（集合），支持包括/不包括 25: IDFA状态（值），支持等于，可选值如下,1(有IDFA)；2(无IDFA) 26: 安装时间自然天（值）
rules.rule	Int	Y	具体规则，默认为包含，枚举值说明： 0: 包含（集合） 1: 不包含（集合） 2: 大于等于（值） 3: 小于等于（值） 4: 区间内（区间） 5: 区间外（区间） 6: 自定义规则（custom） 7: 大于（值） 8: 小于（值）
rules.content	Object	Y	规则内容，规则详见附录(流量分组规则数据格式)规范

3.4 返回参数

字段	类型	是否必传	备注
id	Int	Y	流量分组ID

3.5 样例

请求样例：

curl --location --request POST 'https://openapi.toponad.com/v3/mediation_segment' \
--header 'X-Up-Key: 877f8ae9c6e9ca82c0==5b5fff594c373axxx' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1626161553000' \
--header 'Content-Type: application/json' \
--data-raw '{
    'app_id'             : 'a60f54770a583d',
    'placement_id'       : 'b60f6e9480e4ba',
    'mediation_group_id' : 116112,
    'segment_name'       : 'sdk_and_brand',
    'rules'              : [
        {
            "rule"    : 7,
            "type"    : 9,
            "content" : "5.2.1",
        },
        {
            "type"    : 11,
            "rule"    : 1,
            "content" : [
                "apple",
                "acer",
                "advan",
            ],
        },

    ]
}'

返回样例：

{
    "id": 600271
}

4. 调整流量分组优先级

4.1 请求URL

https://openapi.toponad.com/v3/mediation_segment_priority/:mediation_group_id

4.2 请求方式

PUT

4.3 请求参数

字段	类型	是否必传	备注
app_id	String	Y	应用ID
placement_id	String	Y	广告位ID
segment_ids	Array[Int]	Y	流量分组ID列表

4.4 返回参数

字段	类型	是否必传	备注
segment_ids	Array[Int]	Y	流量分组ID列表

4.5 样例

请求样例：

curl --location --request PUT 'https://openapi.toponad.com/v3/mediation_segment_priority/116112' \
--header 'X-Up-Key: 877f8ae9c6e9ca82c0==5b5fff594c373axxx' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1626161553000' \
--header 'Content-Type: application/json' \
--data-raw '{
    'app_id'       : 'a60f54770a583d',
    'placement_id' : 'b60f6e9480e4ba',
    'segment_ids'  : [
        600269,
        600268,
        600265,
        600264,
        600263,
        600261,
        600258,
        600270,
        600262
    ]
}'

返回样例：

5. 更新流量分组

5.1 请求URL

https://openapi.toponad.com/v3/mediation_segment/:segment_id

5.2 请求方式

PUT

5.3 请求参数

字段	类型	是否必传	备注
app_id	String	Y	应用ID
placement_id	String	Y	广告位ID
mediation_group_id	Int	Y	聚合分组ID
segment_name	String	Y	流量分组名称
timezone	Int	N	流量分组时区，取值范围[-12,12]，分别代表[UTC-12,UTC+12]注意： 1.规则存在时区属性时（天/小时/安装时间自然天）不传默认为0时区（UTC+0） 2.规则不存在时区属性时，可不传
rules	Array[Object]	Y	流量分组规则信息列表
rules.type	Int	Y	规则类型，默认规则为地区，枚举值说明： 0: 地区（集合） 2: 天（星期）（集合） 3: 网络（集合），注意：集合里内容必须是小写且前后不能包含空格，可选值如下：2g,3g,4g,5g,wifi 4: 小时/1225/2203（区间） 5: 自定义规则（custom） 8: 应用版本号（集合） 9: SDK版本号（集合） 10: 设备类型（集合），注意：集合里内容必须是小写且前后不能包含空格，可选值如下：iphone,ipad 11: 设备品牌（集合），集合里可选值如下： Apple,Acer,Advan,Amazon,Asus,Blackshark,Coolpad, GIONEE,Google,Hisense,Honor,HTC,Huawei,Infinix, Lanix,LeEco,Lenovo,LGE,Meitu,Meizu,MetroPCS, Motorola,Nokia,Nubia,OnePlus,OPPO,Qcom,Realme, Redmi,Samsung,Sharp,Smartfren,Smartisan,Sony,TCL, Tecno,Verizon,Vivo,Xiaomi,ZTE,360 12: 系统版本（集合） 17: 设备ID （集合） 20: 安装时间小时（值） 21: 安装时间天（值） 22: 安装时间周（值） 23: 渠道（集合），支持包括/不包括 24: 子渠道（集合），支持包括/不包括 25: IDFA状态（值），支持等于，可选值如下,1(有IDFA)；2(无IDFA) 26: 安装时间自然天（值）
rules.rule	Int	Y	具体规则，默认为包含，枚举值说明： 0: 包含（集合） 1: 不包含（集合） 2: 大于等于（值） 3: 小于等于（值） 4: 区间内（区间） 5: 区间外（区间） 6: 自定义规则（custom） 7: 大于（值） 8: 小于（值） 9: 等于（值）
rules.content	Object	Y	规则内容，规则详见附录(流量分组规则数据格式)规范

5.4 返回参数

字段	类型	是否必传	备注
id	Int	Y	流量分组ID

5.5 样例

请求样例：

curl --location --request PUT 'https://openapi.toponad.com/v3/mediation_segment/600262' \
--header 'X-Up-Key: 877f8ae9c6e9ca82c0==5b5fff594c373axxx' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1626161553000' \
--header 'Content-Type: application/json' \
--data-raw '{
    'app_id'             : 'a60f54770a583d',
    'placement_id'       : 'b60f6e9480e4ba',
    'mediation_group_id' : 116112,
    'segment_name'       : 'new_CHINA_update',
    'rules'              : [
        {
            "rule"    : 7,
            "type"    : 9,
            "content" : "5.2.1",
        },
    ]
}'

返回样例：

{
    "id": 600262
}

6. 删除流量分组

注意：这个流量分组在做实验时不能删除

6.1 请求URL

https://openapi.toponad.com/v3/mediation_segment/:segment_id

6.2 请求方式

DELETE

6.3 请求参数

字段	类型	是否必传	备注
placement_id	String	Y	广告位ID
mediation_group_id	Int	Y	聚合分组ID

6.4 返回参数

字段	类型	是否必传	备注
id	Int	Y	流量分组ID

6.5 样例

请求地址样例：

https://openapi.toponad.com/v3/mediation_segment/600267

请求参数样例：

curl --location --request DELETE 'https://openapi.toponad.com/v3/mediation_segment/600267' \
--header 'X-Up-Key: 877f8ae9c6e9ca82c0==5b5fff594c373axxx' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1626161553000' \
--header 'Content-Type: application/json' \
--data-raw '{
    "placement_id"       : 'b60f6e9480e4ba',
    "mediation_group_id" : 116112
}'

返回样例：

{
    "id": 600267
}

7. 批量修改流量分组在waterfall的属性（已过期，使用Api9）

7.1 请求URL

https://openapi.toponad.com/v3/mediation_segment/:mediation_group_id/segment_id/:segment_id/attributes

7.2 请求方式

POST

7.3 请求参数

字段	类型	是否必传	备注
parallel_request_number	Int	Y	并发请求数
auto_load	Int	N	默认0表示关，只能传0或正整数对于Banner，可以设置自动刷新时间，大于0表示自动刷新时间对于RV和插屏，仅控制自动请求的开关状态，非0表示开
hour_cap	Int	N	展示上限（小时），-1 表示无限制
day_cap	Int	N	展示上限（天），-1 表示无限制
pacing	Int	N	展示间隔（秒），-1 表示无限制

7.4 返回参数

字段	类型	是否必传	备注
id	Int	Y	流量分组ID

7.5 样例

请求样例：

curl --location --request POST 'https://openapi.toponad.com/v3/mediation_segment/116112/segment_id/600262/attributes' \
--header 'X-Up-Key: 877f8ae9c6e9ca82c0==5b5fff594c373axxx' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1626161553000' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id" : 600262
    "auto_load" : 20,
    "hour_cap" : 2,
    "day_cap" : 3,
    "pacing" : 4
}'

返回样例：

{
    "id": 600262
}

8. 获取广告位流量分组高级设置策略

注意：流量分组做了实验，同一个segment_id可能会有多条（对应不同的实验组abtest_group_item_id），文档暂时不体现，待升级

8.1 请求URL

https://openapi.toponad.com/v3/mediation_segment/strategies

8.2 请求方式

GET

8.3 请求参数

字段	类型	是否必传	备注
placement_id	String	Y	Taku的广告位ID，可通过【广告位管理Api1】创建广告位后获取
currency	String	Y	返回数据中币种相关属性的币种单位，例如竞价底价bid_floor

8.4 返回参数

字段	类型	是否必传	备注
-	Array[Object]	Y	流量分组高级设置策略数据列表
_.mediation_group_id	Int	Y	Taku聚合分组ID
_.segment_id	Int	Y	Taku聚合分组下流量分组ID，0代表默认分组
_.segment_name	String	Y	流量分组名字，注意：空字符串代表默认分组
_.bid_floor	Double	Y	竞价底价，枚举说明 -1：代表不限（默认），其他值：最大值10000，美元最小值0.01，人民币最小值0.1 备注：竞价底价具体支持的广告平台及SDK版本请查看头部竞价说明。当广告平台出价低于竞价底价时Taku将会过滤此出价结果。设置竞价底价会降低竞价广告源的填充和收益，请谨慎设置。如果在流量分组和广告源同时设置了竞价底价，优先使用广告源的竞价底价（竞价底价最小值，人民币为￥0.1，美元为 $0.01）。
_.parallel_req_type	Int	Y	并行请求类型，枚举说明： 1：固定数量请求（默认） 2：同价格并行请求备注：选择固定数量请求，广告源将按最大并行请求数顺序发起请求，如果请求异常则顺序请求下一广告源。选择同价格并行请求（Taku SDK v5.9.20及以上），广告源将以价格为优先级顺序，按最大可并行数发起请求，如果全部请求异常，则顺序请求下一优先级广告源。广告展示不受并行影响，会严格遵循广告源优先级排序。
_.parallel_req_num	Int	N	并行请求数，有效区间[1,10]，默认1，注意：固定数量请求时才返回备注：并行条数为1表示串行请求，若条数为n（n>1），Taku同时向前n个广告源发送请求；如果全部请求异常，Taku继续向第n+1到第2n个广告源发送请求，依此类推。并行请求适用于广告展示高频的场景。
_.offer_request_num	Int	Y	广告加载条数，有效区间：[1,100]。注意：暂时只有原生样式支持，其他样式可忽略。备注：从v5.7.6( v5.7.06)版本开始，SDK支持针对广告源维度设置广告请求条数。支持广告源一次返回多条广告的广告平台：腾讯广告、快手广告、穿山甲
_.new_auto_refresh_type	Int	Y	刷新模式，注意：暂时只有横幅样式支持，其他样式可忽略，枚举说明： 1：自动优化 2：手动优化备注：选择手动优化，将按您设置的时间来刷新Banner广告；选择自动优化，Taku将为不同广告平台匹配合适的刷新时间。
_.auto_refresh_time	Int	Y	自动刷新（自动请求），不同广告位样式，默认是关，枚举说明：横幅广告（刷新模式是【手动优化】时的的自动刷新）：-1（关闭自动刷新）；范围[1,1000]（自动刷新间隔，单位秒）。（备注：设置广告定时自动刷新的时间间隔，建议设置间隔10秒至150秒，不填时则不开启自动刷新功能。注意：开启Taku自动刷新前，请确保已关闭第三方广告源的自动刷新或轮播功能，否则会影响广告展示和收益）激励视频/插屏广告/开屏广告（自动请求）：-1（关闭自动刷新）；1或其他正整数（开启自动刷新）。（备注：广告展示、广告关闭、或者 isReady 为False时，Taku SDK会为下一次展示自动请求广告。如果客户端有按照集成文档建议处理预加载逻辑，不建议打开此功能）原生广告等样式：无自动刷新功能，可忽略返回值
_.hour_cap	Int	Y	展示上限（小时），枚举说明： -1：表示无限制（默认）正整数：上限数量，范围[1,1000] 备注：设置单个用户在每个小时内的广告展示次数上限
_.day_cap	Int	Y	展示上限（天），枚举说明： -1：表示无限制（默认）正整数：上限数量，范围[1,1000] 备注：设置单个用户在每天内的广告展示次数上限
_.pacing	Int	Y	展示间隔（秒），枚举说明： -1：表示无限制（默认）正整数：间隔的秒时间，范围[1,10000000] 备注：设置本次展示到下一次请求之间的时间间隔
_.intel_opt_cache	Int	Y	智能优化，枚举说明： 1：关（默认） 2：价格优先 3：展示优先备注：Taku智能优化功能会根据当前广告位的广告缓存情况自动优化，智能优化支持两种模式： 1.价格优先：Taku会根据当前广告缓存情况自动优化广告缓存以提高广告位的填充价值。 2. 展示优先：Taku会根据当前广告缓存情况自动优化广告缓存以提高广告位的人均展示。您可以通过AB实验选择适合您广告位的模式。智能优化模式需要更新Taku Android SDK v6.2.16及以上、Taku iOS SDK v6.2.48及以上。
_.bf_ldf_rf_sw	Int	Y	请求失败重试开关，枚举说明： 1：开 2：关（默认）备注：请求失败后Taku会自动重试一次请求。注：打开请求失败重试后，流量请求、广告请求数会增加。Taku SDK v5.9.40及以上版本支持

8.5 样例

请求样例：

curl --location --request GET https://openapi.toponad.com/v3/mediation_segment/strategies?currency=USD&placement_id=b648a83d80eaxx' \
--header 'X-Up-Key: 877f8ae9c6e9ca82c0===b5fff594c373axxx' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1626056011000' \
--header 'Content-Type: application/json' \
--data-raw ''

返回样例：

[
    {
        "mediation_group_id": 273566,
        "segment_id": 0,
        "segment_name": "",
        "bid_floor": 1.25，
        "parallel_req_type": 1,
        "parallel_req_num": 7,
        "auto_refresh_time": -1,
        "hour_cap": 100,
        "day_cap": 200,
        "pacing": 300,
        "intel_opt_cache": 1
    },
    {
        "mediation_group_id": 273566,
        "segment_id": 652072,
        "segment_name": "渠道",
        "bid_floor": -1，
        "parallel_req_type": 2,
        "auto_refresh_time": 15,
        "hour_cap": 100,
        "day_cap": 200,
        "pacing": 300,
        "intel_opt_cache": 1
    }
]

9. 修改广告位流量分组高级设置策略

注意：若果其中存某个流量分组在做实验，则不会更新这个流量分组（操作成功，但是实际没有生效）,没有做实验的流量分组则更新成功，待升级

9.1 请求URL

https://openapi.toponad.com/v3/mediation_segment/strategies

9.2 请求方式

PUT

9.3 请求参数

字段	类型	是否必传	备注
placement_id	String	Y	Taku的广告位ID，可通过【广告位管理Api1】创建广告位后获取
currency	String	Y	items数据中币种相关属性的币种单位，例如竞价底价bid_floor
items	Array[Object]	Y	流量分组高级设置策略数据列表
items.mediation_group_id	Int	Y	Taku聚合分组ID
items.segment_id	Int	Y	Taku聚合分组下流量分组ID，0代表默认分组
items.bid_floor	Double	N	竞价底价，枚举说明 -1：代表不限（默认），其他值：最大值10000，美元最小值0.01，人民币最小值0.1 不传或传0代表不修改备注：竞价底价具体支持的广告平台及SDK版本请查看头部竞价说明。当广告平台出价低于竞价底价时Taku将会过滤此出价结果。设置竞价底价会降低竞价广告源的填充和收益，请谨慎设置。如果在流量分组和广告源同时设置了竞价底价，优先使用广告源的竞价底价（竞价底价最小值，人民币为￥0.1，美元为 $0.01）。
items.parallel_req_type	Int	N	并行请求类型，枚举说明： 1：固定数量请求（默认） 2：同价格并行请求不传或传0代表不修改备注：选择固定数量请求，广告源将按最大并行请求数顺序发起请求，如果请求异常则顺序请求下一广告源。选择同价格并行请求（Taku SDK v5.9.20及以上），广告源将以价格为优先级顺序，按最大可并行数发起请求，如果全部请求异常，则顺序请求下一优先级广告源。广告展示不受并行影响，会严格遵循广告源优先级排序。
items.parallel_req_num	Int	N	并行请求数，有效区间[1,10]，推荐值2，默认值参考开发者后台，注意：固定数量请求时才可设置数量，非固定固定数量请求不传即可不传或传0代表不修改备注：并行条数为1表示串行请求，若条数为n（n>1），Taku同时向前n个广告源发送请求；如果全部请求异常，Taku继续向第n+1到第2n个广告源发送请求，依此类推。并行请求适用于广告展示高频的场景。
items.auto_refresh_time	Int	N	自动刷新（自动请求），不同广告位样式，默认是关，枚举说明：不传或传0代表不修改横幅广告（刷新模式是【手动优化】时的的自动刷新）：-1（关闭自动刷新）；范围[1,1000]，默认=15（自动刷新间隔，单位秒）。（备注：设置广告定时自动刷新的时间间隔，建议设置间隔10秒至150秒，不填时则不开启自动刷新功能。注意：开启Taku自动刷新前，请确保已关闭第三方广告源的自动刷新或轮播功能，否则会影响广告展示和收益）激励视频/插屏广告/开屏广告（自动请求）：-1（关闭自动刷新）；1（开启自动刷新）。（备注：广告展示、广告关闭、或者 isReady 为False时，Taku SDK会为下一次展示自动请求广告。如果客户端有按照集成文档建议处理预加载逻辑，不建议打开此功能）原生广告等样式：无自动刷新功能，不传即可
items.hour_cap	Int	N	展示上限（小时），枚举说明： -1：表示无限制（默认）正整数：上限数量，范围[1,1000] 不传或传0代表不修改备注：设置单个用户在每个小时内的广告展示次数上限
items.day_cap	Int	N	展示上限（天），枚举说明： -1：表示无限制（默认）正整数：上限数量，范围[1,1000] 不传或传0代表不修改备注：设置单个用户在每天内的广告展示次数上限
items.pacing	Int	N	展示间隔（秒），枚举说明： -1：表示无限制（默认）正整数：间隔的秒时间，范围[1,10000000] 不传或传0代表不修改备注：设置本次展示到下一次请求之间的时间间隔
items.intel_opt_cache	Int	N	智能优化，枚举说明： 1：关（默认） 2：价格优先 3：展示优先不传或传0代表不修改备注：Taku智能优化功能会根据当前广告位的广告缓存情况自动优化，智能优化支持两种模式： 1.价格优先：Taku会根据当前广告缓存情况自动优化广告缓存以提高广告位的填充价值。 2. 展示优先：Taku会根据当前广告缓存情况自动优化广告缓存以提高广告位的人均展示。您可以通过AB实验选择适合您广告位的模式。智能优化模式需要更新Taku Android SDK v6.2.16及以上、Taku iOS SDK v6.2.48及以上。
items.bf_ldf_rf_sw	Int	N	请求失败重试开关，枚举说明： 1：开 2：关（默认）不传或传0代表不修改备注：请求失败后Taku会自动重试一次请求。注：打开请求失败重试后，流量请求、广告请求数会增加。Taku SDK v5.9.40及以上版本支持

9.4 返回参数

字段	类型	是否必传	备注
items	Array[Object]	N	错误广告源信息列表，注意： 1. 列表为空，则标识操作成功 2. 列表不为空，则列表标识哪些item校验不通过，所有item（包括校验通过）操作失败
items.index	Int	Y	错误item所在的索引，从0开始
items.err_code	Int	Y	错误码
items.err_msg	String	Y	错误信息

9.5 样例

请求样例：

curl --location --request PUT 'https://openapi.toponad.com/v3/mediation_segment/strategies' \
--header 'X-Up-Key: 877f8ae9c6e9ca82c0==5b5fff594c373axxx' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1626161553000' \
--header 'Content-Type: application/json' \
--data-raw '{
    "placement_id" : "b648a83d80eaxx",
    "currency" : "CNY",
    "items" : [
        {
            "mediation_group_id":273566,
            "segment_id":0,
            "bid_floor": -1,
            "parallel_req_type":1,
            "parallel_req_num": 7,
            "auto_refresh_time":-1,
            "hour_cap":100,
            "day_cap":200,
            "pacing":300,
            "intel_opt_cache":1
        }
    ]
}'

返回样例：

{

}

上一个

广告平台管理

下一个

聚合管理的广告源管理

最近修改: 2025-08-21Powered by

大纲