← 返回目录
📁 Use Cases › Campaign creation › Create Shopping Ads

创建直播购物广告

本文介绍了创建直播购物广告的步骤。

重要提示
自 2025 年第三季度起， GMV Max 将成为 TikTok 店铺广告的默认且唯一支持的推广系列类型。如果您使用商品销量推广目标并选择 TikTok Shop 作为销售目标页面创建广告，则将无法再使用 API 创建、编辑或复制直播购物广告、商品购物广告 或视频购物广告。请尽早迁移至 GMV Max API。如有任何问题或需要支持，请联系您的 TikTok 销售代表。了解按广告类型和接口划分的具体变动。

支持的市场

请查看下表，了解视频购物广告可用于定向的国家或地区。

| 国家或地区代码 {20%}| 市场{60%} |
|---|---|
| `GB` | 英国 |
| `ID` | 印度尼西亚 |
| `MY` | 马来西亚 |
| `PH` | 菲律宾 |
| `SG` | 新加坡 |
| `TH` | 泰国 |
| `US` | 美国 |
| `VN` | 越南 |

步骤

1.创建推广系列

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

设置 要求 参数 如何设置该参数
推广目标 商品销量 objective_type PRODUCT_SALES
Smart+ 推广系列 未启用

不支持使用/campaign/spc/create/创建启用 Smart+ 推广系列设置的直播购物推广系列。		 / /
iOS 14 专属推广系列 未启用 campaign_type REGULAR_CAMPAIGN 或不传入
app_id 不传入
campaign_app_profile_page_state 不传入
商品来源
（商品数据源）		 TikTok Shop campaign_product_source STORE
特殊广告分类（可选） 需申请白名单才可启用 special_industries 传入合法值，或不传入

注意：在推广系列商品来源为 TikTok Shop 的购物广告中使用特殊广告分类目前为白名单功能。如需使用这些功能，请联系您的TikTok销售代表。
推广系列预算优化 未启用 budget_optimize_on false或不传入
推广系列预算类型 以下任意类型：
  • 日预算
  • 总预算
  • 不限预算
 budget_mode 以下任意值：
  • BUDGET_MODE_DAY
  • BUDGET_MODE_TOTAL
  • BUDGET_MODE_INFINITE

示例

请求

(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": "PRODUCT_SALES",
    "campaign_name": "{{campaign_name}}",
    "campaign_product_source":"STORE",
    "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": {
        "objective": "LANDING_PAGE",
        "is_smart_performance_campaign": false,
        "deep_bid_type": null,
        "campaign_app_profile_page_state": "UNSET",
        "campaign_product_source": "STORE",
        "secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "roas_bid": 0,
        "is_search_campaign": false,
        "campaign_id": "{{campaign_id}}",
        "is_new_structure": true,
        "create_time": "{{create_time}}",
        "operation_status": "ENABLE",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "advertiser_id": "{{advertiser_id}}",
        "campaign_name": "{{campaign_name}}",
        "budget": {{budget}},
        "objective_type": "PRODUCT_SALES",
        "campaign_type": "REGULAR_CAMPAIGN",
        "modify_time": "{{modify_time}}"
    }
}
(/code)

2.创建、管理 TikTok Shop

注意

  • 若指定 TikTok Shop，将会报告此商店的商品销量。
  • 若不指定 TikTok Shop，我们将会报告 TikTok 账号展示的商品的销量。若您不想指定 TikTok Shop，请跳至第 3 步。

TikTok Commerce 为希望利用 TikTok 账户直接销售商品的品牌和卖家提供了直接集成（TikTok Shop）。

直接集成可以通过在 TikTok 商家中心创建 TikTok Shop 进行设置。欲了解如何创建 TikTok Shop，请查看这里。

TikTok Shop 创建完成后, 请遵守以下步骤： - i. 将 TikTok Shop 添加至商务中心。欲了解如何从商务中心请求 TikTok Shop 的权限，请查看这里。 - ii. （可选步骤）使用/bc/member/invite/接口邀请成员加入商务中心，并授予管理员权限。您可以同时为受邀成员指定advertiser_role。 - iii. （可选步骤）使用/bc/asset/assign/接口将 TikTok Shop 共享给商务中心成员，并授予管理权限。请确保将asset_type字段设置为TIKTOK_SHOP，且将store_role字段设置为 AD_PROMOTION。

## 3.创建广告组

设置 要求 参数 如何设置该参数
购物广告类型 直播购物广告 shopping_ads_type LIVE
认证身份
（广告发布身份）		 请选择一个 TikTok 账号作为您用于直播的身份。当该账号在广告排期内开始直播时，您的广告将开始投放。 identity_type 以下任意值：
  • TT_USER
  • BC_AUTH_TT

注意：若设置为BC_AUTH_TT, 您需拥有该 TikTok 账户的使用现有的帖子投放广告权限。
identity_id 请选择一个 TikTok 账号作为您用于直播的身份。

若想获取广告账户下的认证身份列表，请使/identity/get/。
identity_authorized_bc_id identity_type设置为BC_AUTH_TT 时传入合法值
商品来源
（商品数据源）		 未启用 product_source 不传入
商店 （可选） 指定或不指定

  • 若指定 TikTok Shop，将会报告此商店的商品销量。
    若想了解如何管理 TikTok Shop，请查看第 2 步。
  • 若不指定 TikTok Shop，我们将会报告 TikTok 账号展示的商品的销量。
  • store_id
  • store_authorized_bc_id
  • catalog_id
 传入合法值，或不传入
您可使用 /store/list/获取广告账户下可用商店对应的 store_id，store_authorized_bc_id和catalog_id。

注意：自 2024 年 6 月 30 日起，您将无需再传入catalog_id，因为该字段将被忽略。
catalog_authorized_bc_id 不传入
推广对象
（优化位置）		 未设置。
默认设置为直播内容。		 promotion_type LIVE_SHOPPING
推广的网站或应用 未启用
  • app_id
  • pixel_id
 不传入
版位
（广告位）		 编辑广告位，且版位仅为 TikTok placement_type PLACEMENT_TYPE_NORMAL
placements ["PLACEMENT_TIKTOK"]
包含搜索结果 未启用 search_result_enabled false 或不传入
视频共享 启用 share_disabled false 或不传入
Pangle 媒体屏蔽列表 未启用 blocked_pangle_app_ids 不传入
受众定向
  • 已保存受众
 未启用 saved_audience_id 不传入
受众定向
  • 自动定向
 未启用 auto_targeting_enabled 不传入
受众定向
  • 对受众再营销
 未启用
  • shopping_ads_retargeting_type
  • shopping_ads_retargeting_actions_days
  • included_custom_actions
  • excluded_custom_actions
  • shopping_ads_retargeting_custom_audience_relation
 不传入
受众定向
  • 人群属性 - 消费能力
 未启用 spending_power 不传入
受众定向
  • 兴趣与行为 - 购买意向
 未启用 purchase_intention_keyword_ids 不传入
受众定向
  • 受众
    • 智能受众
 未启用 smart_audience_enabled 不传入
受众定向
  • 兴趣与行为
    • 智能型兴趣和行为
 未启用 smart_interest_behavior_enabled 不传入
受众定向
  • Pangle 流量包
 未启用
  • included_pangle_audience_package_ids
  • excluded_pangle_audience_package_ids
 不传入
受众定向
  • 定向扩量
 未启用 targeting_expansion 不传入
内容相关定向 未启用 contextual_tag_ids 不传入
内容排除
  • 库存筛选
 需申请白名单才可启用 brand_safety_type 传入合法值（EXPANDED_INVENTORY，STANDARD_INVENTORY 或 LIMITED_INVENTORY），或不传入

注意：直播购物广告中的 TikTok 库存筛选目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。
brand_safety_partner 不传入
内容排除
  • 类别排除
 未启用 category_exclusion_ids 不传入
内容排除
  • 行业敏感内容控制
 未启用 vertical_sensitivity_id 不传入
排期 指定一个与实际直播时间吻合的排期，从而保证最佳广告投放效果。
需注意仅当卖家（ TikTok 账号）在广告排期内开始直播时，您的广告才开始投放。
  • 例如，若推广系列的排期为今天下午 1 点至 11 点，但卖家直播时间为下午 2 点至 4 点及下午 10 点至 11 点，则推广系列投放时间即为下午 2 点至 4 点及下午 10 点至 11 点这两个时间段。
  • schedule_type
  • schedule_start_time
  • schedule_end_time
 指定一个与实际直播时间吻合的排期
优化目标 以下任意目标：
  • 总收入（推荐）
  • 付费数（推荐）
  • 开始结账数
  • 直播中商品点击数
  • 观众留存率
  • 点击数
  • optimization_goal
  • optimization_event
 以下任意设置：
  • optimization_goal设置为 VALUE 且 optimization_event设置为SHOPPING
  • optimization_goal设置为CONVERT 且 optimization_event设置为SHOPPING
  • optimization_goal设置为CONVERT 且 optimization_event设置为INITIATE_ORDER
  • optimization_goal设置为PRODUCT_CLICK_IN_LIVE 且 optimization_event设置为LIVE_CLICK_PRODUCT_ACTION
  • optimization_goal设置为MT_LIVE_ROOM 且 optimization_event设置为LIVE_STAY_TIME
  • optimization_goal设置为CLICK
频次上限 未启用
  • frequency
  • frequency_schedule
 不传入
竞价策略
  • 优化目标为付费数、开始结账数、直播中商品点击数、观众留存率或点击数时，可设置为以下任意策略：
    • 最大投放量：尽量消耗你的全部预算，以取得最多成效。
    • 目标 CPA 或成本上限：将广告的平均成效成本保持在某个特定值。
  • 优化目标为总收入时，可设置为以下任意策略：
    • 最高总收入：尽量消耗你的全部预算，以获得最多的总收入。
    • 目标 ROAS：将广告的平均 ROAS 保持在某个特定值。
  • bid_type
  • bid_price
  • conversion_bid_price
  • deep_bid_type
  • roas_bid
  • optimization_goal 为 CONVERT，PRODUCT_CLICK_IN_LIVE，MT_LIVE_ROOM 或 CLICK时：
    • 需将 bid_type 设置为 BID_TYPE_CUSTOM 或 BID_TYPE_NO_BID（最大投放量）。不可传入deep_bid_type 和 roas_bid。
      • optimization_goal 为 CONVERT，PRODUCT_CLICK_IN_LIVE 或 MT_LIVE_ROOM 且 bid_type 为 BID_TYPE_CUSTOM （目标 CPA） 时，需同时传入conversion_bid_price。
      • optimization_goal 为 CLICK 且 bid_type 为 BID_TYPE_CUSTOM（成本上限）时，需同时传入bid_price。
  • optimization_goal 为 VALUE时：
    • 需将 deep_bid_type 设置为 VO_MIN_ROAS 或 VO_HIGHEST_VALUE，且同时将 bid_type 设置为 BID_TYPE_NO_BID。不可同时传入 conversion_bid_price 或 bid_price。
      • 若 deep_bid_type 设置为 VO_MIN_ROAS，还需同时传入 roas_bid 。
