(已废弃)获取可用的出价后第三方监测合作伙伴
您可以使用本接口获取可用的出价后第三方监测合作伙伴,以及无法使用某一合作伙伴的原因。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/tool/vast_option/
方法 GET
Header
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type {必填}|string|请求信息类型<br>允许格式:`application/json`。|
参数
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|advertiser_id {必填}|string|广告主ID。 |
|objective_type {必填}|string| 推广目标。枚举值及描述请查看[推广目标](https://ads.tiktok.com/marketing_api/docs?id=1737585562434561)。|
| region_codes |string[]| 国家或地区代码列表。例如 `["US", "JP", "KR"]`。枚举值请查看[附录 - 地区代码](https://ads.tiktok.com/marketing_api/docs?id=1737585867307010)。|
|brand_safety_type|string|品牌安全类型。 允许的枚举值: <ul><li>`STANDARD_INVENTORY`:使用TikTok的品牌安全解决方案中的<strong>标准库存</strong>。您的广告将展示在适合大多数品牌的内容周围。 </li><li>`LIMITED_INVENTORY`:使用TikTok的品牌安全解决方案中的<strong>有限库存</strong>。您的广告将展示在不包含成人主题的内容周围。</li></ul>您可以使用[/tool/region/](https://ads.tiktok.com/marketing_api/docs?id=1737189539571713)接口查询品牌安全设置对应的广告可投放国家或地区。|
返回
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number|返回码。完整返回码列表及描述,可见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息。更多信息可见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|request_id |string|请求的日志ID,唯一标识一个请求。|
|data|object|返回数据。|
#| option_list | object[] | 出价后第三方监测合作伙伴列表。 |
##| partner | string | 出价后第三方品牌安全或可见性监测合作伙伴。枚举值:`MOAT`,`DOUBLE_VERIFY`, `IAS`,`ZEFR`。 <br>您可在调用 [/ad/create/](https://ads.tiktok.com/marketing_api/docs?id=1739953377508354)时通过`viewability_postbid_partner`和`brand_safety_postbid_partner`字段设置出价后第三方监测合作伙伴。 |
##| partner_name | string | 出价后第三方品牌安全监测合作伙伴或.出价后第三方可见性监测合作伙伴的名称。 |
##| vast_type | string | 该合作伙伴提供的出价后第三方全监测类型。枚举值:`VIEWABILITY` (可见性监测),`BRAND_SAFETY`(品牌安全监测)。 |
##| is_require_url | boolean | 当您选择此出价后第三方监测合作伙伴时,是否需要传入对应的VAST网址。 |
##| is_available | boolean | 是否可以在创建或更新广告时选择此出价后第三方监测合作伙伴。 |
##| unavailable_reason | object[] | 无法选择此出价后第三方监测合作伙伴的相关原因信息。当`is_available` 为 `False`时返回。 |
###| reason | string | 无法选择此出价后第三方监测合作伙伴的原因。 |
###| reason_type | string | 原因类型。 枚举值:<ul><li>`UNSUPPORTED_PARTNER`:您尚未获得选择此合作伙伴的授权。</li><li>`UNSUPPORTED_OBJ_TYPE`:该合作伙伴不支持您指定的推广目标。</li><li> `UNSUPPORTED_COUNTRY`:该合作伙伴不支持您指定的国家或地区代码。</li><li> `UNSUPPORTED_PREBID`:该合作伙伴与您在请求中通过`brand_safety_type`字段配置的投前品牌安全设置不匹配。</li></ul>|