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

创建升级版 Smart+ 商品库应用广告

本文介绍使用销量推广目标创建升级版 Smart+ 商品库应用广告的步骤。

升级版 Smart+ 商品库应用广告是一种升级版 Smart+ 销量推广系列，使用商品库中的商品来投放广告。对于这类推广系列，你需要在推广系列层级将 objective_type 设置为 WEB_CONVERSIONS，并将 sales_destination 设置为 APP。借助升级版 Smart+ 商品库应用广告，你可以通过两种主要方式扩大应用用户群：获取新用户（潜客开发）、重新吸引现有用户（再营销）。

根据你是否创建专属推广系列，你可以创建未启用专属推广系列或启用专属推广系列的升级版 Smart+ 商品库应用广告。要了解创建这两种推广系列的详细说明，请查看相应的小节：“创建未启用专属推广系列的升级版 Smart+ 商品库应用广告”、“创建启用专属推广系列的升级版 Smart+ 商品库应用广告”。

创建未启用专属推广系列的升级版 Smart+ 商品库应用广告

未启用专属推广系列的升级版 Smart+ 商品库应用广告是一种升级版 Smart+ 销量推广系列，它未启用 iOS 14 专属推广系列设置，并使用商品库中的商品来投放广告。对于此类推广系列，你可以将 campaign_type 参数设置为 REGULAR_CAMPAIGN，或者不传入 campaign_type。

创建未启用专属推广系列的升级版 Smart+ 商品库应用广告的前提条件

若想创建升级版 Smart+ 商品库应用广告，需先在商务中心设置商品库。

设置商品库的步骤： 1. 使用/catalog/create/接口创建一个商品库。 - 商品库可以是以下任意类型： - 电商 - 酒店 - 航班 - 目的地 - 娱乐 2. 使用 /catalog/product/upload/ 接口（JSON 模式）、/catalog/product/file/ 接口（CSV 文件模板）或 /catalog/feed/create/ 接口（在线数据流上传）将商品上传至商品库。 3. 使用 /catalog/product/log/ 接口查看商品处理结果。 传入第 2 步获得的 feed_log_id。如果返回的 error_affected_products 字段不为空，查看问题详细信息，并回到第 2 步重新上传商品。 4. （可选）使用 /catalog/set/create/ 接口创建商品系列。 若想从商品系列中选择商品，必须创建商品系列。否则可跳过这一步。 5. （可选）使用 /bc/member/invite/ 接口邀请成员加入商务中心并授予管理员权限。 你还可以选择要分配给受邀成员的 advertiser_role。 6. （可选）使用 /bc/asset/assign/ 接口向成员分享商品库，并授予商品库管理权限。 务必在 asset_type 字段中传入 CATALOG，在 catalog_role 字段中传入 ADMIN。 若想查看所有商品库 API，参见此处。

步骤

创建推广系列

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

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

设置 要求 参数 如何配置参数
推广目标 销量 objective_type WEB_CONVERSIONS
销售目标页面 应用 sales_destination APP
商品库类型 使用以下任意类型：
  • 电商
  • 旅行和娱乐
 catalog_enabled true
catalog_type 使用以下任意值：
  • ECOMMERCE
  • TRAVEL_ENTERTAINMENT
iOS 14 专属推广系列 未启用

若想了解如何创建启用 iOS 14 专属推广系列的升级版 Smart+ 商品库应用广告，请查看创建启用专属推广系列的升级版 Smart+ 商品库应用广告。		 campaign_type REGULAR_CAMPAIGN 或不传入
app_id 不传入
campaign_app_profile_page_state 不传入
推广系列名称 传入合法名称 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_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 时：
    • 不传入
实时 API (RTA)（可选） 已启用或未启用

注意：广告组层级的可用广告位可能因你的 RTA 设置而异。

 rta_id 传入与你的广告账号关联的其中一个 RTA ID。

若想获取与你的广告账号关联的 RTA ID 列表，请联系你的 TikTok 代表。

注意：广告组层级的可用广告位设置（placement_type 和 placements）可能因你的 rta_id 配置而异。
使用 RTA 自动选择商品（可选）
  • 如果未启用 RTA，不支持此设置。
  • 如果已启用 RTA，可启用或禁用此设置。
 rta_product_selection_enabled
  • 当 rta_id 不传入时：
    • false 或不传入
  • 当 rta_id 传入时，使用以下任意配置：
    • true
    • false 或不传入
使用 RTA 出价（可选）
  • 如果未启用 RTA，不支持此设置。
  • 如果已启用 RTA，可启用或禁用此设置。
 rta_bid_enabled
  • 当 rta_id 不传入时：
    • false 或不传入
  • 当 rta_id 传入时，使用以下任意配置：
    • true
    • false 或不传入

示例

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/campaign/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "request_id": {{request_id}},
    "objective_type": "WEB_CONVERSIONS",
    "sales_destination": "APP",
    "catalog_enabled": true,
    "catalog_type": "ECOMMERCE",
    "campaign_type": "REGULAR_CAMPAIGN",
    "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}}",
        "campaign_type": "REGULAR_CAMPAIGN",
        "catalog_enabled": true,
        "catalog_type": "ECOMMERCE",
        "create_time": "{{create_time}}",
        "is_promotional_campaign": false,
        "modify_time": "{{modify_time}}",
        "objective_type": "WEB_CONVERSIONS",
        "operation_status": "ENABLE",
        "sales_destination": "APP",
        "secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "smart_plus_adgroup_mode": "MULTIPLE"
    }
}
(/code)

创建广告组

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

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

设置 要求 参数 如何配置参数
广告组名称 传入合法名称 adgroup_name 传入合法值
商品数据源详细信息
· 商品库		 传入至少包含两个通过审核的商品的商品库

注意：

  • 如果在推广系列层级未启用 RTA，可以传入以下任一商品库类型：
    • 电商
    • 酒店
    • 航班
    • 目的地
    • 娱乐
  • 如果在推广系列层级已启用 RTA，可以传入以下任一商品库类型：
    • 电商
    • 娱乐

 catalog_id
catalog_authorized_bc_id		 传入合法值。
商品库 (catalog_id) 需至少包含两个通过审核的商品。可查看从 /catalog/overview/ 接口返回的 approved 值进行验证，该值应至少为 2。


注意：

  • 如果在推广系列层级不传入 rta_id，商品库的 catalog_type 可以是以下任意类型：
    • ECOM
    • HOTEL
    • FLIGHT
    • DESTINATION
    • ENTERTAINMENT
  • 如果在推广系列层级传入 rta_id，商品库的 catalog_type 可以是以下任意类型：
    • ECOM
    • ENTERTAINMENT
优化和出价
· 应用		 使用以下任意类型：
  • Android 应用
  • iOS 应用

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

 promotion_type
app_id
  • 若想传入 Android 应用：
    • 通过 app_id 传入 Android 应用。
    • 将 promotion_type 设置为 APP_ANDROID。
  • 若想传入 iOS 应用：
    • 通过 app_id 传入 iOS 应用。
    • 将 promotion_type 设置为 APP_IOS。
若想获取你的广告账号下的应用列表，需使用 /app/list/ 接口。
  • 对于 Android 应用，返回的 platform 将为 ANDROID。
  • 对于 iOS 应用，返回的 platform 将为 IOS。

注意：当推广系列层级的 budget_optimize_on 为 true 时，为同一推广系列内的所有广告组传入相同的 promotion_type。
优化和出价
· 目标		 使用以下任意类型：
  • 点击
    • 我们会将你的广告投放给最有可能点击的用户。
  • 安装
    • 我们会将你的广告展示给最有可能安装你的应用的用户。
  • 应用内事件
    • 我们会将你的广告展示给最有可能在你的应用中执行某些操作的用户。
  • 价值
    • 为了最大限度地提高总付费价值，我们会将你的广告投放给更有可能付费购买的用户。

注意：

  • 如果你选择推广系列预算模式，此设置必须在同一推广系列内的所有广告组中保持一致。
 optimization_goal 使用以下任意值：
  • CLICK
  • INSTALL（optimization_event 需设置为 ACTIVE）
    • 若想使用 INSTALL，你需要确保已为所选应用设置第三方监测。
      • 若想查看是否已经为应用配置了第三方监测 (tracking_url)，需使用 /app/info/ 端口。
      • 若想为现有应用添加第三方监测，需使用 /app/update/ 端口。查看移动度量合作伙伴监测文档，了解如何从第三方合作伙伴处获得监测链接。
  • IN_APP_EVENT（需传入 optimization_event）
    • 若想使用 IN_APP_EVENT，你需要确保传入的事件 (optimization_event) 适用于所选应用。
  • VALUE（需传入 optimization_event）
    • 如果你将此字段设置为 VALUE，请一并传入广告位参数（placement_type 或同时传入 placement_type 和 placements）。
    • 进一步了解价值优化。

注意：当推广系列层级的 budget_optimize_on 为 true 时，为同一推广系列内的所有广告组传入相同的 optimization_goal。
优化和出价
· 选择应用内事件（当目标为应用内事件时）		 使用以下任意类型：
  • 标准事件
  • 自定义转化

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

 optimization_event
custom_conversion_id		 当 optimization_goal 为 IN_APP_EVENT 时，传入以下任意项：
  • 通过 optimization_event设置标准事件
  • 通过 custom_conversion_id 和 optimization_event设置自定义转化以及关联的转化事件

  • 若想获取应用的可用优化事件 (optimization_event)，需使用 /app/optimization_event/ 接口。
  • 若想获取与应用关联的自定义转化列表，需使用 /custom_conversion/list/ 接口。
    • 若想确认自定义转化是否符合广告组创建的资格条件：
      • 确保返回的 optimization_event 与广告组创建期间传入的 optimization_event 一致。
      • 确保 activity_status 为 NO_RECENT_ACTIVITY 或 ACTIVE。

注意：当推广系列层级的 budget_optimize_on 为 true 时，optimization_event 和 custom_conversion_id（如传入）必须在同一推广系列内的所有广告组中保持一致。
优化和出价
· 出价策略、（可选）目标 CPA 和（可选）目标 ROAS
  • 如果目标为点击、安装或应用内事件，出价策略只能为最大投放量或成本上限。
    • 对于成本上限出价策略，你需要同时传入目标 CPA。
  • 如果目标为价值，出价策略可为最高价值 或最低 ROAS。
    • 对于最低 ROAS 出价策略，你需要同时传入目标 ROAS。

注意：

  • 出价策略必须在同一推广系列内的所有广告组中保持一致。
  • 如果你选择推广系列预算模式，目标 CPA 和目标 ROAS（如传入）必须在同一推广系列内的所有广告组中保持一致。
  • 目标 CPA 和目标 ROAS 出价策略仅支持采用日预算模式的推广系列或广告组。

 bid_type
bid_price
conversion_bid_price
deep_bid_type
roas_bid
  • 如果 optimization_goal 为 CLICK、INSTALL 或 IN_APP_EVENT：
    • 将 bid_type设置为 BID_TYPE_CUSTOM（成本上限）或 BID_TYPE_NO_BID（最大投放量）。请勿传入 deep_bid_type 和 roas_bid。
      • 如果 optimization_goal 为 INSTALL 或 IN_APP_EVENT，且 bid_type 为 BID_TYPE_CUSTOM，请同时传入 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。

注意：

  • bid_type 必须在同一推广系列内的所有广告组中保持一致。
  • 当推广系列层级的 budget_optimize_on 为 true 时，以下设置（如传入）必须在同一推广系列内的所有广告组中保持一致。
    • conversion_bid_price
    • bid_price
    • deep_bid_type
    • roas_bid
  • 在以下任意场景中，你只能将 bid_type 设置为 BID_TYPE_CUSTOM 或将 deep_bid_type 设置为 VO_MIN_ROAS：
    • 在推广系列层级，budget_mode 为 BUDGET_MODE_DYNAMIC_DAILY_BUDGET
    • 在广告组层级，budget_mode 为 BUDGET_MODE_DYNAMIC_DAILY_BUDGET
优化和出价
· 计费事件
  • 如果目标为点击，计费事件应为 CPC。
  • 如果目标为安装、应用内事件或价值，计费事件应为 oCPM。

注意：

  • 如果你选择推广系列预算模式，计费事件必须在同一推广系列内的所有广告组中保持一致。

 billing_event
  • 如果 optimization_goal 为 CLICK，将此字段设置为 CPC。
  • 如果 optimization_goal 为 INSTALL、IN_APP_EVENT 或 VALUE，将此字段设置为 OCPM。

注意：当推广系列层级的 budget_optimize_on 为 true 时，为同一推广系列内的所有广告组传入相同的 billing_event。
优化和出价
· 投放速度		 标准（默认） N/A 升级版 Smart+ 推广系列默认设置为标准投放速度。
预算和排期
· 预算
  • 如果你选择自动推广系列预算模式：
    • 广告组预算会被禁用。推广系列层级预算将用作广告组预算。
  • 如果选择自定义广告组预算策略，你可以使用以下任意广告组预算模式：
    • 总预算
    • 日预算

注意：

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

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

注意：

  • budget_mode（如传入）必须在同一推广系列内的所有广告组中保持一致。
预算和排期
· 自动增加预算（当目标为价值时）		 已启用或未启用

若想启用此设置，应满足以下条件：
  • 在推广系列层级：未启用 CBO。
  • 在广告组层级：
    • 广告组预算为日预算
    • 目标为价值
    • 出价策略为目标 ROAS
    • 出价策略的时间窗口期为第 0 天 ROAS
 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。
    • optimization_goal 为 VALUE。
    • deep_bid_type 为 VO_MIN_ROAS。
    • vbo_window 为 ZERO_DAY。

注意：自动增加预算目前为白名单功能。如需使用此功能，请联系你的 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_FROM_NOW：

  • 在推广系列层级，budget_mode 为 BUDGET_MODE_DYNAMIC_DAILY_BUDGET
  • 在广告组层级，budget_mode 为 BUDGET_MODE_DYNAMIC_DAILY_BUDGET
预算和排期
· 分时段（可选）		 使用以下任意类型：
  • 全天（默认）
  • 选择特定时段
 dayparting 使用以下任意配置：
  • 传入全为 1 的值，或不传入此字段
  • 传入包含 0 的值以表示未投放
受众定向 使用以下任意模式：
  • 潜客开发
    • 寻找有意安装你的应用的新客户
  • 再营销
    • 向已在使用你的应用的客户展示广告

注意：当优化目标为安装时，不支持此设置。

 app_targeting_type 使用以下任意值：
  • PROSPECT
  • RETARGETING


注意：当 optimization_goal 为 INSTALL 时，不支持 app_targeting_type。
受众定向优化模式 使用以下任意模式：
  • 自动定向
    • 你可以使用自动定向来充分利用实时数据和机器学习，向最有可能与广告互动的受众定向投放广告。
  • 自定义定向
    • 你可以使用自定义定向设置，精确控制哪些受众能看到你的广告。这可能会限制广告投放并影响推广效果。

查看升级版 Smart+ 商品库应用广告中不同定向优化模式的可用定向设置，了解每种模式支持的定向设置。		 targeting_optimization_mode 使用以下任意值：
  • AUTOMATIC
  • MANUAL
查看升级版 Smart+ 商品库应用广告中不同定向优化模式的可用定向设置，了解每种模式支持的定向设置。
广告位和品牌安全
· 广告位		 使用以下任意类型：
  • 自动广告位
  • 选择具体广告位：
    • TikTok
    • 全球化应用组合
    • Pangle
 placement_type
placements
  • 若想使用自动广告位，请勿传入 placement_type 和 placements。
    • 系统会根据你的其他设置为你的升级版 Smart+ 广告组自动配置广告位，并会从不同广告位选择优质流量来获得更理想的投放成效。如果提供了参数 placement_type 和 placements，系统将忽略这些参数。
    • 若想获取升级版 Smart+ 广告组的具体广告位设置，需使用 /smart_plus/adgroup/get/ 接口。
  • 若想使用特定广告位，需将 placement_type 设置为 PLACEMENT_TYPE_NORMAL 并在 placements 中传入一个或多个以下广告位：
    • PLACEMENT_TIKTOK
    • PLACEMENT_PANGLE
    • PLACEMENT_GLOBAL_APP_BUNDLE
广告位和品牌安全
· 子广告位
（广告位包含 TikTok 时选填）		 不启用，或启用并带有以下一个或多个选项：
  • Lemon8
  • PineDrama