归因设置
（仅当优化目标为总收入、付费数、开始结账数、直播中商品点击数或观众留存率时支持）
  • 优化目标为总收入、付费数、开始结账数时，支持的点击归因窗口期为：
    • 1天（点击）
    • 7天（点击）
    • 14天（点击）
    • 28天（点击）
  • 优化目标为直播中商品点击数或观众留存率时，支持的点击归因窗口期为 7天（点击）。
 click_attribution_window
  • optimization_goal 为 VALUE 或 CONVERT时，支持的值为：
    • ONE_DAY
    • SEVEN_DAYS
    • FOURTEEN_DAYS
    • TWENTY_EIGHT_DAYS
  • optimization_goal 为 PRODUCT_CLICK_IN_LIVE 或 MT_LIVE_ROOM时，支持的值为SEVEN_DAYS。
  • 优化目标为总收入、付费数、开始结账数时，支持的点击归因窗口期为：
    • 关闭
    • 1天（展示）
    • 7天（展示）
  • 优化目标为直播中商品点击数或观众留存率时，支持的点击归因窗口期为 1天（展示）。
 view_attribution_window
  • optimization_goal 为 VALUE 或 CONVERT时，支持的值为
    • OFF
    • ONE_DAY
    • SEVEN_DAYS
  • optimization_goal 为 PRODUCT_CLICK_IN_LIVE 或 MT_LIVE_ROOM时，支持的值为ONE_DAY。
事件统计方式：仅一次 attribution_event_count ONCE 或不传入
计费事件
（计费点）
  • 若优化目标为点击数，计费事件需为 CPC。
  • 若优化目标为总收入、付费数、开始结账数、直播中商品点击数或观众留存率，计费事件需为 oCPM。
 billing_event
  • optimization_goal 为 CLICK时，本字段需设置为 CPC。
  • optimization_goal 为 VALUE，CONVERT，PRODUCT_CLICK_IN_LIVE 或 MT_LIVE_ROOM时，本字段需设置为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。
程序化创意 未启用 creative_material_mode CUSTOM 或不传入
拆分对比测试 未启用。

直播购物广告组不支持用于/split_test/create/ 创建拆分对比测试。		 / /

示例

优化目标设置为总收入（同时指定 TikTok Shop ）

请求

(code)
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}}",
    "shopping_ads_type": "LIVE", 
    "identity_type": "TT_USER", 
    "identity_id": "{{identity_id}}",
    "store_id":"{{store_id}}",
    "store_authorized_bc_id":"{{store_authorized_bc_id}}",
    "catalog_id":"{{catalog_id}}",
    "promotion_type": "LIVE_SHOPPING",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": [
        "PLACEMENT_TIKTOK"
    ],
    "location_ids": [
        "1643084"
    ],
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    <span style="background-color: green;">"optimization_goal": "VALUE",
    "optimization_event": "SHOPPING",</span>
    "bid_type": "BID_TYPE_NO_BID",
    "deep_bid_type": "VO_MIN_ROAS",
    "roas_bid": {{roas_bid}},
    "billing_event": "OCPM",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

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

优化目标设置为付费数

请求

(code)
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}}",
    "shopping_ads_type": "LIVE", 
    "identity_type": "TT_USER", 
    "identity_id": "{{identity_id}}",
    "promotion_type": "LIVE_SHOPPING",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": [
        "PLACEMENT_TIKTOK"
    ],
    "location_ids": [
        "1643084"
    ],
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    <span style="background-color: green;">"optimization_goal": "CONVERT",
    "optimization_event": "SHOPPING",</span>
    "bid_type": "BID_TYPE_CUSTOM",
    "conversion_bid_price": {{conversion_bid_price}},
    "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": {
        "skip_learning_phase": true,
        "video_download_disabled": false,
        "view_attribution_window": "ONE_DAY",
        "category_id": "0",
        "deep_bid_type": null,
        "share_disabled": false,
        "comment_disabled": false,
        "ios14_quota_type": "UNOCCUPIED",
        "modify_time": "{{modify_time}}",
        "keywords": null,
        "feed_type": null,
        "age_groups": null,
        "isp_ids": [],
        "next_day_retention": null,
        "identity_type": "TT_USER",
        "bid_price": 0,
        "excluded_audience_ids": [],
        "schedule_start_time": "{{schedule_start_time}}",
        "budget": {{budget},
        "campaign_name": "{{campaign_name}}",
        "purchased_impression": null,
        "app_type": null,
        "adgroup_id": "{{adgroup_id}}",
        "inventory_filter_enabled": false,
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "conversion_window": null,
        "app_download_url": null,
        "search_result_enabled": false,
        "click_attribution_window": "SEVEN_DAYS",
        "operation_status": "ENABLE",
        "optimization_event": "SHOPPING",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "product_source": "UNSET",
        "is_smart_performance_campaign": false,
        "is_new_structure": true,
        "deep_cpa_bid": 0,
        "promotion_type": "LIVE_SHOPPING",
        "category_exclusion_ids": [],
        "scheduled_budget": 0,
        "languages": [],
        "rf_estimated_cpr": null,
        "smart_audience_enabled": null,
        "app_id": null,
        "advertiser_id": "{{advertiser_id}}",
        "network_types": [],
        "smart_interest_behavior_enabled": null,
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "attribution_event_count": "ONCE",
        "rf_purchased_type": null,
        "gender": "GENDER_UNLIMITED",
        "conversion_bid_price": {{conversion_bid_price}},
        "campaign_id": "{{campaign_id}}",
        "brand_safety_type": "NO_BRAND_SAFETY",
        "secondary_optimization_event": null,
        "location_ids": [
            "1643084"
        ],
        "interest_keyword_ids": [],
        "identity_id": "{{identity_id}}",
        "pacing": "PACING_MODE_SMOOTH",
        "create_time": "{{create_time}}",
        "statistic_type": null,
        "schedule_end_time": "{{schedule_end_time}}",
        "frequency_schedule": null,
        "interest_category_ids": [],
        "schedule_infos": null,
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "delivery_mode": null,
        "brand_safety_partner": null,
        "creative_material_mode": "CUSTOM",
        "audience_ids": [],
        "adgroup_name": "{{adgroup_name}}",
        "bid_display_mode": "CPMV",
        "optimization_goal": "CONVERT",
        "bid_type": "BID_TYPE_CUSTOM",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "rf_estimated_frequency": null,
        "device_price_ranges": null,
        "is_hfss": false,
        "purchased_reach": null,
        "pixel_id": null,
        "actions": [],
        "billing_event": "OCPM",
        "schedule_type": "SCHEDULE_START_END",
        "shopping_ads_type": "LIVE",
        "auto_targeting_enabled": false,
        "adgroup_app_profile_page_state": null,
        "frequency": null,
        "operating_systems": []
    }
}
(/code)

