← 返回目录
📁 Use Cases › Campaign creation

创建搜索广告推广系列

本文介绍了创建搜索广告推广系列的具体步骤。

简介

搜索广告推广系列是一种基于关键词的推广系列类型，可在 TikTok 的搜索结果页面上以原生形式触达用户。通过搜索广告推广系列，您可以针对搜索专门设定广告预算，并以精准投放特定关键词的方式实现最佳的覆盖和参与度。

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

前提条件

  • 您已经拥有 TikTok API for Business 的使用权限。详见快速入门 - 具体步骤。
  • 若要创建搜索广告推广系列，您需要获取相关的权限。参阅 API 参考了解使用相关接口（包括“步骤”部分列出的接口）所需的权限。参阅更新应用权限范围了解如何设置权限。
  • 不同推广目标下的搜索广告推广系列受独立白名单控制。如需使用这些功能，请联系您的 TikTok 代表。

步骤

1. 创建推广系列

使用 /campaign/create/ 创建推广系列，需满足以下要求：

| 设置{20%} | 要求{25%} | 参数{20%} | 如何配置该参数{35%} |
|---|---|---|
| 推广目标 | 使用以下目标之一：<ul><li><code>WEBSITE_CONVERSIONS</code></li><li><code>TRAFFIC</code></li><li><code>LEAD_GENERATION</code></li></ul> | <code>objective_type</code> | 使用以下任意值：<ul><li><code>WEB_CONVERSIONS</code></li><li><code>TRAFFIC</code></li><li><code>LEAD_GENERATION</code></li></ul> |
| 搜索推广系列 | 启用 | <code>is_search_campaign</code> | <code>true</code> |
| Smart+ 推广系列 | 未启用<br><br>不可使用 [/campaign/spc/create/](1767334204047362.html)为搜索广告推广系列启用 Smart+ 推广系列设置。<br>若想了解如何为推广目标为网站转化量的推广系列启用 Smart+ 推广系列设置，可查看[创建 Smart+ 网站推广系列](1814122471133186.html)。 | / | / |
| 特殊广告分类（可选） | 启用或未启用 | <code>special_industries</code> | 传入合法值或不传入 |
| 推广系列预算优化 (CBO) | 未启用 | <code>budget_optimize_on</code> | <code>false</code> 或不传入 |

示例

使用推广目标网站转化量

请求

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

返回

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

使用推广目标访问量

请求

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

返回

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

使用推广目标线索收集

请求

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

返回

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

2. 创建广告组

使用 /adgroup/create/ 接口创建一个广告组。需确保满足以下要求，这些要求根据您在推广系列层级选择的推广目标而有所不同。

推广目标为网站转化量时

