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

在手动推广系列中开启价值优化

本文介绍了在手动推广系列中开启价值优化（VBO）功能的详细步骤。

前提条件

  • 您已经拥有 TikTok API for Business 的使用权限。详见快速入门 - 具体步骤 。
  • 若要开启价值优化，您需要获取相关的权限。参阅 API 参考了解使用相关接口（包括“步骤”部分列出的接口）所需的权限；参阅更新应用权限范围了解如何设置权限。
  • 不同场景下的广告收入价值优化或应用内购价值优化目前为白名单功能，如需使用这些功能，请联系您的 TikTok 销售代表。
  • 到达解锁阈值后，部分广告收入价值优化和应用内购价值优化功能会自动解锁。若想要了解解锁条件，请查看下文的“价值优化的解锁条件”小节。若想了解应用内购价值优化和广告收入价值优化的详情，请查看价值优化 - 价值类型。
  • 在高级专属推广系列或 Android 推广系列中使用应用内购价值优化的第 0 天出价或第 7 天出价目前为白名单功能，如需使用这些功能，请联系您的 TikTok 销售代表。
  • 在高级专属推广系列或 Android 推广系列中使用广告收入价值优化的第 0 天出价或第 7 天出价目前为白名单功能，如需使用这些功能，请联系您的 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/检查您的设置是否支持价值优化。

开启应用价值优化

应用内购价值优化

对于 iOS 应用

若想了解如何为高级专属推广系列中的 iOS 应用启用应用内购价值优化，请查看创建高级专属推广系列。

对于 Android 应用

  1. 使用/campaign/create/接口创建一个推广系列。需确保满足以下要求：
|设置 {20%} | 要求  {25%} | 参数 {20%} | 如何设置该参数{35%} |
|---|---|---|---|
| 推广目标 | 应用推广 | `objective_type` | `APP_PROMOTION` |
| 应用推广类型 | <ul><li>应用安装 或</li><li>应用再营销 </li></ul> | `app_promotion_type` | <ul><li>`APP_INSTALL` 或</li><li>`APP_RETARGETING`</li></ul> |
| 推广系列预算优化 | 不支持 | `budget_optimize_on` | `false`或不传入 |

示例

请求

(code JSON json)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "objective_type": "APP_PROMOTION",
    "app_promotion_type": "APP_INSTALL",
    "campaign_name": "{{campaign_name}}",    
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": 400
}'
(/code)

返回

(code JSON json)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "campaign_type": "REGULAR_CAMPAIGN",
        "is_smart_performance_campaign": false,
        "deep_bid_type": null,
        "modify_time": "2023-06-27 08:01:50",
        "objective": "APP",
        "campaign_app_profile_page_state": "UNSET",
        "app_promotion_type": "APP_INSTALL",
        "operation_status": "ENABLE",
        "budget": 400,
        "objective_type": "APP_PROMOTION",
        "campaign_id": "{{campaign_id}}",
        "secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "campaign_name": "{{campaign_name}}",
        "create_time": "2023-06-27 08:01:50",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "roas_bid": 0,
        "advertiser_id": "{{advertiser_id}}",
        "is_new_structure": true
    }
}
(/code)
  1. 使用/adgroup/create/接口创建一个广告组。需确保满足以下要求：