注意：

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

 tiktok_subplacements 当 placement_type 为 PLACEMENT_TYPE_NORMAL 且 placements 包含 PLACEMENT_TIKTOK 时：
  • 不传入，或传入以下一个或多个值：
    • LEMON8
    • PINE_DRAMA

注意：

  • 在广告组中使用 Lemon8 子广告位 (LEMON8) 目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。
  • 在广告组中使用 PineDrama 子广告位 (PINE_DRAMA) 目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。
广告位和品牌安全
· 品牌安全和适用性		 这些设置仅应用于 TikTok 信息流广告和搜索广告。之前在品牌安全中心所做的任何账号层级的设置都将应用到推广系列。 N/A N/A
若想获取品牌安全中心的广告账号层级品牌安全和适用性设置，需使用 /tiktok_inventory_filters/get/ 接口。
若想配置或更新品牌安全中心的广告账号层级品牌安全和适用性设置，需使用 /tiktok_inventory_filters/update/ 接口。
广告位和品牌安全
· 用户评论		 已启用或未启用 comment_disabled 传入合法值或不传入
广告位和品牌安全
· 允许下载视频		 已启用或未启用 share_disabled 传入合法值或不传入
广告位和品牌安全
· 允许共享视频		 已启用或未启用 video_download_disabled 传入合法值或不传入
广告位和品牌安全
· Pangle 媒体屏蔽列表		 未启用 N/A N/A

升级版 Smart+ 商品库应用广告中不同定向优化模式的可用定向设置

定向优化模式 可用定向设置 要求 参数 如何配置参数
自动定向
（targeting_optimization_mode 为 AUTOMATIC 或不传入）		 受众控制
· 地域		 地域应与商品库的定向地域匹配或为其子集。 location_ids 或 zipcode_ids，或两者都需要 传入与 catalog_id 定向地域匹配或为其子集的地域的 ID。
若想获取商品库的定向地域，需使用 /catalog/get/ 接口并查看返回的 country。
受众控制
· 最低年龄		 选择以下任意选项：
  • 18
  • 25
 spc_audience_age 使用以下任意值：
  • OVER_EIGHTEEN 或不传入
  • OVER_TWENTY_FIVE
受众控制
· 语言
（可选）		 已启用或未启用 languages 传入合法值或不传入
受众控制
· 自定义受众
（可选）		 已启用或未启用 audience_ids 传入合法值或不传入
受众控制
· 排除受众
（可选）		 已启用或未启用 excluded_audience_ids 传入合法值或不传入
受众控制
· 性别
（可选）		 已启用或未启用 gender 传入合法值或不传入
自定义定向
（targeting_optimization_mode 为 MANUAL）		 再营销
· 自定义受众
（使用电商商品库时为可选）		 已启用或未启用 shopping_ads_retargeting_type
shopping_ads_retargeting_actions_days
included_custom_actions
excluded_custom_actions		 传入合法值或不传入
再营销
· 自定义受众
  · 包含
    · 针对商品库受众或自定义受众中的任意用户定向投放
（同时传入商品库包含受众和自定义受众时为可选）		 已启用或未启用 shopping_ads_retargeting_custom_audience_relation 传入合法值或不传入
人群属性 · 地域 传入合法值。
如果传入商品库，地域应与商品库的定向地域匹配或为其子集。		 location_ids 或 zipcode_ids，或两者都需要 传入合法值。
如果传入商品库，传入与 catalog_id 定向地域匹配或为其子集的地域的 ID。
若想获取商品库的定向地域，需使用 /catalog/get/ 接口并查看返回的 country。
人群属性
· 年龄
（可选）		 已启用或未启用 age_groups 传入合法值或不传入
人群属性
· 性别
（可选）		 已启用或未启用 gender 传入合法值或不传入
人群属性
· 语言
（可选）		 已启用或未启用 languages 传入合法值或不传入
自定义受众
· 包含受众
（可选）		 已启用或未启用 audience_ids 传入合法值或不传入
自定义受众
· 智能受众
（可选）		 已启用或未启用 smart_audience_enabled true 或 false
自定义受众
· 排除受众（可选）		 已启用或未启用 excluded_audience_ids 传入合法值或不传入
详细定向
· 兴趣和行为
  · 兴趣
（可选）		 已启用或未启用 interest_category_ids
interest_keyword_ids		 传入合法值或不传入
详细定向
· 兴趣和行为
  · 购买意向
（可选）		 已启用或未启用 purchase_intention_keyword_ids 传入合法值或不传入
详细定向
· 兴趣和行为
  · 视频互动
  · 创作者互动
  · 话题互动
（可选）		 已启用或未启用 actions true 或 false
详细定向
· 兴趣和行为
  · 智能兴趣和行为
（可选）		 已启用或未启用 smart_interest_behavior_enabled 传入合法值或不传入
详细定向
· 消费能力
（可选）		 已启用或未启用 spending_power 传入合法值或不传入
详细定向
· 家庭收入
（可选）		 已启用或未启用 household_income 传入合法值或不传入
设备
· 操作系统（可选）		 已启用或未启用 operating_systems 传入合法值或不传入
设备
· 操作系统版本
（可选）		 已启用或未启用 min_android_version
min_ios_version		 传入合法值或不传入
设备
· 设备机型
（可选）		 已启用或未启用 device_model_ids 传入合法值或不传入
设备
· 连接类型
（可选）		 已启用或未启用 network_types 传入合法值或不传入
设备
· 运营商
（可选）		 已启用或未启用 carrier_ids 传入合法值或不传入
设备
· 互联网服务提供商（可选）		 已启用或未启用 isp_ids 传入合法值或不传入
设备
· 设备价格
（可选）		 已启用或未启用 device_price_ranges 传入合法值或不传入
使用保存的受众
（可选）		 已启用或未启用 saved_audience_id 传入合法值或不传入

示例

请求

(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}}",
    "catalog_id": "{{catalog_id}}",
    "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
    "app_id": "{{app_id}}",
    "promotion_type": "APP_IOS",
    "optimization_goal": "IN_APP_EVENT",
    "optimization_event": "LOGIN",
    "bid_type": "BID_TYPE_NO_BID",
    "billing_event": "OCPM",
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "targeting_optimization_mode": "AUTOMATIC",
    "targeting_spec": {
        "location_ids": [
            "{{location_ids}}"
        ],
        "operating_systems": [
            "IOS"
        ]
    },
    "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}}",
        "app_config": [],
        "app_id": "{{app_id}}",
        "attribution_event_count": "ONCE",
        "bid_type": "BID_TYPE_NO_BID",
        "billing_event": "OCPM",
        "budget": {{budget}},
        "budget_mode": "BUDGET_MODE_INFINITE",
        "campaign_id": "{{campaign_id}}",
        "campaign_name": "{{campaign_name}}",
        "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
        "catalog_id": "{{catalog_id}}",
        "click_attribution_window": "SEVEN_DAYS",
        "comment_disabled": false,
        "conversion_bid_price": {{conversion_bid_price}},
        "create_time": "{{create_time}}",
        "dayparting": "{{dayparting}}",
        "deep_bid_type": "AEO",
        "engaged_view_attribution_window": "SEVEN_DAYS",
        "is_hfss": false,
        "is_lhf_compliance": false,
        "min_budget": {{min_budget}},
        "modify_time": "{{modify_time}}",
        "operation_status": "ENABLE",
        "optimization_event": "LOGIN",
        "optimization_event_type": "STANDARD_EVENT",
        "optimization_goal": "IN_APP_EVENT",
        "pacing": "PACING_MODE_SMOOTH",
        "phone_info": {},
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "product_source": "CATALOG",
        "promotion_type": "APP_IOS",
        "schedule_end_time": "{{schedule_end_time}}",
        "schedule_start_time": "{{schedule_start_time}}",
        "schedule_type": "SCHEDULE_START_END",
        "search_result_enabled": true,
        "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"
            ],
            "app_targeting_type": "PROSPECT",
            "brand_safety_type": "EXPANDED_INVENTORY",
            "gender": "GENDER_UNLIMITED",
            "location_ids": [
                "{{location_ids}}"
            ],
            "min_ios_version": "8.0",
            "operating_systems": [
                "IOS"
            ],
            "spc_audience_age": "OVER_EIGHTEEN",
            "spending_power": "ALL"
        },
        "video_download_disabled": false,
        "view_attribution_window": "ONE_DAY"
    }
}
(/code)

