创建以网站作为优化位置的升级版 Smart+ 线索收集推广系列
以网站作为优化位置的升级版 Smart+ 线索收集推广系列是指将 promotion_target_type 设置为 EXTERNAL_WEBSITE 的升级版 Smart+ 线索收集推广系列。
步骤
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 |
|
| 推广系列预算模式 |
|
budget_mode |
|
| 基于目标增加预算 (当推广系列预算策略为推广系列预算,且推广系列预算模式为日预算时) |
选择以下任意选项:
|
budget_auto_adjust_strategy |
当 budget_optimize_on 为 true 或不传入,且 budget_mode 为 BUDGET_MODE_DYNAMIC_DAILY_BUDGET 时:
|
| 推广系列预算 |
|
budget |
|
| 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 |
传入合法值 |
| 优化和出价 · 地域 |
网站 注意:如果你选择推广系列预算模式,此设置必须在同一推广系列内的所有广告组中保持一致。 |
promotion_type |
LEAD_GENERATION |
promotion_target_type |
EXTERNAL_WEBSITE注意:当推广系列层级的 |
||
| 优化和出价 · 目标 |
转化 | optimization_goal |
CONVERT |
| 优化和出价 · 事件 · 数据连接 |
合法 Pixel | pixel_id |
传入合法值。 若想获取你的广告账号内的 Pixel 列表,需使用 /pixel/list/ 接口。 |
| 优化和出价 · 事件 · 优化事件 |
已启用 注意:如果你选择推广系列预算模式,此设置必须在同一推广系列内的所有广告组中保持一致。 |
optimization_event |
传入合法值。 若想获取已配置 Pixel 的优化事件,需使用 /pixel/list/ 接口。 查看转化事件 - Pixel 事件文档,查找枚举值。 注意:当推广系列层级的 |
| 优化和出价 · 深层漏斗优化(可选) |
已启用或未启用 通过深层漏斗优化,你可以在主要优化事件之外再选择一个次要事件,这有助于提升推广系列的效果。 |
deep_funnel_optimization_status deep_funnel_event_source deep_funnel_event_source_id deep_funnel_optimization_event |
注意:
|
| 优化和出价 · 出价策略和(可选)目标 CPA |
可采用以下任意出价策略:
注意:
|
bid_typeconversion_bid_price |
将 bid_type 设置为 BID_TYPE_CUSTOM 或 BID_TYPE_NO_BID。
注意:
|
deep_bid_typeroas_bid |
不传入 | ||
| 优化和出价 · 归因设置 |
从支持的归因设置选项中,选择适用于特定场景的选项。 |
|
查看归因窗口期和事件统计方式 - 线索收集文档,了解不同场景支持的归因设置选项。 |
| 优化和出价 · 计费事件 |
oCPM | billing_event |
OCPM |
| 优化和出价 · 投放速度 |
标准(默认) | N/A | 升级版 Smart+ 推广系列默认设置为标准投放速度。 |
| 预算和排期 · 预算 |
注意:广告组预算模式(如传入)必须在同一推广系列内的所有广告组中保持一致。 |
budget_modebudget |
注意: |
| 预算和排期 · 基于目标增加预算(当出价策略为目标 CPA 时) |
已启用或未启用 若想启用此设置,应满足以下条件:
|
budget_auto_adjust_strategy |
使用以下任意值:
如果满足以下所有条件,只能将此字段设置为 AUTO_BUDGET_INCREASE:
注意:基于目标增加预算目前为白名单功能。如需使用此功能,请联系你的 TikTok 销售代表。 |
| 预算和排期 · 为每个广告组添加消耗目标 · 最低日消耗 |
|
min_budget |
|
| 预算和排期 · 排期 |
使用以下任意类型:
|
schedule_type schedule_start_time schedule_end_time |
注意:在以下任意场景中,你只能将
|
| 预算和排期 · 分时段(可选) |
使用以下任意类型:
|
dayparting |
使用以下任意配置:
|
| 受众定向优化模式 | 使用以下任意模式:
|
targeting_optimization_mode |
使用以下任意值:
|
| 广告位和品牌安全 · 广告位 |
使用以下任意类型:
|
placement_typeplacements |
|
| 广告位和品牌安全 · 子广告位 (广告位包含 TikTok 时选填) |
不启用,或启用并带有以下一个或多个选项:
注意:
|
tiktok_subplacements |
当 placement_type 为 PLACEMENT_TYPE_NORMAL 且 placements 包含 PLACEMENT_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: "{{AccessToken}}"' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"campaign_id": "{{campaign_id}}",
"request_id": "{{request_id}}",
"adgroup_name": "{{adgroup_name}}",
"promotion_type": "LEAD_GENERATION",
"promotion_target_type": "EXTERNAL_WEBSITE",
"optimization_goal": "CONVERT",
"pixel_id": "{{pixel_id}}",
"optimization_event": "FORM",
"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": [
"1562822"
]
}
}'
(/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": "EVERY",
"bid_type": "BID_TYPE_CUSTOM",
"billing_event": "OCPM",
"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": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"modify_time": "{{modify_time}}",
"optimization_event": "FORM",
"optimization_goal": "CONVERT",
"pixel_id": "{{pixel_id}}",
"placement_type": "PLACEMENT_TYPE_NORMAL",
"placements": [
"PLACEMENT_TIKTOK",
"PLACEMENT_GLOBAL_APP_BUNDLE"
],
"promotion_target_type": "EXTERNAL_WEBSITE",
"promotion_type": "LEAD_GENERATION",
"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": {
"age_groups": [
"AGE_18_24",
"AGE_25_34",
"AGE_35_44",
"AGE_45_54",
"AGE_55_100"
],
"brand_safety_type": "EXPANDED_INVENTORY",
"gender": "GENDER_UNLIMITED",
"location_ids": [
"1562822"
],
"spc_audience_age": "OVER_EIGHTEEN"
},
"video_download_disabled": false,
"view_attribution_window": "ONE_DAY"
}
}
(/code)
3. 创建广告
使用 /smart_plus/ad/create/ 接口创建广告。
需确保满足以下要求。完整参数列表参见 /smart_plus/ad/create/ 接口。
| 设置 | 要求 | 参数 | 如何配置参数 |
|---|---|---|---|
| 广告名称 (可选) |
默认情况下,系统将自动生成广告名称。你可以通过传入合法的广告名称来自定义。 | ad_name |
|
| 目标页面 | 选择以下任意选项:
|
landing_page_url_list page_list |
|
| 创意素材 · 广告发布身份 |
选择以下任意选项:
|
identity_type |
使用以下任意值:
注意:
|
identity_id |
传入合法值 若想获取你的广告账号下的广告发布身份列表,需使用 /identity/get/ 接口。 |
||
identity_authorized_bc_id |
当 identity_type 为 BC_AUTH_TT 时,传入合法值 |
||
| 创意素材 · 广告创意和广告文案 |
单个广告可添加 1-50 个广告创意,这些创意可包含以下类型:
|
ad_format |
传入合法值 |
creative_list video_info image_info music_info ad_text_list tiktok_item_id |
通过 creative_list 传入 1-50 个广告创意。广告创意可以是以下任意类型:
|
||
| 添加商品和服务信息(可选) | 未启用 | N/A | N/A |
| 行动引导文案 | 动态 | call_to_action_id |
传入合法值 |
call_to_action_list |
不传入 | ||
| 创新互动样式 (可选) (当广告创意包含视频或视频照片时) |
未启用或已启用,最多包含一个以下任意类型的创新互动样式:
|
interactive_add_on_list |
不传入或最多传入以下任意创新互动样式类型的一个 ID:
注意:
|
| 免责声明 (可选) |
已启用或未启用 | disclaimer |
传入合法值或不传入 |
| 监测 · TikTok 事件监测 · 应用事件 (可选) |
已启用或未启用 | tracking_app_id |
传入合法值或不传入 |
| 监测 · 第三方监测设置 · 展示监测 URL (可选) |
已启用或未启用 | impression_tracking_url |
传入合法值或不传入 |
| 监测 · 第三方监测设置 · 点击监测 URL (可选) |
已启用或未启用 | click_tracking_url |
传入合法值或不传入 |
示例
请求
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/ad/create/' \
--header 'Access-Token: "{{AccessToken}}"' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"adgroup_id": "{{adgroup_id}}",
"ad_name": "{{ad_name}}",
"landing_page_url_list": [
{
"landing_page_url": "{{landing_page_url}}"
}
],
"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}}"
}
}
],
"call_to_action_id": "{{call_to_action_id}}",
"impression_tracking_url": "{{impression_tracking_url}}",
"click_tracking_url": "{{click_tracking_url}}"
}'
(/code)
返回
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"ad_id": "{{ad_id}}",
"ad_name": "{{ad_name}}",
"advertiser_id": "{{advertiser_id}}",
"adgroup_id": "{{adgroup_id}}",
"call_to_action_id": "{{call_to_action_id}}",
"click_tracking_url": "{{click_tracking_url}}",
"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}}"
}
}
],
"impression_tracking_url": "{{impression_tracking_url}}",
"landing_page_url_list": [
{
"landing_page_url": "{{landing_page_url}}"
}
],
"secondary_status": "AD_STATUS_CREATE"
}
}
(/code)