|设置 {20%} | 要求  {25%} | 参数 {20%} | 如何设置该参数{35%} |
|---|---|---|---|
| 推广的应用 | 设置一个支持应用内购价值优化的 Android 应用 | <ul><li>`promotion_type`</li><li>`app_id`</li><li>`operating_systems`</li></ul> | <ul><li>将 `promotion_type` 设置为 `APP_ANDROID`</li><li>将 `app_id` 设置为一个支持应用内购价值优化的 Android 应用的 ID。 <br>您可通过[/app/list/](https://ads.tiktok.com/marketing_api/docs?id=1740859313270786)接口获取 Android 应用的 ID。 对于 Android 应用，该接口返回的 `platform` 将为 `ANDROID`。 <br> 若想确认某一 App ID 是否支持应用内购价值优化，可将该 ID 传入 [/tool/vbo_status/](https://ads.tiktok.com/marketing_api/docs?id=1770016073586753) 接口中的 `app_id` 字段。</li><li>将 `operating_systems` 设置为 `["ANDROID"]`</li></ul>  |
| 版位 （广告位） | 以下任一类型: <ul><li><b>自动版位</b> </li><li><b>编辑版位</b>，且版位为仅 TikTok，仅 Pangle，或 TikTok 和 Pangle</li></ul>| `placement_type`<br> `placements` | 以下任一配置: <ul><li>将 `placement_type` 设置为 `PLACEMENT_TYPE_AUTOMATIC` </li><li>将 `placement_type` 设置为 `PLACEMENT_TYPE_NORMAL`，且 `placements` 的值中仅包含 `PLACEMENT_TIKTOK` 或 `PLACEMENT_PANGLE` 或同时包含 `PLACEMENT_TIKTOK` 和 `PLACEMENT_PANGLE`</li></ul> |
| 优化目标 | 价值 | `optimization_goal` | `VALUE` |
| 选择价值类型 |应用内购价值 | `optimization_event` | `ACTIVE_PAY` |
| 深度转化事件 | 购买操作的ROI | `secondary_optimization_event` | `PURCHASE_ROI` |
| 竞价策略 | <ul><li>最高价值（最高总收入）：优先充分消耗预算，同时尽可能获得最大的成效价值</li><li>最低 ROAS（目标 ROAS）：确保您的平均 ROAS 达到或超过目标 ROAS 值</li></ul> | <ul><li>`deep_bid_type` </li><li>`bid_type` </li></ul>| <ul><li>将 `deep_bid_type` 设置为 `VO_MIN_ROAS` 或 `VO_HIGHEST_VALUE`<br><p><span style="color:darkred"><b>注意</b></span>：若您将 `deep_bid_type` 设置为 `VO_MIN_ROAS`，则需同时传入 `roas_bid` 。</li><li>将 `bid_type` 设置为 `BID_TYPE_NO_BID`</li></ul>|
| 竞价策略的时间窗口期 | 以下任一类型: <ul><li>第 7 天 ROAS 或前 7 天最高价值 </li><li>第 0 天 ROAS 或最高价值 </li></ul> | `vbo_window` |以下任一值: <ul><li>`SEVEN_DAYS`</li><li>`ZERO_DAY` </li></ul> 例如，若您将 `deep_bid_type` 设置为 `VO_MIN_ROAS`，同时传入 `roas_bid`，且将 `vbo_window` 设置为 `ZERO_DAY`，系统将努力让第 0 天（当天）的 ROAS 保持在或超过目标 ROAS 值。  <br><br><p><span style="color:darkred"><b>注意</b></span>: 在 Android 推广系列中使用应用内购价值优化的第 0 天出价或第 7 天出价（`vbo_window` 为 `ZERO_DAY` 或 `SEVEN_DAYS`）目前为白名单功能，如需使用这些功能，请联系您的 TikTok 销售代表。 |
| 计费事件 | oCPM | `billing_event` | `OCPM` |
| 投放速度 | 标准 | `pacing` | `PACING_MODE_SMOOTH` |

示例

请求

(code JSON json)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "operation_status": "ENABLE",
    "adgroup_name": "{{adgroup_name}}",
    "promotion_type": "APP_ANDROID",
    "app_id":"{{app_id}}",
    "optimization_event":"ACTIVE_PAY",
    "secondary_optimization_event":"PURCHASE_ROI",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK","PLACEMENT_PANGLE"],
    "video_download_disabled": false,
    "automated_targeting": "OFF",
    "location_ids": ["1733045"],
    "gender": "GENDER_UNLIMITED",
    "operating_systems": ["ANDROID"],
    "targeting_expansion": {
        "enable_expansion": false
    },
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": 400.0,
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "optimization_goal": "VALUE",
    "deep_bid_type":"VO_HIGHEST_VALUE",
    "bid_type": "BID_TYPE_NO_BID",
    "billing_event": "OCPM",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code JSON json)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "adgroup_app_profile_page_state": null,
        "app_download_url": "{{app_download_url}}",
        "optimization_goal": "VALUE",
        "scheduled_budget": 0.0,
        "optimization_event": "ACTIVE_PAY",
        "share_disabled": false,
        "rf_purchased_type": null,
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "keywords": null,
        "pacing": "PACING_MODE_SMOOTH",
        "purchased_reach": null,
        "gender": "GENDER_UNLIMITED",
        "pixel_id": null,
        "ios14_quota_type": "UNOCCUPIED",
        "is_hfss": false,
        "campaign_id": "{{campaign_id}}",
        "languages": [],
        "interest_keyword_ids": [],
        "advertiser_id": "{{advertiser_id}}",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "placements": [
            "PLACEMENT_TIKTOK",
            "PLACEMENT_PANGLE"
        ],
        "excluded_audience_ids": [],
        "adgroup_id": "{{adgroup_id}}",
        "rf_estimated_frequency": null,
        "modify_time": "2023-06-27 08:06:56",
        "comment_disabled": false,
        "skip_learning_phase": true,
        "network_types": [],
        "category_id": "0",
        "audience_ids": [],
        "app_id": "{{app_id}}",
        "statistic_type": null,
        "billing_event": "OCPM",
        "brand_safety_type": "NO_BRAND_SAFETY",
        "auto_targeting_enabled": false,
        "budget": 400.0,
        "brand_safety_partner": null,
        "conversion_bid_price": 0.0,
        "frequency_schedule": null,
        "promotion_type": "APP_ANDROID",
        "app_type": "APP_ANDROID",
        "bid_price": 0.0,
        "package": "{{package}}",
        "feed_type": null,
        "is_new_structure": true,
        "operation_status": "ENABLE",
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "schedule_start_time": "{{schedule_start_time}}",
        "purchased_impression": null,
        "schedule_infos": null,
        "deep_cpa_bid": 0.0,
        "device_price_ranges": null,
        "video_download_disabled": false,
        "conversion_window": null,
        "secondary_optimization_event": "PURCHASE_ROI",
        "schedule_end_time": "{{schedule_end_time}}",
        "location_ids": [
            "1733045"
        ],
        "inventory_filter_enabled": false,
        "operating_systems": [
            "ANDROID"
        ],
        "deep_bid_type": "VO_HIGHEST_VALUE",
        "actions": [],
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "rf_estimated_cpr": null,
        "frequency": null,
        "age_groups": null,
        "creative_material_mode": "CUSTOM",
        "search_result_enabled": true,
        "targeting_expansion": {
            "expansion_enabled": false,
            "expansion_types": []
        },
        "delivery_mode": null,
        "adgroup_name": "{{adgroup_name}}",
        "bid_type": "BID_TYPE_NO_BID",
        "bid_display_mode": "CPMV",
        "interest_category_ids": [],
        "campaign_name": "{{campaign_name}}",
        "create_time": "2023-06-27 08:06:56",
        "isp_ids": [],
        "schedule_type": "SCHEDULE_START_END",
        "next_day_retention": null
    }
}
(/code)
  1. 使用/ad/create/接口创建一个广告。