| 设置{20%} | 要求{25%} | 参数{20%} | 如何设置该参数{35%} |
|---|---|---|
| 优化位置 <br>（推广对象类型） | 选择以下类型之一：<ul><li>网站</li><li>TikTok 即时体验页面</li></ul> | `promotion_type`<br>`promotion_website_type` | <ul><li>若要将优化位置设置为网站，需：<ul><li>将 `promotion_type` 设置为 `WEBSITE`。</li><li>将 `promotion_website_type` 设置为 `UNSET` 或不传入此字段。</li></ul></li><li>若要将优化位置设置为 TikTok 即时体验页面，需：<ul><li>将 `promotion_type` 设置为 `WEBSITE`。</li><li>将 `promotion_website_type` 设置为 `TIKTOK_NATIVE_PAGE`。</li></ul></li></ul> |
| Pixel | <ul><li>优化位置为网站时，需指定 Pixel。</li><li>优化位置为 TikTok 即时体验页面时，不支持指定 Pixel。</li></ul> | `pixel_id` | <ul><li>若 `promotion_website_type` 设置为 `UNSET` 或未传入，则本字段必填。</li><li>若 `promotion_website_type` 设置为 `TIKTOK_NATIVE_PAGE`，则不支持本字段。</li></ul> |
| 优化事件 | 需选择优化事件。<br><br><p><span style="color:darkred"><b>注意</b></span>: 若优化位置为 TikTok 即时体验页面， 则仅唯一支持的优化事件为点击按钮（即针对即时体验页面上的出站点击进行优化）。 | `optimization_event` | 传入合法值。<br><br>若想获取 Pixel 已配置的优化事件，可使用 [/pixel/list/](1740858697598978.html)。<br>枚举值详见 [转化事件 - Pixel事件类型](https://business-api.tiktok.com/portal/docs?id=1739361474981889#item-link-Pixel事件类型)。<br><br><p><span style="color:darkred"><b>注意</b></span>: 若 `promotion_website_type` 设置为 `TIKTOK_NATIVE_PAGE`，则本字段仅支持设置为 `BUTTON`。 |
| 版位 | TikTok 搜索结果。<br>当用户在 TikTok 上搜索与您的关键词相关的词语时，向他们展示您的广告。 | `placement_type`<br>`placements` | 将 `placement_type` 设置为 `PLACEMENT_TYPE_NORMAL`，同时将 `placements` 设置为 `["PLACEMENT_TIKTOK"]`。 |
| 包含搜索结果 | 未启用<br><br><p><span style="color:darkred"><b>重要提示</b></span>：搜索广告推广系列与[自动搜索广告位](1771747626094593.html)不兼容。搜索广告可将您的信息流广告扩展到 TikTok 搜索结果页面，而搜索广告推广系列专门用于在 TikTok 搜索结果页面投放广告。 | `search_result_enabled` | 不传入（推荐做法）<br>本字段将忽略，默认设置为 `false`。 |
| Pangle 媒体屏蔽列表 | 未启用 | `blocked_pangle_app_ids` | 不传入 |
| 受众定向 <br>&#183; 已保存受众 | 未启用 | `saved_audience_id` | 不传入 |
| 受众定向 <br>&#183; 自动定向 | 未启用 | `auto_targeting_enabled` | 不传入 |
| 受众 <br>&#183; 包含<br>&#183; 排除 | 未启用 | `audience_ids`<br>`excluded_audience_ids` | 不传入 |
| 智能受众 | 未启用 | `smart_audience_enabled` | 不传入 |
| 兴趣与行为<br>&#183; 兴趣| 未启用 | `interest_category_ids`<br>`interest_keyword_ids` | 不传入 |
| 兴趣与行为<br>&#183; 购买意向| 未启用 | `purchase_intention_keyword_ids` | 不传入 |
| 兴趣与行为<br>&#183; 视频互动 & 创作者互动 & 话题互动| 未启用 | `actions` | 不传入 |
| 智能型兴趣和行为 | 未启用 | `smart_interest_behavior_enabled` | 不传入 |
| Pangle 流量包 | 未启用 | `included_pangle_audience_package_ids`<br>`excluded_pangle_audience_package_ids` | 不传入 |
| 定向扩量 | 未启用 | `targeting_expansion` | 不传入 |
| <b>关键词</b> | <b>指定 1 到 1,000 个搜索关键词 </b>| `keyword`<br>`match_type` | 指定 1 到 1,000 个搜索关键词及对应的匹配类型，通过 `keyword` 和 `match_type`。<ul><li>若想获取推荐搜索关键词，可使用 [/tool/search_keyword/recommend/](1838630375757825.html)。</li><li>若想获取搜索关键词的审核结果，需调用 [/adgroup/get](1739314558673922.html)，检查返回的对象数组 `search_keywords` 中的 `audit_status` 字段。</li></ul> |
| 自动关键词 | 需申请白名单才可启用 | `automated_keywords_enabled` | `true` 或 `false`（或不传入）。<br><br><p><span style="color:darkred"><b>注意</b></span>: 搜索广告推广系列中使用自动关键词目前为额外的白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。 |
| 每个关键词和匹配类型组合的单独出价（可选） | 未启用 | `keyword_bid_type`<br>`keyword_bid` | 不传入 |
| 内容相关定向 | 未启用 | `contextual_tag_ids` | 不传入 |
| 品牌安全和适用性<br>&#183; 库存筛选 | 未启用，或启用并设置为以下任一库存类型：<ul><li>扩展</li><li>标准</li><li>有限</li></ul> | `brand_safety_type` | 不传入，或设置为以下任一值：<ul><li>`EXPANDED_INVENTORY`</li><li>`STANDARD_INVENTORY`</li><li>`LIMITED_INVENTORY`</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：搜索广告推广系列中使用库存筛选目前为额外的白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。|
| 品牌安全和适用性<br>&#183; 第三方筛选 | 未启用 | `brand_safety_partner` | 不传入 |
| 品牌安全和适用性<br>&#183; 类别排除 | <ul><li>库存筛选设置为扩展层级时：<ul><li>未启用</li></ul></li><li>库存筛选设置为标准或有限层级时：<ul><li>未启用或启用</li></ul></li></ul> | `category_exclusion_ids` | <ul><li>`brand_safety_type` 为 `EXPANDED_INVENTORY` 时：不传入</li><li>`brand_safety_type` 为 `STANDARD_INVENTORY` 或 `LIMITED_INVENTORY` 时：不传入，或指定合法值</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：搜索广告推广系列中使用库存筛选和类别排除目前为额外的白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。|
| 品牌安全和适用性<br>&#183; 行业敏感内容 | 未启用 | `vertical_sensitivity_id` | 不传入 |
| 优化目标 | <ul><li>优化位置为网站时，支持的优化目标为转化和点击。</li><li>优化位置为 TikTok 即时体验页面时，支持的优化目标为转化。</li></ul> | `optimization_goal` | <ul><li>若 `promotion_website_type` 设置为 `UNSET` 或未传入，将 `optimization_goal` 设置为 `CONVERT` 或 `CLICK`。</li><li>若 `promotion_website_type` 设置为 `TIKTOK_NATIVE_PAGE`，将 `optimization_goal` 设置为 `CONVERT`。</li></ul> |
| 竞价策略 | 成本上限且设置目标 CPA | `bid_type`<br>`bid_price`<br>`conversion_bid_price` | 将 `bid_type` 设置为 `BID_TYPE_CUSTOM`。<ul><li>若 `optimization_goal` 为 `CLICK`，需同时传入 `bid_price`。</li><li>若 `optimization_goal` 为 `CONVERT`，需同时传入 `conversion_bid_price`。</li></ul> |
| 计费事件 | <ul><li>优化目标为点击时，支持的计费事件为CPC。</li><li>优化目标为转化时，支持的计费事件为oCPM。</li></ul> | `billing_event` | <ul><li>若 `optimization_goal` 设置为 `CLICK`，将 `billing_event` 设置为 `CPC`。</li><li>若 `optimization_goal` 设置为 `CONVERT`，将 `billing_event` 设置为 `OCPM`。</li></ul> |
| 投放速度 | 标准 | `pacing` | `PACING_MODE_SMOOTH` |
| 程序化创意 | 未启用 | `creative_material_mode` | `CUSTOM` 或不传入 |
| 拆分对比测试 | 未启用<br><br><p><span style="color:darkred"><b>注意</b></span>: 搜索广告组不支持用于 [/split_test/create/](1742666471475201.html) 创建拆分对比测试。 | / | / |
| 否定关键词 （可选） | 您可同时为该广告组设置至多 10,000 个 [否定关键词](1775103049049090.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}}",
    "promotion_type": "WEBSITE",
    "pixel_id":"{{pixel_id}}",
    "optimization_event":"CONSULT",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "search_result_enabled": false,
    "location_ids": ["1733045"],
    "search_keywords":[
        {
        "keyword":"{{keyword}}",
        "match_type":"BROAD_WORD"
        }
    ],
    "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": "CONVERT",
    "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": {
        "network_types": [],
        "adgroup_id": "{{adgroup_id}}",
        "gender": "GENDER_UNLIMITED",
        "schedule_infos": null,
        "inventory_filter_enabled": false,
        "interest_category_ids": [],
        "skip_learning_phase": true,
        "adgroup_app_profile_page_state": null,
        "conversion_bid_price": {{conversion_bid_price}},
        "frequency": null,
        "category_exclusion_ids": [],
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "promotion_website_type": "UNSET",
        "modify_time": "{{modify_time}}",
        "attribution_event_count": "EVERY",
        "bid_price": 0,
        "pacing": "PACING_MODE_SMOOTH",
        "location_ids": [
            "1733045"
        ],
        "rf_estimated_frequency": null,
        "brand_safety_type": "NO_BRAND_SAFETY",
        "share_disabled": false,
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "schedule_start_time": "{{schedule_start_time}}",
        "auto_targeting_enabled": false,
        "schedule_end_time": "{{schedule_end_time}}",
        "statistic_type": null,
        "schedule_type": "SCHEDULE_START_END",
        "conversion_window": null,
        "app_type": null,
        "languages": [],
        "search_result_enabled": false,
        "is_smart_performance_campaign": false,
        "purchased_impression": null,
        "optimization_goal": "CONVERT",
        "adgroup_name": "{{adgroup_name}}",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "delivery_mode": null,
        "operating_systems": [],
        "is_new_structure": true,
        "app_id": null,
        "is_hfss": false,
        "actions": [],
        "operation_status": "ENABLE",
        "deep_cpa_bid": 0,
        "rf_estimated_cpr": null,
        "interest_keyword_ids": [],
        "comment_disabled": false,
        "budget_mode": "BUDGET_MODE_TOTAL",
        "smart_audience_enabled": null,
        "rf_purchased_type": null,
        "billing_event": "OCPM",
        "click_attribution_window": "SEVEN_DAYS",
        "keywords": null,
        "pixel_id": "{{pixel_id}}",
        "scheduled_budget": 0,
        "isp_ids": [],
        "bid_display_mode": "CPMV",
        "bid_type": "BID_TYPE_CUSTOM",
        "device_price_ranges": null,
        "secondary_optimization_event": null,
        "category_id": "0",
        "frequency_schedule": null,
        "create_time": "{{create_time}}",
        "advertiser_id": "{{advertiser_id}}",
        "creative_material_mode": "CUSTOM",
        "smart_interest_behavior_enabled": null,
        "campaign_name": "{{campaign_name}}",
        "campaign_id": "{{campaign_id}}",
        "budget": {{budget}},
        "brand_safety_partner": null,
        "search_keywords": [
            {
                "match_type": "BROAD_WORD",
                "audit_status": "AUDITING",
                "keyword": "{{keyword}}"
            }
        ],
        "app_download_url": null,
        "purchased_reach": null,
        "audience_ids": [],
        "view_attribution_window": "ONE_DAY",
        "promotion_type": "WEBSITE",
        "optimization_event": "CONSULT",
        "ios14_quota_type": "UNOCCUPIED",
        "video_download_disabled": false,
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "feed_type": null,
        "next_day_retention": null,
        "excluded_audience_ids": [],
        "deep_bid_type": null,
        "age_groups": null
    }
}
(/code)
优化位置为 TikTok 即时体验页面且优化目标为转化