优化目标设置为开始结账数

请求

(code)
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}}",
    "shopping_ads_type": "LIVE", 
    "identity_type": "TT_USER", 
    "identity_id": "{{identity_id}}",
    "promotion_type": "LIVE_SHOPPING",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": [
        "PLACEMENT_TIKTOK"
    ],
    "location_ids": [
        "1643084"
    ],
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
     <span style="background-color: green;">"optimization_goal": "CONVERT",
    "optimization_event": "INITIATE_ORDER",</span>
    "bid_type": "BID_TYPE_CUSTOM",
    "conversion_bid_price": {{conversion_bid_price}},
    "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": {
        "view_attribution_window": "ONE_DAY",
        "category_id": "0",
        "operation_status": "ENABLE",
        "advertiser_id": "{{advertiser_id}}",
        "brand_safety_type": "NO_BRAND_SAFETY",
        "search_result_enabled": false,
        "frequency": null,
        "schedule_infos": null,
        "purchased_impression": null,
        "adgroup_name": "{{adgroup_name}}",
        "product_source": "UNSET",
        "secondary_optimization_event": null,
        "is_new_structure": true,
        "category_exclusion_ids": [],
        "brand_safety_partner": null,
        "budget_mode": "BUDGET_MODE_TOTAL",
        "location_ids": [
            "1643084"
        ],
        "billing_event": "OCPM",
        "languages": [],
        "operating_systems": [],
        "schedule_type": "SCHEDULE_START_END",
        "audience_ids": [],
        "pacing": "PACING_MODE_SMOOTH",
        "shopping_ads_type": "LIVE",
        "share_disabled": false,
        "feed_type": null,
        "ios14_quota_type": "UNOCCUPIED",
        "device_price_ranges": null,
        "rf_estimated_cpr": null,
        "conversion_window": null,
        "smart_interest_behavior_enabled": null,
        "click_attribution_window": "SEVEN_DAYS",
        "budget": {{budget}},
        "app_id": null,
        "adgroup_app_profile_page_state": null,
        "isp_ids": [],
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "deep_cpa_bid": 0,
        "is_smart_performance_campaign": false,
        "auto_targeting_enabled": false,
        "smart_audience_enabled": null,
        "optimization_event": "INITIATE_ORDER",
        "schedule_end_time": "{{schedule_end_time}}",
        "adgroup_id": "{{adgroup_id}}",
        "frequency_schedule": null,
        "actions": [],
        "rf_purchased_type": null,
        "deep_bid_type": null,
        "is_hfss": false,
        "scheduled_budget": 0,
        "age_groups": null,
        "inventory_filter_enabled": false,
        "keywords": null,
        "schedule_start_time": "{{schedule_start_time}}",
        "delivery_mode": null,
        "skip_learning_phase": true,
        "interest_category_ids": [],
        "network_types": [],
        "comment_disabled": false,
        "purchased_reach": null,
        "bid_price": 0,
        "app_download_url": null,
        "gender": "GENDER_UNLIMITED",
        "statistic_type": null,
        "promotion_type": "LIVE_SHOPPING",
        "creative_material_mode": "CUSTOM",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "conversion_bid_price":{{conversion_bid_price}}},
        "campaign_id": "{{campaign_id}}",
        "identity_type": "TT_USER",
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "bid_display_mode": "CPMV",
        "excluded_audience_ids": [],
        "bid_type": "BID_TYPE_CUSTOM",
        "attribution_event_count": "ONCE",
        "create_time": "{{create_time}}",
        "video_download_disabled": false,
        "identity_id": "{{identity_id}}",
        "pixel_id": null,
        "app_type": null,
        "campaign_name": "{{campaign_name}}",
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "modify_time": "{{modify_time}}",
        "optimization_goal": "CONVERT",
        "interest_keyword_ids": [],
        "rf_estimated_frequency": null,
        "next_day_retention": null
    }
}
(/code)

优化目标设置为直播中商品点击数

请求