示例

请求

(code JSON json)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [{
        "ad_name": "{{ad_name}}",
        "identity_id":"{{identity_id}}",
        "identity_type":"CUSTOMIZED_USER",
        "ad_format": "SINGLE_VIDEO",
        "video_id":"{{video_id}}",
        "image_ids":["{{image_id}}"],
        "ad_text": "{{ad_text}}",
        "call_to_action": "SHOP_NOW",
        "landing_page_url":"{{landing_page_url}}"
    }]
}'
(/code)

返回

(code JSON json)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "campaign_id": "{{campaign_id}}",
                "image_ids": [
                    "{{image_id}}"
                ],
                "brand_safety_postbid_partner": "UNSET",
                "vast_moat_enabled": false,
                "adgroup_id": "{{adgroup_id}}",
                "ad_texts": null,
                "card_id": null,
                "adgroup_name": "{{adgroup_name}}",
                "ad_format": "SINGLE_VIDEO",
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "optimization_event": "ACTIVE_PAY",
                "viewability_vast_url": null,
                "is_new_structure": true,
                "deeplink_type": "NORMAL",
                "ad_name": "{{ad_name}}",
                "operation_status": "ENABLE",
                "landing_page_url": "",
                "app_name": "{{app_name}}",
                "page_id": null,
                "call_to_action_id": null,
                "click_tracking_url": "{{click_tracking_url}}",
                "music_id": null,
                "tracking_pixel_id": 0,
                "create_time": "2023-06-27 08:08:49",
                "creative_authorized": false,
                "identity_type": "CUSTOMIZED_USER",
                "landing_page_urls": null,
                "profile_image_url": "{{profile_image_url}}",
                "impression_tracking_url": null,
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}"
                ],
                "modify_time": "2023-06-27 08:08:49",
                "is_aco": false,
                "video_id": "{{video_id}}",
                "viewability_postbid_partner": "UNSET",
                "call_to_action": "SHOP_NOW",
                "advertiser_id": "{{advertiser_id}}",
                "creative_type": null,
                "identity_id": "{{identity_id}}",
                "ad_id": "{{ad_id}}",
                "campaign_name": "{{campaign_name}}",
                "playable_url": "",
                "deeplink": "",
                "ad_text": "{{ad_text}}",
                "brand_safety_vast_url": null,
                "tracking_app_id": "{{tracking_app_id}}",
                "display_name": ""
            }
        ]
    }
}
(/code)

广告收入价值优化

对于 iOS 应用

若想了解如何为高级专属推广系列中的 iOS 应用启用广告收入价值优化，请查看创建高级专属推广系列。

对于 Android 应用

  1. 使用/campaign/create/接口创建一个推广系列。需确保满足以下要求：
设置 要求 参数 如何设置该参数
推广目标 应用推广 objective_type APP_PROMOTION
应用推广类型 应用安装 app_promotion_type APP_INSTALL
Smart+ 推广系列 未启用

不支持使用/campaign/spc/create/创建启用 Smart+ 推广系列设置的广告收入价值优化推广系列。		 / /
iOS 14 专属推广系列 未启用 campaign_type REGULAR_CAMPAIGN 或不传入
app_id 不传入
campaign_app_profile_page_state 不传入
推广系列预算优化 未启用 budget_optimize_on false或不传入

示例

请求

(code JSON json)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "objective_type": "APP_PROMOTION",
    "app_promotion_type": "APP_INSTALL",
    "campaign_name": "{{campaign_name}}",
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}}
}'
(/code)