请求

(code curl http)
curl --location '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": "WEBSITE",
    "promotion_website_type":"TIKTOK_NATIVE_PAGE",
    "optimization_event":"CONSULT",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "search_result_enabled": false,
    "location_ids": ["1733045"],
    "search_keywords":[
        {
        "keyword":"{{keyword}}",
        "match_type":"BROAD_WORD"
        }
    ],
    "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": "CONVERT",
    "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": {
        "network_types": [],
        "adgroup_id": "{{adgroup_id}}",
        "gender": "GENDER_UNLIMITED",
        "schedule_infos": null,
        "inventory_filter_enabled": false,
        "interest_category_ids": [],
        "skip_learning_phase": true,
        "adgroup_app_profile_page_state": null,
        "conversion_bid_price": {{conversion_bid_price}},
        "frequency": null,
        "category_exclusion_ids": [],
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "promotion_website_type": "TIKTOK_NATIVE_PAGE",
        "modify_time": "{{modify_time}}",
        "attribution_event_count": "ONCE",
        "bid_price": 0,
        "pacing": "PACING_MODE_SMOOTH",
        "location_ids": [
            "1733045"
        ],
        "rf_estimated_frequency": null,
        "brand_safety_type": "NO_BRAND_SAFETY",
        "share_disabled": false,
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "schedule_start_time": "{{schedule_start_time}}",
        "auto_targeting_enabled": false,
        "schedule_end_time": "{{schedule_end_time}}",
        "statistic_type": null,
        "schedule_type": "SCHEDULE_START_END",
        "conversion_window": null,
        "app_type": null,
        "languages": [],
        "search_result_enabled": false,
        "is_smart_performance_campaign": false,
        "purchased_impression": null,
        "optimization_goal": "CONVERT",
        "adgroup_name": "{{adgroup_name}}",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "delivery_mode": null,
        "operating_systems": [],
        "is_new_structure": true,
        "app_id": null,
        "is_hfss": false,
        "actions": [],
        "operation_status": "ENABLE",
        "deep_cpa_bid": 0,
        "rf_estimated_cpr": null,
        "interest_keyword_ids": [],
        "comment_disabled": false,
        "budget_mode": "BUDGET_MODE_TOTAL",
        "smart_audience_enabled": null,
        "rf_purchased_type": null,
        "billing_event": "OCPM",
        "click_attribution_window": "SEVEN_DAYS",
        "keywords": null,
        "pixel_id": null,
        "scheduled_budget": 0,
        "isp_ids": [],
        "bid_display_mode": "CPMV",
        "bid_type": "BID_TYPE_CUSTOM",
        "device_price_ranges": null,
        "secondary_optimization_event": null,
        "category_id": "0",
        "frequency_schedule": null,
        "create_time": "{{create_time}}",
        "advertiser_id": "{{advertiser_id}}",
        "creative_material_mode": "CUSTOM",
        "smart_interest_behavior_enabled": null,
        "campaign_name": "{{campaign_name}}",
        "campaign_id": "{{campaign_id}}",
        "budget": {{budget}},
        "brand_safety_partner": null,
        "search_keywords": [
            {
                "match_type": "BROAD_WORD",
                "audit_status": "AUDITING",
                "keyword": "{{keyword}}"
            }
        ],
        "app_download_url": null,
        "purchased_reach": null,
        "audience_ids": [],
        "view_attribution_window": "ONE_DAY",
        "promotion_type": "WEBSITE",
        "optimization_event": "CONSULT",
        "ios14_quota_type": "UNOCCUPIED",
        "video_download_disabled": false,
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "feed_type": null,
        "next_day_retention": null,
        "excluded_audience_ids": [],
        "deep_bid_type": null,
        "age_groups": null
    }
}
(/code)

推广目标为访问量时