(code)
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}}",
    "shopping_ads_type": "LIVE", 
    "identity_type": "TT_USER", 
    "identity_id": "{{identity_id}}",
    "promotion_type": "LIVE_SHOPPING",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": [
        "PLACEMENT_TIKTOK"
    ],
    "location_ids": [
        "1643084"
    ],
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
     <span style="background-color: green;">"optimization_goal": "PRODUCT_CLICK_IN_LIVE",
    "optimization_event": "LIVE_CLICK_PRODUCT_ACTION",</span>
    "bid_type": "BID_TYPE_CUSTOM",
    "conversion_bid_price": {{conversion_bid_price}},
    "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": {
        "campaign_id": "{{campaign_id}}",
        "schedule_end_time": "{{schedule_end_time}}",
        "purchased_reach": null,
        "secondary_optimization_event": null,
        "pacing": "PACING_MODE_SMOOTH",
        "app_type": null,
        "device_price_ranges": null,
        "bid_display_mode": "CPMV",
        "creative_material_mode": "CUSTOM",
        "rf_estimated_frequency": null,
        "scheduled_budget": 0,
        "delivery_mode": null,
        "deep_bid_type": null,
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "ios14_quota_type": "UNOCCUPIED",
        "next_day_retention": null,
        "schedule_type": "SCHEDULE_START_END",
        "video_download_disabled": false,
        "excluded_audience_ids": [],
        "is_new_structure": true,
        "conversion_window": null,
        "app_download_url": null,
        "languages": [],
        "interest_category_ids": [],
        "age_groups": null,
        "click_attribution_window": "SEVEN_DAYS",
        "is_hfss": false,
        "brand_safety_partner": null,
        "network_types": [],
        "view_attribution_window": "ONE_DAY",
        "optimization_goal": "PRODUCT_CLICK_IN_LIVE",
        "bid_price": 0,
        "schedule_infos": null,
        "smart_interest_behavior_enabled": null,
        "product_source": "UNSET",
        "brand_safety_type": "NO_BRAND_SAFETY",
        "frequency_schedule": null,
        "comment_disabled": false,
        "modify_time": "{{modify_time}}",
        "adgroup_id": "{{adgroup_id}}",
        "rf_estimated_cpr": null,
        "statistic_type": null,
        "smart_audience_enabled": null,
        "feed_type": null,
        "auto_targeting_enabled": false,
        "schedule_start_time": "{{schedule_start_time}}",
        "keywords": null,
        "attribution_event_count": "ONCE",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "skip_learning_phase": true,
        "adgroup_name": "{{adgroup_name}}",
        "adgroup_app_profile_page_state": null,
        "operating_systems": [],
        "budget": {{budget}},
        "inventory_filter_enabled": false,
        "shopping_ads_type": "LIVE",
        "gender": "GENDER_UNLIMITED",
        "pixel_id": null,
        "identity_id": "{{identity_id}}",
        "bid_type": "BID_TYPE_CUSTOM",
        "isp_ids": [],
        "campaign_name": "{{campaign_name}}",
        "create_time": "{{create_time}}",
        "app_id": null,
        "billing_event": "OCPM",
        "promotion_type": "LIVE_SHOPPING",
        "search_result_enabled": false,
        "identity_type": "TT_USER",
        "conversion_bid_price": {{conversion_bid_price}},
        "rf_purchased_type": null,
        "frequency": null,
        "location_ids": [
            "1643084"
        ],
        "audience_ids": [],
        "operation_status": "ENABLE",
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "category_id": "0",
        "is_smart_performance_campaign": false,
        "deep_cpa_bid": 0,
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "optimization_event": "LIVE_CLICK_PRODUCT_ACTION",
        "purchased_impression": null,
        "actions": [],
        "share_disabled": false,
        "category_exclusion_ids": [],
        "interest_keyword_ids": [],
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "advertiser_id": "{{advertiser_id}}"
    }
}
(/code)

优化目标设置为观众留存率

请求