返回

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "campaign_id": "{{campaign_id}}",
        "is_new_structure": true,
        "budget": {{budget}},
        "objective": "APP",
        "campaign_name": "{{campaign_name}}",
        "secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "campaign_app_profile_page_state": "UNSET",
        "is_search_campaign": false,
        "objective_type": "APP_PROMOTION",
        "advertiser_id": "{{advertiser_id}}",
        "app_promotion_type": "APP_INSTALL",
        "is_smart_performance_campaign": false,
        "campaign_type": "REGULAR_CAMPAIGN",
        "create_time": "{{create_time}}",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "roas_bid": 0,
        "operation_status": "ENABLE",
        "deep_bid_type": null,
        "modify_time": "{{modify_time}}"
    }
}
(/code)
  1. 使用/adgroup/create/接口创建一个广告组。需确保满足以下要求：
设置 要求 参数 如何设置该参数
推广的应用 设置可启用广告收入价值优化的 Android 应用 promotion_type APP_ANDROID
app_id 指定可启用广告收入价值优化的 Android 应用。
  • 您可通过 /app/list/获取 Android 应用的 ID。 Android 应用返回 platform 为 ANDROID。
  • 若想检查某一应用 ID 是否可用于广告收入价值优化，可将该应用 ID 传入/tool/vbo_status/的 app_id字段，返回的vo_iaa_min_roas或vo_iaa_highest_value应为QUALIFIED。
operating_systems ["ANDROID"]
版位
（广告位）		 以下任一类型：
  • 自动版位
  • 编辑版位，且版位为仅 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 AD_REVENUE_VALUE
secondary_optimization_event 不传入
竞价策略 以下任一类型：
  • 最高价值（最高总收入）：优先充分消耗预算，同时尽可能获得最大的成效价值
  • 最低 ROAS（目标 ROAS）：确保您的平均 ROAS 达到或超过目标 ROAS 值
  • deep_bid_type
  • bid_type
  • deep_bid_type 设置为 VO_MIN_ROAS 或 VO_HIGHEST_VALUE。

    注意：若将deep_bid_type 设置为 VO_MIN_ROAS，需同时传入 roas_bid。roas_bid 的取值范围为 0.01-10。

  • bid_type 设置为BID_TYPE_NO_BID。
竞价策略的时间窗口期 以下任一类型：
  • 第 7 天 ROAS 或前 7 天最高价值
  • 第 0 天 ROAS 或最高价值
 vbo_window 以下任一值：
  • SEVEN_DAYS
  • ZERO_DAY

例如，若您将 deep_bid_type 设置为 VO_MIN_ROAS，同时传入 roas_bid，且将 vbo_window 设置为 ZERO_DAY，系统将努力让第 0 天（当天）的 ROAS 保持在或超过目标 ROAS 值。

注意：在 Android 推广系列中使用广告收入价值优化的第 0 天出价或第 7 天出价（vbo_window 为 ZERO_DAY或SEVEN_DAYS）目前为白名单功能，如需使用这些功能，请联系您的 TikTok 销售代表。

计费事件 oCPM billing_event OCPM
投放速度 标准 pacing PACING_MODE_SMOOTH

示例

请求

(code JSON json)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "adgroup_name": "{{adgroup_name}}",
    "promotion_type": "APP_ANDROID",
    "app_id":"{{app_id}}",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": [
        "PLACEMENT_PANGLE"
    ],
    "location_ids": [
        "1643084"
    ],
    "operating_systems": [
        "ANDROID"
    ],
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "optimization_goal": "VALUE",
    "optimization_event": "AD_REVENUE_VALUE",
    "bid_type": "BID_TYPE_NO_BID",
    "deep_bid_type": "VO_MIN_ROAS",
    "roas_bid": {{roas_bid}},
    "billing_event": "OCPM",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "billing_event": "OCPM",
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "schedule_type": "SCHEDULE_START_END",
        "adgroup_name": "{{adgroup_name}}",
        "deep_cpa_bid": 0,
        "pixel_id": null,
        "auto_targeting_enabled": false,
        "skip_learning_phase": true,
        "comment_disabled": false,
        "bid_type": "BID_TYPE_NO_BID",
        "keywords": null,
        "budget_mode": "BUDGET_MODE_TOTAL",
        "frequency": null,
        "brand_safety_type": "NO_BRAND_SAFETY",
        "frequency_schedule": null,
        "adgroup_app_profile_page_state": null,
        "purchased_reach": null,
        "conversion_bid_price": 0,
        "purchased_impression": null,
        "interest_keyword_ids": [],
        "is_new_structure": true,
        "search_result_enabled": false,
        "smart_interest_behavior_enabled": null,
        "smart_audience_enabled": null,
        "create_time": "{{create_time}}",
        "operating_systems": [
            "ANDROID"
        ],
        "click_attribution_window": "SEVEN_DAYS",
        "is_hfss": false,
        "view_attribution_window": "ONE_DAY",
        "delivery_mode": null,
        "app_id": "{{app_id}}",
        "package": "{{package}}",
        "schedule_start_time": "{{schedule_start_time}}",
        "bid_display_mode": "CPMV",
        "campaign_id": "{{campaign_id}}",
        "video_download_disabled": false,
        "interest_category_ids": [],
        "next_day_retention": null,
        "adgroup_id": "{{adgroup_id}}",
        "audience_ids": [],
        "bid_price": 0,
        "excluded_audience_ids": [],
        "budget": {{budget}},
        "statistic_type": null,
        "creative_material_mode": "CUSTOM",
        "actions": [],
        "is_smart_performance_campaign": false,
        "languages": [],
        "category_exclusion_ids": [],
        "promotion_type": "APP_ANDROID",
        "attribution_event_count": "EVERY",
        "brand_safety_partner": null,
        "roas_bid": 2,
        "pacing": "PACING_MODE_SMOOTH",
        "secondary_optimization_event": null,
        "isp_ids": [],
        "app_type": "APP_ANDROID",
        "deep_bid_type": "VO_MIN_ROAS",
        "gender": "GENDER_UNLIMITED",
        "category_id": "0",
        "app_download_url": "{{app_download_url}}",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "optimization_event": "AD_REVENUE_VALUE",
        "location_ids": [
            "1643084"
        ],
        "placements": [
            "PLACEMENT_PANGLE"
        ],
        "share_disabled": false,
        "schedule_end_time": "{{schedule_end_time}}",
        "network_types": [],
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "scheduled_budget": 0,
        "advertiser_id": "{{advertiser_id}}",
        "optimization_goal": "VALUE",
        "campaign_name": "{{campaign_name}}",
        "rf_purchased_type": null,
        "inventory_filter_enabled": false,
        "device_price_ranges": null,
        "ios14_quota_type": "UNOCCUPIED",
        "rf_estimated_frequency": null,
        "conversion_window": null,
        "operation_status": "ENABLE",
        "feed_type": null,
        "rf_estimated_cpr": null,
        "schedule_infos": null,
        "modify_time": "{{modify_time}}",
        "age_groups": null,
        "vbo_window": "SEVEN_DAYS"
    }
}
(/code)
  1. 使用/ad/create/接口创建一个广告。需确保满足以下要求：
