← 返回目录
📁 Use Cases › Campaign creation › Create an Upgraded Smart+ Campaign › Create Upgraded Smart+ Lead Generation Campaigns

创建以即时通讯应用作为优化位置的升级版 Smart+ 线索收集推广系列

本文介绍如何创建以即时通讯应用作为优化位置的升级版 Smart+ 线索收集推广系列。借助这类推广系列，广告受众能够根据其应用安装状态，通过点击广告中的行动引导文案按钮采取两种不同的操作： - 如果受众安装了即时通讯应用（例如 WhatsApp），可在应用上向你（广告主）发送消息。 - 如果受众未安装即时通讯应用，会跳转到自定义 TikTok 即时体验页面进行查看。

前提条件

  • 我们建议在设置推广系列之前，关联我们的其中一个集成的消息管理工具 (MMT)，以深化优化目标和提高广告投放效果。
  • 如果你已经与 MMT 集成并针对“对话数”进行优化，请确保在 MMT 上设置 TikTok 集成，然后再选择“对话数”和消息事件。
  • 如果你使用的是 WhatsApp，需为 WhatsApp Business API 使用唯一的电话号码，该电话号码不能用于其他任何 WhatsApp 个人账号或企业号。你可以直接在 MMT 上注册 WhatsApp Business API。
  • Pancake 等一些 MMT 可能会要求你添加电子钱包，然后你才能回复客户消息。MMT 会向你收取使用 WhatsApp Business API 的费用，然后缴付给 Meta。

步骤

1. 创建推广系列

使用 /smart_plus/campaign/create/ 接口创建推广系列。

需确保满足以下要求。完整参数列表参见 /smart_plus/campaign/create/ 接口。

设置 要求 参数 如何配置参数
推广目标 线索收集 objective_type LEAD_GENERATION
iOS 14 专属推广系列 未启用 campaign_type REGULAR_CAMPAIGN 或不传入
app_id 不传入
campaign_app_profile_page_state 不传入
使用商品库 未启用 catalog_enabled false 或不传入
推广系列名称 传入合法名称 campaign_name 传入合法值
特殊广告类别
（可选）		 未启用或已启用

注意：此设置仅支持在美国或加拿大注册的广告主使用。

 special_industries 不传入或传入合法值
推广系列预算策略 使用以下任意类型：
  • 推广系列预算：你的预算将自动分配给各广告组并自动优化。所有广告组必须使用相同的预算和优化设置。
  • 广告组预算：每个广告组分别使用不同的预算和优化设置，从而精确控制各广告组的消耗。
 budget_optimize_on
  • 要设置自动推广系列预算，请将此字段设置为 true 或不传入。
  • 要设置自定义广告组预算，请将此字段设置为 false。
推广系列预算模式
  • 如果推广系列预算策略为推广系列预算，传入以下任意模式：
    • 日预算
    • 总预算
  • 如果推广系列预算策略为广告组预算，传入以下任意模式，以确定所有广告组的预算限制：
    • 不限
    • 日预算
    • 总预算
 budget_mode
  • 当 budget_optimize_on 为 true 或不传入时，使用以下任意值：
    • BUDGET_MODE_TOTAL
    • BUDGET_MODE_DYNAMIC_DAILY_BUDGET
  • 当 budget_optimize_on 为 false 时，使用以下任意值：
    • BUDGET_MODE_INFINITE
    • BUDGET_MODE_DAY
    • BUDGET_MODE_TOTAL
基于目标增加预算
（当推广系列预算策略为推广系列预算，且推广系列预算模式为日预算时）		 选择以下任意选项：
  • 已启用
  • 未启用
 budget_auto_adjust_strategy 当 budget_optimize_on 为 true 或不传入，且 budget_mode 为 BUDGET_MODE_DYNAMIC_DAILY_BUDGET 时：
  • 要启用该设置，使用以下值：
    • AUTO_BUDGET_INCREASE。允许系统在广告效果出色且满足目标 CPA、第 0 天目标 ROAS 和预算要求时基于目标增加预算。如果你的预算利用率至少达到 90%，日预算将自动增加 20%，每天最多可增加 10 次。你的日预算将在每天重置为原来的日预算。
  • 要禁用该设置：
    • 不传入

    注意：基于目标增加预算目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。
推广系列预算
  • 如果推广系列预算策略为推广系列预算：
    • 传入合法预算。
  • 如果推广系列预算策略为广告组预算：
    • 如果预算限制为不限：
      • 未启用
    • 如果预算限制为日预算或总预算：
      • 传入合法预算
 budget
  • 当 budget_optimize_on 为 true 或不传入时：
    • 传入合法值。
  • 当 budget_optimize_on 为 false 时：
    • 如果 budget_mode 为 BUDGET_MODE_INFINITE：
      • 不传入
    • 如果 budget_mode 为 BUDGET_MODE_DAY 或 BUDGET_MODE_TOTAL：
      • 传入合法值
PO 号（可选） 已启用或未启用 po_number 传入合法值或不传入

示例

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/campaign/create/' \
--header 'Access-Token: "{{AccessToken}}"' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "request_id": "{{request_id}}",
    "objective_type": "LEAD_GENERATION",
    "campaign_name": "{{campaign_name}}",
    "budget": "{{budget}}"
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "advertiser_id": "{{advertiser_id}}",
        "budget": "{{budget}}",
        "budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
        "budget_optimize_on": true,
        "campaign_id": "{{campaign_id}}",
        "campaign_name": "{{campaign_name}}",
        "catalog_enabled": false,
        "create_time": "{{create_time}}",
        "modify_time": "{{modify_time}}",
        "objective_type": "LEAD_GENERATION",
        "operation_status": "ENABLE",
        "secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "smart_plus_adgroup_mode": "MULTIPLE"
}
(/code)

2. 创建广告组

使用 /smart_plus/adgroup/create/ 接口创建广告组。

需确保满足以下要求。完整参数列表参见 /smart_plus/adgroup/create/ 接口。

设置 要求 参数 如何配置参数
广告组名称 传入合法名称 adgroup_name 传入合法值
优化和出价
· 目标		 使用以下任意类型：
  • 点击
    • 向最有可能点击的用户展示你的广告。
  • 对话
    • 向最有可能在 WhatsApp、Messenger、Zalo、LINE 及其他通讯应用上发起对话的用户展示你的广告。


注意：如果你选择推广系列预算模式，此设置必须在所有广告组中保持一致。

 optimization_goal 使用以下任意值：
  • CLICK
  • CONVERSATION


注意：

  • 当推广系列层级的 budget_optimize_on 为 true 时，为同一推广系列内的所有广告组传入相同的 optimization_goal。
  • 如果 optimization_goal 为 CONVERSATION，忽略 optimization_event 或将 optimization_event 设置为 MESSAGE。
优化和出价
· 优化位置		 即时通讯应用：用户点击你的广告后，会自动跳转到你偏好的即时通讯应用，例如 WhatsApp 或 Messenger。

注意：如果你选择推广系列预算模式，此设置必须在同一推广系列内的所有广告组中保持一致。

 promotion_type LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE

注意：当推广系列层级的 budget_optimize_on 为 true 时，为同一推广系列内的所有广告组传入相同的 promotion_type。
promotion_target_type 不传入
优化和出价
· 选择即时通讯应用或使用自定义 URL		 选择以下任意选项：
  • Messenger，使用 Facebook 公共主页编号
  • WhatsApp，使用 WhatsApp 电话号码
  • Zalo，使用 Zalo 官方账号 ID 或 Zalo 电话号码
    • 如果目标是点击且所选即时通讯应用为 Zalo，你只能输入 Zalo 电话号码
  • LINE，使用 LINE 企业 ID
  • 即时通讯 URL


注意：如果目标是对话，你只能从以下选项中选择：

  • Messenger，使用 Facebook 公共主页编号
  • WhatsApp，使用 WhatsApp 电话号码
  • Zalo，使用 Zalo 官方账号 ID 或 Zalo 电话号码
 messaging_app_type
zalo_id_type
messaging_app_account_id
phone_info
  • 使用即时通讯应用 Messenger 的步骤：
    • 将 messaging_app_type 设置为 MESSENGER ，并通过 messaging_app_account_id 传入 Facebook 公共主页编号。
      • 若想查找你的 Facebook 公共主页编号，前往你的 Facebook 公共主页，点击封面图片下方的“About”，然后点击“Page transparency”。
    • 请勿传入 zalo_id_type 和 phone_info。
  • 使用即时通讯应用 WhatsApp 的步骤：
    • 将 messaging_app_type 设置为 WHATSAPP，并传入 phone_info。
    • 请勿传入 zalo_id_type 和 messaging_app_account_id。你的 messaging_app_account_id 设置将被忽略，此字段将被设置为根据传入的 phone_info 自动填充的对应 WhatsApp 电话号码。
  • 使用即时通讯应用 Zalo 的步骤：
    • 将 messaging_app_type 设置为 ZALO。
    • 通过 zalo_id_type 传入 Zalo 联系人格式。
      • 若想使用 Zalo 官方账号 ID，需将 zalo_id_type 设置为 ZALO_OFFICIAL_ACCOUNT，并通过 messaging_app_account_id 传入 Zalo 官方账号 ID。
      • 若想使用 Zalo 电话号码，需将 zalo_id_type 设置为 ZALO_PHONE_ACCOUNT，并通过 phone_info 传入 Zalo 电话号码。

        注意：仅当 optimization_goal 为 CLICK 时，才可将 zalo_id_type 设置为 ZALO_PHONE_ACCOUNT。

  • 使用即时通讯应用 LINE 的步骤：
    • 将 messaging_app_type 设置为 LINE ，并通过 messaging_app_account_id 传入 LINE 企业 ID。
      • 若想查找你的 LINE 企业 ID，前往你的 LINE 官方账号页面。
    • 请勿传入 zalo_id_type 和 phone_info。
  • 使用即时通讯 URL 的步骤：
    • 将 messaging_app_type 设置为 IM_URL。
    • 请勿传入 zalo_id_type、messaging_app_account_id 和 phone_info。

注意：当 optimization_goal 为 CONVERSATION 时，你只能将 messaging_app_type 设置为以下任意值：

  • MESSENGER
  • WHATSAPP
  • ZALO
优化和出价
· 通讯事件组		 满足以下条件时，传入合法通讯事件组：
  • 将目标设置为对话。
  • 广告组设置中的通讯应用账号与现有通讯事件组不匹配。

如果广告组设置中的通讯应用账号与去重现有通讯事件组匹配，系统将自动选择与你所选即时通讯应用账号关联的去重通讯事件组。		 message_event_set_id 满足以下条件时，传入合法值：
  • optimization_goal 为 CONVERSATION。
  • 广告组设置中的通讯应用账号与现有通讯事件组不匹配。

  • 如果广告组设置中的即时通讯应用账号（无论是通过 messaging_app_account_id 传入的 Messenger 账号、Zalo 官方账号，还是通过传入的 phone_info 填充的 WhatsApp 或 Zalo 电话账号）与现有事件组匹配，此字段将被忽略，并自动填充与你选择的即时通讯应用账号关联的去重通讯事件组。
    • 若想确认是否有去重通讯事件组与你选择的即时通讯应用账号关联，需使用 /ctm/message_event_set/get/ 接口，并查看返回的 matched_event_set。
  • 如果广告组设置中的即时通讯应用账号与任何现有通讯事件组均不匹配（/ctm/message_event_set/get/ 返回的 matched_event_set 为空），使用 /ctm/message_event_set/get/ 接口，通过返回参数 message_event_set_list 获取可用于创建广告的通讯事件组。
优化和出价
· 出价策略和（可选）目标 CPA		 可采用以下任意出价策略：
  • 最大投放量。
  • 成本上限。你需要同时传入目标 CPA。

注意：

  • 出价策略必须在同一推广系列内的所有广告组中保持一致。
  • 如果你选择推广系列预算模式，目标 CPA（如传入）必须在所有广告组中保持一致。
  • 目标 CPA 出价策略仅支持采用日预算模式的推广系列或广告组。
 bid_type
bid_price
conversion_bid_price		 将 bid_type 设置为 BID_TYPE_CUSTOM 或 BID_TYPE_NO_BID。
  • 如果 optimization_goal 为 CLICK 且 bid_type 为 BID_TYPE_CUSTOM，请同时传入 bid_price。
  • 如果 optimization_goal 为 CONVERSATION 且 bid_type 为 BID_TYPE_CUSTOM，请同时传入 conversion_bid_price。

注意：

  • bid_type 必须在同一推广系列内的所有广告组中保持一致。
  • 当推广系列层级的 budget_optimize_on 为 true 时，bid_price 或 conversion_bid_price（如传入）应在同一推广系列内的所有广告组中保持一致。
  • 在以下任一场景中，你只能将 bid_type 设置为 BID_TYPE_CUSTOM：
    • 在推广系列层级，budget_mode 为 BUDGET_MODE_DYNAMIC_DAILY_BUDGET
    • 在广告组层级，budget_mode 为 BUDGET_MODE_DYNAMIC_DAILY_BUDGET
deep_bid_type
roas_bid		 不传入
优化和出价
· 计费事件
  • 如果优化目标为点击，计费事件应为 CPC。
  • 如果优化目标为对话，计费事件应为 oCPM。
 billing_event
  • 如果 optimization_goal 为 CLICK，将此字段设置为 CPC。
  • 如果 optimization_goal 为 CONVERSATION，将此字段设置为 OCPM。
优化和出价
· 投放速度		 标准（默认） N/A 升级版 Smart+ 广告组默认设置为标准投放速度。
预算和排期
· 预算
  • 如果你选择推广系列预算模式：
    • 广告组预算会被禁用。推广系列层级预算将用作广告组预算。
  • 如果你选择广告组预算策略：
    • 如果广告组预算限制为不限或总预算，可使用以下任意广告组预算模式：
      • 总预算
      • 日预算
    • 如果广告组预算限制为日预算，可使用以下任意广告组预算模式：
      • 日预算

注意：广告组预算模式（如传入）必须在同一推广系列内的所有广告组中保持一致。

 budget_mode
budget
  • 当推广系列层级的 budget_optimize_on 为 true 时，不支持 budget_mode 和 budget。
  • 当推广系列层级的 budget_optimize_on 为 false 且 budget_mode 为 BUDGET_MODE_INFINITE 或 BUDGET_MODE_TOTAL 时：
    • 将 budget_mode 设置为 BUDGET_MODE_TOTAL 或 BUDGET_MODE_DYNAMIC_DAILY_BUDGET
    • 通过 budget 传入合法预算
  • 当推广系列层级的 budget_optimize_on 为 false 且 budget_mode 为 BUDGET_MODE_DAY 时：
    • 将 budget_mode 设置为 BUDGET_MODE_DYNAMIC_DAILY_BUDGET
    • 通过 budget 传入合法预算

注意：budget_mode（如传入）必须在同一推广系列内的所有广告组中保持一致。
预算和排期
· 基于目标增加预算（当出价策略为目标 CPA 时）		 已启用或未启用

若想启用此设置，应满足以下条件：
  • 在推广系列层级：未启用 CBO。
  • 在广告组层级：
    • 广告组预算为日预算
    • 出价策略为目标 CPA
 budget_auto_adjust_strategy 使用以下任意值：
  • AUTO_BUDGET_INCREASE：启用基于目标增加预算功能。允许系统在广告效果出色且满足目标 CPA、第 0 天目标 ROAS 和预算要求时自动增加预算。如果你的预算利用率至少达到 90%，日预算将自动增加 20%，每天最多可增加 10 次。你的日预算将在每天重置为原来的日预算。
  • UNSET：关闭基于目标增加预算功能。

如果满足以下所有条件，只能将此字段设置为 AUTO_BUDGET_INCREASE：
  • 在推广系列层级：budget_optimize_on 为 false。
  • 在广告组层级：
    • budget_mode 为 BUDGET_MODE_DYNAMIC_DAILY_BUDGET。
    • bid_type 为 BID_TYPE_CUSTOM。

注意：基于目标增加预算目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。
预算和排期
：为每个广告组添加消耗目标
· 最低日消耗
  • 如果你使用推广系列日预算，你可以启用或禁用此设置。
  • 如果你使用推广系列总预算或广告组预算，不支持此设置。
 min_budget
  • 当推广系列层级的 budget_optimize_on 为 true 且 budget_mode 为 BUDGET_MODE_DYNAMIC_DAILY_BUDGET 时，你可以通过这个字段传入合法值，或不传入。
  • 当推广系列层级的 budget_optimize_on 为 true 且 budget_mode 为 BUDGET_MODE_TOTAL 时，或当 budget_optimize_on 为 false 时，不支持此字段。
预算和排期
· 排期		 使用以下任意类型：
  • 设置开始时间并持续投放广告组
  • 设置开始时间和结束时间


注意：在以下任意场景中，你只能选择“设置开始时间和结束时间”：

  • 在推广系列层级，设置了推广系列总预算。
  • 在广告组层级，设置了广告组总预算。
 schedule_type
schedule_start_time
schedule_end_time
  • 若想设置开始时间并持续投放广告组，将 schedule_type 设置为 SCHEDULE_FROM_NOW 并传入 schedule_start_time。请勿传入 schedule_end_time。
  • 若想在排定的开始时间和结束时间之间投放广告组，将 schedule_type 设置为 SCHEDULE_START_END 并传入 schedule_start_time 和 schedule_end_time。


注意：在以下任意场景中，你只能将 schedule_type 设置为 SCHEDULE_START_END：

  • 在推广系列层级，budget_mode 为 BUDGET_MODE_TOTAL
  • 在广告组层级，budget_mode 为 BUDGET_MODE_TOTAL
预算和排期
· 分时段（可选）		 使用以下任意类型：
  • 全天（默认）
  • 选择特定时段
 dayparting 使用以下任意配置：
  • 传入全为 1 的值，或不传入此字段
  • 传入包含 0 的值以表示未投放
受众定向优化模式 使用以下任意模式：
  • 自动定向
    • 你可以使用自动定向来充分利用实时数据和机器学习，向最有可能与广告互动的受众定向投放广告。
  • 自定义定向
    • 你可以使用自定义定向设置，精确控制哪些受众能看到你的广告。这可能会限制广告投放并影响推广效果。