(code)
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}}",
    "shopping_ads_type": "LIVE", 
    "identity_type": "TT_USER", 
    "identity_id": "{{identity_id}}",
    "promotion_type": "LIVE_SHOPPING",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": [
        "PLACEMENT_TIKTOK"
    ],
    "location_ids": [
        "1643084"
    ],
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    <span style="background-color: green;">"optimization_goal": "MT_LIVE_ROOM",
    "optimization_event": "LIVE_STAY_TIME",</span>
    "bid_type": "BID_TYPE_CUSTOM",
    "conversion_bid_price": {{conversion_bid_price}},
    "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": {
        "deep_cpa_bid": 0,
        "attribution_event_count": "ONCE",
        "bid_price": 0,
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "rf_purchased_type": null,
        "inventory_filter_enabled": false,
        "pixel_id": null,
        "schedule_infos": null,
        "optimization_goal": "MT_LIVE_ROOM",
        "operating_systems": [],
        "network_types": [],
        "auto_targeting_enabled": false,
        "click_attribution_window": "SEVEN_DAYS",
        "keywords": null,
        "is_hfss": false,
        "purchased_impression": null,
        "delivery_mode": null,
        "is_new_structure": true,
        "app_download_url": null,
        "share_disabled": false,
        "brand_safety_partner": null,
        "feed_type": null,
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "languages": [],
        "budget_mode": "BUDGET_MODE_TOTAL",
        "location_ids": [
            "1643084"
        ],
        "interest_category_ids": [],
        "smart_audience_enabled": null,
        "is_smart_performance_campaign": false,
        "schedule_end_time": "{{schedule_end_time}}",
        "next_day_retention": null,
        "optimization_event": "LIVE_STAY_TIME",
        "category_id": "0",
        "pacing": "PACING_MODE_SMOOTH",
        "bid_display_mode": "CPMV",
        "brand_safety_type": "NO_BRAND_SAFETY",
        "scheduled_budget": 0,
        "device_price_ranges": null,
        "advertiser_id": "{{advertiser_id}}",
        "frequency_schedule": null,
        "promotion_type": "LIVE_SHOPPING",
        "interest_keyword_ids": [],
        "adgroup_app_profile_page_state": null,
        "schedule_start_time": "{{schedule_start_time}}",
        "search_result_enabled": false,
        "creative_material_mode": "CUSTOM",
        "video_download_disabled": false,
        "modify_time": "{{modify_time}}",
        "deep_bid_type": null,
        "rf_estimated_cpr": null,
        "excluded_audience_ids": [],
        "app_type": null,
        "view_attribution_window": "ONE_DAY",
        "conversion_window": null,
        "actions": [],
        "statistic_type": null,
        "adgroup_name": "{{adgroup_name}}",
        "billing_event": "OCPM",
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "ios14_quota_type": "UNOCCUPIED",
        "app_id": null,
        "purchased_reach": null,
        "conversion_bid_price": {{conversion_bid_price}},
        "category_exclusion_ids": [],
        "comment_disabled": false,
        "audience_ids": [],
        "frequency": null,
        "bid_type": "BID_TYPE_CUSTOM",
        "secondary_optimization_event": null,
        "gender": "GENDER_UNLIMITED",
        "campaign_name": "{{campaign_name}}",
        "isp_ids": [],
        "identity_type": "TT_USER",
        "adgroup_id": "{{adgroup_id}}",
        "shopping_ads_type": "LIVE",
        "budget": {{budget}},
        "skip_learning_phase": true,
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "product_source": "UNSET",
        "create_time": "{{create_time}}",
        "identity_id": "{{identity_id}}",
        "operation_status": "ENABLE",
        "schedule_type": "SCHEDULE_START_END",
        "campaign_id": "{{campaign_id}}",
        "age_groups": null,
        "smart_interest_behavior_enabled": null,
        "rf_estimated_frequency": null
    }
}
(/code)

优化目标设置为点击数

请求

(code)
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}}",
    "shopping_ads_type": "LIVE", 
    "identity_type": "TT_USER", 
    "identity_id": "{{identity_id}}",
    "promotion_type": "LIVE_SHOPPING",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": [
        "PLACEMENT_TIKTOK"
    ],
    "location_ids": [
        "1643084"
    ],
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    <span style="background-color: green;">"optimization_goal": "CLICK",</span>
    "bid_type": "BID_TYPE_CUSTOM",
    "bid_price": {{bid_price}},
    "billing_event": "CPC",
    "pacing": "PACING_MODE_SMOOTH"
}'
(/code)

返回

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

4.创建广告

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

不支持将 is_smart_creative 传入 /ad/aco/create/ 创建开启智能创意的直播购物广告。		 / /
认证身份
（广告发布身份）		 请选择已在广告组层级指定的用于直播的 TikTok 账号身份
  • identity_type
  • identity_id
  • identity_authorized_bc_id
 使用与广告组层级相同的参数和值
商品 未启用
  • product_specific_type
  • item_group_ids
  • product_set_id
  • sku_ids
  • showcase_products
 不传入
创意详情 - 广告样式（广告版式） 以下任意选项：
  • 单视频：用户将在点击行动引导文案按钮“观看直播”、自动生成的商品卡（若有）或主页图标时跳转至直播间。
  • 实时直播：用户将在点击直播内容时跳转至直播间。
 ad_format LIVE_CONTENT
  • creative_type
  • vertical_video_strategy
  • 若要将广告样式设置为单视频，需将 creative_type 设置为 SHORT_VIDEO_LIVE 且将 vertical_video_strategy 设置为 SINGLE_VIDEO。
  • 若要将广告样式设置为实时直播，需将 creative_type 设置为 DIRECT_LIVE 且将 vertical_video_strategy 设置为 LIVE_STREAM。
创意详情 - 动态样式 未启用 dynamic_format 不传入
创意详情 - 创意素材
  • 若广告样式为单视频，需指定一个视频或从指定的 TikTok 账号的公开帖子中选择的一个视频帖子，以及行动引导文案“观看直播”。

    注意：单个广告组中最多支持 20 个 广告样式为单视频的广告。

  • 若广告样式为实时直播，直播内容将用作您的广告创意。

    注意：单个广告组中仅支持创建 1 个广告样式为实时直播的广告。
  • video_id
  • image_ids
  • ad_text
  • tiktok_item_id
  • dark_post_status
  • 若 creative_type 设置为 SHORT_VIDEO_LIVE，您可通过 Spark Ads 提取 或 Spark Ads 推送来创建广告：
    • Spark Ads 推送：指定视频（video_id），视频封面（image_ids）以及广告文案（ad_text）。您可将dark_post_status 设置为 ON，从而确保视频不会作为原生帖子发布在 TikTok 账号中。不支持传入 tiktok_item_id。
    • Spark Ads 拉取： 通过 tiktok_item_id指定 TikTok 帖子。不支持传入video_id，image_ids，ad_text 和 dark_post_status。
      若想了解 Spark Ads 详情，请查看创建 Spark Ads。
  • 若 creative_type 设置为 DIRECT_LIVE，则不支持使用这些参数。
call_to_action
  • 若 creative_type 设置为 SHORT_VIDEO_LIVE，需将本字段设置为WATCH_LIVE。
  • 若 creative_type 设置为 DIRECT_LIVE，需省略本字段或为本字段赋 null 值。
  • promotional_music_disabled
  • item_duet_status
  • item_stitch_status
  • music_id
  • shopping_ads_video_package_id
  • call_to_action_id
 不传入
