← 返回目录
📁 Use Cases › Campaign creation

创建高级专属推广系列

本文介绍了创建高级专属推广系列的具体步骤。

简介

高级专属推广系列是一种新 iOS 推广系列类型,采用捕捉实时信号的高级投放模型提高 iOS 推广系列的效果。

您可以使用推广系列 API 创建高级专属推广系列。这将帮助您简化广告创建流程,提高推广系列的运营效率和管理规模。

前提条件

  • 您已经拥有 TikTok API for Business 的使用权限。详见快速入门 - 具体步骤 。
  • 若要创建高级专属推广系列,您需要获取相关的权限。参阅 API 参考了解使用相关接口(包括“步骤”部分列出的接口)所需的权限。参阅更新应用权限范围了解如何设置权限。

步骤

根据您对是否同时启用 Smart+ 推广系列的偏好,您可以创建手动高级专属推广系列或 Smart+ 高级专属推广系列。欲了解相关创建步骤,请查看对应小节:“创建手动高级专属推广系列的步骤”和“创建 Smart+ 高级专属推广系列的步骤”。

创建手动高级专属推广系列的步骤

1. 创建推广系列

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

设置 要求 参数 如何设置该参数
推广目标 应用推广 objective_type APP_PROMOTION
应用推广类型 应用安装 app_promotion_type APP_INSTALL
Smart+ 推广系列 未启用。
通过/campaign/create/ 创建的推广系列均为标准(未启用 Smart+ 推广系列设置的)推广系列。

若您想创建启用 Smart+ 推广系列设置的高级专属推广系列,请查看创建 Smart+ 高级专属推广系列的步骤。
/ /
iOS 14 专属推广系列 启用 campaign_type IOS14_CAMPAIGN
app_id 传入可用于高级专属推广系列的 iOS 应用的 ID。

若想获取可用的应用,可使用/app/list/。可用的应用需满足以下条件:
  • platform 为 IOS
  • advanced_dedicated_campaign_allowed 为 true

注意:使用高级专属推广系列要求应用满足一定条件。若您的应用不可用于高级专属推广系列,可联系您的 TikTok 销售代表。您的 TikTok 销售代表将提供故障排查支持,帮助您的应用满足高级专属推广系列的条件。

campaign_app_profile_page_state ON 或 OFF(或不传入)
使用高级专属推广系列 启用 is_advanced_dedicated_campaign true
SKAN 归因 启用或不启用 disable_skan_campaign 以下任一值:

注意:为专属推广系列关闭 SKAN 归因目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。

示例

请求

(code curl http)
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_type": "IOS14_CAMPAIGN",
    "app_id": "{{app_id}}",
    "is_advanced_dedicated_campaign": true,
    "campaign_name": "{{campaign_name}}",
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}}
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "budget_mode": "BUDGET_MODE_TOTAL",
        "app_id": "{{app_id}}",
        "create_time": "{{create_time}}",
        "campaign_type": "IOS14_CAMPAIGN",
        "app_promotion_type": "APP_INSTALL",
        "budget": {{budget}},
        "is_search_campaign": false,
        "campaign_id": "{{campaign_id}}",
        "is_new_structure": true,
        "campaign_app_profile_page_state": "OFF",
        "modify_time": "{{modify_time}}",
        "operation_status": "ENABLE",
        "advertiser_id": "{{advertiser_id}}",
        "objective_type": "APP_PROMOTION",
        "secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "deep_bid_type": null,
        "campaign_name": "{{campaign_name}}",
        "is_advanced_dedicated_campaign": true,
        "is_smart_performance_campaign": false,
        "objective": "APP",
        "roas_bid": 0
    }
}
(/code)

2. 创建广告组

使用/adgroup/create/接口创建一个广告组。需确保满足以下要求:

| 设置 {20%}| 要求{25%} | 参数{20%} | 如何设置该参数{35%} |
|---|---|---|---|
| 优化位置 <br>(推广对象)| iOS 应用 | `promotion_type` | `APP_IOS` |
| 版位 <br>(广告位)|使用以下任意类型:<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>|
| 设备 - 系统版本| iOS 14.5 或之后版本 | `operating_systems`<br> `min_ios_version`<br> `ios14_targeting`| <ul><li>将 `operating_systems` 设置为 `["IOS"]`</li><li>将 `ios14_targeting` 设置为 `IOS14_PLUS`</li><li>将 `min_ios_version` 设置为 `14.5` 或之后版本</li></ul>|
| 优化目标 | 使用以下目标之一: <ul><li> 安装 </li><li>应用内事件</li><li> 价值  </li></ul>| `optimization_goal` | 使用以下任意值: <ul><li> `INSTALL`<ul><li>若想使用 `INSTALL`,需确保所指定的应用已设置第三方监测。您可以使用[/app/info/](1740859272887297.html)检查应用是否已设置第三方监测(`tracking_url`)。</li><li>若想为现有应用添加第三方监测,可使用[/app/update/](1740859300069378.html)。若想了解如何从第三方合作伙伴获取监测链接,可查看[移动合作伙伴 (MMP) 跟踪](https://ads.tiktok.com/help/article/mobile-measurement-partner-mmp-tracking?lang=zh)。</li></ul></li><li> `IN_APP_EVENT`(需指定`optimization_event`)<ul><li>若想使用`IN_APP_EVENT`,需确保指定的事件(`optimization_event`)为所选应用的可用事件。您可使用[/app/optimization_event/](1740859338750977.html)获取某一应用的可用事件(`optimization_event`)。</li></ul></li><li>`VALUE` (需设置 `optimization_event` )<ul><li>若想检查某些设置是否支持优化目标价值,可使用[/tool/vbo_status/](1770016073586753.html)。</li></ul></li></ul>|
| 竞价策略 | <ul><li>优化目标是安装或应用内事件时,可设置为最大投放量或成本上限。</li><li>优化目标为价值时,可设置为最高价值(优先充分消耗预算,同时尽可能获得最大的成效价值)或最低 ROAS(确保您的平均 ROAS 达到或超过目标 ROAS 值)。</li></ul> | `bid_type`<br>`conversion_bid_price` <br>`deep_bid_type`<br>`roas_bid`   |<ul><li>若 `optimization_goal` 设置为 `INSTALL` 或 `IN_APP_EVENT`:<ul><li>需将 `bid_type` 设置为 `BID_TYPE_CUSTOM` 或 `BID_TYPE_NO_BID`。不可传入 `deep_bid_type` 和 `roas_bid`。<ul><li>若 `bid_type` 设置为 `BID_TYPE_CUSTOM`,需同时传入 `conversion_bid_price`。</li></ul></li></ul></li><li>若 `optimization_goal` 设置为 `VALUE`:<ul><li>需将 `deep_bid_type` 设置为 `VO_MIN_ROAS` 或 `VO_HIGHEST_VALUE`,且同时将 `bid_type` 设置为 `BID_TYPE_NO_BID`。不可同时传入 `conversion_bid_price`。<ul><li>若 `deep_bid_type` 设置为 `VO_MIN_ROAS`,需同时传入 `roas_bid`。</li></ul></li></ul></li></ul> |
| 选择价值类型 | 若优化目标为价值且使用了自归因平台,可选择以下任一类型:<ul><li>应用内购价值</li><li>广告收入价值<br><p><span style="color:darkred"><b>注意</b></span>:若使用广告收入价值,需确保版位为仅 TikTok 或仅 Pangle。</li></ul> | `optimization_event`<br>`secondary_optimization_event` | 当 `optimization_goal` 是 `VALUE` 且推广系列层级返回的 `bid_align_type` 的值为 `SAN` :<ul><li>若您想使用应用内购价值,需将 `optimization_event` 设置为 `ACTIVE_PAY` 并将 `secondary_optimization_event` 设置为 `PURCHASE_ROI`。</li><li>若您想使用广告收入价值,需将 `optimization_event` 设置为 `AD_REVENUE_VALUE` 且不传入 `secondary_optimization_event`。<br><p><span style="color:darkred"><b>注意</b></span>:若使用广告收入价值,需确保 `placement_type` 设置为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 为 `&#91;"PLACEMENT_TIKTOK"&#93;` 或 `&#91;"PLACEMENT_PANGLE"&#93;`。</li></ul><br> 若想获取推广系列的 `bid_align_type`,可使用 [/campaign/get/](1739315828649986.html)。|
| 竞价策略的时间窗口期 | 若优化目标为价值且使用了自归因平台归因,可选择以下任一类型:<ul><li>第 7 天 ROAS 或前 7 天最高价值</li><li>第 0 天 ROAS 或最高价值</li></ul>| `vbo_window` | 若 `optimization_goal` 为 `VALUE` 且推广系列层级返回的 `bid_align_type` 是 `SAN` ,可使用以下任一值:<ul><li>`SEVEN_DAYS`</li><li>`ZERO_DAY`</li></ul><br>例如,如果您将 `deep_bid_type` 设置为 `VO_MIN_ROAS`,同时传入 `roas_bid`,且将 `vbo_window` 设置为 `ZERO_DAY`,系统将努力让第 0 天(当天)的 ROAS 保持在或超过目标 ROAS 值。<br><br> 若想获取推广系列的 `bid_align_type`,可使用 [/campaign/get/](1739315828649986.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>在高级专属推广系列中使用<b>应用内购价值优化</b>的第 0 天出价或第 7 天出价(`vbo_window` 为 `ZERO_DAY` 或 `SEVEN_DAYS`)目前为白名单功能。如需使用这些功能,请联系您的 TikTok 销售代表。</li><li>在高级专属推广系列中使用<b>广告收入价值优化</b>的第 0 天出价或第 7 天出价(`vbo_window` 为 `ZERO_DAY` 或 `SEVEN_DAYS`)目前为白名单功能。如需使用这些功能,请联系您的 TikTok 销售代表。</li></ul>|
| 计费事件<br>(计费点)| oCPM|`billing_event`| `OCPM`|
| 投放速度 | <ul><li>若竞价策略设置为成本上限,支持将投放速度设置为标准或加速。</li><li>若竞价策略设置为最大投放量、最高总收入或最低 ROAS,仅支持将投放速度设置为标准。</li></ul> | `pacing` | <ul><li> `bid_type` 为 `BID_TYPE_CUSTOM` 时,可将 `pacing` 设置为 `PACING_MODE_SMOOTH` 或 `PACING_MODE_FAST`。</li><li> `bid_type` 为 `BID_TYPE_NO_BID` 时,仅支持将 `pacing` 设置为 `PACING_MODE_SMOOTH`。</li></ul> |

示例

请求

(code curl http)
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_nam}}",
    "promotion_type": "APP_IOS",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["6252001"],
    "operating_systems":["IOS"],
    "ios14_targeting": "IOS14_PLUS",
    "min_ios_version": "14.5",
    "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": "INSTALL",
    "bid_type": "BID_TYPE_NO_BID",
    "billing_event": "OCPM",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "adgroup_name": "{{adgroup_name}}",
        "adgroup_app_profile_page_state": "OFF",
        "is_new_structure": true,
        "video_download_disabled": false,
        "deep_bid_type": "DEFAULT",
        "engaged_view_attribution_window": "SEVEN_DAYS",
        "optimization_event": "ACTIVE",
        "conversion_bid_price": 0,
        "share_disabled": false,
        "schedule_type": "SCHEDULE_START_END",
        "interest_category_ids": [],
        "isp_ids": [],
        "keywords": null,
        "bid_display_mode": "CPMV",
        "creative_material_mode": "CUSTOM",
        "comment_disabled": false,
        "delivery_mode": null,
        "is_hfss": false,
        "brand_safety_type": "NO_BRAND_SAFETY",
        "audience_ids": [],
        "optimization_goal": "INSTALL",
        "category_id": "0",
        "auto_targeting_enabled": false,
        "promotion_type": "APP_IOS",
        "click_attribution_window": "SEVEN_DAYS",
        "skip_learning_phase": true,
        "ios14_targeting": "IOS14_PLUS",
        "adgroup_app_profile_page_type": "OFF",
        "gender": "GENDER_UNLIMITED",
        "bid_type": "BID_TYPE_NO_BID",
        "purchased_reach": null,
        "network_types": [],
        "frequency": null,
        "attribution_event_count": "ONCE",
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "create_time": "{{create_time}}",
        "inventory_filter_enabled": false,
        "ios14_quota_type": "OCCUPIED",
        "app_type": "APP_IOS",
        "excluded_audience_ids": [],
        "category_exclusion_ids": [],
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "smart_interest_behavior_enabled": null,
        "statistic_type": "NONE",
        "pixel_id": null,
        "advertiser_id": "{{advertiser_id}}",
        "operation_status": "ENABLE",
        "billing_event": "OCPM",
        "modify_time": "{{modify_time}}",
        "package": "{{package}}",
        "view_attribution_window": "ONE_DAY",
        "search_result_enabled": true,
        "deep_cpa_bid": 0,
        "campaign_id": "{{campaign_id}}",
        "rf_estimated_frequency": null,
        "next_day_retention": null,
        "age_groups": null,
        "actions": [],
        "scheduled_budget": 0,
        "adgroup_id": "{{adgroup_id}}",
        "location_ids": [
            "6252001"
        ],
        "schedule_infos": null,
        "conversion_window": null,
        "app_download_url": "{{app_download_url}}",
        "feed_type": null,
        "languages": [],
        "device_price_ranges": null,
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "min_ios_version": "14.5",
        "rf_estimated_cpr": null,
        "schedule_end_time": "{{schedule_end_time}}",
        "budget": {{budget}},
        "interest_keyword_ids": [],
        "operating_systems": [
            "IOS"
        ],
        "brand_safety_partner": null,
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "frequency_schedule": null,
        "purchased_impression": null,
        "is_smart_performance_campaign": false,
        "rf_purchased_type": null,
        "schedule_start_time": "{{schedule_start_time}}",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "campaign_name": "{{campaign_name}}",
        "app_id": "{{app_id}}",
        "pacing": "PACING_MODE_SMOOTH",
        "bid_price": 0,
        "secondary_optimization_event": null,
        "smart_audience_enabled": null
    }
}
(/code)

3. 创建广告

使用/ad/create/接口创建一个广告。

示例

请求

(code curl http)
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": "75960823018",
    "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": "SHOP_NOW",
        "landing_page_url":"{{landing_page_url}}"
    }]
}'
(/code)

返回

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

创建 Smart+ 高级专属推广系列的步骤

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

设置 要求 参数 如何设置该参数
推广目标 应用推广 objective_type APP_PROMOTION
应用推广类型 应用安装 app_promotion_type APP_INSTALL
Smart+ 推广系列 启用。
通过/campaign/spc/create/ 创建的推广系列均为 Smart+ 推广系列。
/ /
iOS 14 专属推广系列 启用 campaign_type IOS14_CAMPAIGN
app_id 传入可用于高级专属推广系列的 iOS 应用的 ID。

若想获取可用的应用,可使用/app/list/。可用的应用需满足以下条件:
  • platform 为 IOS
  • advanced_dedicated_campaign_allowed 为 true

注意:使用高级专属推广系列要求应用满足一定条件。若您的应用不可用于高级专属推广系列,可联系您的 TikTok 销售代表。您的 TikTok 销售代表将提供故障排查支持,帮助您的应用满足高级专属推广系列的条件。

campaign_app_profile_page_state ON 或 OFF(或不传入)
使用高级专属推广系列 启用 is_advanced_dedicated_campaign true
SKAN 归因 启用或不启用 disable_skan_campaign 以下任一值:

注意: 为专属推广系列关闭 SKAN 归因目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。

优化位置
(推广对象)
iOS 应用 promotion_type APP_IOS
版位
(广告位)
使用以下任意类型:
  • 自动版位
  • 编辑版位且版位设置为 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 使用以下任意值:
  • INSTALL
    • 若想使用 INSTALL,需确保所指定的应用已设置第三方监测。您可以使用/app/info/检查应用是否已设置第三方监测(tracking_url)。
    • 若想为现有应用添加第三方监测,可使用/app/update/。若想了解如何从第三方合作伙伴获取监测链接,可查看移动合作伙伴 (MMP) 跟踪。
  • IN_APP_EVENT(需指定optimization_event)
    • 若想使用IN_APP_EVENT,需确保指定的事件(optimization_event)为所选应用的可用事件。您可使用/app/optimization_event/获取某一应用的可用事件(optimization_event)。
  • VALUE(需将 optimization_event 设置为 ACTIVE_PAY或 AD_REVENUE_VALUE)
    • 若想检查某些设置是否支持优化目标价值,可使用/tool/vbo_status/。
竞价策略
  • 若优化目标为安装或应用内事件,可设置为最大投放量或成本上限。
  • 若优化目标为价值,可设置为最高价值(优先充分消耗预算,同时尽可能获得最大的成效价值)或最低 ROAS(确保您的平均 ROAS 达到或超过目标 ROAS 值)。