查看不同定向优化模式可用的定向设置文档，了解每种模式支持的定向设置。		 targeting_optimization_mode 使用以下任意值：
  • AUTOMATIC
  • MANUAL

查看不同定向优化模式可用的定向设置文档，了解每种模式支持的定向设置。
广告位和品牌安全
· 广告位		 TikTok placement_type PLACEMENT_TYPE_NORMAL
placements ["PLACEMENT_TIKTOK"]
广告位和品牌安全
· 子广告位
（广告位包含 TikTok 时选填）		 不启用，或启用并带有以下选项：
  • PineDrama

注意：

  • 在广告组中使用 PineDrama 子广告位 (PINE_DRAMA) 目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。

 tiktok_subplacements 不传入，或传入以下值：
  • PINE_DRAMA

注意：

  • 在广告组中使用 PineDrama 子广告位 (PINE_DRAMA) 目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。
广告位和品牌安全
· 品牌安全和适用性		 这些设置仅应用于 TikTok 信息流广告。之前在品牌安全中心所做的任何账号层级的设置都将应用到推广系列。 N/A N/A

若想获取品牌安全中心的广告账号层级品牌安全和适用性设置，需使用 /tiktok_inventory_filters/get/ 接口。
若想配置或更新品牌安全中心的广告账号层级品牌安全和适用性设置，需使用 /tiktok_inventory_filters/update/ 接口。
广告位和品牌安全
· 允许下载视频		 已启用或未启用 share_disabled 传入合法值或不传入
广告位和品牌安全
· 允许共享视频		 已启用或未启用 video_download_disabled 传入合法值或不传入
广告位和品牌安全
· Pangle 媒体屏蔽列表		 未启用 N/A N/A

示例

目标为点击，即时通讯应用为 Messenger

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "request_id": "{{request_id}}",
    "adgroup_name": "{{adgroup_name}}",
    "optimization_goal": "CLICK",
    "promotion_type": "LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE",
    "messaging_app_type": "MESSENGER",
    "messaging_app_account_id": "{{messaging_app_account_id}}",
    "bid_type": "BID_TYPE_CUSTOM",
    "bid_price": {{bid_price}},
    "billing_event": "CPC",
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "targeting_spec": {
        "location_ids": [
            "{{location_ids}}"
        ]
    },
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": [
        "PLACEMENT_TIKTOK"
    ]
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "adgroup_id": "{{adgroup_id}}",
        "adgroup_name": "{{adgroup_name}}",
        "advertiser_id": "{{advertiser_id}}",
        "bid_price": {{bid_price}},
        "bid_type": "BID_TYPE_CUSTOM",
        "billing_event": "CPC",
        "budget": 0,
        "budget_mode": "BUDGET_MODE_INFINITE",
        "campaign_id": "{{campaign_id}}",
        "campaign_name": "{{campaign_name}}",
        "comment_disabled": false,
        "create_time": "{{create_time}}",
        "dayparting": "{{dayparting}}",
        "messaging_app_account_id": "{{messaging_app_account_id}}",
        "messaging_app_type": "MESSENGER",
        "min_budget": 0,
        "modify_time": "{{modify_time}}",
        "operation_status": "ENABLE",
        "optimization_goal": "CLICK",
        "pacing": "PACING_MODE_SMOOTH",
        "phone_info": {},
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "promotion_type": "LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE",
        "schedule_end_time": "{{schedule_end_time}}",
        "schedule_start_time": "{{schedule_start_time}}",
        "schedule_type": "SCHEDULE_START_END",
        "search_result_enabled": false,
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "share_disabled": false,
        "targeting_optimization_mode": "AUTOMATIC",
        "targeting_spec": {
            "actions": [],
            "age_groups": [
                "AGE_18_24",
                "AGE_25_34",
                "AGE_35_44",
                "AGE_45_54",
                "AGE_55_100"
            ],
            "brand_safety_type": "LIMITED_INVENTORY",
            "category_exclusion_ids": [
                "{{category_exclusion_ids}}"
            ],
            "gender": "GENDER_UNLIMITED",
            "location_ids": [
                "{{location_ids}}"
            ],
            "spc_audience_age": "OVER_EIGHTEEN",
            "spending_power": "ALL"
        },
        "video_download_disabled": false
    }
}
(/code)

目标为对话，即时通讯应用为 WhatsApp

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "request_id": "{{request_id}}",
    "adgroup_name": "{{adgroup_name}}",
    "optimization_goal": "CONVERSATION",
    "promotion_type": "LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE",
    "messaging_app_type": "WHATSAPP",
    "phone_info": {
        "phone_number": "{{phone_number}}",
        "phone_region_code": "US",
        "phone_region_calling_code": "+1"
    },
    "message_event_set_id": "{{message_event_set_id}}",
    "bid_type": "BID_TYPE_CUSTOM",
    "conversion_bid_price": {{conversion_bid_price}},
    "billing_event": "OCPM",
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "targeting_spec": {
        "location_ids": [
            "{{location_ids}}"
        ]
    },
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": [
        "PLACEMENT_TIKTOK"
    ]
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "adgroup_id": "{{adgroup_id}}",
        "adgroup_name": "{{adgroup_name}}",
        "advertiser_id": "{{advertiser_id}}",
        "attribution_event_count": "ONCE",
        "bid_type": "BID_TYPE_CUSTOM",
        "billing_event": "OCPM",
        "budget": 0,
        "budget_mode": "BUDGET_MODE_INFINITE",
        "campaign_id": "{{campaign_id}}",
        "campaign_name": "{{campaign_name}}",
        "click_attribution_window": "SEVEN_DAYS",
        "comment_disabled": false,
        "conversion_bid_price": {{conversion_bid_price}},
        "create_time": "{{create_time}}",
        "dayparting": "{{dayparting}}",
        "engaged_view_attribution_window": "ONE_DAY",
        "incentive_offer_type": "COST_CAP_AND_MIN_ROAS",
        "message_event_set_id": "{{message_event_set_id}}",
        "messaging_app_account_id": "{{messaging_app_account_id}}",
        "messaging_app_type": "WHATSAPP",
        "min_budget": 0,
        "modify_time": "{{modify_time}}",
        "operation_status": "ENABLE",
        "optimization_event": "MESSAGE",
        "optimization_goal": "CONVERSATION",
        "pacing": "PACING_MODE_SMOOTH",
        "phone_info": {
            "phone_number": "{{phone_number}}",
            "phone_region_calling_code": "+1",
            "phone_region_code": "US"
        },
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "promotion_type": "LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE",
        "schedule_end_time": "{{schedule_end_time}}",
        "schedule_start_time": "{{schedule_start_time}}",
        "schedule_type": "SCHEDULE_START_END",
        "search_result_enabled": false,
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "share_disabled": false,
        "skip_learning_phase": true,
        "targeting_optimization_mode": "AUTOMATIC",
        "targeting_spec": {
            "actions": [],
            "age_groups": [
                "AGE_18_24",
                "AGE_25_34",
                "AGE_35_44",
                "AGE_45_54",
                "AGE_55_100"
            ],
            "brand_safety_type": "LIMITED_INVENTORY",
            "category_exclusion_ids": [
                "{{category_exclusion_ids}}"
            ],
            "gender": "GENDER_UNLIMITED",
            "location_ids": [
                "{{location_ids}}"
            ],
            "spc_audience_age": "OVER_EIGHTEEN",
            "spending_power": "ALL"
        },
        "video_download_disabled": false,
        "view_attribution_window": "ONE_DAY"
    }
}
(/code)