| 设置{20%} | 要求{25%} | 参数{20%} | 如何设置该参数{35%} |
|---|---|---|
| 优化位置 <br>(推广对象类型) | 网站 |  `promotion_type` | `WEBSITE` |
| Pixel & 优化事件 | 未启用 | `pixel_id`<br>`optimization_event` | 不传入 |
| 版位 | TikTok 搜索结果。<br>当用户在 TikTok 上搜索与您的关键词相关的词语时，向他们展示您的广告。 | `placement_type`<br>`placements` | 将 `placement_type` 设置为 `PLACEMENT_TYPE_NORMAL`，同时将 `placements` 设置为 `["PLACEMENT_TIKTOK"]`。 |
| 包含搜索结果 | 未启用<br><br><p><span style="color:darkred"><b>重要提示</b></span>: 搜索广告推广系列与[自动搜索广告位](1771747626094593.html)不兼容。搜索广告可将您的信息流广告扩展到 TikTok 搜索结果页面，而搜索广告推广系列专门用于在 TikTok 搜索结果页面投放广告。 | `search_result_enabled` | 不传入（推荐做法）<br>本字段将忽略，默认设置为 `false`。 |
| Pangle 媒体屏蔽列表 | 未启用 | `blocked_pangle_app_ids` | 不传入 |
| 受众定向 <br>&#183; 已保存受众 | 未启用 | `saved_audience_id` | 不传入 |
| 受众定向 <br>&#183; 自动定向 | 未启用 | `auto_targeting_enabled` | 不传入 |
| 受众 <br>&#183; 包含<br>&#183; 排除 | 未启用 | `audience_ids`<br>`excluded_audience_ids` | 不传入 |
| 智能受众 | 未启用 | `smart_audience_enabled` | 不传入 |
| 兴趣与行为<br>&#183; 兴趣| 未启用 | `interest_category_ids`<br>`interest_keyword_ids` | 不传入 |
| 兴趣与行为<br>&#183; 购买意向| 未启用 | `purchase_intention_keyword_ids` | 不传入 |
| 兴趣与行为<br>&#183; 视频互动 & 创作者互动 & 话题互动| 未启用 | `actions` | 不传入 |
| 智能型兴趣和行为 | 未启用 | `smart_interest_behavior_enabled` | 不传入 |
| Pangle 流量包 | 未启用 | `included_pangle_audience_package_ids`<br>`excluded_pangle_audience_package_ids` | 不传入 |
| 定向扩量 | 未启用 | `targeting_expansion` | 不传入 |
| <b>关键词</b> | <b>指定 1 到 1,000 个搜索关键词 </b>| `keyword`<br>`match_type` | 指定 1 到 1,000 个搜索关键词及对应的匹配类型，通过 `keyword` 和 `match_type`。<ul><li>若想获取推荐搜索关键词，可使用 [/tool/search_keyword/recommend/](1838630375757825.html)。</li><li>若想获取搜索关键词的审核结果，需调用 [/adgroup/get](1739314558673922.html)，检查返回的对象数组 `search_keywords` 中的 `audit_status` 字段。</li></ul> |
| 自动关键词 | 需申请白名单才可启用 | `automated_keywords_enabled` | `true` 或 `false`（或不传入）。<br><br><p><span style="color:darkred"><b>注意</b></span>: 搜索广告推广系列中使用自动关键词目前为额外的白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。 |
| 每个关键词和匹配类型组合的单独出价（可选） | 未启用 | `keyword_bid_type`<br>`keyword_bid` | 不传入 |
| 内容相关定向 | 未启用 | `contextual_tag_ids` | 不传入 |
| 品牌安全和适用性<br>&#183; 库存筛选 | 未启用，或启用并设置为以下任一库存类型：<ul><li>扩展</li><li>标准</li><li>有限</li></ul> | `brand_safety_type` | 不传入，或设置为以下任一值：<ul><li>`EXPANDED_INVENTORY`</li><li>`STANDARD_INVENTORY`</li><li>`LIMITED_INVENTORY`</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：搜索广告推广系列中使用库存筛选和类别排除目前为额外的白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。|
| 品牌安全和适用性<br>&#183; 第三方筛选 | 未启用 | `brand_safety_partner` | 不传入 |
| 品牌安全和适用性<br>&#183; 类别排除 | <ul><li>库存筛选设置为扩展层级时：<ul><li>未启用</li></ul></li><li>库存筛选设置为标准或有限层级时：<ul><li>未启用或启用</li></ul></li></ul> | `category_exclusion_ids` | <ul><li>`brand_safety_type` 为 `EXPANDED_INVENTORY` 时：不传入</li><li>`brand_safety_type` 为 `STANDARD_INVENTORY` 或 `LIMITED_INVENTORY` 时：不传入，或指定合法值</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：搜索广告推广系列中使用库存筛选和类别排除目前为额外的白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。|
| 品牌安全和适用性<br>&#183; 行业敏感内容 | 未启用 | `vertical_sensitivity_id` | 不传入 |
| 优化目标 | 点击 | `optimization_goal` | `CLICK` |
| 竞价策略 | 使用以下类型之一：<ul><li>成本上限</li><li>最大投放量</li></ul> | `bid_type`<br>`bid_price` | <ul><li>若想将竞价策略设置为成本上限，需将 `bid_type` 设置为 `BID_TYPE_CUSTOM` 且同时传入 `bid_price`。</li><li>若想将竞价策略设置为最大投放量，需将 `bid_type` 设置为 `BID_TYPE_NO_BID`。无需同时传入 `bid_price`。</li></ul> |
| 计费事件 | CPC | `billing_event` | CPC |
| 投放速度 | 标准 | `pacing` | `PACING_MODE_SMOOTH` |
| 程序化创意 | 未启用 | `creative_material_mode` | `CUSTOM` 或不传入 |
| 拆分对比测试 | 未启用<br><br><p><span style="color:darkred"><b>注意</b></span>: 搜索广告组不支持用于 [/split_test/create/](1742666471475201.html) 创建拆分对比测试。 | / | / |
| 否定关键词 （可选） | 您可同时为该广告组设置至多 10,000 个 [否定关键词](1775103049049090.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}}",
    "promotion_type": "WEBSITE",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "search_result_enabled": false,
    "location_ids": ["1733045"],
    "search_keywords":[
        {
        "keyword":"{{keyword}}",
        "match_type":"BROAD_WORD"
        }
    ],
    "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": "CLICK",
    "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": {
        "adgroup_app_profile_page_state": null,
        "brand_safety_partner": null,
        "category_id": "0",
        "bid_display_mode": "CPMV",
        "skip_learning_phase": false,
        "advertiser_id": "{{advertiser_id}}",
        "age_groups": null,
        "schedule_start_time": "{{schedule_start_time}}",
        "smart_interest_behavior_enabled": null,
        "delivery_mode": null,
        "optimization_goal": "CLICK",
        "keywords": null,
        "campaign_id": "{{campaign_id}}",
        "adgroup_id": "{{adgroup_id}}",
        "brand_safety_type": "NO_BRAND_SAFETY",
        "network_types": [],
        "app_download_url": null,
        "deep_cpa_bid": 0,
        "search_result_enabled": false,
        "pixel_id": null,
        "frequency_schedule": null,
        "statistic_type": null,
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "create_time": "{{create_time}}",
        "frequency": null,
        "interest_category_ids": [],
        "actions": [],
        "feed_type": null,
        "smart_audience_enabled": null,
        "bid_price": {{bid_price}},
        "purchased_reach": null,
        "app_type": null,
        "conversion_window": null,
        "pacing": "PACING_MODE_SMOOTH",
        "audience_ids": [],
        "rf_estimated_cpr": null,
        "billing_event": "CPC",
        "is_new_structure": true,
        "device_price_ranges": null,
        "deep_bid_type": null,
        "schedule_type": "SCHEDULE_START_END",
        "budget": {{}},
        "operation_status": "ENABLE",
        "category_exclusion_ids": [],
        "app_id": null,
        "secondary_optimization_event": null,
        "ios14_quota_type": "UNOCCUPIED",
        "schedule_infos": null,
        "is_smart_performance_campaign": false,
        "campaign_name": "{{campaign_name}}",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "optimization_event": null,
        "search_keywords": [
            {
                "match_type": "BROAD_WORD",
                "keyword": "{{keyword}}",
                "audit_status": "AUDITING",
                "keyword_bid_type": "FOLLOW_ADGROUP",
                "keyword_bid": 12.0
            }
        ],
        "schedule_end_time": "{{schedule_end_time}}",
        "location_ids": [
            "1733045"
        ],
        "isp_ids": [],
        "next_day_retention": null,
        "scheduled_budget": 0,
        "adgroup_name": "{{adgroup_name}}",
        "excluded_audience_ids": [],
        "gender": "GENDER_UNLIMITED",
        "auto_targeting_enabled": false,
        "rf_purchased_type": null,
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "is_hfss": false,
        "comment_disabled": false,
        "conversion_bid_price": 0,
        "creative_material_mode": "CUSTOM",
        "operating_systems": [],
        "purchased_impression": null,
        "video_download_disabled": false,
        "budget_mode": "BUDGET_MODE_TOTAL",
        "interest_keyword_ids": [],
        "bid_type": "BID_TYPE_CUSTOM",
        "share_disabled": false,
        "rf_estimated_frequency": null,
        "promotion_type": "WEBSITE",
        "modify_time": "{{modify_time}}",
        "languages": [],
        "inventory_filter_enabled": false
    }
}
(/code)

推广目标为线索收集时

| 设置{20%} | 要求{25%} | 参数{20%} | 如何设置该参数{35%} |
|---|---|---|
| 优化位置 <br>(推广对象类型) | 选择以下类型之一：<ul><li>落地页</li><li>线索表单</li></ul> | `promotion_type`<br>`promotion_target_type` | <ul><li>将 `promotion_type` 设置为 `LEAD_GENERATION`。</li><li>若要将优化位置设置为落地页，需将 `promotion_target_type` 设置为 `EXTERNAL_WEBSITE`。</li><li>若要将优化位置设置为线索表单，需将 `promotion_target_type` 设置为 `INSTANT_PAGE` 或不传入此字段。</li></ul> |
| Pixel & 优化事件 | <ul><li>若优化位置为落地页，您可同时启用 Pixel 和优化事件，或不启用 Pixel 和优化事件。<ul><li>若启用 Pixel 和优化事件，需将优化目标设置为转化。</li><li>若禁用 Pixel 和优化事件，需将优化目标设置为点击。</li></ul></li><li>若优化位置为线索表单，则不支持启用 Pixel 和优化事件。</li></ul> | `pixel_id`<br>`optimization_event` | <ul><li>若 `promotion_target_type` 设置为 `EXTERNAL_WEBSITE`，您可同时传入 `pixel_id` 和 `optimization_event`，或不传入它们。若想获取 Pixel 及其关联的优化事件，可使用 [/pixel/list/](1740858697598978.html)。<ul><li>若同时传入 `pixel_id` 和 `optimization_event`，将 `optimization_goal` 设置为 `CONVERT`。</li><li>若未传入 `pixel_id` 和 `optimization_event`，将 `optimization_goal` 设置为 `CLICK`。</li></ul></li><li>若 `promotion_target_type` 设置为 `INSTANT_PAGE` 或未传入此字段，则无须传入 `pixel_id` 和 `optimization_event`。</li></ul> |
| 版位 | TikTok 搜索结果。<br>当用户在 TikTok 上搜索与您的关键词相关的词语时，向他们展示您的广告。 | `placement_type`<br>`placements` | 将 `placement_type` 设置为 `PLACEMENT_TYPE_NORMAL`，同时将 `placements` 设置为 `["PLACEMENT_TIKTOK"]`。 |
| 包含搜索结果 | 未启用<br><br><p><span style="color:darkred"><b>重要提示</b></span>: 搜索广告推广系列与[自动搜索广告位](1771747626094593.html)不兼容。搜索广告可将您的信息流广告扩展到 TikTok 搜索结果页面，而搜索广告推广系列专门用于在 TikTok 搜索结果页面投放广告。 | `search_result_enabled` | 不传入（推荐做法）<br>本字段将被忽略并默认设置为 `false`。 |
| Pangle 媒体屏蔽列表 | 未启用 | `blocked_pangle_app_ids` | 不传入 |
| 受众定向 <br>&#183; 已保存受众 | 未启用 | `saved_audience_id` | 不传入 |
| 受众定向 <br>&#183; 自动定向 | 未启用 | `auto_targeting_enabled` | 不传入 |
| 受众 <br>&#183; 包含<br>&#183; 排除 | 未启用 | `audience_ids`<br>`excluded_audience_ids` | 不传入 |
| 智能受众 | 未启用 | `smart_audience_enabled` | 不传入 |
| 兴趣与行为<br>&#183; 兴趣| 未启用 | `interest_category_ids`<br>`interest_keyword_ids` | 不传入 |
| 兴趣与行为<br>&#183; 购买意向| 未启用 | `purchase_intention_keyword_ids` | 不传入 |
| 兴趣与行为<br>&#183; 视频互动 & 创作者互动 & 话题互动| 未启用 | `actions` | 不传入 |
| 智能型兴趣和行为 | 未启用 | `smart_interest_behavior_enabled` | 不传入 |
| Pangle 流量包 | 未启用 | `included_pangle_audience_package_ids`<br>`excluded_pangle_audience_package_ids` | 不传入 |
| 定向扩量 | 未启用 | `targeting_expansion` | 不传入 |
| <b>关键词</b> | <b>指定 1 到 1,000 个搜索关键词 </b>| `keyword`<br>`match_type` | 指定 1 到 1,000 个搜索关键词及对应的匹配类型，通过 `keyword` 和 `match_type`。<ul><li>若想获取推荐搜索关键词，可使用 [/tool/search_keyword/recommend/](1838630375757825.html)。</li><li>若想获取搜索关键词的审核结果，需调用 [/adgroup/get](1739314558673922.html)，检查返回的对象数组 `search_keywords` 中的 `audit_status` 字段。</li></ul> |
| 自动关键词 | 需申请白名单才可启用 | `automated_keywords_enabled` | `true` 或 `false`（或不传入）。<br><br><p><span style="color:darkred"><b>注意</b></span>: 搜索广告推广系列中使用自动关键词目前为额外的白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。 |
| 每个关键词和匹配类型组合的单独出价（可选） | 未启用 | `keyword_bid_type`<br>`keyword_bid` | 不传入 |
| 内容相关定向 | 未启用 | `contextual_tag_ids` | 不传入 |
| 品牌安全和适用性<br>&#183; 库存筛选 | 未启用，或启用并设置为以下任一库存类型：<ul><li>扩展</li><li>标准</li><li>有限</li></ul> | `brand_safety_type` | 不传入，或设置为以下任一值：<ul><li>`EXPANDED_INVENTORY`</li><li>`STANDARD_INVENTORY`</li><li>`LIMITED_INVENTORY`</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：搜索广告推广系列中使用库存筛选和类别排除目前为额外的白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。|
| 品牌安全和适用性<br>&#183; 第三方筛选 | 未启用 | `brand_safety_partner` | 不传入 |
| 品牌安全和适用性<br>&#183; 类别排除 | <ul><li>库存筛选设置为扩展层级时：<ul><li>未启用</li></ul></li><li>库存筛选设置为标准或有限层级时：<ul><li>未启用或启用</li></ul></li></ul> | `category_exclusion_ids` | <ul><li>`brand_safety_type` 为 `EXPANDED_INVENTORY` 时：不传入</li><li>`brand_safety_type` 为 `STANDARD_INVENTORY` 或 `LIMITED_INVENTORY` 时：不传入，或指定合法值</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：搜索广告推广系列中使用库存筛选和类别排除目前为额外的白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。|
| 品牌安全和适用性<br>&#183; 行业敏感内容 | 未启用 | `vertical_sensitivity_id` | 不传入 |
| 优化目标 | <ul><li>若优化位置为落地页，支持的优化事件为点击或转化。</li><li>若优化位置为线索表单，支持的优化目标为线索。</li></ul> | `optimization_goal` | <ul><li>若 `promotion_target_type` 设置为 `EXTERNAL_WEBSITE`，将 `optimization_goal` 设置为 `CONVERT` 或 `CLICK`。</li><li>若 `promotion_target_type` 设置为 `INSTANT_PAGE` 或未传入此字段，将 `optimization_goal` 设置为 `LEAD_GENERATION`。</li></ul> |
| 竞价策略 | <ul><li>若优化位置为落地页且优化目标为转化：<ul><li>成本上限</li></ul></li><li>若优化位置为落地页且优化目标为点击：<ul><li>成本上限或最大投放量</li></ul></li><li>若优化位置为线索表单：<ul><li>成本上限</li></ul></li></ul> | `bid_type`<br>`bid_price`<br>`conversion_bid_price` | <ul><li>若 `promotion_target_type` 设置为 `EXTERNAL_WEBSITE` 且 `optimization_goal` 设置为 `CONVERT`，将 `bid_type` 设置为 `BID_TYPE_CUSTOM` 且同时传入 `conversion_bid_price`。</li><li>若 `promotion_target_type` 设置为 `EXTERNAL_WEBSITE` 且 `optimization_goal` 设置为 `CLICK`：<ul><li>若想将竞价策略设置为成本上限，需将 `bid_type` 设置为 `BID_TYPE_CUSTOM` 且同时传入 `bid_price`。</li><li>若想将竞价策略设置为最大投放量，需将 `bid_type` 设置为 `BID_TYPE_NO_BID`。无需传入 `bid_price` 和 `conversion_bid_price`。</li></ul></li><li>若 `promotion_target_type` 设置为 `INSTANT_PAGE` 或未传入此字段，将 `bid_type` 设置为 `BID_TYPE_CUSTOM` 且同时传入 `conversion_bid_price`。</li></ul> |
| 计费事件 | <ul><li>若优化目标为转化或线索，支持的计费事件为 oCPM。</li><li>若优化目标为点击，支持的计费事件为 CPC。</li></ul> | `billing_event` | <ul><li>若 `optimization_goal` 设置为 `CONVERT` 或 `LEAD_GENERATION`，将 `billing_event` 设置为 `OCPM`。</li><li>若 `optimization_goal` 设置为 `CLICK`，将 `billing_event` 设置为 `CPC`。</li></ul> |
| 投放速度 | 标准 | `pacing` | `PACING_MODE_SMOOTH` |
| 程序化创意 | 未启用 | `creative_material_mode` | `CUSTOM` 或不传入 |
| 拆分对比测试 | 未启用<br><br><p><span style="color:darkred"><b>注意</b></span>: 搜索广告组不支持用于 [/split_test/create/](1742666471475201.html) 创建拆分对比测试。 | / | / |
| 否定关键词 （可选） | 您可同时为该广告组设置至多 10,000 个 [否定关键词](1775103049049090.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}}",
    "promotion_type": "LEAD_GENERATION",
    "promotion_target_type":"EXTERNAL_WEBSITE",
    "pixel_id":"{{pixel_id}}",
    "optimization_event":"ON_WEB_DETAIL",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["6252001"],
    "search_keywords":[
        {
        "keyword":"{{keyword}}",
        "match_type":"BROAD_WORD"
        }
    ],
    "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": "CONVERT",
    "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": {
        "location_ids": [
            "6252001"
        ],
        "device_price_ranges": null,
        "click_attribution_window": "SEVEN_DAYS",
        "keywords": null,
        "isp_ids": [],
        "inventory_filter_enabled": false,
        "smart_interest_behavior_enabled": null,
        "interest_keyword_ids": [],
        "video_download_disabled": false,
        "adgroup_app_profile_page_state": null,
        "app_download_url": null,
        "purchased_reach": null,
        "creative_material_mode": "CUSTOM",
        "skip_learning_phase": true,
        "search_keywords": [
            {
                "audit_status": "AUDITING",
                "keyword": "{{keyword}}",
                "match_type": "BROAD_WORD"
            }
        ],
        "is_smart_performance_campaign": false,
        "operation_status": "ENABLE",
        "app_id": null,
        "rf_estimated_cpr": null,
        "pixel_id": "{{pixel_id}}",
        "campaign_name": "{{campaign_name}}",
        "statistic_type": null,
        "budget_mode": "BUDGET_MODE_TOTAL",
        "search_result_enabled": false,
        "schedule_infos": null,
        "ios14_quota_type": "UNOCCUPIED",
        "schedule_start_time": "{{schedule_start_time}}",
        "campaign_id": "{{campaign_id}}",
        "operating_systems": [],
        "actions": [],
        "delivery_mode": null,
        "comment_disabled": false,
        "frequency": null,
        "audience_ids": [],
        "adgroup_name": "{{adgroup_name}}",
        "scheduled_budget": 0,
        "secondary_optimization_event": null,
        "optimization_goal": "CONVERT",
        "gender": "GENDER_UNLIMITED",
        "network_types": [],
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "rf_estimated_frequency": null,
        "conversion_window": null,
        "frequency_schedule": null,
        "deep_bid_type": null,
        "app_type": null,
        "is_hfss": false,
        "billing_event": "OCPM",
        "smart_audience_enabled": null,
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "attribution_event_count": "ONCE",
        "conversion_bid_price": {{conversion_bid_price}},
        "languages": [],
        "category_id": "0",
        "adgroup_id": "{{adgroup_id}}",
        "category_exclusion_ids": [],
        "budget": {{budget}},
        "pacing": "PACING_MODE_SMOOTH",
        "schedule_end_time": "{{schedule_end_time}}",
        "deep_cpa_bid": 0,
        "bid_display_mode": "CPMV",
        "promotion_type": "LEAD_GENERATION",
        "optimization_event": "ON_WEB_DETAIL",
        "is_new_structure": true,
        "auto_targeting_enabled": false,
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "next_day_retention": null,
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "schedule_type": "SCHEDULE_START_END",
        "advertiser_id": "{{advertiser_id}}",
        "age_groups": null,
        "purchased_impression": null,
        "brand_safety_partner": null,
        "view_attribution_window": "ONE_DAY",
        "modify_time": "{{modify_time}}",
        "bid_price": 0,
        "promotion_target_type": "EXTERNAL_WEBSITE",
        "create_time": "{{create_time}}",
        "bid_type": "BID_TYPE_CUSTOM",
        "share_disabled": false,
        "brand_safety_type": "NO_BRAND_SAFETY",
        "rf_purchased_type": null,
        "excluded_audience_ids": [],
        "interest_category_ids": [],
        "feed_type": null
    }
}
(/code)
优化位置为线索表单且优化目标为线索量

