← 返回目录
📁 API Reference › Tools

检查设置是否支持价值优化

您可以使用本接口检查设置是否支持价值优化(VBO),同时获取指定的设置下可用的价值优化竞价策略。 若想要了解如何启用价值优化,请查看开启价值优化。

注意
若您通过请求指定了价值优化的白名单功能,且未开启对应的白名单,返回中将显示指定的设置不支持价值优化(vo_status=NOT_SUPPORT)。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/tool/vbo_status/

方法 GET

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| advertiser_id {必填} | string | 广告主ID。 |
| objective_type{必填} | string | 推广目标。 <br>将本字段设置为 `APP_PROMOTION`,`WEB_CONVERSIONS`,或`PRODUCT_SALES`。<br>若您将本字段设置为其他目标,返回的`vo_status` 将为`NOT_SUPPORT`,因为价值优化不支持这些目标。<br>枚举值和对应描述详见[推广目标](https://ads.tiktok.com/marketing_api/docs?id=1737585562434561)。 <br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>`objective_type` 设置为 `PRODUCT_SALES` ,且`promotion_type`同时设置为`LIVE_SHOPPING` 或`VIDEO_SHOPPING`时,不支持传入`pixel_id` 或`app_id`。</li><li>其他情况下,需传入`pixel_id`和`app_id`其中之一。</li></ul> |
| app_promotion_type{+条件必填} | string | `objective_type`设置为`APP_PROMOTION`时必填。 <br>应用推广类型。 <br>枚举值:<ul><li>`APP_INSTALL`:让新用户安装您的应用。</li><li> `APP_RETARGETING`:重新吸引现有用户在您的应用中执行操作。</li><li>`MINIS`:TikTok Minis。吸引用户在 TikTok Minis 内观看剧集或玩游戏。<ul><li>若想了解支持本设置的推广系列类型,可查看[创建升级版 Smart+ Minis 推广系列](1853377811982657.html)。</li></ul></li></ul> <p><span style="color:darkred"><b>注意</b></span>: iOS 14专属推广系列中仅支持枚举值`APP_INSTALL`。 |
| campaign_type| string | 无需同时传入 `campaign_type` 和 `ios14_quota_type` 字段。若同时传入, `ios14_quota_type` 字段将被忽略。<br><br>推广系列类型。<br><br> 枚举值:<ul><li> `REGULAR_CAMPAIGN`:非 iOS 14专属推广系列。</li><li>`IOS14_CAMPAIGN`:iOS 14专属推广系列。</li></ul> <br> `IOS14_CAMPAIGN` 的值仅支持以下场景:<ul><li>`objective_type` 为 `PRODUCT_SALES`。</li><li>`objective_type` 为 `APP_PROMOTION` 且 `app_promotion_type` 为 `APP_INSTALL`。</li></ul> |
| is_advanced_dedicated_campaign | boolean | 是否使用高级专属推广系列。高级专属推广系列采用捕捉实时信号的高级投放模型。 <br><br>支持的值:`true`,`false`。 <br>默认值:`false`。 <br><br>若想了解如何创建此类推广系列,请查看[创建高级专属推广系列](1797011827608577.html)。  |
| disable_skan_campaign | boolean | 仅当满足以下所有条件时生效: <ul><li>`objective_type` 为 `APP_PROMOTION`。</li><li>`app_promotion_type` 为 `APP_INSTALL`。</li><li>`campaign_type` 为 `IOS14_CAMPAIGN`。</li><li>`app_id` 为可用于[高级专属推广系列](1797011827608577.html)的 iOS 应用的 ID。 若想确认应用能否用于高级专属推广系列中,可使用 [/app/list/](1740859313270786.html) 并查看返回的 `advanced_dedicated_campaign_allowed`。</li></ul><br>是否关闭 SKAN(SKAdNetwork)归因(Apple 针对 iOS 推广系列的转化归因解决方案)。 <br><br>枚举值:<ul><li>`true`:关闭 SKAN 归因。推广系列将不受[专属推广系列配额限制](1752256248260610.html)的约束,您可为此推广系列拉取[自归因平台(SAN)指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-自归因平台指标)数据。但是,不支持为此推广系列拉取 [SKAN 指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-SKAN%20指标)数据。了解自归因平台集成的详情。<ul><li>若专属推广系列中使用了可用于高级专属推广系列的应用,您需使用以下配置之一:仅启用 SKAN 归因、仅启用高级专属推广系列设置、同时启用 SKAN 归因和高级专属推广系列设置。不支持为此推广系列同时关闭 SKAN 归因和高级专属推广系列设置。</li></ul></li><li>`false`:启用 SKAN 归因。推广系列将受[专属推广系列配额限制](1752256248260610.html)的约束,您可为此推广系列拉取 [SKAN 指标](https://business-api.tiktok.com/portal/docs?id=1751443967255553#item-link-SKAN%20指标)数据。<ul><li>若您启用 SKAN 归因的同时将 `is_advanced_dedicated_campaign` 设置为 `true`,从而启用高级专属推广系列设置,您将可以为此推广系列同时拉取自归因平台指标和 SKAN 指标数据。</li></ul></li></ul><br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>为专属推广系列关闭 SKAN 归因目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。</li><li>使用高级专属推广系列要求应用满足一定条件。若您的应用不可用于高级专属推广系列,可联系您的 TikTok 销售代表。您的 TikTok 销售代表将提供故障排查支持,帮助您的应用满足高级专属推广系列的条件。</li></ul>|
| bid_align_type | string | 仅当满足以下所有条件时生效: <ul><li>`objective_type` 为 `APP_PROMOTION`。</li><li>`app_promotion_type` 为 `APP_INSTALL`。</li><li>`campaign_type` 为 `IOS14_CAMPAIGN`。</li><li>`app_id` 为可用于[高级专属推广系列](1797011827608577.html)的 iOS 应用的 ID。 若想确认应用能否用于高级专属推广系列中,可使用 [/app/list/](1740859313270786.html) 并查看返回的 `advanced_dedicated_campaign_allowed`。</li></ul><br>专属推广系列的归因类型。此类型决定广告组层级设置的目标 CPA (`conversion_bid_price`)或目标 ROAS(`roas_bid`) 基于的归因网络类型。 <br><br>枚举值:<ul><li>`SAN`:自归因平台归因。</li><li>`SKAN`:SKAN 归因。</li></ul><br><ul><li>若 `is_advanced_dedicated_campaign` 为 `true` 且您未申请专属推广系列关闭 SKAN 归因的白名单,需将本字段设置为 `SKAN`。</li><li>若 `is_advanced_dedicated_campaign` 为 `true`,您已申请专属推广系列关闭 SKAN 归因的白名单,且 `disable_skan_campaign` 设置为 `false`,需将本字段设置为 `SAN`。</li><li>若 `is_advanced_dedicated_campaign` 为 `true` 且 `disable_skan_campaign` 为 `true`,需将本字段设置为 `SAN`。</li><li>若 `is_advanced_dedicated_campaign` 为 `false` 且 `disable_skan_campaign` 设置为 `false`,需将本字段设置为 `SKAN`。</li></ul> |
| promotion_type {必填} | string | 推广对象类型。 枚举值详见[枚举值-推广对象类型](https://ads.tiktok.com/marketing_api/docs?id=1737174886619138)。 <br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>`objective_type` 设置为 `PRODUCT_SALES` ,且`promotion_type`同时设置为`LIVE_SHOPPING` 或`VIDEO_SHOPPING`时,不支持传入`pixel_id` 或`app_id`。</li><li>其他情况下,需传入`pixel_id`和`app_id`其中之一。</li></ul>  |
| placements {必填} | string[] | 广告版位。 <br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>目前,本字段支持`PLACEMENT_TIKTOK`,`PLACEMENT_PANGLE`,`PLACEMENT_GLOBAL_APP_BUNDLE` 。</li><li>若所属的推广系列的推广目标为商品销量(`objective_type` = `PRODUCT_SALES`),仅支持TikTok版位(`PLACEMENT_TIKTOK`)。</li></ul>|
| ios14_quota_type {-即将废弃} | string | 无需同时传入 `campaign_type` 和 `ios14_quota_type` 字段。若同时传入, `ios14_quota_type` 字段将被忽略。<br>若您想要指定推广系列为 iOS 14专属推广系列,推荐您仅传入 `campaign_type` 字段。<br><ul><li>`campaign_type` 为 `REGULAR_CAMPAIGN` 或 `ios14_quota_type` 为 `UNOCCUPIED` 均表示推广系列非 iOS 14专属推广系列。</li><li> `campaign_type` 为 `IOS14_CAMPAIGN` 或 `ios14_quota_type` 为 `OCCUPIED` 均表示推广系列为iOS 14专属推广系列。</li></ul> <br>该推广系列是否占用 iOS 14专属推广系列的配额。 <br>枚举值:<ul><li>`OCCUPIED`:该推广系列是iOS 14专属推广系列。</li><li> `UNOCCUPIED`: 该推广系列不是iOS 14专属推广系列。</li></ul>|
| campaign_app_profile_page_state | string | 是否在推广系列层级使用应用介绍页优化广告投放。 <br> 枚举值: `ON`, `OFF`。 <br> 本字段仅支持在`objective_type`为`APP_PROMOTION`的iOS 14专属推广系列(`ios14_quota_type`=`OCCUPIED`)中使用,否则会出现报错。 |
| pixel_id {+条件必填} | string | `objective_type` 设置为`PRODUCT_SALES`且`promotion_type`同时设置为`LIVE_SHOPPING`或`VIDEO_SHOPPING`,或`app_promotion_type`为`MINIS`时不支持本字段。<br>其他情况下,需传入`pixel_id`和`app_id`其中之一。<br>Pixel ID。 <br>若传入了本字段,则需同时传入`optimization_event` 。<br> 若想要获取Pixel ID,可使用[/pixel/list/](https://ads.tiktok.com/marketing_api/docs?id=1740858697598978)接口。 |
| app_id {+条件必填} | string | `objective_type` 设置为 `PRODUCT_SALES`且`promotion_type`同时设置为`LIVE_SHOPPING`或`VIDEO_SHOPPING`,或`app_promotion_type`为`MINIS`时不支持本字段。<br>其他情况下,需传入`pixel_id`和`app_id`其中之一。<br> 推广的应用的ID。 <br>若想要获取 App ID,可使用 [/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786)接口。 |
| optimization_event {+条件必填} | string | 传入`pixel_id `时,本字段必填。 <br>传入`app_id`时,忽略本字段。 <br>广告组转化事件。 <br> 参阅[转化事件](https://ads.tiktok.com/marketing_api/docs?id=1739361474981889) ,获取详细信息。 |
| store_id | string | 仅当 `objective_type` 设置为`PRODUCT_SALES`时生效。<br>TikTok Shop 店铺ID。 <br><p><span style="color:darkred"><b>注意</b></span>:若想要获取 TikTok Shop 店铺 ID ,您可以调用[/bc/asset/get/](https://ads.tiktok.com/marketing_api/docs?id=1739432717798401): <ul><li>当返回中的`asset_type`为 `TIKTOK_SHOP`时,对应的`asset_id`为 TikTok Shop 店铺 ID。</li></ul> |
| is_smart_performance_campaign {-即将废弃}| boolean | 该推广系列是否为 Smart+ 推广系列。 <br>枚举值:`true`,`false`。 |
| campaign_automation_type | string | 推广系列自动化类型。<br><br>枚举值:<ul><li>`MANUAL`:手动推广系列。</li><li>`SMART_PLUS`:Smart+ 推广系列。</li><li>`UPGRADED_SMART_PLUS`:升级版 Smart+ 推广系列,一种新的自动化推广系列类型。查看[升级版 Smart+ 推广系列](1853452461203458.html)文档,详细了解升级版 Smart+ 推广系列。</li></ul> |
| budget_optimize_on | boolean | 是否开启推广系列预算优化(CBO)。 <br>枚举值:`true`, `false`。<br>若想要了解详细信息,请参阅[推广系列预算优化](https://ads.tiktok.com/marketing_api/docs?id=1739381757818881)。 |

示例

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/tool/vbo_status/?advertiser_id={{advertiser_id}}&promotion_type=LIVE_SHOPPING&placements=["PLACEMENT_TIKTOK"]&objective_type=PRODUCT_SALES&optimization_event=SHOPPING&store_id={{store_id}}' \
--header 'Access-Token: {{Access-Token}}' \
(/code)

返回

|字段{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| 返回数据。 |
#| vo_status| string | 请求中的设置对于网站价值优化或应用内购价值优化功能的支持情况。 <br>枚举值:<ul><li>`QUALIFIED`:支持。</li><li>`NO_EVENT`:不支持,因为 Pixel (`pixel_id`)或应用(`app_id`)未产生事件。</li><li>`NO_VALUE`:不支持,因为 Pixel (`pixel_id`)或应用 (`app_id`)未产生价值。</li><li>`INSUFFICIENT_EVENTS`:不支持,因为 Pixel (`pixel_id`)或应用 (`app_id`)产生的事件数不足。</li><li>`NOT_SUPPORT`:不支持,因为以下任一原因:<ul><li>设置本身不支持价值优化。</li><li>设置本身支持价值优化, 但设置中指定了白名单功能,且您未开启对应白名单。</li></ul></li></ul>  |
#| vo_min | string | 开启网站价值优化或应用内购价值优化功能时,请求中的设置对同时使用竞价策略成本上限的支持情况。<br>枚举值:<ul><li> `QUALIFIED`:支持。</li><li>`NO_EVENT`:不支持,因为 Pixel (`pixel_id`)或应用 (`app_id`)未产生事件。</li><li>`NO_VALUE`:不支持,因为 Pixel (`pixel_id`)或应用 (`app_id`)未产生价值。</li><li>`INSUFFICIENT_EVENTS`:不支持,因为 Pixel (`pixel_id`)或应用(`app_id`)产生的事件数不足。</li><li> `NOT_SUPPORT`:不支持,因为以下任一原因:<ul><li>设置本身不支持在开启价值优化时,同时使用竞价策略成本上限。</li><li>设置本身支持支持在开启价值优化时,同时使用竞价策略成本上限,但设置中指定了白名单功能,且您未开启对应白名单。</li></ul></li></ul><br><p><span style="color:darkred"><b>注意</b></span>:已不支持使用价值优化时同时使用竞价策略成本上限。因此,本字段的值始终为`NOT_SUPPORT`。|
#| vo_min_roas| string | 开启网站价值优化或应用内购价值优化功能时,请求中的设置对同时使用竞价策略最低 ROAS 的支持情况。 <br>枚举值:<ul><li> `QUALIFIED`:支持。</li><li>`NO_EVENT`:不支持,因为 Pixel (`pixel_id`)或应用(`app_id`)未产生事件。</li><li>`NO_VALUE`:不支持,因为 Pixel (`pixel_id`)或应用 (`app_id`)未产生价值。</li><li> `INSUFFICIENT_EVENTS`:不支持,因为 Pixel (`pixel_id`)或应用 (`app_id`)产生的事件数不足。</li><li>`NOT_SUPPORT`:不支持,因为以下任一原因:<ul><li>设置本身不支持在开启价值优化时,同时使用竞价策略最低 ROAS。</li><li>设置本身支持支持在开启价值优化时,同时使用竞价策略最低 ROAS,但设置中指定了白名单功能,且您未开启对应白名单。</li></ul></li></ul>|
#| vo_highest_value | string | 开启网站价值优化或应用内购价值优化功能时,请求中的设置对同时使用竞价策略最高价值的支持情况。 <br>枚举值: <ul><li> `QUALIFIED`:支持。</li><li> `NO_EVENT`:不支持,因为 Pixel (`pixel_id`)或应用(`app_id`)未产生事件。</li><li> `NO_VALUE`:不支持,因为 Pixel (`pixel_id`)或应用(`app_id`)未产生价值。</li><li>`INSUFFICIENT_EVENTS`:不支持,因为 Pixel (`pixel_id`)或应用(`app_id`)产生的事件数不足。</li><li> `NOT_SUPPORT`:不支持,因为以下任一原因:<ul><li>设置本身不支持在开启价值优化时,同时使用竞价策略最高价值。</li><li>设置本身支持支持在开启价值优化时,同时使用竞价策略最高价值,但设置中指定了白名单功能,且您未开启对应白名单。</li></ul></li></ul>|
#| vo_iaa_min_roas | string | 开启应用广告收入价值优化功能时,请求中的设置对同时使用竞价策略第 7 天最低 ROAS 的支持情况。<br><br> 枚举值:<ul><li> `QUALIFIED`:支持。</li><li>`NO_EVENT`:不支持,因为应用(`app_id`)未产生任何事件。</li><li>`NO_VALUE`:不支持,因为应用(`app_id`)未产生转化价值大于 0 的事件。</li><li>`INSUFFICIENT_EVENTS`:不支持,因为应用(`app_id`)产生的转化价值大于 0 的事件数不足。</li><li>`NOT_SUPPORT`:不支持,因为以下任一原因:<ul><li>设置本身不支持在开启应用广告收入价值优化时,同时使用竞价策略第 7 天最低 ROAS。</li><li>设置本身支持支持在开启应用广告收入价值优化时,同时使用竞价策略第 7 天最低 ROAS,但应用(`app_id`)未满足该功能的解锁条件。 </li></ul></li></ul>|
#| vo_iaa_highest_value | string | 开启应用广告收入价值优化功能时,请求中的设置对同时使用竞价策略前 7 天最高价值的支持情况。<br><br> 枚举值:<ul><li> `QUALIFIED`:支持。</li><li>`NO_EVENT`:不支持,因为应用(`app_id`)未产生任何事件。</li><li>`NO_VALUE`:不支持,因为应用(`app_id`)未产生转化价值大于 0 的事件。</li><li>`INSUFFICIENT_EVENTS`:不支持,因为应用(`app_id`)产生的转化价值大于 0 的事件数不足。</li><li>`NOT_SUPPORT`:不支持,因为以下任一原因:<ul><li>设置本身不支持在开启应用广告收入价值优化时,同时使用竞价策略前 7 天最高价值。</li><li>设置本身支持支持在开启应用广告收入价值优化时,同时使用竞价策略前 7 天最高价值,但应用(`app_id`)未满足该功能的解锁条件。 </li></ul></li></ul> |
#| vo_iaa_min_roas_zero_day | string | 开启应用广告收入价值优化功能时,请求中的设置对同时使用竞价策略第 0 天最低 ROAS 的支持情况。<br><br> 枚举值:<ul><li> `QUALIFIED`:支持。</li><li>`NO_EVENT`:不支持,因为应用(`app_id`)未产生任何事件。</li><li>`NO_VALUE`:不支持,因为应用(`app_id`)未产生转化价值大于 0 的事件。</li><li>`INSUFFICIENT_EVENTS`:不支持,因为应用(`app_id`)产生的转化价值大于 0 的事件数不足。</li><li>`NOT_SUPPORT`:不支持,因为以下任一原因:<ul><li>设置本身不支持在开启应用广告收入价值优化时,同时使用竞价策略第 0 天最低 ROAS。</li><li>设置本身支持支持在开启应用广告收入价值优化时,同时使用竞价策略第 0 天最低 ROAS,但广告主(`advertiser_id`)未申请广告收入价值优化的第 0 天出价的白名单。 </li></ul></li></ul>|
#| vo_iaa_highest_value_zero_day | string | 开启应用广告收入价值优化功能时,请求中的设置对同时使用竞价策略第 0 天最高价值的支持情况。<br><br> 枚举值:<ul><li> `QUALIFIED`:支持。</li><li>`NO_EVENT`:不支持,因为应用(`app_id`)未产生任何事件。</li><li>`NO_VALUE`:不支持,因为应用(`app_id`)未产生转化价值大于 0 的事件。</li><li>`INSUFFICIENT_EVENTS`:不支持,因为应用(`app_id`)产生的转化价值大于 0 的事件数不足。</li><li>`NOT_SUPPORT`:不支持,因为以下任一原因:<ul><li>设置本身不支持在开启应用广告收入价值优化时,同时使用竞价策略第 0 天最高价值。</li><li>设置本身支持支持在开启应用广告收入价值优化时,同时使用竞价策略第 0 天最高价值,但广告主(`advertiser_id`)未申请广告收入价值优化的第 0 天出价的白名单。 </li></ul></li></ul> |
#| roas_status_day7 | string | 开启应用内购价值优化功能时,请求中的设置对同时使用竞价策略第 7 天最低 ROAS 的支持情况。 <br><br>枚举值: <ul><li>`QUALIFIED`:支持。</li><li> `NO_EVENT`:不支持,因为应用(`app_id`)未产生任何事件。</li><li>`NO_VALUE`:不支持,因为应用(`app_id`)未产生转化价值大于 0 的事件。</li><li> `INSUFFICIENT_EVENTS`:不支持,因为应用(`app_id`)产生的转化价值大于 0 的事件数不足。</li><li>`NOT_SUPPORT`:不支持,因为以下任一原因:<ul><li>设置本身不支持在开启应用内购价值优化时,同时使用竞价策略第 7 天最低 ROAS。</li><li>设置本身支持支持在开启应用内购价值优化时,同时使用竞价策略第 7 天最低 ROAS,但广告主(`advertiser_id`)未申请应用内购价值优化的第 7 天出价的白名单。</li></ul></li></ul> |
#| highest_value_status_day7 | string | 开启应用内购价值优化功能时,请求中的设置对同时使用竞价策略前 7 天最高价值的支持情况。 <br><br>枚举值: <ul><li>`QUALIFIED`:支持。</li><li> `NO_EVENT`:不支持,因为应用(`app_id`)未产生任何事件。</li><li>`NO_VALUE`:不支持,因为应用(`app_id`)未产生转化价值大于 0 的事件。</li><li> `INSUFFICIENT_EVENTS`:不支持,因为应用(`app_id`)产生的转化价值大于 0 的事件数不足。</li><li>`NOT_SUPPORT`:不支持,因为以下任一原因:<ul><li>设置本身不支持在开启应用内购价值优化时,同时使用竞价策略前 7 天最高价值。</li><li>设置本身支持支持在开启应用内购价值优化时,同时使用竞价策略前 7 天最高价值,但广告主(`advertiser_id`)未申请应用内购价值优化的第 7 天出价的白名单。</li></ul></li></ul> |
#| roas_status_day0 | string | 开启应用内购价值优化功能时,请求中的设置对同时使用竞价策略第 0 天最低 ROAS 的支持情况。 <br><br>枚举值: <ul><li>`QUALIFIED`:支持。</li><li> `NO_EVENT`:不支持,因为应用(`app_id`)未产生任何事件。</li><li>`NO_VALUE`:不支持,因为应用(`app_id`)未产生转化价值大于 0 的事件。</li><li> `INSUFFICIENT_EVENTS`:不支持,因为应用(`app_id`)产生的转化价值大于 0 的事件数不足。</li><li>`NOT_SUPPORT`:不支持,因为以下任一原因:<ul><li>设置本身不支持在开启应用内购价值优化时,同时使用竞价策略第 0 天最低 ROAS。</li><li>设置本身支持支持在开启应用内购价值优化时,同时使用竞价策略第 0 天最低 ROAS,但广告主(`advertiser_id`)未申请应用内购价值优化的第 0 天出价的白名单。</li></ul></li></ul> |
#| highest_value_status_day0 | string | 开启应用内购价值优化功能时,请求中的设置对同时使用竞价策略第 0 天最高价值的支持情况。 <br><br>枚举值: <ul><li>`QUALIFIED`:支持。</li><li> `NO_EVENT`:不支持,因为应用(`app_id`)未产生任何事件。</li><li>`NO_VALUE`:不支持,因为应用(`app_id`)未产生转化价值大于 0 的事件。</li><li> `INSUFFICIENT_EVENTS`:不支持,因为应用(`app_id`)产生的转化价值大于 0 的事件数不足。</li><li>`NOT_SUPPORT`:不支持,因为以下任一原因:<ul><li>设置本身不支持在开启应用内购价值优化时,同时使用竞价策略第 0 天最高价值。</li><li>设置本身支持支持在开启应用内购价值优化时,同时使用竞价策略第 0 天最高价值,但广告主(`advertiser_id`)未申请应用内购价值优化的第 0 天出价的白名单。</li></ul></li></ul> |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "vo_highest_value": "QUALIFIED",
        "vo_min_roas": "QUALIFIED",
        "vo_status": "QUALIFIED",
        "vo_min": "NOT_SUPPORT",
        "vo_iaa_highest_value": "NOT_SUPPORT",
        "vo_iaa_min_roas": "NOT_SUPPORT",
        "vo_iaa_highest_value_zero_day": "NOT_SUPPORT",
        "vo_iaa_min_roas_zero_day": "NOT_SUPPORT"
    }
}
(/code)

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →