创建升级版 Smart+ TikTok Growth Max 小游戏推广系列
本文介绍创建升级版 Smart+ TikTok Growth Max 小游戏推广系列的步骤。
升级版 Smart+ TikTok Growth Max 小游戏推广系列是一种升级版 Smart+ 推广系列,用于推广 TikTok 小游戏。
步骤
1. 创建推广系列
使用 /smart_plus/campaign/create/ 接口创建推广系列。
需确保满足以下要求。完整参数列表参见 /smart_plus/campaign/create/ 接口。
| 设置 | 要求 | 参数 | 如何配置参数 |
|---|---|---|---|
| 推广目标 | 原生增长 | objective_type |
APP_PROMOTION |
app_promotion_type |
MINIS |
||
| iOS 14 专属推广系列 | 未启用 | campaign_type |
REGULAR_CAMPAIGN 或不传入 |
app_id |
不传入 | ||
campaign_app_profile_page_state |
不传入 | ||
| 使用商品库 | 未启用 | catalog_enabled |
false |
| 推广系列名称 | 传入合法名称 | campaign_name |
传入合法值 |
| 推广系列预算策略 | 使用以下任意类型:
|
budget_optimize_on |
|
| 推广系列预算模式 |
|
budget_mode |
|
| 推广系列预算 |
|
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: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"request_id": "{{request_id}}",
"objective_type": "APP_PROMOTION",
"app_promotion_type": "MINIS",
"campaign_type": "REGULAR_CAMPAIGN",
"catalog_enabled": false,
"campaign_name": "{{campaign_name}}",
"budget_optimize_on": true,
"budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
"budget": {{budget}}
}'
(/code)
返回
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"advertiser_id": "{{advertiser_id}}",
"app_promotion_type": "MINIS",
"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",
"create_time": "{{create_time}}",
"modify_time": "{{modify_time}}",
"objective_type": "APP_PROMOTION",
"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 |
传入合法值 |
| 优化和出价 · 小游戏 |
传入一个有效的小游戏类型的 TikTok Minis 注意:如果你选择推广系列预算模式,此设置必须在同一推广系列内的所有广告组中保持一致。 |
promotion_type |
MINI_GAME注意:当推广系列层级的 |
minis_id |
传入一个有效的 TikTok Minis 的 ID。 若想获取广告账号中有效的 TikTok Minis 的 ID,需使用 /minis/get/ 接口,并选择 minis_status 为 ACTIVE 且 minis_type 为 MINI_GAME 的 TikTok Minis。 |
||
| 优化和出价 · 目标 |
价值:为了最大限度地提高总付费价值,我们会将你的广告投放给更有可能付费购买的用户。 注意:如果你选择推广系列预算模式,此设置必须在同一推广系列内的所有广告组中保持一致。 |
optimization_goal |
VALUE(需传入 optimization_event)注意:当推广系列层级的 |
| 优化和出价 · 选择价值 |
广告收入价值 注意:
|
optimization_event |
AD_REVENUE_VALUE若想确认设置是否符合启用广告收入价值的条件,需使用 /tool/vbo_status/ 接口。 注意:
|
| 优化和出价 · 出价策略和(可选)目标 ROAS |
选择以下任意选项:
注意:
|
|
将 deep_bid_type 设置为 VO_MIN_ROAS 或 VO_HIGHEST_VALUE,并将 bid_type 设置为 BID_TYPE_NO_BID。请勿传入 conversion_bid_price 和 bid_price。
注意:
|
| 优化和出价 · 出价策略的时间窗口期 |
使用以下任意类型:
注意:如果你选择推广系列预算模式,此设置(如传入)必须在同一推广系列内的所有广告组中保持一致。 |
vbo_window |
使用以下任意值:
deep_bid_type 设置为 VO_MIN_ROAS,传入 roas_bid 并将 vbo_window 设置为 ZERO_DAY,系统将力求让你当日的平均 ROAS 达到或高于目标 ROAS 值。若想确认设置是否符合启用第 0 天时间窗口期或第 7 天时间窗口期的条件,需使用 /tool/vbo_status/ 接口。 注意:当推广系列层级的 |
| 优化和出价 · 归因设置 |
归因窗口期将默认为 30 天点击,事件统计方式将默认为每一次。 |
|
不传入
|
| 优化和出价 · 计费事件 |
oCPM 注意:如果你选择推广系列预算模式,计费事件必须在同一推广系列内的所有广告组中保持一致。 |
billing_event |
OCPM注意:当推广系列层级的 |
| 优化和出价 · 投放速度 |
标准(默认) | N/A | 升级版 Smart+ 推广系列默认设置为标准投放速度。 |
| 预算和排期 · 预算 |
注意:广告组预算模式(如传入)必须在同一推广系列内的所有广告组中保持一致。 |
budget_modebudget |
注意: |
| 预算和排期 · 为每个广告组添加消耗目标 · 最低日消耗 |
|
min_budget |
|
| 预算和排期 · 排期 |
使用以下任意类型:
注意:在以下任意场景中,你只能选择“设置开始时间并持续投放广告组”:
|
schedule_typeschedule_start_timeschedule_end_time |
注意:在以下任意场景中,你只能将
|
| 预算和排期 · 分时段(可选) |
使用以下任意类型:
|
dayparting |
使用以下任意配置:
|
| 受众定向优化模式 | 自动定向
|
targeting_optimization_mode |
AUTOMATIC 或不传入如需了解支持的定向设置,参见升级版 Smart+ TikTok Growth Max 小游戏推广系列中不同定向优化模式的可用定向设置。 |
| 广告位和品牌安全 · 广告位 |
TikTok | placement_type |
PLACEMENT_TYPE_NORMAL |
placements |
PLACEMENT_TIKTOK |
||
| 广告位和品牌安全 · 子广告位 (广告位包含 TikTok 时选填) |
不启用,或启用并带有以下一个或多个选项:
注意:
|
tiktok_subplacements |
不传入,或传入以下一个或多个值:
注意:
|
| 广告位和品牌安全 · 品牌安全和适用性 |
这些设置仅应用于 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+ TikTok Growth Max 小游戏推广系列中不同定向优化模式的可用定向设置
| 定向优化模式 | 可用定向设置 | 要求 | 参数 | 如何配置参数 |
|---|---|---|---|---|
| 自动定向 ( targeting_optimization_mode 为 AUTOMATIC 或不传入) |
受众控制 · 地域 |
定向地域应与 TikTok Minis 的定向地域匹配或为其子集。 | location_ids 或 zipcode_ids,或两者都需要 |
传入与已传入 minis_id 的定向地域匹配或为其子集的地域的 ID。若想获取 TikTok Minis 的定向地域,需使用 /minis/get/ 接口并查看返回的 region_codes。 |
| 受众控制 · 最低年龄 |
选择以下任意选项:
|
spc_audience_age |
使用以下任意值:
|
|
| 受众控制 · 语言(可选) |
已启用或未启用 | languages |
传入合法值或不传入 | |
| 受众控制 · 性别(可选) |
已启用或未启用 | gender |
传入合法值或不传入 | |
| 受众控制 · 排除受众(可选) |
已启用或未启用 | excluded_audience_ids |
传入合法值或不传入 |
示例
请求
(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}}",
"promotion_type": "MINI_GAME",
"minis_id": "{{minis_id}}",
"optimization_goal": "VALUE",
"optimization_event": "ACTIVE_PAY",
"bid_type": "BID_TYPE_NO_BID",
"deep_bid_type": "VO_HIGHEST_VALUE",
"vbo_window": "ZERO_DAY",
"billing_event": "OCPM",
"schedule_type": "SCHEDULE_START_END",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_end_time": "{{schedule_end_time}}",
"placement_type": "PLACEMENT_TYPE_NORMAL",
"placements": [
"PLACEMENT_TIKTOK"
],
"targeting_optimization_mode": "AUTOMATIC",
"targeting_spec": {
"location_ids": [
"{{location_id}}"
]
}
}'
(/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_NO_BID",
"billing_event": "OCPM",
"budget": 0,
"budget_mode": "BUDGET_MODE_INFINITE",
"campaign_id": "{{campaign_id}}",
"campaign_name": "{{campaign_name}}",
"click_attribution_window": "THIRTY_DAYS",
"comment_disabled": false,
"conversion_bid_price": 0,
"create_time": "{{create_time}}",
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"deep_bid_type": "VO_HIGHEST_VALUE",
"engaged_view_attribution_window": "OFF",
"is_hfss": false,
"is_lhf_compliance": false,
"min_budget": 0,
"minis_id": "{{minis_id}}",
"modify_time": "{{modify_time}}",
"operation_status": "ENABLE",
"optimization_event": "ACTIVE_PAY",
"optimization_goal": "VALUE",
"pacing": "PACING_MODE_SMOOTH",
"phone_info": {},
"placement_type": "PLACEMENT_TYPE_NORMAL",
"placements": [
"PLACEMENT_TIKTOK"
],
"promotion_type": "MINI_GAME",
"schedule_end_time": "{{schedule_end_time}}",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_type": "SCHEDULE_START_END",
"search_result_enabled": false,
"secondary_optimization_event": "PURCHASE_ROI",
"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": [
"200",
"202",
"203"
],
"gender": "GENDER_UNLIMITED",
"location_ids": [
"{{location_id}}"
],
"spc_audience_age": "OVER_EIGHTEEN"
},
"vbo_window": "ZERO_DAY",
"video_download_disabled": false,
"view_attribution_window": "OFF"
}
}
(/code)
3. 创建广告
使用 /smart_plus/ad/create/ 接口创建广告。
需确保满足以下要求。完整参数列表参见 /smart_plus/ad/create/ 接口。
| 设置 | 要求 | 参数 | 如何配置参数 |
|---|---|---|---|
| 广告名称 (可选) |
默认情况下,系统将自动生成广告名称。 你可以通过传入合法的广告名称来自定义。 |
ad_name |
|
| 创意素材 · 广告发布身份 |
选择以下任意选项:
|
identity_type |
使用以下任意值:
注意:
|
identity_id |
传入合法值 若想获取你的广告账号下的广告发布身份列表,需使用 /identity/get/ 接口。 |
||
identity_authorized_bc_id |
当 identity_type 为 BC_AUTH_TT 时,传入合法值 |
||
| 创意素材 · 广告创意和广告文案 |
单个广告可添加 1-50 个广告创意,这些创意可包含以下类型:
注意:你的创意可能符合付费流量和自然流量优化的条件。在此流程中,广告目标页面链接和相关 URL 参数可能会同步到你的 TikTok 帖子,作为原生锚点展示在推荐页中。在 TikTok 和授权第三方的报告系统中,经过这一优化的原生创意的效果将与付费广告合并为一个实体进行报告。 |
ad_format |
传入合法值 |
creative_listvideo_infoimage_infomusic_infoad_text_listtiktok_item_id |
通过 creative_list 传入 1-50 个广告创意。广告创意可以是以下任意类型:
注意:你的创意可能符合付费流量和自然流量优化的条件。在此流程中,广告目标页面链接和相关 URL 参数可能会同步到你的 TikTok 帖子,作为原生锚点展示在推荐页中。在 TikTok 和授权第三方的报告系统中,经过这一优化的原生创意的效果将与付费广告合并为一个实体进行报告。 |
||
| 创意素材 · 试玩素材 (对单视频广告样式可选) |
已启用或未启用 | playable_list |
当 ad_format 为 SINGLE_VIDEO 时:
|
| 卖点(可选) | 已启用或未启用 | selling_points |
传入合法值或不传入 |
| 行动引导文案 | 动态 | call_to_action_id |
传入合法值 要了解如何创建动态 CTA,请查看 CTA 建议 > 动态 CTA。 |
call_to_action_list |
不传入 | ||
| 创新互动样式 (可选) (当传入短剧类型的 TikTok Minis 且广告创意包含视频或视频帖子时) |
未启用或已启用,最多包含一个以下任意类型的创新互动样式:
|
interactive_add_on_list |
不传入或最多传入以下任意创新互动样式类型的一个 ID:
注意:
|
| 目标页面 | TikTok Minis URL。此链接将出现在广告中,用户点击后将直接跳转到 TikTok Minis 界面。 | landing_page_url_list |
传入合法的 TikTok Minis URL。 确保 URL 与在广告组层级传入的 minis_id 匹配。要获取合法的 TikTok Minis URL,请联系你的 TikTok 销售代表。 |
| 免责声明 (可选) |
已启用或未启用 | 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": "SINGLE_VIDEO",
"video_info": {
"video_id": "{{video_id}}"
},
"image_info": [
{
"web_uri": "{{web_uri}}"
}
],
"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}}"
}
],
"landing_page_url_list": [
{
"landing_page_url": "{{landing_page_url}}"
}
],
"ad_configuration": {
"call_to_action_id": "{{call_to_action_id}}",
"product_info": {
"selling_points": [
"{{selling_point}}"
]
}
}
}'
(/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",
"deeplink_utm_params": [],
"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_authorized_bc_id": "{{bc_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT",
"image_info": [
{
"web_uri": "{{image_web_uri}}"
}
],
"material_name": "",
"video_info": {
"file_name": "",
"video_id": "{{video_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": "{{ad_id}}"
}
}
(/code)