请求

(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}}",
    "promotion_type": "LEAD_GENERATION",
    "promotion_target_type":"INSTANT_PAGE",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": ["PLACEMENT_TIKTOK"],
    "location_ids": ["6252001"],
    "search_keywords":[
        {
        "keyword":"{{keyword}}",
        "match_type":"BROAD_WORD"
        }
    ],
    "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": "LEAD_GENERATION",
    "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": {
        "audience_ids": [],
        "actions": [],
        "brand_safety_type": "NO_BRAND_SAFETY",
        "campaign_id": "{{campaign_id}}",
        "share_disabled": false,
        "next_day_retention": null,
        "rf_estimated_frequency": null,
        "is_new_structure": true,
        "search_keywords": [
            {
                "keyword": "{{keyword}}",
                "audit_status": "AUDITING",
                "match_type": "BROAD_WORD"
            }
        ],
        "adgroup_id": "{{adgroup_id}}",
        "adgroup_name": "{{adgroup_name}}",
        "frequency_schedule": null,
        "campaign_name": "{{campaign_name}}",
        "smart_audience_enabled": null,
        "delivery_mode": null,
        "operating_systems": [],
        "deep_bid_type": null,
        "pixel_id": null,
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "attribution_event_count": "ONCE",
        "conversion_bid_price": {{conversion_bid_price}},
        "gender": "GENDER_UNLIMITED",
        "smart_interest_behavior_enabled": null,
        "statistic_type": null,
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "pacing": "PACING_MODE_SMOOTH",
        "optimization_goal": "LEAD_GENERATION",
        "is_hfss": false,
        "bid_type": "BID_TYPE_CUSTOM",
        "search_result_enabled": false,
        "schedule_end_time": "{{schedule_end_time}}",
        "advertiser_id": "{{advertiser_id}}",
        "feed_type": null,
        "deep_cpa_bid": 0,
        "schedule_infos": null,
        "app_download_url": null,
        "rf_estimated_cpr": null,
        "age_groups": [
            "AGE_18_24",
            "AGE_25_34",
            "AGE_35_44",
            "AGE_45_54",
            "AGE_55_100"
        ],
        "languages": [],
        "adgroup_app_profile_page_state": null,
        "bid_price": 0,
        "promotion_type": "LEAD_GENERATION",
        "promotion_target_type": "INSTANT_PAGE",
        "operation_status": "ENABLE",
        "scheduled_budget": 0,
        "modify_time": "{{modify_time}}",
        "app_id": null,
        "video_download_disabled": false,
        "is_smart_performance_campaign": false,
        "schedule_type": "SCHEDULE_START_END",
        "category_id": "0",
        "location_ids": [
            "6252001"
        ],
        "bid_display_mode": "CPMV",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "secondary_optimization_event": null,
        "network_types": [],
        "schedule_start_time": "{{schedule_start_time}}",
        "auto_targeting_enabled": false,
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "comment_disabled": false,
        "brand_safety_partner": null,
        "optimization_event": "FORM",
        "frequency": null,
        "purchased_reach": null,
        "purchased_impression": null,
        "isp_ids": [],
        "interest_category_ids": [],
        "ios14_quota_type": "UNOCCUPIED",
        "category_exclusion_ids": [],
        "billing_event": "OCPM",
        "rf_purchased_type": null,
        "keywords": null,
        "view_attribution_window": "ONE_DAY",
        "creative_material_mode": "CUSTOM",
        "click_attribution_window": "SEVEN_DAYS",
        "interest_keyword_ids": [],
        "skip_learning_phase": true,
        "inventory_filter_enabled": false,
        "app_type": null,
        "excluded_audience_ids": [],
        "device_price_ranges": null,
        "create_time": "{{create_time}}",
        "budget": {{budget}},
        "conversion_window": null
    }
}
(/code)