设置 要求 参数 如何设置该参数
认证身份
（广告发布身份）		 自定义用户
（自定义身份）		 identity_type CUSTOMIZED_USER
identity_id 传入合法值
identity_authorized_bc_id 不传入
广告样式 以下任意类型：
  • 单视频
  • 单图片
 ad_format 以下任意值：
  • SINGE_VIDEO
  • SINGE_IMAGE

示例

请求

(code JSON json)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [{
        "ad_name": "{{ad_name}}",
        "identity_type":"CUSTOMIZED_USER",
        "identity_id":"{{identity_id}}",
        "ad_format": "SINGLE_VIDEO",
        "video_id":"{{video_id}}",
        "image_ids":["{{image_id}}"],
        "ad_text": "{{ad_text}}",
        "call_to_action": "LEARN_MORE"
    }]
}'
(/code)

返回

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "viewability_vast_url": null,
                "call_to_action": "LEARN_MORE",
                "creative_authorized": false,
                "call_to_action_id": null,
                "brand_safety_vast_url": null,
                "creative_type": null,
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}"
                ],
                "is_new_structure": true,
                "create_time": "{{create_time}}",
                "playable_url": "",
                "ad_name": "{{ad_name}}",
                "profile_image_url": "{{profile_image_url}}",
                "identity_type": "CUSTOMIZED_USER",
                "music_id": null,
                "ad_texts": null,
                "campaign_id": "{{campaign_id}}",
                "vast_moat_enabled": false,
                "ad_id": "{{ad_id}}",
                "adgroup_id": "{{adgroup_id}}",
                "tracking_app_id": "{{tracking_app_id}}",
                "landing_page_urls": null,
                "identity_id": "{{identity_id}}",
                "app_name": "{{app_name}}",
                "page_id": null,
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "tracking_pixel_id": 0,
                "impression_tracking_url": "{{impression_tracking_url}}",
                "deeplink": "",
                "click_tracking_url": "{{click_tracking_url}}",
                "image_ids": [
                    "{{image_id}}"
                ],
                "optimization_event": "AD_REVENUE_VALUE",
                "ad_format": "SINGLE_VIDEO",
                "card_id": null,
                "landing_page_url": "",
                "advertiser_id": "{{advertiser_id}}",
                "campaign_name": "{{campaign_name}}",
                "display_name": "",
                "video_id": "{{video_id}}",
                "adgroup_name": "{{adgroup_name}}",
                "ad_text": "{{ad_text}}",
                "viewability_postbid_partner": "UNSET",
                "is_aco": false,
                "deeplink_type": "NORMAL",
                "operation_status": "ENABLE",
                "modify_time": "{{modify_time}}"
            }
        ]
    }
}
(/code)

开启网站价值优化

  1. 使用/campaign/create/接口创建一个推广系列。需确保满足以下要求：
设置 要求 参数 如何设置该参数
推广目标 网站转化量 objective_type WEB_CONVERSIONS
Smart+ 推广系列 未启用

若您想了解如何创建启用了 Smart+ 推广系列设置的网站转化量推广系列，可查看创建 Smart+ 推广系列。		 /
 /
iOS 14 专属推广系列 未启用 campaign_type REGULAR_CAMPAIGN或不传入
app_id 不传入
campaign_app_profile_page_state 不传入
推广系列预算优化（CBO） 启用或未启用