bid_type
conversion_bid_price
deep_bid_type
roas_bid
  • 若 optimization_goal 设置为 INSTALL 或 IN_APP_EVENT:
    • 需将 bid_type 设置为 BID_TYPE_CUSTOM 或 BID_TYPE_NO_BID。不可传入 deep_bid_type 和 roas_bid。
      • 若 bid_type 设置为 BID_TYPE_CUSTOM,需同时传入 conversion_bid_price。
  • 若 optimization_goal 设置为 VALUE:
    • 需将 deep_bid_type 设置为 VO_MIN_ROAS 或 VO_HIGHEST_VALUE,且同时将 bid_type 设置为 BID_TYPE_NO_BID。不可同时传入 conversion_bid_price。
      • 若 deep_bid_type 设置为 VO_MIN_ROAS,需同时传入 roas_bid。
选择价值类型
  • 若优化目标为价值且使用了自归因平台归因,可选择以下任一类型:
    • 应用内购价值
    • 广告收入价值

      注意: 若要使用广告收入价值,需确保版位为仅 TikTok 或 TikTok 和 Pangle。

optimization_event 若 optimization_goal 为 VALUE 且 bid_align_type 的值为 SAN:
  • 若您想使用应用内购价值,需将 optimization_event 设置为 ACTIVE_PAY。
  • 若您想使用广告收入价值,需将 optimization_event 设置为 AD_REVENUE_VALUE。

    注意: 若要使用广告收入价值,需确保 placement_type 设置为 PLACEMENT_TYPE_NORMAL 且 placements 为 ["PLACEMENT_TIKTOK"] 或 ["PLACEMENT_TIKTOK","PLACEMENT_PANGLE"]。


若想获取推广系列的 bid_align_type,可使用 /campaign/get/。
竞价策略的时间窗口期
  • 若优化目标为价值且使用了自归因平台归因,可选择以下任一类型:
    • 第 7 天 ROAS 或前 7 天最高价值
    • 第 0 天 ROAS 或最高价值
vbo_window
  • 若 optimization_goal 为 VALUE 且 bid_align_type 为 SAN,可使用以下任一值:
    • SEVEN_DAYS
    • ZERO_DAY

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

    若想获取推广系列的 bid_align_type,请使用 /campaign/get/。

    注意:

    • 在高级专属推广系列中使用应用内购价值优化的第 0 天出价或第 7 天出价(vbo_window 为 ZERO_DAY 或 SEVEN_DAYS)目前为白名单功能。如需使用这些功能,请联系您的 TikTok 销售代表。
    • 在高级专属推广系列中使用广告收入价值优化的第 0 天出价或第 7 天出价(vbo_window 为 ZERO_DAY 或 SEVEN_DAYS)目前为白名单功能。如需使用这些功能,请联系您的 TikTok 销售代表。

计费事件
(计费点)
oCPM billing_event OCPM
投放速度
  • 若竞价策略设置为成本上限,支持将投放速度设置为标准或加速。
  • 若竞价策略设置为最大投放量、最高总收入或最低 ROAS,仅支持将投放速度设置为标准。
pacing
  • 若 bid_type 为 BID_TYPE_CUSTOM,可将 pacing 设置为 PACING_MODE_SMOOTH 或 PACING_MODE_FAST。
  • 若 bid_type 为 BID_TYPE_NO_BID,仅支持将 pacing 设置为 PACING_MODE_SMOOTH。

