TikTok 广告管理平台的推广系列功能与 API 配置间的映射
本文介绍了 TikTok 广告管理平台上推广系列、广告组、广告层级的功能及在 API 中的对应配置。若您已是TikTok 广告管理平台的用户,且希望集成 TikTok API for Business,建议您在集成前阅读本文,了解 TikTok 广告管理平台上的推广系列相关功能在 TikTok API for Business 中的支持情况。
需注意下文所列的映射关系可能未涵盖所有可能的情景。对于本文档中未列出的功能,您可参考推广系列管理。
推广系列层级
若要创建推广系列,需使用/campaign/create/。
下表列出了 TikTok 广告管理平台上推广系列层级的设置及 API 中的对应配置。
| TikTok 广告管理平台模块 | TikTok 广告管理平台设置 | TikTok 广告管理平台界面示例 | API 配置 |
|---|---|---|---|
| 推广目标 | 推广目标 | objective_type |
|
| 推广目标为销量 | virtual_objective_type了解如何将推广目标从网站转化量或商品销量升级为销量。 |
||
| 销量目标页面 | sales_destination |
||
| 推广系列类型 | 应用推广类型 (“推广目标”设置为“应用推广”时) |
app_promotion_type |
|
| Smart+ 推广系列 | 使用/campaign/spc/create/ 创建 Smart+ 推广系列。 | ||
| iOS 14 专属推广系列 | 使用 iOS 14 专属推广系列 | campaign_type |
|
| 应用 | app_id |
||
| 使用高级专属推广系列 | is_advanced_dedicated_campaign |
||
| SKAN 归因 | disable_skan_campaign |
||
| 使用应用介绍页优化投放 | campaign_app_profile_page_state |
||
| 推广系列类型 (“售卖类型”设置为“覆盖和频次” 且“推广目标”设置为“覆盖人数”时) |
推广系列类型 | rf_campaign_type |
|
| 商品数据源(商品来源) (“售卖类型”设置为“竞价” 且“推广目标”设置为“商品销量”时) |
商品数据源 | campaign_product_source |
|
| 设置 |
系列名称 | campaign_name |
|
| 特殊广告分类 | special_industries |
||
| 推广系列预算优化 | budget_optimize_on |
||
| 设置推广系列预算 | budget_modebudget |
||
| 实时 API (RTA) | rta_id |
||
| 使用 RTA 自动选择商品 | rta_product_selection_enabled |
||
| 推广系列列表 | 推广系列 - 开关 | operation_status |
广告组层级
若要创建广告组,需使用/adgroup/create/。
下表列出了 TikTok 广告管理平台上广告组层级的设置及 API 中的对应配置。
| TikTok 广告管理平台模块 | TikTok 广告管理平台设置 | TikTok 广告管理平台界面示例 | API 配置 |
|---|---|---|---|
| 设置 |
广告组名称 | adgroup_name |
|
| 购物广告类型 (“售卖类型”设置为“竞价”,且 “推广目标”设置为“商品销量”时) |
购物广告类型 | shopping_ads_type |
|
| 广告发布身份(认证身份) (“购物广告类型”设置为“直播购物广告”时) |
identity_ididentity_typeidentity_authorized_bc_id |
||
| 商品数据源详细信息 (“售卖类型”设置为“竞价”, “推广目标”设置为“商品销量”,且“购物广告类型”设置为“视频购物广告”时) |
目录(商品库) | product_sourcecatalog_idcatalog_authorized_bc_id |
|
| TikTok Shop | product_sourcestore_idstore_authorized_bc_id |
||
| 橱窗 | product_sourceidentity_ididentity_typeidentity_authorized_bc_id |
||
| 优化位置(推广对象) | 优化位置 |
promotion_type |
|
| 优化位置 (“推广目标”设置为“线索收集”时) |
promotion_target_type |
||
| 优化位置 (“应用推广类型”设置为“应用预注册”时) |
promotion_website_type |
||
| 应用 (“推广目标”设置为“应用推广”时) |
app_id |
||
| TikTok Pixel | pixel_id |
||
| 优化事件 | optimization_event |
||
| 选择即时通讯应用或使用自定义链接 (优化位置为即时通讯应用时)
|
messaging_app_typemessaging_app_account_idphone_region_codephone_region_calling_codephone_number |
||
深层漏斗优化
|
deep_funnel_optimization_statusdeep_funnel_event_sourcedeep_funnel_event_source_iddeep_funnel_optimization_event |
||
| 广告位 (版位) | 自动广告位 编辑广告位 |
placement_typeplacements |
|
| 包含搜索结果 | search_result_enabled |
||
|
tiktok_subplacements |
||
| 用户评论 | comment_disabled |
||
| 视频下载 |
video_download_disabled |
||
| 视频共享 | share_disabled |
||
| Pangle 媒体屏蔽列表 | blocked_pangle_app_ids |
||
| 受众定向 | 已保存受众 | saved_audience_id |
|
选择定向模式
|
auto_targeting_enabled |
||
| 定向更广泛的受众 /对受众再营销 (“购物广告类型”设置为“视频购物广告”且“商品数据源详细信息”设置为“目录”(商品库)时) |
shopping_ads_retargeting_typeshopping_ads_retargeting_actions_daysincluded_custom_actionsexcluded_custom_actions |
||
| 扩大范围 / 缩小范围 (“购物广告类型”设置为“视频购物广告”,“商品数据源详细信息”设置为“目录”,且选择“对受众再营销”时) |
shopping_ads_retargeting_custom_audience_relation |
||
| 人群属性 - 地域 | location_idszipcode_ids |
||
| 人群属性 - 语言 | languages |
||
| 人群属性 - 性别 | gender |
||
| 人群属性 - 年龄 | age_groups |
||
| 人群属性 - 消费能力 | spending_power |
||
| 人群属性 - 家庭收入 |
household_income |
||
受众
|
audience_idsexcluded_audience_ids |
||
| 智能受众 | smart_audience_enabled |
||
| 兴趣与行为 - 兴趣 | interest_category_idsinterest_keyword_ids |
||
| 兴趣与行为 - 购买意向 | purchase_intention_keyword_ids |
||
| 兴趣与行为 - 视频互动 & 创作者互动 & 话题互动 |
actions |
||
| 智能型兴趣和行为 | smart_interest_behavior_enabled |
||
| Pangle流量包 | included_pangle_audience_package_idsexcluded_pangle_audience_package_ids |
||
| 设备 - 系统版本 | operating_systemsmin_android_versionmin_ios_versionios14_targeting |
||
| 设备 - 设备机型 | device_model_ids |
||
| 设备 - 网络情况 | network_types |
||
| 设备 - 运营商 | carrier_ids |
||
| 设备 - 互联网服务提供商 |
isp_ids |
||
| 设备 - 设备价格 | device_price_ranges |
||
| 定向扩量 | targeting_expansion |
||
| 内容相关定向 | 内容话题 | contextual_tag_ids |
|
| 内容排除 | 库存筛选 | brand_safety_typebrand_safety_partner |
|
| 类别排除 | category_exclusion_ids |
||
| 行业敏感内容控制 | vertical_sensitivity_id |
||
| 预算 & 排期 | 预算 | budget_modebudget |
|
| 排期 | schedule_typeschedule_start_timeschedule_end_time |
||
| 分时段 | dayparting |
||
| 出价 & 优化 |
优化目标 | optimization_goal |
|
| 消息事件集 (优化位置为即时通讯应用且优化目标为会话数时) |
message_event_set_id |
||
| 频次上限 | frequencyfrequency_schedule |
||
| 选择要优化投放的应用内事件数据 (“优化目标”设置为“安装与应用内事件数据”时) |
secondary_optimization_event |
||
| 竞价策略 | bid_typebid_price |
||
| USD/转化 |
conversion_bid_price |
||
| 竞价策略 | deep_bid_typeroas_bid |
||
| 第 7 天 ROAS / 第 0 天 ROAS | vbo_window |
||
| USD/观看 | bid_display_mode |
||
| 留存率目标 | next_day_retention |
||
归因设置
|
click_attribution_windowview_attribution_windowattribution_event_count |
||
| 计费点 | billing_event |
||
| 投放速度 | pacing |
||
| 推广系列列表 | 广告组 - 开关 | operation_status |
广告层级
若要创建广告,需使用/ad/create/。
下表列出了 TikTok 广告管理平台上广告层级的设置及 API 中的对应配置。
| TikTok 广告管理平台模块 | TikTok 广告管理平台设置 | TikTok 广告管理平台界面示例 | API 配置 |
|---|---|---|---|
| 智能创意广告 | 智能创意广告 | 若想了解如何创建智能创意广告,请查看智能创意。 | |
| 广告名称 | 广告名称 | ad_name |
|
| 广告发布身份(认证身份) | 广告发布身份 | identity_typeidentity_ididentity_authorized_bc_id |
|
| 商品详情 | 商品 | catalog_idproduct_specific_typeitem_group_idsproduct_set_idsku_ids |
|
showcase_products |
|||
| 创意详情 | 广告版式(广告样式) | ad_format |
|
| 广告版式 | vertical_video_strategy |
||
| 广告设置 - 动态样式 | dynamic_format |
||
| 创意素材 - 视频 | video_id |
||
| 创意素材 - 图片 | image_ids |
||
| 创意素材 - 音乐 | music_id |
||
| 创意素材 - 帖子 | tiktok_item_id |
||
| 创意素材 - 帖子 - 推广音乐 | promotional_music_disabled |
||
| 创意素材 - 帖子 - 拼接与合拍 | item_duet_statusitem_stitch_status |
||
| 创意素材 - 视频 - 只作为广告显示 | dark_post_status |
||
| 创意素材 - 商品库视频 | shopping_ads_video_package_id |
||
| 创意素材 - 广告文案 | ad_text |
||
| 创意素材 - 行动引导文案 | call_to_actioncall_to_action_id |
||
| 创新互动样式 | card_id |
||
| 目标页面 | URL | landing_page_url |
|
| 自定义页面 | page_id |
||
| 添加特定的自定产品页面作为目标页面 (添加特定的自定义商品页面作为目标页面) |
cpp_url |
||
| TikTok 页面类型 | tiktok_page_category |
||
| 电话号码 | phone_region_codephone_region_calling_codephone_number |
||
| 直达链接优先 & 延迟深度链接 |
deeplinkdeeplink_type |
||
| 延迟深度链接 (购物广告场景下) |
shopping_ads_deeplink_type |
||
| 落地页类型 (购物广告场景下) |
shopping_ads_fallback_type |
||
| 失败路径 | fallback_type |
||
| 动态目标页面 | dynamic_destination |
||
| 构建 URL 参数 | utm_params |
||
| 即时体验商品页面 | instant_product_page_used |
||
| 欢迎消息 | auto_message_id |
||
| 此广告包含由 AI 生成的内容 | aigc_disclosure_type |
||
| 免责声明 | 免责声明 | disclaimer_typedisclaimer_text disclaimer_clickable_texts |
|
| 监测 | TikTok 事件跟踪 - 网站事件 | tracking_pixel_id |
|
| TikTok 事件跟踪 - 应用事件 | tracking_app_id |
||
| TikTok 事件跟踪 - 线下事件 | tracking_offline_event_set_ids |
||
| TikTok 事件跟踪 - 消息事件集 | tracking_message_event_set_id |
||
| TikTok 事件跟踪 - 第三方可见性监测 | vast_moat_enabledviewability_postbid_partnerviewability_vast_url |
||
| TikTok 事件跟踪 - 通过第三方合作伙伴测评品牌安全性 | brand_safety_postbid_partnerbrand_safety_vast_url |
||
| 第三方监测设置 - 展现监测URL | impression_tracking_url |
||
| 第三方监测设置 - 点击监测URL | click_tracking_url |
||
| 试玩素材 | 添加试玩素材 | playable_url |
|
| 推广系列列表 | 广告 - 开关 | operation_status |