目标为点击，使用即时通讯 URL

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "campaign_id": "{{campaign_id}}",
    "request_id": "{{request_id}}",
    "adgroup_name": "{{adgroup_name}}",
    "optimization_goal": "CLICK",
    "promotion_type": "LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE",
    "messaging_app_type": "IM_URL",
    "bid_type": "BID_TYPE_CUSTOM",
    "bid_price": {{bid_price}},
    "billing_event": "CPC",
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "targeting_spec": {
        "location_ids": [
            "{{location_ids}}"
        ]
    },
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": [
        "PLACEMENT_TIKTOK"
    ]
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "adgroup_id": "{{adgroup_id}}",
        "adgroup_name": "{{adgroup_name}}",
        "advertiser_id": "{{advertiser_id}}",
        "bid_price": {{bid_price}},
        "bid_type": "BID_TYPE_CUSTOM",
        "billing_event": "CPC",
        "budget": 0,
        "budget_mode": "BUDGET_MODE_INFINITE",
        "campaign_id": "{{campaign_id}}",
        "campaign_name": "{{campaign_name}}",
        "comment_disabled": false,
        "create_time": "{{create_time}}",
        "dayparting": "{{dayparting}}",
        "messaging_app_type": "IM_URL",
        "min_budget": 0,
        "modify_time": "{{modify_time}}",
        "operation_status": "ENABLE",
        "optimization_goal": "CLICK",
        "pacing": "PACING_MODE_SMOOTH",
        "phone_info": {},
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "promotion_type": "LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE",
        "schedule_end_time": "{{schedule_end_time}}",
        "schedule_start_time": "{{schedule_start_time}}",
        "schedule_type": "SCHEDULE_START_END",
        "search_result_enabled": false,
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "share_disabled": false,
        "targeting_optimization_mode": "AUTOMATIC",
        "targeting_spec": {
            "actions": [],
            "age_groups": [
                "AGE_18_24",
                "AGE_25_34",
                "AGE_35_44",
                "AGE_45_54",
                "AGE_55_100"
            ],
            "brand_safety_type": "LIMITED_INVENTORY",
            "category_exclusion_ids": [
                "{{category_exclusion_ids}}"
            ],
            "gender": "GENDER_UNLIMITED",
            "location_ids": [
                "{{location_ids}}"
            ],
            "spc_audience_age": "OVER_EIGHTEEN",
            "spending_power": "ALL"
        },
        "video_download_disabled": false
    }
}
(/code)

3. 创建广告

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

需确保满足以下要求。完整参数列表参见 /smart_plus/ad/create/ 接口。

设置 要求 参数 如何配置参数
广告名称
（可选）		 默认情况下，系统将自动生成广告名称。
你可以通过传入合法的广告名称来自定义。		 ad_name
  • 若想系统自动生成广告名称，需将此字段设置为 ""（空字符串）。
  • 若想自定义广告名称，需传入非空字符串值。
目标页面 查看适用于不同场景的目标页面和监测通讯事件组选项，了解如何配置该设置。 landing_page_url_list
page_list		 查看适用于不同场景的目标页面和监测通讯事件组选项，了解如何配置这些参数。
创意素材
· 广告创意和广告文案		 单个广告可添加 1-50 个广告创意，这些创意可包含以下类型：
  • 视频
  • TikTok 视频帖子
  • TikTok 照片帖子
  • 轮播

查看按广告发布身份和广告类型划分的广告创意组合文档，了解基于广告发布身份类型的可用广告创意组合。		 ad_format 传入合法值
creative_list
video_info
image_info
music_info
ad_text_list
tiktok_item_id		 通过 creative_list 传入 1-50 个广告创意。广告创意可以是以下任意类型：
  • 视频
  • TikTok 视频帖子
  • TikTok 照片帖子
  • 轮播

查看按广告发布身份和广告类型划分的广告创意组合文档，了解基于广告发布身份类型的可用广告创意组合的配置。
添加商品和服务信息
（可选）		 未启用 N/A N/A
行动引导文案 动态 call_to_action_id 传入合法值
call_to_action_list 不传入
免责声明
（可选）		 已启用或未启用 disclaimer 传入合法值或不传入
监测
· TikTok 事件监测
  · 应用事件
（可选）		 已启用或未启用 tracking_app_id 传入合法值或不传入
监测
· TikTok 事件监测
  · 通讯事件组
（可选）		 查看适用于不同场景的目标页面和监测通讯事件组选项，了解如何配置该设置。 tracking_message_event_set_id 查看适用于不同场景的目标页面和监测通讯事件组选项，了解如何配置该参数。
监测
· 第三方监测设置
  · 展示监测 URL