创意详情 - 创新互动样式 未启用

  • 若直播间存在置顶商品，两秒观看后会出现自动生成的展示置顶商品的商品卡。用户可点击商品卡进入展示商品详情页的直播间。
  • 若直播间不存在置顶商品或置顶商品已售罄，则不会出现商品卡。
 card_id 不传入
目标页面 未启用
  • landing_page_url
  • page_id
  • tiktok_page_category
  • phone_region_code
  • phone_region_calling_code
  • phone_number
  • deeplink
  • deeplink_type
  • shopping_ads_deeplink_type
  • shopping_ads_fallback_type
  • fallback_type
  • dynamic_destination
  • utm_params
  • instant_product_page_used
  • page_image_index
 不传入
免责声明 未启用
  • disclaimer_type
  • disclaimer_text
  • disclaimer_clickable_texts
 不传入
监测 未启用
  • tracking_pixel_id
  • tracking_app_id
  • tracking_offline_event_set_ids
  • viewability_postbid_partner
  • viewability_vast_url
  • brand_safety_postbid_partner
  • brand_safety_vast_url
  • impression_tracking_url
  • click_tracking_url
 不传入
试玩素材 未启用 playable_url 不传入

示例

广告样式设置为实时直播

请求

(code)
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": "LIVE_CONTENT",
            <span style="background-color: green;">"creative_type": "DIRECT_LIVE",
            "vertical_video_strategy": "LIVE_STREAM"</span>
        }
    ]
}'
(/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": [
            {
                "campaign_name": "{{campaign_name}}",
                "ad_id": "{{ad_id}}",
                "advertiser_id": "{{advertiser_id}}",
                "identity_id": "{{identity_id}}",
                "ad_text": "",
                "call_to_action_id": null,
                "app_name": "{{app_name}}",
                "campaign_id": "{{campaign_id}}",
                "shopping_ads_video_package_id": "",
                "operation_status": "ENABLE",
                "is_new_structure": true,
                "display_name": "{{display_name}}",
                "ad_name": "{{ad_name}}",
                "avatar_icon_web_uri": "",
                "creative_type": "DIRECT_LIVE",
                "is_aco": false,
                "identity_type": "TT_USER",
                "adgroup_name": "{{adgroup_name}}",
                "ad_format": "LIVE_CONTENT",
                "deeplink": null,
                "music_id": null,
                "product_specific_type": "UNSET",
                "impression_tracking_url": null,
                "landing_page_urls": null,
                "adgroup_id": "{{adgroup_id}}",
                "profile_image_url": "",
                "click_tracking_url": null,
                "viewability_postbid_partner": "UNSET",
                "viewability_vast_url": null,
                "landing_page_url": null,
                "video_id": null,
                "creative_authorized": false,
                "brand_safety_postbid_partner": "UNSET",
                "vertical_video_strategy": "LIVE_STREAM",
                "optimization_event": "LIVE_STAY_TIME",
                "image_ids": [],
                "dynamic_destination": "UNSET",
                "create_time": "{{create_time}}",
                "card_id": null,
                "brand_safety_vast_url": null,
                "modify_time": "{{modify_time}}",
                "ad_texts": null,
                "playable_url": "",
                "page_id": null,
                "dynamic_format": "UNSET",
                "vast_moat_enabled": false
            }
        ]
    }
}
(/code)

广告样式设置为单视频，使用 Spark Ads 拉取

请求

(code)
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": "LIVE_CONTENT",
            <span style="background-color: green;">"creative_type": "SHORT_VIDEO_LIVE",
            "vertical_video_strategy": "SINGLE_VIDEO",</span>
            "tiktok_item_id": "{{tiktok_item_id}}",
            <span style="background-color: green;">"call_to_action": "WATCH_LIVE"</span>
        }
    ]
}'
(/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": [
            {
                "campaign_id": "{{campaign_id}}",
                "vertical_video_strategy": "SINGLE_VIDEO",
                "landing_page_url": null,
                "avatar_icon_web_uri": "",
                "advertiser_id": "{{advertiser_id}}",
                "profile_image_url": "",
                "card_id": null,
                "is_aco": false,
                "product_specific_type": "UNSET",
                "ad_id": "{{ad_id}}",
                "deeplink": null,
                "modify_time": "{{modify_time}}",
                "impression_tracking_url": null,
                "adgroup_name": "{{adgroup_name}}",
                "creative_type": "SHORT_VIDEO_LIVE",
                "page_id": null,
                "promotional_music_disabled": true,
                "image_ids": [
                    ""
                ],
                "call_to_action_id": null,
                "music_id": null,
                "identity_type": "TT_USER",
                "video_id": null,
                "app_name": "{{app_name}}",
                "campaign_name": "{{campaign_name}}",
                "operation_status": "ENABLE",
                "dynamic_format": "UNSET",
                "ad_text": "{{ad_text}}",
                "viewability_vast_url": null,
                "landing_page_urls": null,
                "create_time": "{{create_time}}",
                "identity_id": "{{identity_id}}",
                "ad_format": "SINGLE_VIDEO",
                "adgroup_id": "{{adgroup_id}}",
                "display_name": "{{display_name}}",
                "ad_name": "{{ad_name}}",
                "click_tracking_url": null,
                "creative_authorized": false,
                "brand_safety_postbid_partner": "UNSET",
                "optimization_event": null,
                "brand_safety_vast_url": null,
                "call_to_action": "WATCH_LIVE",
                "shopping_ads_video_package_id": "",
                "playable_url": "",
                "dynamic_destination": "UNSET",
                "viewability_postbid_partner": "UNSET",
                "ad_texts": null,
                "is_new_structure": true,
                "vast_moat_enabled": false,
                "tiktok_item_id": "{{tiktok_item_id}}"
            }
        ]
    }
}
(/code)

广告样式设置为单视频，使用 Spark Ads 推送且不启用"只作为广告展示"

请求

(code)
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": "LIVE_CONTENT",
            <span style="background-color: green;">"creative_type": "SHORT_VIDEO_LIVE",
            "vertical_video_strategy": "SINGLE_VIDEO",</span>
            "video_id": "{{video_id}}",
            "image_ids": ["{{image_id}}"],
            "ad_text": "{{ad_text}}",
            <span style="background-color: green;">"call_to_action": "WATCH_LIVE"</span>
        }
    ]
}'
(/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": [
            {
                "modify_time": "{{modify_time}}",
                "card_id": null,
                "call_to_action_id": null,
                "operation_status": "ENABLE",
                "ad_text": "{{ad_text}}",
                "campaign_name": "{{campaign_name}}",
                "creative_authorized": false,
                "image_ids": [
                    "{{image_id}}"
                ],
                "is_aco": false,
                "optimization_event": null,
                "landing_page_urls": null,
                "branded_content_disabled": false,
                "music_id": null,
                "impression_tracking_url": null,
                "brand_safety_vast_url": null,
                "shopping_ads_video_package_id": "",
                "adgroup_id": "{{adgroup_id}}",
                "create_time": "{{create_time}}",
                "viewability_vast_url": null,
                "vast_moat_enabled": false,
                "landing_page_url": null,
                "brand_safety_postbid_partner": "UNSET",
                "click_tracking_url": null,
                "profile_image_url": "",
                "deeplink": null,
                "dark_post_status": "OFF",
                "call_to_action": "WATCH_LIVE",
                "viewability_postbid_partner": "UNSET",
                "ad_format": "SINGLE_VIDEO",
                "display_name": "{{display_name}}",
                "video_id": "{{video_id}}",
                "avatar_icon_web_uri": "",
                "product_specific_type": "UNSET",
                "page_id": null,
                "is_new_structure": true,
                "ad_id": "{{ad_id}}",
                "identity_id": "{{identity_id}}",
                "advertiser_id": "{{advertiser_id}}",
                "dynamic_format": "UNSET",
                "campaign_id": "{{campaign_id}}",
                "ad_texts": null,
                "app_name": "{{app_name}}",
                "ad_name": "{{ad_name}}",
                "identity_type": "TT_USER",
                "dynamic_destination": "UNSET",
                "creative_type": "SHORT_VIDEO_LIVE",
                "adgroup_name": "{{adgroup_name}}",
                "playable_url": "",
                "vertical_video_strategy": "SINGLE_VIDEO"
            }
        ]
    }
}
(/code)

广告样式设置为单视频，使用 Spark Ads 推送且启用"只作为广告展示"

请求

(code)
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": "LIVE_CONTENT",
            <span style="background-color: green;">"creative_type": "SHORT_VIDEO_LIVE",
            "vertical_video_strategy": "SINGLE_VIDEO",</span>
            "video_id": "{{video_id}}",
            "image_ids": ["{{image_id}}"],
           <span style="background-color: green;">"dark_post_status":"ON",</span>
            "ad_text": "{{ad_text}}",
            <span style="background-color: green;">"call_to_action": "WATCH_LIVE"</span>
        }
    ]
}'
(/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": [
            {
                "creative_type": "SHORT_VIDEO_LIVE",
                "ad_id": "{{ad_id}}",
                "page_id": null,
                "music_id": null,
                "brand_safety_vast_url": null,
                "image_ids": [
                    "{{image_id}}"
                ],
                "dynamic_destination": "UNSET",
                "call_to_action_id": null,
                "ad_text": "{{ad_text}}",
                "branded_content_disabled": false,
                "video_id": "{{video_id}}",
                "click_tracking_url": null,
                "profile_image_url": "",
                "identity_id": "{{identity_id}}",
                "creative_authorized": false,
                "brand_safety_postbid_partner": "UNSET",
                "is_new_structure": true,
                "landing_page_urls": null,
                "dynamic_format": "UNSET",
                "viewability_vast_url": null,
                "ad_texts": null,
                "landing_page_url": null,
                "avatar_icon_web_uri": "",
                "campaign_id": "{{campaign_id}}",
                "advertiser_id": "{{advertiser_id}}",
                "dark_post_status": "ON",
                "campaign_name": "{{campaign_name}}",
                "modify_time": "{{modify_time}}",
                "is_aco": false,
                "vast_moat_enabled": false,
                "viewability_postbid_partner": "UNSET",
                "card_id": null,
                "vertical_video_strategy": "SINGLE_VIDEO",
                "ad_name": "{{ad_name}}",
                "identity_type": "TT_USER",
                "display_name": "{{display_name}}",
                "ad_format": "SINGLE_VIDEO",
                "create_time": "{{create_time}}",
                "adgroup_name": "{{adgroup_name}}",
                "operation_status": "ENABLE",
                "deeplink": null,
                "call_to_action": "WATCH_LIVE",
                "shopping_ads_video_package_id": "",
                "optimization_event": null,
                "adgroup_id": "{{adgroup_id}}",
                "product_specific_type": "UNSET",
                "playable_url": "",
                "app_name": "{{app_name}}",
                "impression_tracking_url": null
            }
        ]
    }
}
(/code)
← 迁移至 GMV Max 推广系列（即将废弃）创建商品购物广告 →

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