示例

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/spc/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_type": "IOS14_CAMPAIGN",
    "app_id": "{{app_id}}",
    "is_advanced_dedicated_campaign": true,
    "campaign_name": "{{campaign_name}}",
    "promotion_type": "APP_IOS",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": [
        "PLACEMENT_TIKTOK"
    ],
    "location_ids": [
        "6252001"
    ],
    "budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_FROM_NOW",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "optimization_goal": "INSTALL",
    "bid_type": "BID_TYPE_NO_BID",
    "billing_event": "OCPM",
    "identity_type": "CUSTOMIZED_USER",
    "identity_id": "{{identity_id}}",
    "media_info_list": [
        {
            "media_info": {
                "video_info": {
                    "video_id": "{{video_id}}",
                    "file_name": "{{file_name}}"
                },
                "image_info": [
                    {
                        "web_uri": "{{web_uri}}"
                    }
                ]
            }
        }
    ],
    "title_list": [
        {
            "title": "{{title}}"
        }
    ],
    "call_to_action_id": "{{call_to_action_id}}"
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "modify_time": "{{modify_time}}",
        "click_attribution_window": "SEVEN_DAYS",
        "pixel_id": null,
        "campaign_type": "IOS14_CAMPAIGN",
        "page_list": null,
        "is_advanced_dedicated_campaign": true,
        "deep_bid_type": "DEFAULT",
        "call_to_action_id": "{{call_to_action_id}}",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "budget": {{budget}},
        "scheduled_budget": 0,
        "app_id": "{{app_id}}",
        "advertiser_id": "{{advertiser_i}}",
        "conversion_bid_price": null,
        "campaign_id": "{{campaign_id}}",
        "deeplink_type": null,
        "app_promotion_type": "APP_INSTALL",
        "landing_page_urls": null,
        "optimization_goal": "INSTALL",
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "billing_event": "OCPM",
        "bid_type": "BID_TYPE_NO_BID",
        "budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
        "click_tracking_url": "{{click_tracking_url}}",
        "view_attribution_window": "ONE_DAY",
        "deeplink": "",
        "bid_price": null,
        "excluded_audience_ids": null,
        "optimization_event": "ACTIVE",
        "schedule_start_time": "{{schedule_start_time}}",
        "identity_id": "{{identity_id}}",
        "video_download_disabled": false,
        "adgroup_secondary_status": "ADGROUP_STATUS_AUDIT",
        "create_time": "{{create_time}}",
        "title_list": [
            {
                "title": "{{title}}"
            }
        ],
        "schedule_end_time": "{{schedule_end_time}}",
        "app_name": "{{app_name}}",
        "operation_status": "ENABLE",
        "gender": "GENDER_UNLIMITED",
        "schedule_type": "SCHEDULE_FROM_NOW",
        "call_to_action_list": [],
        "comment_disabled": false,
        "share_disabled": false,
        "media_info_list": [
            {
                "media_info": {
                    "tiktok_item_id": null,
                    "identity_id": null,
                    "image_info": [
                        {
                            "web_uri": "{{web_uri}}"
                        }
                    ],
                    "video_info": {
                        "video_id": "{{video_id}}",
                        "file_name": "{{file_name}}"
                    },
                    "identity_type": null
                }
            }
        ],
        "campaign_secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "blocked_pangle_app_ids": null,
        "identity_type": "CUSTOMIZED_USER",
        "app_type": "APP_IOS",
        "card_list": null,
        "special_industries": null,
        "is_smart_performance_campaign": true,
        "campaign_app_profile_page_state": "OFF",
        "skip_learning_phase": true,
        "exclude_age_under_eighteen": true,
        "spc_type": "UNSET",
        "location_ids": [
            "6252001"
        ],
        "engaged_view_attribution_window": "SEVEN_DAYS",
        "languages": [],
        "impression_tracking_url": null,
        "campaign_name": "{{campaign_name}}",
        "attribution_event_count": "ONCE",
        "promotion_website_type": null,
        "promotion_type": "APP_IOS",
        "app_download_url": "{{app_download_url}}",
        "objective_type": "APP_PROMOTION"
    }
}
(/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 每日平台更新简报 →