（可选）		 已启用或未启用 impression_tracking_url 传入合法值或不传入
监测
· 第三方监测设置
  · 点击监测 URL
（可选）		 已启用或未启用 click_tracking_url 传入合法值或不传入

适用于不同场景的目标页面和监测通讯事件组选项

下表列出了根据针对即时通讯应用（或自定义 URL）的广告组设置和优化目标，可用的广告目标页面和监测通讯事件组选项。了解如何为每个选项设置参数。

即时通讯应用或自定义 URL
(messaging_app_type)		 可用优化目标 (optimization_goal) 可用目标页面 如何配置目标页面 如何配置监测通讯事件组
(tracking_message_event_set_id)
Messenger
(MESSENGER)		 点击
(CLICK)		 即时通讯应用 请勿传入 landing_page_url_list、page_list、deeplink、deeplink_type 和 fallback_type。
系统将根据你在广告组层级的即时通讯应用设置自动填充 landing_page_url_list。		 未启用或已启用，度量通讯事件组 (tracking_message_event_set_id)。
TikTok 即时体验页面 通过 page_list 传入 TikTok 即时体验页面，请勿传入 landing_page_url_list、deeplink、deeplink_type 和 fallback_type。page_list 需与广告组层级的相应即时通讯应用信息匹配。
  • 若想确认 page_list 是否与广告组层级的相应即时通讯应用信息匹配，需使用 /page/get/ 接口，并查看返回的 messaging_app_type 和 messaging_app_account_id。
 未启用
对话
(CONVERSATION)		 即时通讯应用 请勿传入 landing_page_url_list、page_list、deeplink、deeplink_type 和 fallback_type。
系统将根据你在广告组层级的即时通讯应用设置自动填充 landing_page_url_list。		 未启用
WhatsApp
(WHATSAPP)		 点击
(CLICK)		 即时通讯应用 请勿传入 landing_page_url_list 和 page_list。
系统将根据你在广告组层级的即时通讯应用设置自动填充 landing_page_url_list。		 未启用或已启用，度量通讯事件组 (tracking_message_event_set_id)。
TikTok 即时体验页面 通过 page_list 传入 TikTok 即时体验页面，请勿传入 landing_page_url_list、deeplink、deeplink_type 和 fallback_type。page_list 需与广告组层级的相应即时通讯应用信息匹配。
  • 若想确认 page_list 是否与广告组层级的相应即时通讯应用信息匹配，需使用 /page/get/ 接口，并查看返回的 messaging_app_type 和 messaging_app_account_id。
 未启用
对话
(CONVERSATION)		 即时通讯应用 请勿传入 landing_page_url_list、page_list、deeplink、deeplink_type 和 fallback_type。
系统将根据你在广告组层级的即时通讯应用设置自动填充 landing_page_url_list。		 未启用
Zalo
(ZALO)		 点击
(CLICK)		 即时通讯应用 请勿传入 landing_page_url_list、page_list、deeplink、deeplink_type 和 fallback_type。
系统将根据你在广告组层级的即时通讯应用设置自动填充 landing_page_url_list。		 未启用
TikTok 即时体验页面 通过 page_list 传入 TikTok 即时体验页面，请勿传入 landing_page_url_list、deeplink、deeplink_type 和 fallback_type。page_list 需与广告组层级的相应即时通讯应用信息匹配。 未启用
对话
(CONVERSATION)		 即时通讯应用 请勿传入 landing_page_url_list、page_list、deeplink、deeplink_type 和 fallback_type。
系统将根据你在广告组层级的即时通讯应用设置自动填充 landing_page_url_list。		 未启用
Line
(LINE)		 点击
(CLICK)		 即时通讯应用 请勿传入 landing_page_url_list、page_list、deeplink、deeplink_type 和 fallback_type。
系统将根据你在广告组层级的即时通讯应用设置自动填充 landing_page_url_list。		 未启用
TikTok 即时体验页面 通过 page_list 传入 TikTok 即时体验页面，请勿传入 landing_page_url_list、deeplink、deeplink_type 和 fallback_type。page_list 需与广告组层级的相应即时通讯应用信息匹配。 未启用
即时通讯 URL
(IM_URL)		 点击
(CLICK)		 即时通讯应用 手动传入即时通讯 URL，请勿传入 page_list。
  • 若想将即时通讯 URL 指定为 Apple 通用链接或 Android 应用链接：
    • 将 landing_page_url_list 设置为以 http:// 或 https:// 开头的链接。
    • 请勿传入 deeplink、deeplink_type 和 fallback_type。
  • 若想将即时通讯 URL 指定为即时通讯应用的自定义 URL 架构：
    • 将 deeplink 设置为 scheme://resource 格式的链接。例如，WhatsApp 的自定义 URL 架构应遵循 whatsapp://resource 格式。
    • 将 deeplink_type 设置为 NORMAL。
    • 将 fallback_type 设置为 WEBSITE。
    • 将 landing_page_url_list 设置为失败路径 URL，格式为以 http:// 或 https:// 开头的 Apple 通用链接或 Android 应用链接。

      注意：若想验证 URL 是否为合法的 Apple 通用链接、Android 应用链接或自定义 URL 架构，需将 URL 传入 /tool/url_validate/ 接口中的参数 url。

 未启用
TikTok 即时体验页面 通过 page_list 传入 TikTok 即时体验页面，请勿传入 landing_page_url_list、deeplink、deeplink_type 和 fallback_type。

示例