若您想了解如何创建启用了推广系列预算优化设置的网站转化量推广系列，可查看推广系列预算优化。		 budget_optimize_on true，或false或不传入

注意：同时开启推广系列预算优化和网站价值优化目前为白名单功能。如需使用此功能，请联系您的TikTok销售代表。

示例 请求

(code JSON json)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "objective_type": "WEB_CONVERSIONS",
    "campaign_name": "{{campaign_name}}",
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": 400
}'
(/code)

返回

(code JSON json)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "deep_bid_type": null,
        "roas_bid": 0,
        "advertiser_id": "{{advertiser_id}}",
        "objective_type": "WEB_CONVERSIONS",
        "campaign_name": "{{campaign_name}}",
        "campaign_type": "REGULAR_CAMPAIGN",
        "objective": "LANDING_PAGE",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "create_time": "2023-06-27 05:43:14",
        "campaign_id": "{{campaign_id}}",
        "is_new_structure": true,
        "is_smart_performance_campaign": false,
        "modify_time": "2023-06-27 05:43:14",
        "budget": 400,
        "secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "operation_status": "ENABLE"
    }
}
(/code)
  1. 使用/adgroup/create/接口创建一个广告组。需确保满足以下要求：

注意
优化目标为自动价值优化的广告组不支持传入/split_test/create/创建拆分对比测试。

|设置 {20%} | 要求  {25%} | 参数 {20%} | 如何设置该参数{35%} |
|---|---|---|---|
| 推广的网站 | 设置一个支持价值优化的 Pixel | `promotion_type` | `WEBSITE` |
| 推广的网站 | 设置一个支持价值优化的 Pixel | `pixel_id` | 设置一个支持价值优化的 Pixel 的ID。<br>若想确认某一 Pixel ID 是否支持价值优化，可将该 ID 传入[/tool/vbo_status/](https://ads.tiktok.com/marketing_api/docs?id=1770016073586753) 接口中的 `pixel_id` 字段。<br> 若想获取获取 Pixel ID，可使用[/pixel/list/](https://ads.tiktok.com/marketing_api/docs?id=1740858697598978)接口。 |
| 优化目标 | 以下任意目标：<ul><li>价值：充分消耗预算，获得最多的付费价值，或尽量将平均广告花费回报（ROAS）控制在您设定的值。</li><li>自动价值优化：通过机器学习进行动态优化，以实现最大价值或最大投放量。</li></ul> | `optimization_goal` | 以下任意值：<ul><li>`VALUE`</li><li>`AUTOMATIC_VALUE_OPTIMIZATION`</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>自动价值优化目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li><li>同时启用自动价值优化和推广系列预算优化目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li></ul>  |
| 转化事件（优化事件） | 支付完成 | `optimization_event` | `SHOPPING` |
| 竞价策略 | <ul><li>若优化目标设置为价值，可使用以下任意策略：<ul><li>最高价值：充分消耗预算，获得最多的付费价值</li><li>最低 ROAS：尽量将平均广告花费回报（ROAS）控制在您设定的值 </li></ul></li><li>若优化目标设置为自动价值优化，仅支持使用最高价值。</li></ul> | <ul><li>`deep_bid_type`</li><li> `bid_type` </li></ul>|<ul><li>若 `optimization_goal` 设置为 `VALUE`，需使用以下设置：<ul><li>将 `deep_bid_type` 设置为 `VO_MIN_ROAS` 或 `VO_HIGHEST_VALUE`。 <br><p><span style="color:darkred"><b>注意</b></span>：若您将 `deep_bid_type` 设置为 `VO_MIN_ROAS`，则需同时传入 `roas_bid` 。</li><li>将 `bid_type` 设置为 `BID_TYPE_NO_BID`。</li></ul></li><li>若`optimization_goal` 设置为 `AUTOMATIC_VALUE_OPTIMIZATION` ，需使用以下设置：<ul><li>不支持使用 `roas_bid` 。</li><li>需将 `deep_bid_type` 设置为 `VO_HIGHEST_VALUE` 且将 `bid_type` 设置为 `BID_TYPE_NO_BID`。<ul><li>可不传入 `deep_bid_type` 和 `bid_type`。若未传入这两个字段，`deep_bid_type` 将默认设置为 `VO_HIGHEST_VALUE` ， `bid_type` 将默认设置为 `BID_TYPE_NO_BID`。</li></ul></li></ul></li></ul> |
| 计费事件 | oCPM | `billing_event` | `OCPM` |
| 投放速度 | 标准 | `pacing` | `PACING_MODE_SMOOTH` |

示例

优化目标为价值

请求

(code JSON json)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "operation_status": "ENABLE",
    "adgroup_name": "{{adgroup_name}}",
    "promotion_type": "WEBSITE",
    "pixel_id":"{{pixel_id}}",
    "optimization_event":"SHOPPING",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK","PLACEMENT_PANGLE"],
    "location_ids": ["1733045"],
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": 400.0,
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "optimization_goal": "VALUE",
    "deep_bid_type":"VO_HIGHEST_VALUE",
    "bid_type": "BID_TYPE_NO_BID",
    "billing_event": "OCPM",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code JSON json)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "promotion_website_type": "UNSET",
        "promotion_type": "WEBSITE",
        "schedule_end_time": "{{schedule_end_time}}",
        "adgroup_name": "{{adgroup_name}}",
        "skip_learning_phase": true,
        "statistic_type": null,
        "advertiser_id": "{{advertiser_id}}",
        "deep_bid_type": "VO_HIGHEST_VALUE",
        "bid_price": 0,
        "bid_display_mode": "CPMV",
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "search_result_enabled": true,
        "adgroup_app_profile_page_state": null,
        "share_disabled": false,
        "comment_disabled": false,
        "purchased_impression": null,
        "bid_type": "BID_TYPE_NO_BID",
        "actions": [],
        "age_groups": null,
        "schedule_infos": null,
        "pacing": "PACING_MODE_SMOOTH",
        "rf_estimated_cpr": null,
        "auto_targeting_enabled": false,
        "ios14_quota_type": "UNOCCUPIED",
        "deep_cpa_bid": 0,
        "interest_keyword_ids": [],
        "location_ids": [
            "1733045"
        ],
        "gender": "GENDER_UNLIMITED",
        "schedule_start_time": "{{schedule_start_time}}",
        "create_time": "2023-06-27 06:02:23",
        "campaign_id": "{{campaign_id}}",
        "scheduled_budget": 0,
        "billing_event": "OCPM",
        "rf_purchased_type": null,
        "optimization_goal": "VALUE",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "creative_material_mode": "CUSTOM",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "device_price_ranges": null,
        "operating_systems": [],
        "budget": 400,
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "languages": [],
        "frequency": null,
        "operation_status": "ENABLE",
        "network_types": [],
        "modify_time": "2023-06-27 06:02:23",
        "inventory_filter_enabled": false,
        "interest_category_ids": [],
        "app_download_url": null,
        "conversion_window": null,
        "frequency_schedule": null,
        "brand_safety_partner": null,
        "keywords": null,
        "adgroup_id": "{{adgroup_id}}",
        "campaign_name": "{{campaign_name}}",
        "app_id": null,
        "secondary_optimization_event": null,
        "is_new_structure": true,
        "conversion_bid_price": 0,
        "is_hfss": false,
        "next_day_retention": null,
        "schedule_type": "SCHEDULE_START_END",
        "delivery_mode": null,
        "pixel_id": "{{pixel_id}}",
        "isp_ids": [],
        "optimization_event": "SHOPPING",
        "category_id": "0",
        "video_download_disabled": false,
        "audience_ids": [],
        "rf_estimated_frequency": null,
        "feed_type": null,
        "brand_safety_type": "NO_BRAND_SAFETY",
        "app_type": null,
        "placements": [
            "PLACEMENT_TIKTOK",
            "PLACEMENT_PANGLE"
        ],
        "targeting_expansion": {
            "expansion_types": [],
            "expansion_enabled": false
        },
        "excluded_audience_ids": [],
        "purchased_reach": null
    }
}
(/code)

