← 返回目录
📁 Use Cases › Campaign creation

创建社区互动广告

本文介绍了创建社区互动广告的具体步骤。

简介

借助社区互动推广目标，您可以与 TikTok 社区（当今世界上最有价值的社区之一）建立并培养联系。该推广目标可使您推动粉丝增长或增加 TikTok 不同落地页的流量。

您可以使用推广系列管理 API 创建社区互动广告。这将帮助您简化广告创建流程，提高推广系列的运营效率和管理规模。

前提条件

  • 您已经拥有 TikTok API for Business 的使用权限。详见快速入门 - 具体步骤 。
  • 若要创建社区互动广告，您需要获取相关的权限。参阅 API 参考了解使用相关接口（包括“步骤”部分列出的接口）所需的权限。参阅更新应用权限范围了解如何设置权限。

步骤

1. 创建推广系列

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

设置 要求 参数 如何设置该参数
推广目标 社区互动 objective_type ENGAGEMENT
Smart+ 推广系列 未启用

不支持使用/campaign/spc/create/创建启用 Smart+ 推广系列设置的社区互动推广系列。		 /
 /
iOS 14 专属推广系列 未启用 campaign_type REGULAR_CAMPAIGN 或不传入
app_id 不传入
campaign_app_profile_page_state 不传入

示例

请求

(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": "ENGAGEMENT",
    "campaign_name": "{{campaign_name}}",
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}}
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "budget_mode": "BUDGET_MODE_TOTAL",
        "objective": "LANDING_PAGE",
        "budget": {{budget}},
        "deep_bid_type": null,
        "is_smart_performance_campaign": false,
        "is_advanced_dedicated_campaign": false,
        "is_search_campaign": false,
        "advertiser_id": "{{advertiser_id}}",
        "campaign_type": "REGULAR_CAMPAIGN",
        "modify_time": "{{modify_time}}",
        "roas_bid": 0,
        "rta_id": null,
        "secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "campaign_name": "{{campaign_name}}",
        "create_time": "{{create_time}}",
        "objective_type": "ENGAGEMENT",
        "operation_status": "ENABLE",
        "is_new_structure": true,
        "campaign_id": "{{campaign_id}}",
        "rta_product_selection_enabled": false
    }
}
(/code)

2. 创建广告组

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

| 设置 {18%}| 要求{27%} | 参数 {20%}| 如何设置该参数 {35%}|
|---|---|---|---|
|互动类型 | TikTok 账户 <br><br><p><span style="color:darkred"><b>注意</b></span>：不支持通过 API 创建互动类型设置为 LIVE 的社区互动广告组。| / | / <br><br><p><span style="color:darkred"><b>注意</b></span>：通过 API 创建的社区互动广告组的互动类型均默认设置为“TikTok 账户”。 |
| 版位 <br>（广告位）| <b>编辑广告位</b>，且版位仅为 TikTok <br><br>您可同时指定下列 TikTok 子版位：<ul><li> 信息流。广告将投放在“推荐”动态中，可能投放在“个人资料页”和“关注”推荐内容中。</li><li>搜索推荐内容（白名单功能）。</li><li>TikTok Lite（白名单功能）。占用内容更小、视频加载速度更快的精简版 TikTok 应用。TikTok Lite 子版位仅支持定向日本或韩国时使用。</li></ul>| `placement_type` <br>`placements` <br>`tiktok_subplacements`| `placement_type` 设置为 `PLACEMENT_TYPE_NORMAL`，且 `placements` 设置为 `["PLACEMENT_TIKTOK"]`。<br><br>您可同时通过 `tiktok_subplacements` 指定下列 TikTok 子版位：<ul><li> `IN_FEED`</li><li>`SEARCH_FEED`</li><li> `TIKTOK_LITE`<span style="color:Red">即将废弃</span></li></ul><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>自 2025 年 7 月 19 日起，您将无法创建或复制使用子版位 TikTok Lite （`TIKTOK_LITE`）的广告组。为确保流畅、不受影响的广告创建体验，推荐您从广告组创建流程中移除此子版位或避免复制包含此类广告组的推广系列。</li><li>在广告组中使用子版位 TikTok Lite（`TIKTOK_LITE`）目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li><li>在广告组中使用子版位搜索推荐内容（`SEARCH_FEED`）目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li><li>若您传入 `tiktok_subplacements`，`tiktok_subplacements`的值中需至少包含 `IN_FEED`。</li><li>若想在 `tiktok_subplacements` 的值中包含 `TIKTOK_LITE`，您需要在定向地域（`location_ids`）中包含日本或韩国的地域。否则，将出现报错。 </li><li>若想在 `tiktok_subplacements` 的值中包含 `SEARCH_FEED` 或 `TIKTOK_LITE`，不可同时将 `brand_safety_type` 设置为 `THRID_PARTY`。</li></ul> |
| 优化目标 | 使用以下目标之一： <ul><li>账号关注</li><li>TikTok 页面访问</li></ul>| `optimization_goal` | 使用以下任意值：<ul><li>`FOLLOWERS`</li><li>`PAGE_VISIT`</li></ul> |
| 竞价策略| 使用以下任意类型： <ul><li>最大投放量</li><li>成本上限</li></ul>| `bid_type`<br> `bid_price`<br> `conversion_bid_price`  | `bid_type`使用以下任意值：<ul><li>`BID_TYPE_NO_BID`</li><li>`BID_TYPE_CUSTOM`<ul><li>`bid_type` 为 `BID_TYPE_CUSTOM` 且 `optimization_goal` 为 `FOLLOWERS`时，需同时传入`conversion_bid_price`。</li><li>`bid_type` 为 `BID_TYPE_CUSTOM` 且 `optimization_goal` 为 `PAGE_VISIT`时，需同时传入`bid_price`。 </li></ul></li></ul>|
|计费事件 | <ul><li>优化目标为 TikTok 页面访问时，计费事件需为 CPC。</li><li>优化目标为账号关注时，计费事件需为 oCPM。</li></ul> | `billing_event` |<ul><li> `optimization_goal` 为 `PAGE_VISIT`时 ，将本字段设置为 `CPC`。</li><li>`optimization_goal` 为 `FOLLOWERS`时 ，将本字段设置为`OCPM`。</li></ul>|
| 投放速度 |<ul><li>若竞价策略设置为最大投放量，仅支持将投放速度设置为标准。</li><li>若竞价策略设置为成本上限，支持将投放速度设置为标准或加速。</li></ul> | `pacing` | <ul><li>`bid_type` 为 `BID_TYPE_NO_BID`时，仅支持将 `pacing` 设置为 `PACING_MODE_SMOOTH`。</li><li> `bid_type` 为 `BID_TYPE_CUSTOM`时，可将 `pacing` 设置为 `PACING_MODE_SMOOTH` 或 `PACING_MODE_FAST`。</li></ul>|
| 拆分对比测试 |支持<br><br>社区互动广告组支持传入[/split_test/create/](1742666471475201.html)中创建拆分对比测试。| / | / |

示例

优化目标设置为账号关注

请求

(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_name}}",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["6251999"],
    "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": "FOLLOWERS",
    "bid_type": "BID_TYPE_CUSTOM",
    "conversion_bid_price": {{conversion_bid_price}},
    "billing_event": "OCPM",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

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

优化目标设置为 TikTok 页面访问

请求

(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_name}}",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["6251999"],
    "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": "PAGE_VISIT",
    "bid_type": "BID_TYPE_CUSTOM",
    "bid_price": {{bid_price}},
    "billing_event": "CPC",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "actions": [],
        "category_exclusion_ids": [],
        "adgroup_id": "{{adgroup_id}}",
        "deep_cpa_bid": 0,
        "smart_audience_enabled": null,
        "schedule_end_time": "{{schedule_end_time}}",
        "skip_learning_phase": false,
        "bid_price": {{bid_price}},
        "excluded_audience_ids": [],
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "conversion_window": null,
        "next_day_retention": null,
        "gender": "GENDER_UNLIMITED",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "frequency": null,
        "interest_category_ids": [],
        "brand_safety_type": "NO_BRAND_SAFETY",
        "promotion_type": "WEBSITE_OR_DISPLAY",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "vbo_window": null,
        "frequency_schedule": null,
        "billing_event": "CPC",
        "ios14_quota_type": "UNOCCUPIED",
        "rf_purchased_type": null,
        "interest_keyword_ids": [],
        "operation_status": "ENABLE",
        "inventory_filter_enabled": false,
        "campaign_id": "{{campaign_id}}",
        "app_type": null,
        "schedule_type": "SCHEDULE_START_END",
        "budget": {{budget}},
        "secondary_optimization_event": null,
        "share_disabled": false,
        "audience_ids": [],
        "rf_estimated_cpr": null,
        "device_price_ranges": null,
        "adgroup_app_profile_page_state": null,
        "purchased_impression": null,
        "brand_safety_partner": null,
        "create_time": "{{create_time}}",
        "auto_targeting_enabled": false,
        "network_types": [],
        "video_download_disabled": false,
        "age_groups": null,
        "statistic_type": null,
        "schedule_start_time": "{{schedule_start_time}}",
        "advertiser_id": "{{advertiser_id}}",
        "languages": [],
        "smart_interest_behavior_enabled": null,
        "bid_display_mode": "CPMV",
        "campaign_name": "{{campaign_name}}",
        "keywords": null,
        "creative_material_mode": "CUSTOM",
        "adgroup_name": "{{adgroup_name}}",
        "delivery_mode": null,
        "purchased_reach": null,
        "app_id": null,
        "optimization_goal": "PAGE_VISIT",
        "scheduled_budget": 0,
        "operating_systems": [],
        "bid_type": "BID_TYPE_CUSTOM",
        "pacing": "PACING_MODE_SMOOTH",
        "schedule_infos": null,
        "pixel_id": null,
        "modify_time": "{{modify_time}}",
        "comment_disabled": false,
        "conversion_bid_price": 0,
        "rf_estimated_frequency": null,
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "app_download_url": null,
        "deep_bid_type": null,
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "is_new_structure": true,
        "feed_type": null,
        "is_hfss": false,
        "search_result_enabled": false,
        "optimization_event": "PAGE_VISIT",
        "is_smart_performance_campaign": false,
        "isp_ids": [],
        "category_id": "0",
        "location_ids": [
            "6251999"
        ]
    }
}
(/code)

3. 创建广告

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

设置 要求 参数 如何设置该参数
智能创意 未启用

不支持将is_smart_creative 传入 /ad/aco/create/创建开启智能创意的社区互动广告。		 / /
广告样式 单视频 ad_format SINGLE_VIDEO
认证身份
（广告发布身份）		 以下任意类型：
  • 授权用户
  • TikTok 用户
  • 添加到商务中心的 TikTok 用户
 identity_type 以下任意值：
  • AUTH_CODE
  • TT_USER
  • BC_AUTH_TT

若想了解 Spark Ads 的创建步骤，可查看创建 Spark Ads。
identity_id 传入合法值。

若想获取广告账号下的认证身份，可使用/identity/get/。
identity_authorized_bc_id 若 identity_type 设置为 BC_AUTH_TT，需传入合法值。
目标页面
  • 若广告组层级优化目标设置为账号关注，目标页面为 TikTok 账号主页。
  • 若广告组层级优化目标设置为 TikTok 页面访问，可选择以下任意类型：
    • 账号主页
      • 无需指定 TikTok 页面 URL 或 TikTok 即时体验页面。
    • 其他 TikTok 页面
      • 需指定一个 TikTok 页面 URL。
    • TikTok 即时体验页面
      • 需指定一个自定义 TikTok 即时体验页面。
 tiktok_page_category
landing_page_url
page_id
  • 若广告组层级 optimization_goal 设置为 FOLLOWERS，无需传入tiktok_page_category、landing_page_url 和 page_id。
  • 若广告组层级 optimization_goal 设置为 PAGE_VISIT，需传入tiktok_page_category 来指定具体的目标页面。
    • 若想将目标页面设置为账号主页，需将tiktok_page_category 设置为PROFILE_PAGE。无需传入landing_page_url 和 page_id。
    • 若想将目标页面设置为其他 TikTok 页面，需将 tiktok_page_category 设置为OTHER_TIKTOK_PAGE 且通过landing_page_url 传入一个播放列表页面、话题标签页面、音乐页面或商业化特效页面的 TikTok 页面 URL。无需传入page_id。
      • 若想获取 TikTok 页面 URL，可在 TikTok 应用中点按你要推广的 TikTok 页面右上角的分享按钮，然后点击复制 URL。
    • 若想将目标页面设置为 TikTok 即时体验页面，需将 tiktok_page_category 设置为 TIKTOK_INSTANT_PAGE 且通过page_id传入一个自定义 TikTok 即时体验页面的 ID。无需传入landing_page_url。
      • 若想获取广告账户中的自定义 TikTok 即时体验页面，可使用 /page/get/ 并将 business_type 设置为 TIKTOK_INSTANT_PAGE。
行动引导文案
  • 若广告组层级优化目标设置为账号关注：未启用。
  • 若广告组层级优化目标设置为 TikTok 页面访问：需指定一个标准行动引导文案或动态行动引导文案。
 call_to_action
call_to_action_id
  • 若广告组层级 optimization_goal 设置为 FOLLOWERS，无需传入call_to_action 和 call_to_action_id。
  • 若广告组层级 optimization_goal 设置为 PAGE_VISIT，需通过call_to_action指定一个标准行动引导文案或通过call_to_action_id指定一个动态行动引导文案。
创新互动样式
（可选）		 未启用，或使用以下类型：
  • 包含提醒的倒计时贴纸

注意：若广告组层级设置了 TikTok 子版位搜索推荐内容，则不支持使用包含提醒的倒计时贴纸。