目标页面为即时通讯应用

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "ad_name": "{{ad_name}}",
    "creative_list": [
        {
            "creative_info": {
                "ad_format": "CAROUSEL_ADS",
                "image_info": [
                    {
                        "web_uri": "{{web_uri}}"
                    }
                ],
                "music_info": {
                    "music_id": "{{music_id}}"
                },
                "identity_type": "TT_USER",
                "identity_id": "{{identity_id}}"
            }
        },
        {
            "creative_info": {
                "ad_format": "SINGLE_VIDEO",
                "video_info": {
                    "video_id": "{{video_id}}"
                },
                "image_info": [
                    {
                        "web_uri": "{{web_uri}}"
                    }
                ],
                "identity_type": "TT_USER",
                "identity_id": "{{identity_id}}"
            }
        },
        {
            "creative_info": {
                "ad_format": "SINGLE_VIDEO",
                "tiktok_item_id": "{{tiktok_item_id}}",
                "identity_type": "TT_USER",
                "identity_id": "{{identity_id}}"
            }
        }
    ],
    "ad_text_list": [
        {
            "ad_text": "{{ad_text}}"
        },
        {
            "ad_text": "{{ad_text}}"
        },
        {
            "ad_text": "{{ad_text}}"
        },
        {
            "ad_text": "{{ad_text}}"
        },
        {
            "ad_text": "{{ad_text}}"
        }
    ],
    "ad_configuration": {
        "call_to_action_id": "{{call_to_action_id}}"
    }
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_configuration": {
            "call_to_action_id": "{{call_to_action_id}}",
            "dark_post_status": "OFF",
            "fallback_type": "UNSET",
            "phone_info": {},
            "tracking_info": {},
            "utm_params": []
        },
        "ad_name": "{{ad_name}}",
        "ad_text_list": [
            {
                "ad_text": "{{ad_text}}"
            },
            {
                "ad_text": "{{ad_text}}"
            },
            {
                "ad_text": "{{ad_text}}"
            },
            {
                "ad_text": "{{ad_text}}"
            },
            {
                "ad_text": "{{ad_text}}"
            }
        ],
        "adgroup_id": "{{adgroup_id}}",
        "adgroup_name": "{{adgroup_name}}",
        "advertiser_id": "{{advertiser_id}}",
        "auto_message_list": [],
        "call_to_action_list": [],
        "campaign_id": "{{campaign_id}}",
        "campaign_name": "{{campaign_name}}",
        "create_time": "{{create_time}}",
        "creative_list": [
            {
                "ad_material_id": "{{ad_material_id}}",
                "creative_info": {
                    "ad_format": "SINGLE_VIDEO",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "TT_USER",
                    "image_info": [
                        {
                            "web_uri": "{{web_uri}}"
                        }
                    ],
                    "material_name": "{{material_name}}",
                    "video_info": {
                        "file_name": "{{file_name}}",
                        "video_id": "{{video_id}}"
                    }
                },
                "material_operation_status": "ENABLE"
            },
            {
                "ad_material_id": "{{ad_material_id}}",
                "creative_info": {
                    "ad_format": "SINGLE_VIDEO",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "TT_USER",
                    "tiktok_item_id": "{{tiktok_item_id}}"
                },
                "material_operation_status": "ENABLE"
            },
            {
                "ad_material_id": "{{ad_material_id}}",
                "creative_info": {
                    "ad_format": "CAROUSEL_ADS",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "TT_USER",
                    "image_info": [
                        {
                            "web_uri": "{{web_uri}}"
                        }
                    ],
                    "material_name": "{{material_name}}",
                    "music_info": {
                        "music_id": "{{music_id}}"
                    }
                },
                "material_operation_status": "ENABLE"
            }
        ],
        "deeplink_list": [],
        "interactive_add_on_list": [],
        "landing_page_url_list": [
            {
                "landing_page_url": "{{landing_page_url}}"
            }
        ],
        "modify_time": "{{modify_time}}",
        "operation_status": "ENABLE",
        "page_list": [],
        "secondary_status": "AD_STATUS_AUDIT",
        "smart_plus_ad_id": "{{smart_plus_ad_id}}"
    }
}
(/code)

目标页面为使用 Apple 通用链接或 Android 应用链接的即时通讯 URL

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "ad_name": "{{ad_name}}",
    "creative_list": [
        {
            "creative_info": {
                "ad_format": "CAROUSEL_ADS",
                "image_info": [
                    {
                        "web_uri": "{{web_uri}}"
                    }
                ],
                "music_info": {
                    "music_id": "{{music_id}}"
                },
                "identity_type": "TT_USER",
                "identity_id": "{{identity_id}}"
            }
        },
        {
            "creative_info": {
                "ad_format": "SINGLE_VIDEO",
                "video_info": {
                    "video_id": "{{video_id}}"
                },
                "image_info": [
                    {
                        "web_uri": "{{web_uri}}"
                    }
                ],
                "identity_type": "TT_USER",
                "identity_id": "{{identity_id}}"
            }
        },
        {
            "creative_info": {
                "ad_format": "SINGLE_VIDEO",
                "tiktok_item_id": "{{tiktok_item_id}}",
                "identity_type": "TT_USER",
                "identity_id": "{{identity_id}}"
            }
        }
    ],
    "ad_text_list": [
        {
            "ad_text": "{{ad_text}}"
        },
        {
            "ad_text": "{{ad_text}}"
        },
        {
            "ad_text": "{{ad_text}}"
        },
        {
            "ad_text": "{{ad_text}}"
        },
        {
            "ad_text": "{{ad_text}}"
        }
    ],
    "landing_page_url_list": [
        {
            "landing_page_url": "{{landing_page_url}}"
        }
    ],
    "ad_configuration": {
        "call_to_action_id": "{{call_to_action_id}}"
    }
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_configuration": {
            "call_to_action_id": "{{call_to_action_id}}",
            "dark_post_status": "OFF",
            "fallback_type": "UNSET",
            "phone_info": {},
            "tracking_info": {},
            "utm_params": []
        },
        "ad_name": "{{ad_name}}",
        "ad_text_list": [
            {
                "ad_text": "{{ad_text}}"
            },
            {
                "ad_text": "{{ad_text}}"
            },
            {
                "ad_text": "{{ad_text}}"
            },
            {
                "ad_text": "{{ad_text}}"
            },
            {
                "ad_text": "{{ad_text}}"
            }
        ],
        "adgroup_id": "{{adgroup_id}}",
        "adgroup_name": "{{adgroup_name}}",
        "advertiser_id": "{{advertiser_id}}",
        "auto_message_list": [],
        "call_to_action_list": [],
        "campaign_id": "{{campaign_id}}",
        "campaign_name": "{{campaign_name}}",
        "create_time": "{{create_time}}",
        "creative_list": [
            {
                "ad_material_id": "{{ad_material_id}}",
                "creative_info": {
                    "ad_format": "SINGLE_VIDEO",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "TT_USER",
                    "image_info": [
                        {
                            "web_uri": "{{web_uri}}"
                        }
                    ],
                    "material_name": "",
                    "video_info": {
                        "file_name": "",
                        "video_id": "{{video_id}}"
                    }
                },
                "material_operation_status": "ENABLE"
            },
            {
                "ad_material_id": "{{ad_material_id}}",
                "creative_info": {
                    "ad_format": "SINGLE_VIDEO",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "TT_USER",
                    "tiktok_item_id": "{{tiktok_item_id}}"
                },
                "material_operation_status": "ENABLE"
            },
            {
                "ad_material_id": "{{ad_material_id}}",
                "creative_info": {
                    "ad_format": "CAROUSEL_ADS",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "TT_USER",
                    "image_info": [
                        {
                            "web_uri": "{{web_uri}}"
                        }
                    ],
                    "material_name": "{{material_name}}",
                    "music_info": {
                        "music_id": "{{music_id}}"
                    }
                },
                "material_operation_status": "ENABLE"
            }
        ],
        "deeplink_list": [],
        "interactive_add_on_list": [],
        "landing_page_url_list": [
            {
                "landing_page_url": "{{landing_page_url}}"
            }
        ],
        "modify_time": "{{modify_time}}",
        "operation_status": "ENABLE",
        "page_list": [],
        "secondary_status": "AD_STATUS_AUDIT",
        "smart_plus_ad_id": "{{smart_plus_ad_id}}"
    }
}
(/code)

