← 返回目录
📁 Marketing API › Campaign Management › Guides › Ad group › Bidding › Value-Based Optimization

在 Smart+ 推广系列中开启价值优化

本文介绍了在 Smart+ 推广系列中开启价值优化(VBO)功能的详细步骤。

前提条件

  • 您已经拥有 TikTok API for Business 的使用权限。详见快速入门 - 具体步骤。
  • 若要开启价值优化,您需要获取相关的权限。参阅 API 参考了解使用相关接口(包括“步骤”部分列出的接口)所需的权限;参阅更新应用权限了解如何设置权限。
  • 不同场景下的广告收入价值优化或应用内购价值优化目前为白名单功能,如需使用这些功能,请联系您的 TikTok 销售代表。
  • 到达解锁阈值后,部分广告收入价值优化和应用内购价值优化功能会自动解锁。若想要了解解锁条件,请查看下文的“价值优化的解锁条件”小节。若想了解应用内购价值优化和广告收入价值优化的详情,请查看价值优化 - 应用的价值类型。

价值优化的解锁条件

所推广的应用(app_id)或网站(pixel_id)满足以下解锁条件后,该应用或网站将自动解锁价值优化功能。

| 推广对象{15%} | 解锁条件{30%} | 参数{15%} | 要求{40%}  |
|---|---|---|---|
| 应用(应用内购价值优化) | 解锁条件受您想使用的版位设置影响:<ul><li>若要使用自动版位,或非仅 Pangle 的手动版位,则该应用需在<strong>任意连续 7 天内,在 TikTok 或全球化应用组合版位上获得的已归因且有价值的购买事件次数在去重后达到 30 次。</strong></li><li>若想使用仅 Pangle 的手动版位,您需首先申请仅 Pangle 版位下启用价值优化功能的白名单。此外,该应用需<strong>在 Pangle 版位上累计获得的已归因且有价值的购买事件次数在去重后达到 50 次</strong>。</li></ul><p><span style="color:darkred"><b>注意</b></span>:<ul><li> 应用解锁应用内购价值优化功能后,可永久用于应用内购价值优化。</li><li>在仅 Pangle 版位下启用价值优化功能目前为白名单功能,如需使用此功能,请联系您的 TikTok 销售代表。</li></ul>| `app_id` | <ul><li>若您不想将 `placements` 设置为 `PLACEMENT_PANGLE` ,则该应用(`app_id`) 需在任意连续 7 天内,在 TikTok 或全球化应用组合版位上获得的已归因且在 `properties` 对象中设置了 `value` 的购买事件( `optimization_event` = `ACTIVE_PAY` )次数在去重后达到 30 次。</li><li>若您想将 `placements` 设置为 `PLACEMENT_PANGLE` ,则该应用(`app_id`) 需在 Pangle 版位上累计获得的已归因且在 `properties` 对象中设置了 `value` 的购买事件( `optimization_event` = `ACTIVE_PAY` )次数在去重后达到 50 次。</li></ul> 若想要查看某一应用是否已累计足够的事件数,且支持与某版位设置共用,可将版位设置及 App ID 传入[/tool/vbo_status/](https://ads.tiktok.com/marketing_api/docs?id=1770016073586753)。若应用已累计足够的事件数,且支持与指定的版位设置共用,则返回的 `vo_status` 将为 `QUALIFIED`。 <br> 若想要为某一应用报告应用事件,可使用[/app/track/](https://ads.tiktok.com/marketing_api/docs?id=1740859196043266)或[/app/batch/](https://ads.tiktok.com/marketing_api/docs?id=1740859218541569)。 |
| 应用(广告收入价值优化) | 若想解锁自动版位、仅 TikTok 的手动版位,或仅 Pangle 的手动版位的广告收入价值优化功能,该应用需满足以下要求:<ul><li> 应用为 Android 应用。</li><li> 应用设置的移动测量合作伙伴是 AppsFlyer 或 Adjust。</li><li> 应用的广告展示 ROAS 大于或等于 1。</li></ul> <br><p><span style="color:darkred"><b>注意</b></span>: 应用解锁广告收入价值优化功能后,可永久用于广告收入价值优化。 | `app_id` | 若想启用 `PLACEMENT_TYPE_AUTOMATIC`,`PLACEMENT_TIKTOK`,或 `PLACEMENT_PANGLE`版位下的广告收入价值优化功能,该应用(`app_id`)需满足以下要求: <ul><li> 从[/app/info/](1740859272887297.html)返回的 `platform` 为`ANDROID`。</li><li> 从[/app/info/](1740859272887297.html)返回的 `partner_name` 为 `AppsFlyer` 或 `Adjust`。</li><li>应用的<strong>广告展示 ROAS</strong>在之前的任意时间区间内达到或超过 1。<ul><li> 若想确认是否满足广告展示 ROAS 要求,您可以使用以下任意方法:<ul><li><strong>方法 1(推荐) </strong>:将`app_id` 直接传入 [/tool/vbo_status/](https://ads.tiktok.com/marketing_api/docs?id=1770016073586753),检查应用是否支持使用广告收入价值优化。</li><li><strong>方法 2</strong> :使用 [/report/integrated/get/](1740302848100353.html) 请求同步基础报表。将 `query_lifetime` 设置为 `true`,且在请求参数`metric` 中包含应用内事件指标`total_ad_impression_roas` 和属性指标 `tt_app_id`。该应用(`tt_app_id`)的广告展示 ROAS(`total_ad_impression_roas`)需大于等于 1。</li></ul></li></ul></li></ul>  |
| 网站 | 该 Pixel <strong>任意连续 7 天内,在 TikTok、Pangle 或全球化应用组合版位上获得的已归因且有价值和币种的支付完成事件次数在去重后达到 20 次。</strong> <ul><li>若该 Pixel 任意连续 7 天内,在 TikTok 版位上获得的已归因且有价值的支付完成事件次数在去重后<strong>达到 20 次</strong>,但在 Pangle 版位获得的已归因且有价值的支付完成事件次数在去重后也<strong>达到20 次</strong>,则支持使用任意版位设置。 </li><li>若该 Pixel 任意连续 7 天内,在 TikTok 版位上获得的已归因且有价值的支付完成事件次数在去重后<strong>达到 20 次</strong>,但在 Pangle 版位获得的已归因且有价值的支付完成事件次数在去重后<strong>不足 20 次</strong>,则仅支持使用 TikTok 版位。 </li><li>若该 Pixel 任意连续 7 天内,在 TikTok 版位上获得的已归因且有价值的支付完成事件次数在去重后<strong>不足 20 次</strong>,但在 Pangle 版位获得的已归因且有价值的支付完成事件次数在去重后<strong>达到 20 次</strong>,则仅支持使用 Pangle 版位。</li></ul><p><span style="color:darkred"><b>注意</b></span>:Pixel 解锁价值优化功能后,可永久用于价值优化。| `pixel_id` | 该 Pixel (`pixel_id`)任意连续 7 天内,在 TikTok、Pangle 或全球化应用组合版位上获得的已归因且在 `properties` 对象中设置了 `value` 和 `currency` 的支付完成事件( `optimization_event` = `SHOPPING` )次数在去重后达到 20 次。<ul><li>若该 Pixel 任意连续 7 天内,在 TikTok 版位上获得的已归因且有价值的支付完成事件次数在去重后达到 20 次,但在 Pangle 版位获得的已归因且有价值的支付完成事件次数在去重后也达到 20 次,则支持使用 `placement_type` 和 `placements` 设置任意版位。</li><li>若该 Pixel 任意连续 7 天内,在 TikTok 版位上获得的 已归因且有价值的支付完成事件次数在去重后达到 20 次,但在 Pangle 版位获得的已归因且有价值的支付完成事件次数在去重后不足 20 次,则仅支持将 `placements` 设置为 `PLACEMENT_TIKTOK` 。</li><li>若该 Pixel 任意连续 7 天内,在 TikTok 版位上获得的已归因且有价值的支付完成事件次数在去重后不足 20 次,但在 Pangle 版位获得的已归因且有价值的支付完成事件次数在去重后达到 20 次,则仅支持则仅支持将 `placements` 设置为 `PLACEMENT_PANGLE` 。</li></ul>若想要查看某一 Pixel 是否已累计足够的事件数,且支持与某版位设置共用,可将版位设置及 Pixel ID 传入 [/tool/vbo_status/](https://ads.tiktok.com/marketing_api/docs?id=1770016073586753)。若 Pixel 已累计足够的事件数,且支持与指定的版位设置共用,则返回的 `vo_status` 将为 `QUALIFIED`。 <br>若想要为某一 Pixel 报告网页事件,可使用[/pixel/track/](https://ads.tiktok.com/marketing_api/docs?id=1740858531237890)或[/pixel/batch/](https://ads.tiktok.com/marketing_api/docs?id=1740858565852225)。 |

步骤

注意
开启价值优化前,推荐您使用 /tool/vbo_status/ 检查您的设置是否支持价值优化。

在 Smart+ 应用推广系列中开启价值优化

在 Smart+ Android 应用推广系列中开启价值优化

使用 /campaign/spc/create/ 接口创建一个 Smart+ 推广系列。需确保满足以下要求。

设置 要求 参数 如何设置该参数
推广目标 应用推广 objective_type APP_PROMOTION
应用推广类型 应用安装 app_promotion_type APP_INSTALL
Smart+ 推广系列 启用。
通过 /campaign/spc/create/ 创建的推广系列均为 Smart+ 推广系列。
/ /
iOS 14 专属推广系列 未启用 campaign_type REGULAR_CAMPAIGN 或不传入
优化位置
(推广对象)
设置一个支持价值优化的 Android 应用 promotion_type APP_ANDROID
app_id 设置一个支持价值优化的 Android 应用的 ID。

您可通过 /app/list/ 获取 Android 应用的 ID。对于 Android 应用,该接口返回的 platform 将为 ANDROID。

若想确认某一 App ID 是否支持应用内购价值优化,可将该 ID 传入 /tool/vbo_status/ 接口中的 app_id 字段。
版位 以下任一类型:
  • 自动版位
  • 编辑版位,且版位为仅 TikTok,仅 Pangle,或 TikTok 和 Pangle
placement_type
placements
以下任一配置:
  • 将 placement_type 设置为 PLACEMENT_TYPE_AUTOMATIC
  • 将 placement_type 设置为 PLACEMENT_TYPE_NORMAL,且在 placements 的值中仅包含 PLACEMENT_TIKTOK 或 PLACEMENT_PANGLE 或同时包含 PLACEMENT_TIKTOK 和 PLACEMENT_PANGLE
优化目标 价值 optimization_goal VALUE
选择价值 以下任一类型:
  • 应用内购价值
  • 广告收入价值
optimization_event
  • 若想使用应用内购价值,需将 optimization_event 设置为 ACTIVE_PAY。
  • 若想使用广告收入价值,需将 optimization_event 设置为 AD_REVENUE_VALUE。
竞价策略 以下任一类型:
  • 最高价值(最高总收入):优先充分消耗预算,同时尽可能获得最大的成效价值
  • 最低 ROAS(目标 ROAS):确保您的平均 ROAS 达到或超过目标 ROAS 值
deep_bid_type
roas_bid
将 deep_bid_type 设置为 VO_MIN_ROAS 或 VO_HIGHEST_VALUE。

注意:若您将 deep_bid_type 设置为 VO_MIN_ROAS,则需同时传入 roas_bid。

bid_type BID_TYPE_NO_BID
conversion_bid_price 不传入
竞价策略的时间窗口 以下任一类型:
  • 第 7 天 ROAS 或最高价值
  • 第 0 天 ROAS 或最高价值
vbo_window 以下任一值:
  • SEVEN_DAYS
  • ZERO_DAY

例如,若您将 deep_bid_type 设置为 VO_MIN_ROAS,同时传入 roas_bid,且将 vbo_window 设置为 ZERO_DAY,系统将努力让第 0 天(当天)的 ROAS 保持在或超过目标 ROAS 值。
计费事件 oCPM billing_event OCPM
投放类型 标准 N/A N/A

在 Smart+ iOS 应用推广系列中开启价值优化

使用 /campaign/spc/create/ 接口创建一个 Smart+ 推广系列。需确保满足以下要求。

设置 要求 参数 如何设置该参数
推广目标 应用推广 objective_type APP_PROMOTION
应用推广类型 应用安装 app_promotion_type APP_INSTALL
Smart+ 推广系列 启用。
通过 /campaign/spc/create/ 创建的推广系列均为 Smart+ 推广系列。
/ /
iOS 14 专属推广系列 未启用或启用 campaign_type REGULAR_CAMPAIGN(或不传入)或 IOS14_CAMPAIGN
优化位置
(推广对象)
设置一个支持价值优化的 iOS 应用 promotion_type APP_IOS
app_id 设置一个支持价值优化的 iOS 应用的 ID。

您可通过 /app/list/ 获取 iOS 应用的 ID。对于 iOS 应用,该接口返回的 platform 将为 IOS。

若想确认某一 App ID 是否支持应用内购价值优化,可将该 ID 传入 /tool/vbo_status/ 接口中的 app_id 字段。
版位 以下任一类型:
  • 自动版位
  • 编辑版位,且版位为仅 TikTok,仅 Pangle,或 TikTok 和 Pangle
placement_type
placements
以下任一配置:
  • 将 placement_type 设置为 PLACEMENT_TYPE_AUTOMATIC
  • 将 placement_type 设置为 PLACEMENT_TYPE_NORMAL,且在 placements 的值中仅包含 PLACEMENT_TIKTOK 或 PLACEMENT_PANGLE 或同时包含 PLACEMENT_TIKTOK 和 PLACEMENT_PANGLE
优化目标 价值 optimization_goal VALUE
选择价值 以下任一类型:
  • 应用内购价值
  • 广告收入价值
optimization_event
  • 若想使用应用内购价值,需将 optimization_event 设置为 ACTIVE_PAY。
  • 若想使用广告收入价值,需将 optimization_event 设置为 AD_REVENUE_VALUE。
竞价策略 以下任一类型:
  • 最高价值(最高总收入):优先充分消耗预算,同时尽可能获得最大的成效价值
  • 最低 ROAS(目标 ROAS):确保您的平均 ROAS 达到或超过目标 ROAS 值
deep_bid_type
roas_bid
将 deep_bid_type 设置为 VO_MIN_ROAS 或 VO_HIGHEST_VALUE。

注意:若您将 deep_bid_type 设置为 VO_MIN_ROAS,则需同时传入 roas_bid。

bid_type BID_TYPE_NO_BID
conversion_bid_price 不传入
竞价策略的时间窗口 以下任一类型:
  • 第 7 天 ROAS 或最高价值
  • 第 0 天 ROAS 或最高价值
vbo_window 以下任一值:
  • SEVEN_DAYS
  • ZERO_DAY

例如,若您将 deep_bid_type 设置为 VO_MIN_ROAS,同时传入 roas_bid,且将 vbo_window 设置为 ZERO_DAY,系统将努力让第 0 天(当天)的 ROAS 保持在或超过目标 ROAS 值。
计费事件 oCPM billing_event OCPM
投放类型 标准 N/A N/A

在 Smart+ 网站推广系列中开启价值优化

若想了解如何在 Smart+ 应用推广系列中开启价值优化,请查看创建 Smart+ 网站推广系列并将 optimization_goal 设置为 VALUE。

内容来源: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 每日平台更新简报 →