card_id 不传入或指定以下类型的创意素材包的 ID：
  • 包含提醒的倒计时贴纸（sticker_type 为 REMINDER_COUNTDOWN 或 LIVE_REMINDER_COUNTDOWN）

若想创建创意素材包，可使用/creative/portfolio/create/。
  • 欲了解如何获取倒计时贴纸素材包的 ID，请参考贴纸。

注意：若广告组层级的 tiktok_subplacements 中包含了 SEARCH_FEED ，则不支持在广告层级通过 card_id 传入包含提醒的倒计时贴纸。

示例

目标页面设置为账号主页（广告组层级优化目标为账户关注）

请求

(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": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [{
        "ad_name": "{{ad_name}}",
        "identity_type":"AUTH_CODE",
        "identity_id":"{{identity_id}}",
        "ad_format": "SINGLE_VIDEO",
        "tiktok_item_id":"{{tiktok_item_id}}"
    }]
}'
(/code)

返回

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

目标页面设置为账号主页（广告组层级优化目标为 TikTok 页面访问）

请求

(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": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [{
        "ad_name": "{{ad_name}}",
        "identity_type":"TT_USER",
        "identity_id":"{{identity_id}}",
        "ad_format": "SINGLE_VIDEO",
        "tiktok_item_id":"{{tiktok_item_id}}",
        "tiktok_page_category":"PROFILE_PAGE",
        "call_to_action":"VIEW_PROFILE"
    }]
}'
(/code)

返回

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

目标页面设置为其他 TikTok 页面（广告组层级优化目标为 TikTok 页面访问）

请求

(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": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [{
        "ad_name": "{{ad_name}}",
        "identity_type":"TT_USER",
        "identity_id":"{{identity_id}}",
        "ad_format": "SINGLE_VIDEO",
        "tiktok_item_id":"{{tiktok_item_id}}",
        "tiktok_page_category":"OTHER_TIKTOK_PAGE",
        "call_to_action":"VIEW_PROFILE",
        "landing_page_url":"{{landing_page_url}}"
    }]
}'
(/code)

返回

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

目标页面设置为 TikTok 即时体验页面（广告组层级优化目标为 TikTok 页面访问）

请求

(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": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [{
        "ad_name": "{{ad_name}}",
        "identity_type":"TT_USER",
        "identity_id":"{{identity_id}}",
        "ad_format": "SINGLE_VIDEO",
        "tiktok_item_id":"{{tiktok_item_id}}",
        "tiktok_page_category":"TIKTOK_INSTANT_PAGE",
        "call_to_action":"VIEW_PROFILE",
        "page_id":"{{page_id}}"
    }]
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "display_name": "{{display_name}}",
                "music_id": null,
                "tiktok_item_id": "{{tiktok_item_id}}",
                "adgroup_id": "{{adgroup_id}}",
                "campaign_name": "{{campaign_name}}",
                "avatar_icon_web_uri": "",
                "profile_image_url": "",
                "modify_time": "{{modify_time}}",
                "vast_moat_enabled": false,
                "carousel_image_labels": null,
                "ad_format": "SINGLE_VIDEO",
                "optimization_event": "PAGE_VISIT",
                "advertiser_id": "{{advertiser_id}}",
                "app_name": "{{app_name}}",
                "landing_page_url": null,
                "adgroup_name": "{{adgroup_name}}",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id_1}}",
                    "{{tracking_offline_event_set_id_2}}"
                ],
                "create_time": "{{create_time}}",
                "video_id": null,
                "ad_texts": null,
                "impression_tracking_url": null,
                "campaign_id": "{{campaign_id}}",
                "call_to_action": "VIEW_PROFILE",
                "ad_name": "{{ad_name}}",
                "promotional_music_disabled": true,
                "creative_authorized": false,
                "image_ids": [],
                "identity_type": "TT_USER",
                "call_to_action_id": null,
                "card_id": null,
                "viewability_postbid_partner": "UNSET",
                "tiktok_page_category": "TIKTOK_INSTANT_PAGE",
                "is_aco": false,
                "playable_url": "",
                "viewability_vast_url": null,
                "ad_text": "{{ad_text}}",
                "landing_page_urls": null,
                "operation_status": "ENABLE",
                "click_tracking_url": null,
                "ad_id": "{{ad_id}}",
                "identity_id": "{{identity_id}}",
                "deeplink": null,
                "is_new_structure": true,
                "brand_safety_vast_url": null,
                "creative_type": "CUSTOM_INSTANT_PAGE",
                "page_id": {{page_id}},
                "tracking_pixel_id": 0
            }
        ]
    }
}
(/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 每日平台更新简报 →