3. 创建广告

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

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

不支持将 is_smart_creative 传入 /ad/aco/create/ 创建开启智能创意的搜索广告。		 / /
认证身份
（广告发布身份）		 以下任意选项：
  • 自定义用户（自定义身份）
  • 授权用户
  • TikTok 用户
  • 添加到商务中心的 TikTok 用户
 identity_type 以下任意值：
  • CUSTOMIZED_USER
  • AUTH_CODE
  • TT_USER
  • BC_AUTH_TT
identity_id 传入合法值

若想获取广告账号下的认证身份，可使用 /identity/get/。
identity_authorized_bc_id 若 identity_type 设置为 BC_AUTH_TT，需传入合法值。
广告样式 以下任一选项：
  • 单视频
  • 轮播图片
 ad_format 以下任一值：
  • SINGLE_VIDEO
  • CAROUSEL_ADS
创意素材 广告样式为单视频时：
  • 使用 TikTok 用户身份或添加到商务中心的 TikTok 用户身份推送帖子创建 Spark Ads 或使用自定义用户身份时，需指定视频和视频封面。
  • 使用 TikTok 用户身份或添加到商务中心的 TikTok 用户身份提取帖子创建 Spark Ads 或使用授权用户身份时，需指定 TikTok 视频帖子。

广告样式为轮播图片时：
  • 遵循创建标准轮播广告的步骤中的指引。

注意:

  • 对于非 Spark Ads，您可指定只多 5 个广告文案，从而启用智能多标题广告文案功能。系统将自动将相关性最强的文案展示给受众并优化文案效果。
 video_id
image_ids
ad_text
ad_texts
tiktok_item_id
dark_post_status		 当 ad_format 为 SINGLE_VIDEO 时：
  • 若 identity_type 设置为 CUSTOMIZED_USER，需指定视频（video_id），视频封面（image_ids），和单个广告文案（ad_text）或多个广告文案（ad_texts）。无需传入 tiktok_item_id。
  • 若 identity_type 设置为 TT_USER 或 BC_AUTH_TT，您可通过推送帖子或提取帖子创建 Spark Ads：
    • 推送帖子创建 Spark Ads：需指定视频（video_id），视频封面（image_ids），和广告文案（ad_text）。无需传入 tiktok_item_id。您可以把 dark_post_status 设置为 ON，从而确保视频仅发布为广告，而不会作为原生视频发布到 TikTok 账号中。
    • 提取帖子创建 Spark Ads：需通过 tiktok_item_id 指定 TikTok 视频帖子。无需传入 video_id，image_ids，ad_text 和 dark_post_status。
    • 若想了解 Spark Ads 详情，请查看 创建 Spark Ads。
  • 若 identity_type 设置为 AUTH_CODE，需通过 tiktok_item_id 指定 TikTok 视频帖子。无需传入 video_id，image_ids 及 ad_text。

当 ad_format 为 CAROUSEL_ADS 时，请查看 创建标准轮播广告的步骤，了解如何创建标准轮播广告。
行动引导文案 设置对应文案 call_to_action
call_to_action_id		 为 call_to_action 或 call_to_action_id 传入合法值。
创新互动样式（对于单视频广告可选）
  • 当广告样式为单视频时，仅支持展示卡片。
  • 当广告样式为轮播图片时，不支持使用创新互动样式。
 card_id 当 ad_format 为 SINGLE_VIDEO 时：不传入，或设置一个展示卡片 ID。
若想创建创意素材包，可使用 /creative/portfolio/create/。
若想了解如何获取展示卡片的 ID，请参考 卡片。

当 ad_format 为 CAROUSEL_ADS 时：不传入。
目标页面
  • 当推广目标为网站转化量时：
    • 若广告组层级优化位置设置为网站，目标页面可设置为网站 URL 或 TikTok 即时体验页面。
    • 若广告组层级优化位置设置为 TikTok 即时体验页面，目标页面仅可设置为 TikTok 即时体验页面。
  • 推广目标为访问量时，目标页面可设置为网站 URL 或 TikTok 即时体验页面。
  • 当推广目标为线索收集时：
    • 若广告组层级优化位置设置为落地页，目标页面可设置为网站 URL 或 TikTok 即时体验页面。
    • 若广告组层级优化位置设置为线索表单，目标页面仅可设置为线索表单。
 landing_page_url
page_id
creative_type
  • 当 objective_type 设置为 WEB_CONVERSIONS 时：
    • 若广告组层级 promotion_website_type 设置为 UNSET 或未传入，您需通过 landing_page_url 指定网站 URL，或通过 page_id 指定 TikTok 即时体验页面。若想筛选您的广告账户下的 TikTok 即时体验页面，可使用 /page/get/。需传入 advertiser_id 并将 business_type 设置为 TIKTOK_INSTANT_PAGE。
    • 若 promotion_website_type 设置为 TIKTOK_NATIVE_PAGE，您需通过 page_id 指定 TikTok 即时体验页面。
      • 若需传入 page_id，您可以省略 creative_type，默认设置为 CUSTOM_INSTANT_PAGE，也可以手动设置 creative_type 为 CUSTOM_INSTANT_PAGE。
  • 当 objective_type 设置为 TRAFFIC 时，您需通过 landing_page_url 指定网站 URL，或通过 page_id 指定 TikTok 即时体验页面。
    • 若想筛选您的广告账户下的 TikTok 即时体验页面，可使用 /page/get/。需传入 advertiser_id 并将 business_type 设置为 TIKTOK_INSTANT_PAGE。
  • 当 objective_type 设置为 LEAD_GENERATION 时：
    • 若广告组层级 promotion_target_type 设置为 EXTERNAL_WEBSITE，您需通过 landing_page_url 指定网站 URL，或通过 page_id 指定 TikTok 即时体验页面。
      • 若想筛选您的广告账户下的 TikTok 即时体验页面，可使用 /page/get/。需传入 advertiser_id，并将 business_type 设置为 TIKTOK_INSTANT_PAGE。
    • 若 promotion_target_type 设置为 INSTANT_PAGE 或未传入此字段，您需通过 page_id 指定可投放的线索表单。
      • 若想筛选您的广告账户下可投放的线索表单，可使用 /page/get/。需传入 advertiser_id，设置 business_type 为 LEAD_GEN，并设置 status 为 PUBLISHED。