创建广告

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

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

设置 要求 参数 如何配置参数
广告名称（可选） 默认情况下，系统将自动生成广告名称。
你可以通过传入合法的广告名称来自定义。		 ad_name
  • 若想系统自动生成广告名称，需将此字段设置为 ""（空字符串）。
  • 若想自定义广告名称，需传入非空字符串值。
商品数据源详细信息
· 商品
  • 在推广系列层级启用“使用 RTA 自动选择商品”时：所有商品
  • 未启用“使用 RTA 自动选择商品”时，选择以下任意选项：
    • 所有商品
    • 商品系列
    • 特定商品，最多 20 个商品
 product_specific_type
product_set_id
product_ids
  • 当推广系列层级的 rta_product_selection_enabled 为 true 时：ALL
  • 当推广系列层级的 rta_product_selection_enabled 为 false 或不传入时，将 product_specific_type 设置为 ALL、PRODUCT_SET 或 CUSTOMIZED_PRODUCTS。
    • 如果将 product_specific_type 设置为 ALL，无需传入 product_set_id 和 product_ids。
    • 如果将 product_specific_type 设置为 PRODUCT_SET，需传入 product_set_id，无需传入 product_ids。
    • 如果将 product_specific_type 设置为 CUSTOMIZED_PRODUCTS，需通过 product_ids 传入最多 20 个可用商品库商品，无需传入 product_set_id。
创意素材
· 广告发布身份		 选择以下任意选项：
  • 自定义用户（自定义身份）
  • 授权用户
  • TikTok 用户
  • 商务中心内的 TikTok 账号用户
 identity_type 使用以下任意值：
  • CUSTOMIZED_USER
  • AUTH_CODE
  • TT_USER
  • BC_AUTH_TT

注意：

  • 对于非 Spark Ads 广告发布身份 (CUSTOMIZED_USER)，需在 ad_configuration 对象内为 identity_type 和 identity_id 传入值。
  • 对于 Spark Ads 广告发布身份，需在 creative_info 对象内为 identity_type 和 identity_id 传入值。
identity_id 传入合法值
若想获取你的广告账号下的广告发布身份列表，需使用 /identity/get/ 接口。
identity_authorized_bc_id 当 identity_type 为 BC_AUTH_TT 时，传入合法值
创意素材
· 从商品库自动选择		 选择以下任意选项：
  • 已启用（推荐）
  • 未启用
    • 你商品库中的图片和视频将不会用于为你的商品自动生成经过优化的、所有样式的商品库广告。系统将使用你传入的内容自动创建单视频广告。
    • 单个广告可添加 1 到 50 个广告创意，这些创意可包含以下类型：
      • 视频
      • TikTok 视频帖子
      • TikTok 照片帖子
      • 轮播
    • 查看按广告发布身份和广告类型划分的广告创意组合文档，了解基于广告发布身份类型的可用广告创意组合。

    注意：不使用商品库作为创意，可能会限制潜在的广告效果。

 catalog_creative_toggle
video_info
image_info
music_info
ad_text_list
tiktok_item_id
ad_format
  • 若想启用自动选择商品库创意，需将 catalog_creative_toggle 设置为 true，为每个 creative_info 对象中的 ad_format 传入合法值，并通过 music_info 传入 1 首音乐。查看 自定义升级版 Smart+ 商品库应用广告中的广告样式组合，了解详细配置选项和要求。

    注意：当 catalog_creative_toggle 为 true 时，music_info 为必填字段。

  • 若想禁用自动选择商品库创意，将 catalog_creative_toggle 设置为 false。
    • 单个广告可添加 1 到 50 个广告创意，这些创意可包含以下类型：
      • 视频
      • TikTok 视频帖子
      • TikTok 照片帖子
      • 轮播
    • 对于每个创意，为每个 creative_info 对象中的 ad_format 传入相应的值。
    • 查看按广告发布身份和广告类型划分的广告创意组合文档，了解基于广告发布身份类型的可用广告创意组合的配置。
行动引导文案 动态 call_to_action_id 传入合法值
call_to_action_list 不传入
创新互动样式（可选）（当广告创意包含视频或视频帖子时） 未启用或已启用，最多包含一个以下任意类型的创新互动样式：
  • 展示卡片
  • 倒计时贴纸
  • 礼品码贴纸
 interactive_add_on_list 不传入或最多传入以下任意创新互动样式类型的一个 ID：
  • 倒计时贴纸
  • 礼品码贴纸
  • 展示卡片

注意：

  • 如果 creative_list 包含视频创意（包括视频和 TikTok 视频帖子），你只能使用创新互动样式。


若想创建创新互动样式（创意素材包），需使用 /creative/portfolio/create/ 接口。
  • 查看卡片文档，了解如何获取展示卡片素材包 ID。
  • 查看贴纸文档，了解如何获取倒计时贴纸 ID 或礼品码贴纸素材包 ID。
目标页面
  • 如果推广的应用为 Android 应用：Google Play
  • 如果推广的应用为 iOS 应用：App Store
 landing_page_url_list
page_list
  • 当广告组层级的 promotion_type 为 APP_ANDROID 时，你只能将目标页面设置为 Google Play。
    • 请勿传入 landing_page_url_list 和 page_list。
  • 当广告组层级的 promotion_type 为 APP_IOS 时，你只能将目标页面设置为 App Store。
    • 请勿传入 landing_page_url_list 和 page_list。
延迟深度链接（可选）（当目标页面为 Google Play/App Store 时） 未启用或已启用并设置合法深度链接。
用户安装并首次打开你的应用时，延迟深度链接会将其引导至特定页面。必须借助第三方监测链接才能使用此功能。		 deeplink_type 不传入或传入 DEFERRED_DEEPLINK
deeplink
  • 当 deeplink_type 不传入时：
    • 不传入
  • 当 deeplink_type 为 DEFERRED_DEEPLINK 时：
    • 传入自定义深度链接
构建 URL 参数（可选）
  • 如果未启用延迟深度链接，不支持此设置。
  • 如果启用延迟深度链接，可启用或禁用此设置。
 deeplink_utm_params
  • 当 deeplink_type 不传入时：
    • 不传入
  • 当 deeplink_type 为 DEFERRED_DEEPLINK 时，使用以下任意配置：
    • 传入合法值或不传入

如果将 deeplink 设置为已包含 URL 参数的 URL，可选择同时传入 deeplink_utm_params 以存储 URL 中使用的参数。
在这一情况下，需确保 deeplink_utm_params 与已使用的 URL 参数精确匹配。广告投放时，URL 参数不会自动附加到 deeplink 中。
免责声明
（可选）		 已启用或未启用 disclaimer 传入合法值或不传入

自定义升级版 Smart+ 商品库应用广告中的广告样式组合

如果启用自动选择商品库创意（catalog_creative_toggle 为 true），系统将使用 3 种可能的样式组合自动创建广告：商品库轮播、商品库视频和单视频广告。

下表列出了升级版 Smart+ 商品库应用广告的可用广告样式组合。

商品库轮播样式是否可用？ 商品库视频样式是否可用？ 单视频广告样式是否可用？ 升级版 Smart+ 商品库应用广告的广告样式组合
✅ ❌ ❌ 仅商品库轮播
✅ ❌ ✅ 商品库轮播和单视频广告
✅ ✅ ❌ 商品库轮播和商品库视频
✅ ✅ ✅ 商品库轮播、商品库视频和单视频广告

为确保某些广告样式可在升级版 Smart+ 商品库应用广告中使用，请遵循下表中的说明。

广告样式 广告样式描述 如何确保广告样式可用 如何配置参数
商品库轮播 以幻灯片样式展示 2-20 个商品。此样式将同时展示你商品库中最多 20 个商品的图片。 商品库需至少包含两个支持轮播广告的商品。 确保商品库 (catalog_id) 至少包含两个通过审核的商品。可查看从 /catalog/overview/ 接口返回的 approved 值进行验证，该值应至少为 2。
  • 轮播图片选择范围：系统将动态选择商品库 (catalog_id) 中商品的图片，作为正在投放的商品库轮播广告中展示的图片。商品图片的选择范围由传入的 product_specific_type 参数决定：
    • 如果 product_specific_type 设置为 ALL，系统将从商品库的所有商品中动态选择轮播图片。
    • 如果 product_specific_type 设置为 PRODUCT_SET，系统将从传入商品系列 (product_set_id) 的商品中动态选择轮播图片。
    • 如果 product_specific_type 设置为 CUSTOMIZED_PRODUCTS，系统将从自定义范围（最多 20 个商品 (product_ids) ）的商品中动态选择轮播图片。
  • 轮播图片类型：
    • 使用商品主图片：默认情况下，动态选择的商品库商品的主图片 URL 将用作轮播图片。