优化目标为自动价值优化

请求

(code JSON json)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "operation_status": "ENABLE",
    "adgroup_name": "{{adgroup_name}}",
    "promotion_type": "WEBSITE",
    "pixel_id":"{{pixel_id}}",
    "optimization_event":"SHOPPING",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK","PLACEMENT_PANGLE"],
    "location_ids": ["1733045"],
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": 400.0,
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",   
    "optimization_goal": "AUTOMATIC_VALUE_OPTIMIZATION",
    "deep_bid_type":"VO_HIGHEST_VALUE",
    "bid_type": "BID_TYPE_NO_BID",
    "billing_event": "OCPM",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code JSON json)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "age_groups": null,
        "pacing": "PACING_MODE_SMOOTH",
        "billing_event": "OCPM",
        "view_attribution_window": "ONE_DAY",
        "keywords": null,
        "adgroup_name": "{{adgroup_name}}",
        "is_smart_performance_campaign": false,
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "rf_estimated_frequency": null,
        "frequency_schedule": null,
        "device_price_ranges": null,
        "frequency": null,
        "bid_display_mode": "CPMV",
        "pixel_id": "{{pixel_id}}",
        "optimization_event": "SHOPPING",
        "modify_time": "{{modify_time}}",
        "feed_type": null,
        "gender": "GENDER_UNLIMITED",
        "comment_disabled": false,
        "adgroup_app_profile_page_state": null,
        "click_attribution_window": "SEVEN_DAYS",
        "smart_interest_behavior_enabled": null,
        "placements": [
            "PLACEMENT_TIKTOK",
            "PLACEMENT_PANGLE"
        ],
        "delivery_mode": null,
        "campaign_name": "{{campaign_name}}",
        "conversion_bid_price": 0,
        "adgroup_id": "{{adgroup_id}}",
        "auto_targeting_enabled": false,
        "purchased_reach": null,
        "search_result_enabled": true,
        "actions": [],
        "creative_material_mode": "CUSTOM",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "is_new_structure": true,
        "interest_category_ids": [],
        "attribution_event_count": "EVERY",
        "smart_audience_enabled": null,
        "deep_bid_type": "VO_HIGHEST_VALUE",
        "share_disabled": false,
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "conversion_window": null,
        "is_hfss": false,
        "budget": {{budget}},
        "advertiser_id": "{{advertiser_id}}",
        "audience_ids": [],
        "inventory_filter_enabled": false,
        "video_download_disabled": false,
        "rf_purchased_type": null,
        "brand_safety_partner": null,
        "promotion_type": "WEBSITE",
        "statistic_type": null,
        "bid_price": 0,
        "product_source": "UNSET",
        "ios14_quota_type": "UNOCCUPIED",
        "languages": [],
        "brand_safety_type": "NO_BRAND_SAFETY",
        "purchased_impression": null,
        "app_id": null,
        "operation_status": "ENABLE",
        "rf_estimated_cpr": null,
        "interest_keyword_ids": [],
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "secondary_optimization_event": null,
        "schedule_end_time": "{{schedule_end_time}}",
        "category_id": "0",
        "optimization_goal": "AUTOMATIC_VALUE_OPTIMIZATION",
        "create_time": "{{create_time}}",
        "schedule_infos": null,
        "scheduled_budget": 0,
        "deep_cpa_bid": 0,
        "network_types": [],
        "excluded_audience_ids": [],
        "isp_ids": [],
        "schedule_type": "SCHEDULE_START_END",
        "promotion_website_type": "UNSET",
        "category_exclusion_ids": [],
        "skip_learning_phase": true,
        "operating_systems": [],
        "next_day_retention": null,
        "location_ids": [
            "1733045"
        ],
        "campaign_id": "{{campaign_id}}",
        "schedule_start_time": "{{schedule_start_time}}",
        "app_type": null,
        "app_download_url": null,
        "bid_type": "BID_TYPE_NO_BID"
    }
}
(/code)
  1. 使用/ad/create/接口创建一个广告。

示例

请求

(code JSON json)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [{
        "ad_name": "{{ad_name}}",
        "identity_id":"{{identity_id}}",
        "identity_type":"CUSTOMIZED_USER",
        "ad_format": "SINGLE_VIDEO",
        "video_id":"{{video_id}}",
        "image_ids":["{{image_id}}"],
        "ad_text": "{{ad_text}}",
        "call_to_action": "SHOP_NOW",
        "landing_page_url":"{{landing_page_url}}"
    }]
}'
(/code)

返回

(code JSON json)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "advertiser_id": "{{advertiser_id}}",
                "tracking_pixel_id": {{tracking_pixel_id}},
                "campaign_id": "{{campaign_id}}",
                "modify_time": "2023-06-27 06:16:12",
                "fallback_type": "UNSET",
                "campaign_name": "{{campaign_name}}",
                "card_id": null,
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "ad_format": "SINGLE_VIDEO",
                "is_aco": false,
                "adgroup_id": "{{adgroup_id}}",
                "landing_page_urls": null,
                "deeplink_type": "NORMAL",
                "optimization_event": "SHOPPING",
                "click_tracking_url": null,
                "viewability_postbid_partner": "UNSET",
                "is_new_structure": true,
                "viewability_vast_url": null,
                "call_to_action_id": null,
                "ad_text": "{{ad_text}}",
                "call_to_action": "SHOP_NOW",
                "identity_id": "{{identity_id}}",
                "profile_image_url": "{{profile_image_url}}",
                "app_name": "",
                "brand_safety_postbid_partner": "UNSET",
                "ad_name": "{{ad_name}}",
                "display_name": "{{display_name}}",
                "creative_authorized": false,
                "identity_type": "CUSTOMIZED_USER",
                "ad_ref_pixel_id": {{ad_ref_pixel_id}},
                "page_id": null,
                "impression_tracking_url": null,
                "vast_moat_enabled": false,
                "operation_status": "ENABLE",
                "ad_texts": null,
                "video_id": "{{video_id}}",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}"
                ],
                "brand_safety_vast_url": null,
                "playable_url": "",
                "create_time": "2023-06-27 06:16:12",
                "ad_id": "{{ad_id}}",
                "creative_type": null,
                "adgroup_name": "{{adgroup_name}}",
                "music_id": null,
                "image_ids": [
                    "{{image_id}}"
                ],
                "landing_page_url": "{{landing_page_url}}",
                "deeplink": ""
            }
        ]
    }
}
(/code)

开启商品销量目标下的价值优化

若想要为商品销量目标开启价值优化，您可以使用 /tool/vbo_status/接口检查您的设置是否支持价值优化。您需在请求中将 objective_type 设置为 PRODUCT_SALES 。若您的设置支持价值优化，返回的 vo_status 将为QUALIFIED。需注意根据您的使用场景，商品销量目标下开启价值优化所需的具体设置也会发生变化。

← 在 Smart+ 推广系列中开启价值优化出价限制 →

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