第三方可见性监测 未启用 viewability_postbid_partner
viewability_vast_url		 不传入
通过第三方合作伙伴测评品牌安全性 未启用 brand_safety_postbid_partner
brand_safety_vast_url		 不传入

示例

目标页面为网站 URL 且广告样式为非 Spark Ads 的单视频广告

请求

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

目标页面为网站 URL 且广告样式为非 Spark Ads 的轮播图片广告

请求

(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_id":"{{identity_id}}",
        "identity_type":"CUSTOMIZED_USER",
        "ad_format": "CAROUSEL_ADS",
        "image_ids": [
              "{{image_id}}",
              "{{image_id}}"
         ],
        "music_id": "{{music_id}}",    
        "ad_text": "{{ad_text}}",
        "call_to_action": "SHOP_NOW",
        "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_text": "{{ad_text}}",
                "campaign_name": "{{campaign_name}}",
                "carousel_image_labels": null,
                "ad_format": "CAROUSEL_ADS",
                "is_new_structure": true,
                "landing_page_url": "{{landing_page_url}}",
                "click_tracking_url": null,
                "creative_type": null,
                "operation_status": "ENABLE",
                "call_to_action_id": null,
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}"
                ],
                "brand_safety_vast_url": null,
                "identity_id": "{{identity_id}}",
                "card_id": null,
                "deeplink_type": "NORMAL",
                "adgroup_id": "{{adgroup_id}}",
                "ad_name": "{{ad_name}}",
                "viewability_postbid_partner": "UNSET",
                "viewability_vast_url": null,
                "call_to_action": "SHOP_NOW",
                "modify_time": "{{modify_time}}",
                "app_name": "",
                "deeplink": "",
                "image_ids": [
                    "{{image_id}}",
                    "{{image_id}}"
                ],
                "is_aco": false,
                "campaign_id": "{{campaign_id}}",
                "creative_authorized": false,
                "landing_page_urls": null,
                "fallback_type": "UNSET",
                "adgroup_name": "{{adgroup_name}}",
                "profile_image_url": "{{profile_image_url}}",
                "vast_moat_enabled": false,
                "tracking_pixel_id": 0,
                "display_name": "{{display_name}}",
                "identity_type": "CUSTOMIZED_USER",
                "create_time": "{{create_time}}",
                "advertiser_id": "{{advertiser_id}}",
                "page_id": null,
                "impression_tracking_url": null,
                "video_id": null,
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "playable_url": "",
                "ad_texts": null,
                "music_id": "{{music_id}}",
                "ad_id": "{{ad_id}}",
                "optimization_event": null
            }
        ]
    }
}
(/code)

目标页面为 TikTok 即时体验页面且广告样式为非 Spark Ads 的单视频广告

请求

(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": "{{dvertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [{
        "ad_name": "{{ad_name}}",
        "identity_id":"{{identity_id}}",
        "identity_type":"CUSTOMIZED_USER",
        "ad_format": "SINGLE_VIDEO",
        "video_id":"{{identity_id}}",
        "image_ids":["{{image_id}}"],
        "ad_text": "{{ad_text}}",
        "call_to_action": "SHOP_NOW",
        "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": [
            {
                "viewability_vast_url": null,
                "ad_id": "{{ad_id}}",
                "adgroup_id": "{{adgroup_id}}",
                "card_id": null,
                "vast_moat_enabled": false,
                "impression_tracking_url": null,
                "modify_time": "{{modify_time}}",
                "profile_image_url": "{{profile_image_url}}",
                "playable_url": "",
                "ad_ref_pixel_id": {{ad_ref_pixel_id}},
                "fallback_type": "UNSET",
                "is_aco": false,
                "call_to_action": "SHOP_NOW",
                "image_ids": [
                    "{{image_id}}"
                ],
                "ad_format": "SINGLE_VIDEO",
                "app_name": "",
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}"
                ],
                "page_id": {{page_id}},
                "is_new_structure": true,
                "landing_page_urls": null,
                "display_name": "{{display_name}}",
                "operation_status": "ENABLE",
                "deeplink": null,
                "call_to_action_id": null,
                "identity_type": "CUSTOMIZED_USER",
                "creative_authorized": false,
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "ad_texts": null,
                "identity_id": "{{identity_id}}",
                "create_time": "{{create_time}}",
                "advertiser_id": "{{advertiser_id}}",
                "landing_page_url": "",
                "music_id": null,
                "campaign_name": "{{campaign_name}}",
                "campaign_id": "{{campaign_id}}",
                "brand_safety_vast_url": null,
                "adgroup_name": "{{adgroup_name}}",
                "video_id": "{{video_id}}",
                "ad_name": "{{ad_name}}",
                "tracking_pixel_id": 0,
                "viewability_postbid_partner": "UNSET",
                "creative_type": "CUSTOM_INSTANT_PAGE",
                "optimization_event": "CONSULT",
                "ad_text": "{{ad_text}}",
                "click_tracking_url": null
            }
        ]
    }
}
(/code)

目标页面为线索表单（推广目标为线索收集且优化位置为线索表单时）且广告样式为非 Spark Ads 的单视频广告

请求

(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_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",
        "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": [
            {
                "deeplink": null,
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}",
                "vast_moat_enabled": false,
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}",
                    "{{tracking_offline_event_set_id}}"
                ],
                "is_aco": false,
                "ad_text": "{{ad_text}}",
                "profile_image_url": "{{profile_image_url}}",
                "brand_safety_vast_url": null,
                "tracking_pixel_id": 0,
                "call_to_action_id": null,
                "ad_format": "SINGLE_VIDEO",
                "ad_name": "{{ad_name}}",
                "creative_authorized": false,
                "video_id": "{{video_id}}",
                "identity_type": "CUSTOMIZED_USER",
                "call_to_action": "SHOP_NOW",
                "carousel_image_labels": null,
                "is_new_structure": true,
                "creative_type": "LEAD_ADS",
                "campaign_name": "{{campaign_name}}",
                "viewability_postbid_partner": "UNSET",
                "card_id": null,
                "landing_page_url": null,
                "ad_texts": null,
                "music_id": null,
                "click_tracking_url": null,
                "impression_tracking_url": null,
                "campaign_id": "{{campaign_id}}",
                "landing_page_urls": null,
                "display_name": "{{display_name}}",
                "modify_time": "{{modify_time}}",
                "adgroup_name": "{{adgroup_name}}",
                "create_time": "{{create_time}}",
                "identity_id": "{{identity_id}}",
                "ad_id": "{{ad_id}}",
                "app_name": "",
                "adgroup_id": "{{adgroup_id}}",
                "image_ids": [
                    "{{image_id}}"
                ],
                "viewability_vast_url": null,
                "ad_ref_pixel_id": {{ad_ref_pixel_id}},
                "advertiser_id": "{{advertiser_id}}",
                "playable_url": "",
                "operation_status": "ENABLE",
                "optimization_event": "FORM",
                "page_id": {{page_id}}
            }
        ]
    }
}
(/code)

后续步骤

在报表 API 中使用搜索广告推广系列相关功能

创建搜索广告后，您可以使用报表 API 通过基础报表中的 search_keyword 维度检索按搜索关键词分组的数据或通过 match_type 维度检索按匹配类型分组的数据。

相关文档

← 创建启用网站和应用优化的手动非商品库广告创建 Spark Ads →

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