传入支持商品库轮播广告的音乐。 通过 music_info 传入 1 个可用于商品库轮播广告的音乐 ID。

若想获取合法音乐 ID，可采用以下任意方式：
  • 在 /file/music/get/ 接口中将 music_scene 指定为 CATALOG_CAROUSEL，为广告账号下的商品库轮播广告筛选音乐。
  • 通过以下任意方式，将用于商品库轮播广告的自定义音乐上传到广告账号：
    • 在 /file/music/upload/ 接口中将 music_scene 指定为 CATALOG_CAROUSEL 并传入 music_file 和 music_signature。
    • 在 /file/music/upload/ 接口中将 music_scene 指定为 CATALOG_CAROUSEL，以及将 upload_type 指定为 UPLOAD_BY_FILE_ID，并传入 file_id。
商品库视频 基于商品库中的信息生成动态视频 商品库需至少关联 1 个视频模板，或为每个商品库商品配置视频 URL。
系统将为每个商品库商品自动选择你的任一视频模板以生成相应的商品库视频，或使用该商品库商品的视频 URL。		 确保至少有 1 个视频模板绑定你的商品库 (catalog_id)，或为每个商品库商品配置了视频 URL (video_url)。
单视频广告 使用传入的视频创意推广你的商品。 传入其他视频 通过 video_info 传入其他视频，并通过 image_info 传入封面图片。

示例

仅使用商品库素材 请求

(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": "CATALOG_CAROUSEL",
                "music_info": {
                    "music_id": "{{music_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": {
        "product_specific_type": "ALL",
        "identity_type": "CUSTOMIZED_USER",
        "identity_id": "{{identity_id}}",
        "catalog_creative_toggle": true,
        "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}}",
            "catalog_creative_info": {},
            "catalog_creative_toggle": true,
            "dark_post_status": "ON",
            "deeplink_utm_params": [],
            "fallback_type": "UNSET",
            "identity_id": "{{identity_id}}",
            "identity_type": "CUSTOMIZED_USER",
            "phone_info": {},
            "product_info": {
                "product_image_list": []
            },
            "product_specific_type": "ALL",
            "tracking_info": {
                "app_tracking_info_list": [],
                "tracking_app_id": "{{tracking_app_id}}",
                "tracking_pixel_id": "{{tracking_pixel_id}}"
            },
            "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": "CATALOG_CAROUSEL",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "CUSTOMIZED_USER",
                    "material_name": "{{material_name}}",
                    "music_info": {
                        "music_id": "{{music_id}}"
                    }
                },
                "material_operation_status": "ENABLE"
            }
        ],
        "custom_product_page_list": [],
        "deeplink_list": [],
        "disclaimer": {},
        "interactive_add_on_list": [],
        "landing_page_url_list": [],
        "modify_time": "{{modify_time}}",
        "operation_status": "ENABLE",
        "page_list": [],
        "secondary_status": "AD_STATUS_AUDIT",
        "smart_plus_ad_id": "{{smart_plus_ad_id}}"
    }
}
(/code)

仅使用非商品库素材 请求

(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": "SINGLE_VIDEO",
                "image_info": [
                    {
                        "web_uri": "{{web_uri}}"
                    }
                ],
                "video_info": {
                    "video_id": "{{video_id}}"
                },
                "identity_type": "BC_AUTH_TT",
                "identity_id": "{{identity_id}}",
                "identity_authorized_bc_id": "{{identity_authorized_bc_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": {
        "product_specific_type": "ALL",
        "catalog_creative_toggle": false,
        "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}}",
            "catalog_creative_info": {},
            "catalog_creative_toggle": false,
            "dark_post_status": "ON",
            "deeplink_utm_params": [],
            "fallback_type": "UNSET",
            "phone_info": {},
            "product_info": {
                "product_image_list": []
            },
            "product_specific_type": "ALL",
            "tracking_info": {
                "app_tracking_info_list": [],
                "tracking_app_id": "{{tracking_app_id}}",
                "tracking_pixel_id": "{{tracking_pixel_id}}"
            },
            "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_authorized_bc_id": "{{identity_authorized_bc_id}}",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "BC_AUTH_TT",
                    "image_info": [
                        {
                            "web_uri": "{{web_uri}}"
                        }
                    ],
                    "material_name": "{{material_name}}",
                    "video_info": {
                        "file_name": "{{file_name}}",
                        "video_id": "{{video_id}}"
                    }
                },
                "material_operation_status": "ENABLE"
            }
        ],
        "custom_product_page_list": [],
        "deeplink_list": [],
        "disclaimer": {},
        "interactive_add_on_list": [],
        "landing_page_url_list": [],
        "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+ 商品库应用广告是一种升级版 Smart+ 销量推广系列，它启用 iOS 14 专属推广系列设置，并使用商品库中的商品来投放广告。对于此类推广系列，你需要将 campaign_type 参数设置为 IOS14_CAMPAIGN。

创建启用专属推广系列的升级版 Smart+ 商品库应用广告的前提条件

若想创建升级版 Smart+ 商品库应用广告，需先在商务中心设置商品库。

设置商品库的步骤： 1. 使用/catalog/create/接口创建一个商品库。 - 商品库可以是以下任意类型： - 电商 - 酒店 - 航班 - 目的地 - 娱乐 2. 使用 /catalog/product/upload/ 接口（JSON 模式）、/catalog/product/file/ 接口（CSV 文件模板）或 /catalog/feed/create/ 接口（在线数据流上传）将商品上传至商品库。 3. 使用 /catalog/product/log/ 接口查看商品处理结果。 传入第 2 步获得的 feed_log_id。如果返回的 error_affected_products 字段不为空，查看问题详细信息，并回到第 2 步重新上传商品。 4. （可选）使用 /catalog/set/create/ 接口创建商品系列。 若想从商品系列中选择商品，必须创建商品系列。否则可跳过这一步。 5. （可选）使用 /bc/member/invite/ 接口邀请成员加入商务中心并授予管理员权限。 你还可以选择要分配给受邀成员的 advertiser_role。 6. （可选）使用 /bc/asset/assign/ 接口向成员分享商品库，并授予商品库管理权限。 务必在 asset_type 字段中传入 CATALOG，在 catalog_role 字段中传入 ADMIN。 若想查看所有商品库 API，参见此处。

步骤

创建推广系列

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

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

设置 要求 参数 如何配置参数
推广目标 销量 objective_type WEB_CONVERSIONS
销售目标页面 应用 sales_destination APP
商品库类型 使用以下任意类型：
  • 电商
  • 旅行和娱乐
 catalog_enabled true
catalog_type 使用以下任意值：
  • ECOMMERCE
  • TRAVEL_ENTERTAINMENT
iOS 14 专属推广系列 已启用

若想了解如何创建未启用 iOS 14 专属推广系列的升级版 Smart+ 商品库应用广告，请查看创建未启用专属推广系列的升级版 Smart+ 商品库应用广告。		 campaign_type IOS14_CAMPAIGN
应用 传入合法的 iOS 应用 app_id 传入合法值。
若想获取你的广告账号下的应用列表，需使用 /app/list/ 接口。
对于 iOS 应用，返回的 platform 将为 IOS。
SKAN 归因（可选） 未启用或已启用 disable_skan_campaign 使用以下任意值：

注意：禁用专属推广系列的 SKAN 归因目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。
使用应用介绍页优化投放 未启用 campaign_app_profile_page_state OFF（或不传入）
推广系列名称 传入合法名称 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_auto_adjust_strategy
  • 当 budget_optimize_on 为 true 或不传入，并且 budget_mode 为 BUDGET_MODE_DYNAMIC_DAILY_BUDGET 时，使用以下任意值：
    • AUTO_BUDGET_INCREASE：启用自动增加预算功能。允许系统在广告效果出色且满足目标 CPA、第 0 天目标 ROAS 和预算要求时自动增加预算。如果你的预算利用率至少达到 90%，日预算将自动增加 20%，每天最多可增加 10 次。你的日预算将在每天重置为原来的日预算。
    • UNSET：关闭自动增加预算功能。

    注意：自动增加预算目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。
推广系列预算
  • 如果推广系列预算策略为自动推广系列预算，请传入合法预算
  • 如果推广系列预算策略为自定义广告组预算：
    • 未启用
 budget
  • 当 budget_optimize_on 为 true 或不传入时，传入合法值。
  • 当 budget_optimize_on 为 false 时：
    • 不传入
实时 API (RTA)（可选） 已启用或未启用


注意：广告组层级的可用广告位可能因你的 RTA 设置而异。

 rta_id 传入与你的广告账号关联的其中一个 RTA ID。

若想获取与你的广告账号关联的 RTA ID 列表，请联系你的 TikTok 代表。


注意：广告组层级的可用广告位设置（placement_type 和 placements）可能因你的 rta_id 配置而异。
使用 RTA 自动选择商品（可选）
  • 如果未启用 RTA，不支持此设置。
  • 如果已启用 RTA，可启用或禁用此设置。
 rta_product_selection_enabled
  • 当 rta_id 不传入时：
    • false 或不传入
  • 当 rta_id 传入时，使用以下任意配置：
    • true
    • false 或不传入
使用 RTA 出价（可选）
  • 如果未启用 RTA，不支持此设置。
  • 如果已启用 RTA，可启用或禁用此设置。
 rta_bid_enabled
  • 当 rta_id 不传入时：
    • false 或不传入
  • 当 rta_id 传入时，使用以下任意配置：
    • true
    • false 或不传入

示例

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/campaign/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "request_id": "{{request_id}}",
    "objective_type": "WEB_CONVERSIONS",
    "sales_destination": "APP",
    "catalog_enabled": true,
    "catalog_type": "ECOMMERCE",
    "campaign_type": "IOS14_CAMPAIGN",
    "app_id": "{{app_id}}",
    "campaign_name": "{{campaign_name}}",
    "budget": {{budget}}
}'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "advertiser_id": "{{advertiser_id}}",
        "app_id": "{{app_id}}",
        "bid_align_type": "SAN",
        "budget": {{budget}},
        "budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
        "budget_optimize_on": true,
        "campaign_id": "{{campaign_id}}",
        "campaign_name": "{{campaign_name}}",
        "campaign_type": "IOS14_CAMPAIGN",
        "catalog_enabled": true,
        "catalog_type": "ECOMMERCE",
        "create_time": "{{create_time}}",
        "disable_skan_campaign": false,
        "is_advanced_dedicated_campaign": true,
        "is_promotional_campaign": false,
        "modify_time": "{{modify_time}}",
        "objective_type": "WEB_CONVERSIONS",
        "operation_status": "ENABLE",
        "sales_destination": "APP",
        "secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "smart_plus_adgroup_mode": "MULTIPLE"
    }
}
(/code)

创建广告组

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

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

设置 要求 参数 如何配置参数
广告组名称 传入合法名称 adgroup_name 传入合法值
商品数据源详细信息
· 商品库		 传入至少包含两个通过审核的商品的商品库

注意：

  • 如果在推广系列层级未启用 RTA，可以传入以下任一商品库类型：
    • 电商
    • 酒店
    • 航班
    • 目的地
    • 娱乐
  • 如果在推广系列层级已启用 RTA，可以传入以下任一商品库类型：
    • 电商
    • 娱乐

 catalog_id
catalog_authorized_bc_id		 传入合法值。
商品库 (catalog_id) 需至少包含两个通过审核的商品。可查看从 /catalog/overview/ 接口返回的 approved 值进行验证，该值应至少为 2。


注意：

  • 如果在推广系列层级不传入 rta_id，商品库的 catalog_type 可以是以下任意类型：
    • ECOM
    • HOTEL
    • FLIGHT
    • DESTINATION
    • ENTERTAINMENT
  • 如果在推广系列层级传入 rta_id，商品库的 catalog_type 可以是以下任意类型：
    • ECOM
    • ENTERTAINMENT
优化和出价
· 应用		 iOS 应用


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

 promotion_type APP_IOS


注意：当推广系列层级的 budget_optimize_on 为 true 时，为同一推广系列内的所有广告组传入相同的 promotion_type。
优化和出价
· 目标		 使用以下任意类型：
  • 点击
    • 我们会将你的广告投放给最有可能点击的用户。
  • 安装
    • 我们会将你的广告展示给最有可能安装你的应用的用户。
  • 应用内事件
    • 我们会将你的广告展示给最有可能在你的应用中执行某些操作的用户。
  • 价值
    • 为了最大限度地提高总付费价值，我们会将你的广告投放给更有可能付费购买的用户。


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

 optimization_goal 使用以下任意值：
  • CLICK
  • INSTALL（optimization_event 需设置为 ACTIVE）
    • 若想使用 INSTALL，你需要确保已为所选应用设置第三方监测。
      • 若想查看是否已经为应用配置了第三方监测 (tracking_url)，需使用 /app/info/ 端口。
      • 若想为现有应用添加第三方监测，需使用 /app/update/ 端口。查看移动度量合作伙伴监测文档，了解如何从第三方合作伙伴处获得监测链接。
  • IN_APP_EVENT（需传入 optimization_event）
    • 若想使用 IN_APP_EVENT，你需要确保传入的事件 (optimization_event) 适用于所选应用。
  • VALUE（需传入 optimization_event）
    • 如果你将此字段设置为 VALUE，请一并传入广告位参数（placement_type 或同时传入 placement_type 和 placements）。
    • 进一步了解价值优化。

注意：当推广系列层级的 budget_optimize_on 为 true 时，为同一推广系列内的所有广告组传入相同的 optimization_goal。
优化和出价
· 选择应用内事件（当目标为应用内事件时）		 使用以下任意类型：
  • 标准事件
  • 自定义转化

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

 optimization_event
custom_conversion_id		 当 optimization_goal 为 IN_APP_EVENT 时，传入以下任意项：
  • 通过 optimization_event设置标准事件
  • 通过 custom_conversion_id 和 optimization_event设置自定义转化以及关联的转化事件

  • 若想获取应用的可用优化事件 (optimization_event)，需使用 /app/optimization_event/ 接口。
  • 若想获取与应用关联的自定义转化列表，需使用 /custom_conversion/list/ 接口。
    • 若想确认自定义转化是否符合广告组创建的资格条件：
      • 确保返回的 optimization_event 与广告组创建期间传入的 optimization_event 一致。
      • 确保 activity_status 为 NO_RECENT_ACTIVITY 或 ACTIVE。

注意：当推广系列层级的 budget_optimize_on 为 true 时，optimization_event 和 custom_conversion_id（如传入）必须在同一推广系列内的所有广告组中保持一致。
优化和出价
· 出价策略、（可选）目标 CPA 和（可选）目标 ROAS
  • 如果目标为点击、安装或应用内事件，出价策略只能为最大投放量或成本上限。
    • 对于成本上限出价策略，你需要同时传入目标 CPA。
  • 如果目标为价值，出价策略可为最高价值或最低 ROAS。
    • 对于最低 ROAS 出价策略，你需要同时传入目标 ROAS。

注意：

  • 出价策略必须在同一推广系列内的所有广告组中保持一致。
  • 如果你选择推广系列预算模式，目标 CPA 和目标 ROAS（如传入）必须在同一推广系列内的所有广告组中保持一致。
  • 目标 CPA 和目标 ROAS 出价策略仅支持采用日预算模式的推广系列或广告组。

 bid_type
bid_price
conversion_bid_price
deep_bid_type
roas_bid
  • 如果 optimization_goal 为 CLICK、INSTALL 或 IN_APP_EVENT：
    • 将 bid_type设置为 BID_TYPE_CUSTOM（成本上限）或 BID_TYPE_NO_BID（最大投放量）。请勿传入 deep_bid_type 和 roas_bid。
      • 如果 optimization_goal 为 INSTALL 或 IN_APP_EVENT，且 bid_type 为 BID_TYPE_CUSTOM，请同时传入 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。

注意：

  • bid_type 必须在同一推广系列内的所有广告组中保持一致。
  • 当推广系列层级的 budget_optimize_on 为 true 时，以下设置（如传入）必须在同一推广系列内的所有广告组中保持一致。
    • conversion_bid_price
    • bid_price
    • deep_bid_type
    • roas_bid
  • 在以下任意场景中，你只能将 bid_type 设置为 BID_TYPE_CUSTOM 或将 deep_bid_type 设置为 VO_MIN_ROAS：
    • 在推广系列层级，budget_mode 为 BUDGET_MODE_DYNAMIC_DAILY_BUDGET
    • 在广告组层级，budget_mode 为 BUDGET_MODE_DYNAMIC_DAILY_BUDGET
优化和出价
· 计费事件
  • 如果目标为点击，计费事件应为 CPC。
  • 如果目标为安装、应用内事件或价值，计费事件应为 oCPM。

注意：

  • 如果你选择推广系列预算模式，计费事件必须在同一推广系列内的所有广告组中保持一致。
 billing_event
  • 如果 optimization_goal 为 CLICK，将此字段设置为 CPC。
  • 如果 optimization_goal 为 INSTALL、IN_APP_EVENT 或 VALUE，将此字段设置为 OCPM。

注意：当推广系列层级的 budget_optimize_on 为 true 时，为同一推广系列内的所有广告组传入相同的 billing_event。
优化和出价
· 投放速度		 标准（默认） N/A 升级版 Smart+ 推广系列默认设置为标准投放速度。
预算和排期
· 预算
  • 如果你选择自动推广系列预算模式：
    • 广告组预算会被禁用。推广系列层级预算将用作广告组预算。
  • 如果选择自定义广告组预算策略，你可以使用以下任意广告组预算模式：
    • 总预算
    • 日预算

注意：

  • 广告组预算模式（如传入）必须在同一推广系列内的所有广告组中保持一致。
 budget_mode
budget
  • 当推广系列层级的 budget_optimize_on 为 true 时，不支持 budget_mode 和 budget。
  • 当推广系列层级的 budget_optimize_on 为 false 时：
    • 将 budget_mode 设置为 BUDGET_MODE_TOTAL 或 BUDGET_MODE_DYNAMIC_DAILY_BUDGET
    • 通过 budget 传入合法预算


注意：

  • budget_mode（如传入）必须在同一推广系列内的所有广告组中保持一致。
预算和排期
· 自动增加预算（当目标为价值时）		 已启用或未启用

若想启用此设置，应满足以下条件：
  • 在推广系列层级：未启用 CBO。
  • 在广告组层级：
    • 广告组预算为日预算
    • 目标为价值
    • 出价策略为目标 ROAS
    • 出价策略的时间窗口期为第 0 天 ROAS
 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。
    • optimization_goal 为 VALUE。
    • deep_bid_type 为 VO_MIN_ROAS。
    • vbo_window 为 ZERO_DAY。

注意：自动增加预算目前为白名单功能。如需使用此功能，请联系你的 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_FROM_NOW：

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

查看升级版 Smart+ 商品库应用广告中不同定向优化模式的可用定向设置，了解每种模式支持的定向设置。		 targeting_optimization_mode 使用以下任意值：
  • AUTOMATIC
  • MANUAL
查看升级版 Smart+ 商品库应用广告中不同定向优化模式的可用定向设置，了解每种模式支持的定向设置。
广告位和品牌安全
· 广告位		 TikTok placement_type PLACEMENT_TYPE_NORMAL
placements PLACEMENT_TIKTOK
广告位和品牌安全
· 子广告位
（广告位包含 TikTok 时选填）		 不启用，或启用并带有以下一个或多个选项：
  • Lemon8
  • PineDrama

注意：

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

 tiktok_subplacements 不传入，或传入以下一个或多个值：
  • LEMON8
  • PINE_DRAMA

注意：

  • 在广告组中使用 Lemon8 子广告位 (LEMON8) 目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。
  • 在广告组中使用 PineDrama 子广告位 (PINE_DRAMA) 目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。
广告位和品牌安全
· 品牌安全和适用性		 这些设置仅应用于 TikTok 信息流广告和搜索广告。之前在品牌安全中心所做的任何账号层级的设置都将应用到推广系列。 N/A N/A
若想获取品牌安全中心的广告账号层级品牌安全和适用性设置，需使用 /tiktok_inventory_filters/get/ 接口。
若想配置或更新品牌安全中心的广告账号层级品牌安全和适用性设置，需使用 /tiktok_inventory_filters/update/ 接口。
广告位和品牌安全
· 用户评论		 已启用或未启用 comment_disabled 传入合法值或不传入
广告位和品牌安全
· 允许下载视频		 已启用或未启用 share_disabled 传入合法值或不传入
广告位和品牌安全
· 允许共享视频		 已启用或未启用 video_download_disabled 传入合法值或不传入
广告位和品牌安全
· Pangle 媒体屏蔽列表		 未启用 N/A N/A

示例

请求

(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}}",
    "catalog_id": "{{catalog_id}}",
    "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
    "app_id": "{{app_id}}",
    "promotion_type": "APP_IOS",
    "optimization_goal": "IN_APP_EVENT",
    "optimization_event": "LOGIN",
    "bid_type": "BID_TYPE_NO_BID",
    "billing_event": "OCPM",
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "targeting_optimization_mode": "AUTOMATIC",
    "targeting_spec": {
        "app_targeting_type": "PROSPECT",
        "location_ids": [
            "{{location_ids}}"
        ],
        "operating_systems": [
            "IOS"
        ]
    },
    "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}}",
        "app_config": [],
        "app_id": "{{app_id}}",
        "attribution_event_count": "ONCE",
        "bid_type": "BID_TYPE_NO_BID",
        "billing_event": "OCPM",
        "budget": {{budget}},
        "budget_mode": "BUDGET_MODE_INFINITE",
        "campaign_id": "{{campaign_id}}",
        "campaign_name": "{{campaign_name}}",
        "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
        "catalog_id": "{{catalog_id}}",
        "click_attribution_window": "SEVEN_DAYS",
        "comment_disabled": false,
        "conversion_bid_price": {{conversion_bid_price}},
        "create_time": "{{create_time}}",
        "dayparting": "{{dayparting}}",
        "deep_bid_type": "AEO",
        "engaged_view_attribution_window": "SEVEN_DAYS",
        "is_hfss": false,
        "is_lhf_compliance": false,
        "min_budget": {{min_budget}},
        "modify_time": "{{modify_time}}",
        "operation_status": "ENABLE",
        "optimization_event": "LOGIN",
        "optimization_event_type": "STANDARD_EVENT",
        "optimization_goal": "IN_APP_EVENT",
        "pacing": "PACING_MODE_SMOOTH",
        "phone_info": {},
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "product_source": "CATALOG",
        "promotion_type": "APP_IOS",
        "schedule_end_time": "{{schedule_end_time}}",
        "schedule_start_time": "{{schedule_start_time}}",
        "schedule_type": "SCHEDULE_START_END",
        "search_result_enabled": true,
        "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"
            ],
            "app_targeting_type": "PROSPECT",
            "brand_safety_type": "EXPANDED_INVENTORY",
            "gender": "GENDER_UNLIMITED",
            "location_ids": [
                "{{location_ids}}"
            ],
            "min_ios_version": "14.0",
            "operating_systems": [
                "IOS"
            ],
            "spc_audience_age": "OVER_EIGHTEEN",
            "spending_power": "ALL"
        },
        "video_download_disabled": false,
        "view_attribution_window": "ONE_DAY"
    }
}
(/code)

创建广告

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

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

设置 要求 参数 如何配置参数
广告名称（可选） 默认情况下，系统将自动生成广告名称。
你可以通过传入合法的广告名称来自定义。		 ad_name
  • 若想系统自动生成广告名称，需将此字段设置为 ""（空字符串）。
  • 若想自定义广告名称，需传入非空字符串值。
商品数据源详细信息
· 商品
  • 在推广系列层级启用“使用 RTA 自动选择商品”时：所有商品
  • 未启用“使用 RTA 自动选择商品”时，选择以下任意选项：
    • 所有商品
    • 商品系列
    • 特定商品，最多 20 个商品
 product_specific_type
product_set_id
product_ids
  • 当推广系列层级的 rta_product_selection_enabled 为 true 时：ALL
  • 当推广系列层级的 rta_product_selection_enabled 为 false 或不传入时，将 product_specific_type 设置为 ALL、PRODUCT_SET 或 CUSTOMIZED_PRODUCTS。
    • 如果将 product_specific_type 设置为 ALL，无需传入 product_set_id 和 product_ids。
    • 如果将 product_specific_type 设置为 PRODUCT_SET，需传入 product_set_id，无需传入 product_ids。
    • 如果将 product_specific_type 设置为 CUSTOMIZED_PRODUCTS，需通过 product_ids 传入最多 20 个可用商品库商品，无需传入 product_set_id。
创意素材
· 广告发布身份		 选择以下任意选项：
  • 自定义用户（自定义身份）
  • 授权用户
  • TikTok 用户
  • 商务中心内的 TikTok 账号用户
 identity_type 使用以下任意值：
  • CUSTOMIZED_USER
  • AUTH_CODE
  • TT_USER
  • BC_AUTH_TT

注意：

  • 对于非 Spark Ads 广告发布身份 (CUSTOMIZED_USER)，需在 ad_configuration 对象内为 identity_type 和 identity_id 传入值。
  • 对于 Spark Ads 广告发布身份，需在 creative_info 对象内为 identity_type 和 identity_id 传入值。
identity_id 传入合法值
若想获取你的广告账号下的广告发布身份列表，需使用 /identity/get/ 接口。
identity_authorized_bc_id 当 identity_type 为 BC_AUTH_TT 时，传入合法值
创意素材
· 从商品库自动选择		 选择以下任意选项：
  • 已启用（推荐）
  • 未启用
    • 你商品库中的图片和视频将不会用于为你的商品自动生成经过优化的、所有样式的商品库广告。系统将使用你传入的内容自动创建单视频广告。
    • 单个广告可添加 1 到 50 个广告创意，这些创意可包含以下类型：
      • 视频
      • TikTok 视频帖子
      • TikTok 照片帖子
      • 轮播
    • 查看按广告发布身份和广告类型划分的广告创意组合文档，了解基于广告发布身份类型的可用广告创意组合。

    注意：不使用商品库作为创意，可能会限制潜在的广告效果。

 catalog_creative_toggle
video_info
image_info
music_info
ad_text_list
tiktok_item_id
ad_format
  • 若想启用自动选择商品库创意，需将 catalog_creative_toggle 设置为 true，为每个 creative_info 对象中的 ad_format 传入合法值，并通过 music_info 传入 1 首音乐。查看 自定义升级版 Smart+ 商品库应用广告中的广告样式组合，了解详细配置选项和要求。

    注意：当 catalog_creative_toggle 为 true 时，music_info 为必填字段。

  • 若想禁用自动选择商品库创意，将 catalog_creative_toggle 设置为 false。
    • 单个广告可添加 1 到 50 个广告创意，这些创意可包含以下类型：
      • 视频
      • TikTok 视频帖子
      • TikTok 照片帖子
      • 轮播
    • 对于每个创意，为每个 creative_info 对象中的 ad_format 传入相应的值。
    • 查看按广告发布身份和广告类型划分的广告创意组合文档，了解基于广告发布身份类型的可用广告创意组合的配置。
行动引导文案 动态 call_to_action_id 传入合法值
call_to_action_list 不传入
创新互动样式（可选）（当广告创意包含视频或视频帖子时） 未启用或已启用，最多包含一个以下任意类型的创新互动样式：
  • 展示卡片
  • 倒计时贴纸
  • 礼品码贴纸
 interactive_add_on_list 不传入或最多传入以下任意创新互动样式类型的一个 ID：
  • 倒计时贴纸
  • 礼品码贴纸
  • 展示卡片

注意：

  • 如果 creative_list 包含视频创意（包括视频和 TikTok 视频帖子），你只能使用创新互动样式。


若想创建创新互动样式（创意素材包），需使用 /creative/portfolio/create/ 接口。
  • 查看卡片文档，了解如何获取展示卡片素材包 ID。
  • 查看贴纸文档，了解如何获取倒计时贴纸 ID 或礼品码贴纸素材包 ID。
目标页面
  • 如果推广的应用为 Android 应用：Google Play
  • 如果推广的应用为 iOS 应用：App Store
 landing_page_url_list
page_list
  • 当广告组层级的 promotion_type 为 APP_ANDROID 时，你只能将目标页面设置为 Google Play。
    • 请勿传入 landing_page_url_list 和 page_list。
  • 当广告组层级的 promotion_type 为 APP_IOS 时，你只能将目标页面设置为 App Store。
    • 请勿传入 landing_page_url_list 和 page_list。
延迟深度链接（当目标页面为 Google Play/App Store 时） 未启用 deeplink_type 不传入
deeplink 不传入
构建 URL 参数 未启用 deeplink_utm_params 不传入
免责声明
（可选）		 已启用或未启用 disclaimer 传入合法值或不传入

示例

仅使用商品库素材 请求

(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": "CATALOG_CAROUSEL",
                "music_info": {
                    "music_id": "{{music_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": {
        "product_specific_type": "ALL",
        "identity_type": "CUSTOMIZED_USER",
        "identity_id": "{{identity_id}}",
        "catalog_creative_toggle": true,
        "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}}",
            "catalog_creative_info": {},
            "catalog_creative_toggle": true,
            "dark_post_status": "ON",
            "deeplink_utm_params": [],
            "fallback_type": "UNSET",
            "identity_id": "{{identity_id}}",
            "identity_type": "CUSTOMIZED_USER",
            "phone_info": {},
            "product_info": {
                "product_image_list": []
            },
            "product_specific_type": "ALL",
            "tracking_info": {
                "app_tracking_info_list": [],
                "tracking_app_id": "{{tracking_app_id}}",
                "tracking_pixel_id": "{{tracking_pixel_id}}"
            },
            "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": "CATALOG_CAROUSEL",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "CUSTOMIZED_USER",
                    "material_name": "{{material_name}}",
                    "music_info": {
                        "music_id": "{{music_id}}"
                    }
                },
                "material_operation_status": "ENABLE"
            }
        ],
        "custom_product_page_list": [],
        "deeplink_list": [],
        "disclaimer": {},
        "interactive_add_on_list": [],
        "landing_page_url_list": [],
        "modify_time": "{{modify_time}}",
        "operation_status": "ENABLE",
        "page_list": [],
        "secondary_status": "AD_STATUS_AUDIT",
        "smart_plus_ad_id": "{{smart_plus_ad_id}}"
    }
}

(/code)

仅使用非商品库素材 请求

(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": "SINGLE_VIDEO",
                "image_info": [
                    {
                        "web_uri": "{{web_uri}}"
                    }
                ],
                "video_info": {
                    "video_id": "{{video_id}}"
                },
                "identity_type": "BC_AUTH_TT",
                "identity_id": "{{identity_id}}",
                "identity_authorized_bc_id": "{{identity_authorized_bc_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": {
        "product_specific_type": "ALL",
        "catalog_creative_toggle": false,
        "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}}",
            "catalog_creative_info": {},
            "catalog_creative_toggle": false,
            "dark_post_status": "ON",
            "deeplink_utm_params": [],
            "fallback_type": "UNSET",
            "phone_info": {},
            "product_info": {
                "product_image_list": []
            },
            "product_specific_type": "ALL",
            "tracking_info": {
                "app_tracking_info_list": [],
                "tracking_app_id": "{{tracking_app_id}}",
                "tracking_pixel_id": "{{tracking_pixel_id}}"
            },
            "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_authorized_bc_id": "{{identity_authorized_bc_id}}",
                    "identity_id": "{{identity_id}}",
                    "identity_type": "BC_AUTH_TT",
                    "image_info": [
                        {
                            "web_uri": "{{web_uri}}"
                        }
                    ],
                    "material_name": "{{material_name}}",
                    "video_info": {
                        "file_name": "{{file_name}}",
                        "video_id": "{{video_id}}"
                    }
                },
                "material_operation_status": "ENABLE"
            }
        ],
        "custom_product_page_list": [],
        "deeplink_list": [],
        "disclaimer": {},
        "interactive_add_on_list": [],
        "landing_page_url_list": [],
        "modify_time": "{{modify_time}}",
        "operation_status": "ENABLE",
        "page_list": [],
        "secondary_status": "AD_STATUS_AUDIT",
        "smart_plus_ad_id": "{{smart_plus_ad_id}}"
    }
}
(/code)
← 创建启用网站和应用优化的升级版 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 每日平台更新简报 →