目标页面为使用自定义 URL 架构的即时通讯 URL

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "ad_name": "{{ad_name}}",
    "creative_list": [
        {
            "creative_info": {
                "ad_format": "CAROUSEL_ADS",
                "image_info": [
                    {
                        "web_uri": "{{web_uri}}"
                    }
                ],
                "music_info": {
                    "music_id": "{{music_id}}"
                },
                "identity_type": "TT_USER",
                "identity_id": "{{identity_id}}"
            }
        },
        {
            "creative_info": {
                "ad_format": "SINGLE_VIDEO",
                "video_info": {
                    "video_id": "{{video_id}}"
                },
                "image_info": [
                    {
                        "web_uri": "{{web_uri}}"
                    }
                ],
                "identity_type": "TT_USER",
                "identity_id": "{{identity_id}}"
            }
        },
        {
            "creative_info": {
                "ad_format": "SINGLE_VIDEO",
                "tiktok_item_id": "{{tiktok_item_id}}",
                "identity_type": "TT_USER",
                "identity_id": "{{identity_id}}"
            }
        }
    ],
    "ad_text_list": [
        {
            "ad_text": "{{ad_text}}"
        },
        {
            "ad_text": "{{ad_text}}"
        },
        {
            "ad_text": "{{ad_text}}"
        },
        {
            "ad_text": "{{ad_text}}"
        },
        {
            "ad_text": "{{ad_text}}"
        }
    ],
    "landing_page_url_list": [
        {
            "landing_page_url": "{{landing_page_url}}"
        }
    ],
    "deeplink_list": [
        {
            "deeplink": "{{deeplink}}",
            "deeplink_type": "NORMAL"
        }
    ],
    "ad_configuration": {
        "call_to_action_id": "{{call_to_action_id}}",
        "fallback_type": "WEBSITE"
    }
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_configuration": {
            "call_to_action_id": "{{call_to_action_id}}",
            "dark_post_status": "OFF",
            "fallback_type": "WEBSITE",
            "phone_info": {},
            "tracking_info": {},
            "utm_params": []
        },
        "ad_name": "{{ad_name}}",
        "ad_text_list": [
            {
                "ad_text": "{{ad_text}}"
            },
            {
                "ad_text": "{{ad_text}}"
            },
            {
                "ad_text": "{{ad_text}}"
            },
            {
                "ad_text": "{{ad_text}}"
            },
            {
                "ad_text": "{{ad_text}}"
            }
        ],
        "adgroup_id": "{{adgroup_id}}",
        "adgroup_name": "{{adgroup_name}}",
        "advertiser_id": "{{advertiser_id}}",
        "auto_message_list": [],
        "call_to_action_list": [],
        "campaign_id": "{{campaign_id}}",
        "campaign_name": "{{campaign_name}}",
        "create_time": "{{create_time}}",
        "creative_list": [
            {
                "ad_material_id": "{{ad_material_id}}",
                "creative_info": {
                    "ad_format": "SINGLE_VIDEO",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "TT_USER",
                    "image_info": [
                        {
                            "web_uri": "{{web_uri}}"
                        }
                    ],
                    "material_name": "",
                    "video_info": {
                        "file_name": "",
                        "video_id": "{{video_id}}"
                    }
                },
                "material_operation_status": "ENABLE"
            },
            {
                "ad_material_id": "{{ad_material_id}}",
                "creative_info": {
                    "ad_format": "SINGLE_VIDEO",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "TT_USER",
                    "tiktok_item_id": "{{tiktok_item_id}}"
                },
                "material_operation_status": "ENABLE"
            },
            {
                "ad_material_id": "{{ad_material_id}}",
                "creative_info": {
                    "ad_format": "CAROUSEL_ADS",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "TT_USER",
                    "image_info": [
                        {
                            "web_uri": "{{web_uri}}"
                        }
                    ],
                    "material_name": "{{material_name}}",
                    "music_info": {
                        "music_id": "{{music_id}}"
                    }
                },
                "material_operation_status": "ENABLE"
            }
        ],
        "deeplink_list": [
            {
                "deeplink": "{{deeplink}}",
                "deeplink_type": "NORMAL"
            }
        ],
        "interactive_add_on_list": [],
        "landing_page_url_list": [
            {
                "landing_page_url": "{{landing_page_url}}"
            }
        ],
        "modify_time": "{{modify_time}}",
        "operation_status": "ENABLE",
        "page_list": [],
        "secondary_status": "AD_STATUS_AUDIT",
        "smart_plus_ad_id": "{{smart_plus_ad_id}}"
    }
}
(/code)
← 创建升级版 Smart+ 汽车库存广告创建启用网站和应用优化的升级版 Smart+ 广告 →

内容来源：TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了？
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →