(即将废弃)创建旧版 Smart+ 网站推广系列
本文介绍了创建 Smart+ 网站推广系列的具体步骤。
根据您对网站推广系列类型的偏好,您可创建普通 Smart+ 网站推广系列、Smart+ 商品库广告或(即将废弃的)智能效果网站推广系列。若想了解相关创建步骤,请查看对应小节:“创建普通 Smart+ 网站推广系列”、“创建 Smart+ 商品库广告”和“创建一个智能效果网站推广系列”。
注意
智能效果网站推广系列将在下个 API 版本中废弃。为保证流畅的 API 体验,建议您尽快升级至 Smart+ 网站推广系列。Smart+ 网站推广系列是 AI 驱动的自动化解决方案,利用机器学习模型来促进广告主实现商业目标。
创建普通 Smart+ 网站推广系列
普通 Smart+ 网站推广系列指不使用商品库商品投放广告的 Smart+ 网站推广系列。对于此类推广系列,您需将 web_all_in_one_catalog_status 设置为 UNSET 或不传入 web_all_in_one_catalog_status。
步骤
创建普通 Smart+ 网站推广系列需确保满足以下要求。若想了解完整的参数列表,可查看/campaign/spc/create/接口文档。
注意
普通 Smart+ 网站广告组不支持用于/split_test/create/创建拆分对比测试。
| 设置 | 要求 | 参数 | 如何设置该参数 |
|---|---|---|---|
| 推广目标 | 网站转化量 | objective_type |
WEB_CONVERSIONS |
| 网站推广系列类型 | Smart+ 网站推广系列 | spc_type |
WEB_ALL_IN_ONE |
| iOS 14 专属推广系列 | 未启用 | campaign_type |
REGULAR_CAMPAIGN 或不传入 |
app_id |
不传入 | ||
campaign_app_profile_page_state |
不传入 | ||
| 特殊广告分类(可选) | 启用或未启用 注意:本设置仅支持注册地为美国或加拿大的广告主使用。 |
special_industries |
传入合法值,或不传入 |
| 推广系列预算优化 | N/A Smart+ 网站推广系列默认均启用推广系列预算优化 |
N/A | N/A 注意:若您使用/campaign/get/检索 Smart+ 网站推广系列,返回的 |
| 优化位置 (推广对象类型) |
网站 | promotion_type |
WEBSITE |
promotion_website_type |
不传入 | ||
| 商品来源详情 · 使用商品库 |
未启用 | web_all_in_one_catalog_status |
UNSET 或不传入 |
| 优化目标 | 使用以下任一目标:
|
optimization_goal |
使用以下任一值:
|
| Pixel (数据连接) |
|
pixel_id |
|
| 优化事件 |
|
optimization_event |
|
| 出价策略 |
|
bid_typebid_priceconversion_bid_pricedeep_bid_typeroas_bid |
|
| 归因设置 | 在具体场景中选择对应支持的归因设置 |
|
若想了解不同场景下支持的归因设置,请查看 归因窗口期和事件统计方式 - 网站转化量。 |
| 计费事件 (计费点) |
|
billing_event |
|
| 受众定向 · 地域 |
启用 | location_ids |
传入合法值 |
| 受众定向 · 语言 (可选) |
启用或未启用 | languages |
传入合法值,或不传入 |
| 受众定向 · 性别(可选) |
需申请白名单才可启用 注意:Smart+ 推广系列中的年龄定向目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。 |
gender |
传入合法值,或不传入 |
| 受众定向 · 年龄 |
18+ | exclude_age_under_eighteen |
true |
| 受众定向 · 排除受众(可选) |
启用或未启用 | excluded_audience_ids |
传入合法值,或不传入 |
| 版位 (广告位) |
TikTok 版位(包括搜索结果)或自动版位 | placement_type placements |
不传入 注意 :自动选择版位是 Smart+ 网站推广系列的一个重点功能。系统将根据您的其他设置自动配置广告投放版位,并从不同的版位中选择高质量流量,来实现更好的广告效果。若传入了
|
| 用户评论(可选) | 启用或未启用 | comment_disabled |
传入合法值,或不传入 |
| 允许下载视频(可选) | 启用或未启用 | share_disabled |
传入合法值,或不传入 |
| 允许共享视频(可选) | 启用或未启用 | video_download_disabled |
传入合法值,或不传入 |
| 预算模式 | 使用以下任一类型:
|
budget_mode |
使用以下任一值:
|
| 排期类型 | 以下任一类型:
|
schedule_typeschedule_start_timeschedule_end_time |
|
| 认证身份 (广告发布身份) |
使用以下任一类型:
|
identity_type |
使用以下任一值:
注意:对于用于 Spark Ads 的认证身份,需在 |
identity_id |
传入合法值 若想获取广告账号下的认证身份,可使用/identity/get/。 |
||
identity_authorized_bc_id |
identity_type 为 BC_AUTH_TT时传入合法值 |
||
| 目标页面 | 网站 URL | landing_page_urlspage_list |
|
| 创意素材 |
|
video_infoimage_infotitle_listtiktok_item_id |
|
| 添加商品信息 · 添加促销码或优惠 (可选) |
不启用,或启用最多 10 个促销码或优惠 | promo_info_list |
不传入,或传入合法值 |
| 创新互动样式(可选) | 未启用,或使用以下任一类型:
|
card_list |
不传入或指定以下任一类型的创意素材包的 ID:
若想创建创意素材包,可使用 /creative/portfolio/create/。 |
| 行动引导文案 | 使用以下任一类型:
注意:使用用于 Spark Ads 的认证身份时,仅支持使用动态优选行动引导文案。 |
call_to_action_idcall_to_action_list |
注意:若 |
示例
优化目标设置为转化
出价策略为目标 CPA 且使用非 Spark Ads 认证身份
请求
(code http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/spc/create/' \
--header 'Access-Token: {{Access-Token}}' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"objective_type": "WEB_CONVERSIONS",
"spc_type": "WEB_ALL_IN_ONE",
"campaign_name": "{{campaign_name}}",
"operation_status": "DISABLE",
"promotion_type": "WEBSITE",
"exclude_age_under_eighteen": true,
"placement_type": "PLACEMENT_TYPE_NORMAL",
"placements": ["PLACEMENT_TIKTOK"],
<span style="background-color: green;">"optimization_goal": "CONVERT",
"pixel_id": "{{pixel_id}}",
"optimization_event": "DOWNLOAD_START",
"bid_type":"BID_TYPE_CUSTOM",
"conversion_bid_price":{{conversion_bid_price}},
"billing_event": "OCPM", </span>
"location_ids": [
"2077456",
"6252001"
],
"budget_mode": "BUDGET_MODE_DAY",
"budget": {{budget}},
"schedule_type": "SCHEDULE_FROM_NOW",
"schedule_start_time": "{{schedule_start_time}}",
<span style="background-color: green;">"identity_id": "{{identity_id}}",
"identity_type": "CUSTOMIZED_USER",</span>
"media_info_list": [
{
"media_info": {
<span style="background-color: green;">"image_info": [
{
"web_uri": "{{web_uri}}"
}
],
"video_info": {
"video_id": "{{video_id}}"
}</span>
}
}
],
"title_list": [
{
"title": "{{title}}"
}
],
"call_to_action_list": [
{
"call_to_action": "ORDER_NOW"
}
],
"landing_page_urls": [
{
"landing_page_url": "{{landing_page_url}}"
}
]
}'
(/code)
返回
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"landing_page_urls": [
{
"tiktok_item_id": null,
"video_id": null,
"landing_page_url": "{{landing_page_url}}"
}
],
"deep_bid_type": null,
"impression_tracking_url": null,
"card_list": null,
"schedule_end_time": "{{schedule_end_time}}",
"page_list": null,
"promotion_type": "WEBSITE",
"campaign_type": "REGULAR_CAMPAIGN",
"excluded_audience_ids": null,
"advertiser_id": "{{advertiser_id}}",
"engaged_view_attribution_window": null,
"is_smart_performance_campaign": true,
"is_advanced_dedicated_campaign": false,
"app_download_url": null,
"campaign_id": "{{campaign_id}}",
"campaign_app_profile_page_state": null,
"comment_disabled": false,
"identity_id": "{{identity_id}}",
"modify_time": "{{modify_time}}",
"optimization_event": "DOWNLOAD_START",
"optimization_goal": "CONVERT",
"call_to_action_id": null,
"deeplink": "",
"spc_type": "WEB_ALL_IN_ONE",
"app_name": null,
"placement_type": "PLACEMENT_TYPE_NORMAL",
"billing_event": "OCPM",
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"pixel_id": "{{pixel_id}}",
"schedule_type": "SCHEDULE_FROM_NOW",
"title_list": [
{
"title": "{{title}}"
}
],
"app_promotion_type": null,
"exclude_age_under_eighteen": true,
"budget": {{budget}},
"promotion_website_type": "UNSET",
"campaign_name": "{{campaign_name}}",
"special_industries": null,
"operation_status": "DISABLE",
"app_id": null,
"attribution_event_count": "ONCE",
"gender": "GENDER_UNLIMITED",
"call_to_action_list": [
{
"call_to_action": "ORDER_NOW"
}
],
"bid_price": null,
"create_time": "{{create_time}}",
"objective_type": "WEB_CONVERSIONS",
"click_tracking_url": null,
"location_ids": [
"2077456",
"6252001"
],
"schedule_start_time": "{{schedule_start_time}}",
"conversion_bid_price": {{conversion_bid_price}},
"app_type": null,
"placements": [
"PLACEMENT_TIKTOK"
],
"blocked_pangle_app_ids": null,
"video_download_disabled": false,
"media_info_list": [
{
"media_info": {
"video_info": {
"video_id": "{{video_id}}",
"file_name": ""
},
"aigc_disclosure_type": null,
"identity_id": null,
"image_info": [
{
"web_uri": "{{web_uri}}"
}
],
"identity_type": null,
"tiktok_item_id": null
}
}
],
"scheduled_budget": 0,
"deeplink_type": null,
"skip_learning_phase": true,
"adgroup_secondary_status": "ADGROUP_STATUS_CAMPAIGN_DISABLE",
"budget_mode": "BUDGET_MODE_DAY",
"languages": [],
"share_disabled": false,
"campaign_secondary_status": "CAMPAIGN_STATUS_DISABLE",
"view_attribution_window": "ONE_DAY",
"bid_type": "BID_TYPE_CUSTOM",
"identity_type": "CUSTOMIZED_USER",
"click_attribution_window": "SEVEN_DAYS"
}
}
(/code)
出价策略为目标 CPA 且使用授权码授权的 Spark Ads 认证身份
请求
(code http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/spc/create/' \
--header 'Access-Token: {{Access-Token}}' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"objective_type": "WEB_CONVERSIONS",
"spc_type": "WEB_ALL_IN_ONE",
"campaign_name": "{{campaign_name}}",
"operation_status": "DISABLE",
"promotion_type": "WEBSITE",
"exclude_age_under_eighteen": true,
"placement_type": "PLACEMENT_TYPE_NORMAL",
"placements": ["PLACEMENT_TIKTOK"],
<span style="background-color: green;">"optimization_goal": "CONVERT",
"pixel_id": "{{pixel_id}}",
"optimization_event": "DOWNLOAD_START",
"bid_type":"BID_TYPE_CUSTOM",
"conversion_bid_price":{{conversion_bid_price}},
"billing_event": "OCPM",</span>
"location_ids": [
"2077456",
"6252001"
],
"budget_mode": "BUDGET_MODE_DAY",
"budget": {{budget}},
"schedule_type": "SCHEDULE_FROM_NOW",
"schedule_start_time": "{{schedule_start_time}}",
"media_info_list": [
{
"media_info": {
<span style="background-color: green;">"identity_type": "AUTH_CODE",
"identity_id": "{{identity_id}}",
"tiktok_item_id": "{{tiktok_item_id}}"</span>
}
}
],
<span style="background-color: green;">"call_to_action_id": "{{call_to_action_id}}",</span>
"landing_page_urls": [
{
"landing_page_url": "{{landing_page_url}}"
}
]
}'
(/code)
返回
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"create_time": "{{create_time}}",
"title_list": [
{
"title": ""
}
],
"share_disabled": false,
"media_info_list": [
{
"media_info": {
"image_info": null,
"aigc_disclosure_type": null,
"video_info": null,
"tiktok_item_id": "{{tiktok_item_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "AUTH_CODE"
}
}
],
"budget_mode": "BUDGET_MODE_DAY",
"comment_disabled": false,
"engaged_view_attribution_window": null,
"schedule_end_time": "{{schedule_end_time}}",
"identity_id": null,
"click_attribution_window": "SEVEN_DAYS",
"bid_price": null,
"promotion_website_type": "UNSET",
"app_type": null,
"adgroup_secondary_status": "ADGROUP_STATUS_CAMPAIGN_DISABLE",
"gender": "GENDER_UNLIMITED",
"campaign_app_profile_page_state": null,
"placements": [
"PLACEMENT_TIKTOK"
],
"languages": [],
"schedule_type": "SCHEDULE_FROM_NOW",
"call_to_action_id": "{{call_to_action_id}}",
"skip_learning_phase": true,
"budget": {{budget}},
"location_ids": [
"2077456",
"6252001"
],
"deeplink": "",
"objective_type": "WEB_CONVERSIONS",
"modify_time": "{{modify_time}}",
"identity_type": null,
"excluded_audience_ids": null,
"video_download_disabled": false,
"deeplink_type": null,
"app_promotion_type": null,
"placement_type": "PLACEMENT_TYPE_NORMAL",
"call_to_action_list": [],
"spc_type": "WEB_ALL_IN_ONE",
"app_download_url": null,
"optimization_goal": "CONVERT",
"is_smart_performance_campaign": true,
"card_list": null,
"landing_page_urls": [
{
"landing_page_url": "{{landing_page_url}}",
"tiktok_item_id": null,
"video_id": null
}
],
"campaign_secondary_status": "CAMPAIGN_STATUS_DISABLE",
"deep_bid_type": null,
"view_attribution_window": "ONE_DAY",
"app_id": null,
"promotion_type": "WEBSITE",
"schedule_start_time": "{{schedule_start_time}}",
"app_name": null,
"campaign_name": "{{campaign_name}}",
"click_tracking_url": null,
"conversion_bid_price": {{conversion_bid_price}},
"bid_type": "BID_TYPE_CUSTOM",
"scheduled_budget": 0,
"special_industries": null,
"advertiser_id": "{{advertiser_id}}",
"is_advanced_dedicated_campaign": false,
"operation_status": "DISABLE",
"blocked_pangle_app_ids": null,
"exclude_age_under_eighteen": true,
"impression_tracking_url": null,
"optimization_event": "DOWNLOAD_START",
"attribution_event_count": "ONCE",
"page_list": null,
"campaign_type": "REGULAR_CAMPAIGN",
"pixel_id": "{{pixel_id}}",
"billing_event": "OCPM",
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"campaign_id": "{{campaign_id}}"
}
}
(/code)
出价策略为目标 CPA 且使用绑定的企业号类型的 Spark Ads 认证身份
请求
(code http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/spc/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"objective_type": "WEB_CONVERSIONS",
"spc_type": "WEB_ALL_IN_ONE",
"campaign_name": "{{campaign_name}}",
"operation_status": "DISABLE",
"promotion_type": "WEBSITE",
"exclude_age_under_eighteen": true,
"placement_type": "PLACEMENT_TYPE_NORMAL",
"placements": ["PLACEMENT_TIKTOK"],
<span style="background-color: green;">"optimization_goal": "CONVERT",
"pixel_id": "{{pixel_id}}",
"optimization_event": "DOWNLOAD_START",
"bid_type":"BID_TYPE_CUSTOM",
"conversion_bid_price":{{conversion_bid_price}},
"billing_event": "OCPM",</span>
"location_ids": [
"2077456",
"6252001"
],
"budget_mode": "BUDGET_MODE_DAY",
"budget": {{budget}},
"schedule_type": "SCHEDULE_FROM_NOW",
"schedule_start_time": "{{schedule_start_time}}",
"media_info_list": [
{
"media_info": {
<span style="background-color: green;">"identity_type": "TT_USER",
"identity_id": "{{identity_id}}",
"tiktok_item_id": "{{tiktok_item_id}}"</span>
}
}
],
<span style="background-color: green;">"call_to_action_id": "{{call_to_action_id}}",</span>
"landing_page_urls": [
{
"landing_page_url": "{{landing_page_url}}"
}
]
}'
(/code)
返回
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"comment_disabled": false,
"page_list": null,
"campaign_app_profile_page_state": null,
"call_to_action_id": "{{call_to_action_id}}",
"schedule_type": "SCHEDULE_FROM_NOW",
"attribution_event_count": "ONCE",
"optimization_event": "DOWNLOAD_START",
"dayparting": "1111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"budget": {{budget}},
"pixel_id": "{{pixel_id}}",
"placement_type": "PLACEMENT_TYPE_NORMAL",
"objective_type": "WEB_CONVERSIONS",
"blocked_pangle_app_ids": null,
"skip_learning_phase": true,
"click_tracking_url": null,
"identity_id": "{{identity_id}}",
"placements": [
"PLACEMENT_TIKTOK"
],
"campaign_secondary_status": "CAMPAIGN_STATUS_DISABLE",
"gender": "GENDER_UNLIMITED",
"conversion_bid_price": {{conversion_bid_price}},
"campaign_type": "REGULAR_CAMPAIGN",
"app_type": null,
"deep_bid_type": null,
"promotion_website_type": "UNSET",
"location_ids": [
"2077456",
"6252001"
],
"is_smart_performance_campaign": true,
"create_time": "{{create_time}}",
"special_industries": null,
"bid_price": null,
"media_info_list": [
{
"media_info": {
"video_info": null,
"image_info": null,
"aigc_disclosure_type": null,
"tiktok_item_id": "{{tiktok_item_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER"
}
}
],
"budget_mode": "BUDGET_MODE_DAY",
"adgroup_secondary_status": "ADGROUP_STATUS_CAMPAIGN_DISABLE",
"engaged_view_attribution_window": null,
"schedule_start_time": "{{schedule_start_time}}",
"optimization_goal": "CONVERT",
"app_name": null,
"languages": [],
"title_list": [
{
"title": "{{title}}"
}
],
"deeplink": "{{deeplink}}",
"deeplink_type": null,
"identity_type": "{{identity_type}}",
"schedule_end_time": "{{schedule_end_time}}",
"modify_time": "{{modify_time}}",
"campaign_name": "{{campaign_name}}",
"impression_tracking_url": null,
"share_disabled": false,
"landing_page_urls": [
{
"video_id": null,
"landing_page_url": "{{landing_page_url}}",
"tiktok_item_id": null
}
],
"billing_event": "OCPM",
"excluded_audience_ids": null,
"scheduled_budget": 0,
"promotion_type": "WEBSITE",
"spc_type": "WEB_ALL_IN_ONE",
"operation_status": "DISABLE",
"app_id": "{{app_id}}",
"exclude_age_under_eighteen": true,
"click_attribution_window": "SEVEN_DAYS",
"app_download_url": "{{app_download_url}}",
"campaign_id": "{{campaign_id}}",
"bid_type": "BID_TYPE_CUSTOM",
"video_download_disabled": false,
"view_attribution_window": "ONE_DAY",
"is_advanced_dedicated_campaign": false,
"card_list": null,
"app_promotion_type": null,
"advertiser_id": "{{advertiser_id}}",
"call_to_action_list": []
}
}
(/code)
优化目标设置为价值
出价策略为最高价值且使用非 Spark Ads 认证身份
请求
(code http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/spc/create/' \
--header 'Access-Token: {{Access-Token}}' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"objective_type": "WEB_CONVERSIONS",
"spc_type": "WEB_ALL_IN_ONE",
"campaign_name": "{{campaign_name}}",
"operation_status": "DISABLE",
"promotion_type": "WEBSITE",
"exclude_age_under_eighteen": true,
"placement_type": "PLACEMENT_TYPE_NORMAL",
"placements": ["PLACEMENT_TIKTOK"],
<span style="background-color: green;"> "optimization_goal": "VALUE",
"pixel_id": "{{pixel_id}}",
"optimization_event": "SHOPPING",
"deep_bid_type": "VO_HIGHEST_VALUE",
"bid_type": "BID_TYPE_NO_BID",
"billing_event": "OCPM",</span>
"location_ids": [
"2077456",
"6252001"
],
"budget_mode": "BUDGET_MODE_DAY",
"budget": {{budget}},
"schedule_type": "SCHEDULE_FROM_NOW",
"schedule_start_time": "{{schedule_start_time}}",
<span style="background-color: green;">"identity_id": "{{identity_id}}",
"identity_type": "CUSTOMIZED_USER", </span>
"media_info_list": [
{
"media_info": {
<span style="background-color: green;">"image_info": [
{
"web_uri": "{{web_uri}}"
}
],
"video_info": {
"video_id": "{{video_id}}" </span>
}
}
}
],
"title_list": [
{
"title": "{{title}}"
}
],
"call_to_action_list": [
{
"call_to_action": "ORDER_NOW"
}
],
"landing_page_urls": [
{
"landing_page_url": "{{landing_page_url}}"
}
]
}'
(/code)
返回
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"click_attribution_window": "SEVEN_DAYS",
"title_list": [
{
"title": "{{title}}"
}
],
"app_id": null,
"impression_tracking_url": null,
"campaign_secondary_status": "CAMPAIGN_STATUS_DISABLE",
"campaign_name": "{{campaign_name}}",
"video_download_disabled": false,
"card_list": null,
"promotion_website_type": "UNSET",
"identity_type": "CUSTOMIZED_USER",
"share_disabled": false,
"objective_type": "WEB_CONVERSIONS",
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"campaign_id": "{{campaign_id}}",
"gender": "GENDER_UNLIMITED",
"location_ids": [
"2077456",
"6252001"
],
"app_promotion_type": null,
"languages": [],
"adgroup_secondary_status": "ADGROUP_STATUS_CAMPAIGN_DISABLE",
"conversion_bid_price": null,
"operation_status": "DISABLE",
"schedule_end_time": "{{schedule_end_time}}",
"is_smart_performance_campaign": true,
"bid_type": "BID_TYPE_NO_BID",
"scheduled_budget": 0,
"campaign_type": "REGULAR_CAMPAIGN",
"optimization_goal": "VALUE",
"call_to_action_id": null,
"view_attribution_window": "ONE_DAY",
"excluded_audience_ids": null,
"skip_learning_phase": true,
"budget_mode": "BUDGET_MODE_DAY",
"optimization_event": "SHOPPING",
"blocked_pangle_app_ids": null,
"is_advanced_dedicated_campaign": false,
"placements": [
"PLACEMENT_TIKTOK"
],
"bid_price": null,
"pixel_id": "{{pixel_id}}",
"budget": "{{budget}}",
"modify_time": "{{modify_time}}",
"promotion_type": "WEBSITE",
"deeplink_type": null,
"billing_event": "OCPM",
"deeplink": "",
"special_industries": null,
"comment_disabled": false,
"identity_id": "{{identity_id}}",
"click_tracking_url": null,
"exclude_age_under_eighteen": true,
"spc_type": "WEB_ALL_IN_ONE",
"app_type": null,
"media_info_list": [
{
"media_info": {
"video_info": {
"video_id": "{{video_id}}",
"file_name": ""
},
"aigc_disclosure_type": null,
"identity_type": null,
"tiktok_item_id": null,
"identity_id": null,
"image_info": [
{
"web_uri": "{{web_uri}}"
}
]
}
}
],
"schedule_type": "SCHEDULE_FROM_NOW",
"deep_bid_type": "VO_HIGHEST_VALUE",
"attribution_event_count": "EVERY",
"advertiser_id": "{{advertiser_id}}",
"engaged_view_attribution_window": null,
"create_time": "{{create_time}}",
"campaign_app_profile_page_state": null,
"app_name": null,
"landing_page_urls": [
{
"landing_page_url": "{{landing_page_url}}",
"tiktok_item_id": null,
"video_id": null
}
],
"call_to_action_list": [
{
"call_to_action": "ORDER_NOW"
}
],
"page_list": null,
"app_download_url": null,
"placement_type": "PLACEMENT_TYPE_NORMAL",
"schedule_start_time": "{{schedule_start_time}}"
}
}
(/code)
优化目标设置为点击
出价策略为每次点击的成本上限且使用非 Spark Ads 认证身份
请求
(code http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/spc/create/' \
--header 'Access-Token: {{Access-Token}}' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"objective_type": "WEB_CONVERSIONS",
"spc_type": "WEB_ALL_IN_ONE",
"campaign_name": "{{campaign_name}}",
"operation_status": "DISABLE",
"promotion_type": "WEBSITE",
"exclude_age_under_eighteen": true,
"placement_type": "PLACEMENT_TYPE_NORMAL",
"placements": ["PLACEMENT_TIKTOK"],
<span style="background-color: green;"> "optimization_goal": "CLICK",
"bid_type": "BID_TYPE_CUSTOM",
"bid_price": {{bid_price}},
"billing_event": "CPC",</span>
"location_ids": [
"2077456",
"6252001"
],
"budget_mode": "BUDGET_MODE_DAY",
"budget": {{budget}},
"schedule_type": "SCHEDULE_FROM_NOW",
"schedule_start_time": "{{schedule_start_time}}",
<span style="background-color: green;"> "identity_id": "{{identity_id}}",
"identity_type": "CUSTOMIZED_USER",</span>
"media_info_list": [
{
"media_info": {
<span style="background-color: green;">"image_info": [
{
"web_uri": "{{web_uri}}"
}
],
"video_info": {
"video_id": "{{video_id}}" </span>
}
}
}
],
"title_list": [
{
"title": "{{title}}"
}
],
"call_to_action_list": [
{
"call_to_action": "ORDER_NOW"
}
],
"landing_page_urls": [
{
"landing_page_url": "{{landing_page_url}}"
}
]
}'
(/code)
返回
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"billing_event": "CPC",
"bid_price": {{bid_price}},
"objective_type": "WEB_CONVERSIONS",
"is_smart_performance_campaign": true,
"scheduled_budget": 0,
"budget": {{budget}},
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"deeplink": "",
"pixel_id": null,
"title_list": [
{
"title": "{{title}}"
}
],
"app_name": null,
"schedule_type": "SCHEDULE_FROM_NOW",
"skip_learning_phase": null,
"languages": [],
"excluded_audience_ids": null,
"create_time": "{{create_time}}",
"operation_status": "DISABLE",
"optimization_event": null,
"bid_type": "BID_TYPE_CUSTOM",
"app_id": null,
"app_download_url": null,
"identity_type": "CUSTOMIZED_USER",
"is_advanced_dedicated_campaign": false,
"campaign_name": "{{campaign_name}}",
"placement_type": "PLACEMENT_TYPE_NORMAL",
"campaign_secondary_status": "CAMPAIGN_STATUS_DISABLE",
"advertiser_id": "{{advertiser_id}}",
"special_industries": null,
"click_attribution_window": null,
"landing_page_urls": [
{
"tiktok_item_id": null,
"landing_page_url": "{{landing_page_url}}",
"video_id": null
}
],
"app_type": null,
"attribution_event_count": null,
"spc_type": "WEB_ALL_IN_ONE",
"share_disabled": false,
"impression_tracking_url": null,
"call_to_action_list": [
{
"call_to_action": "ORDER_NOW"
}
],
"exclude_age_under_eighteen": true,
"card_list": null,
"campaign_type": "REGULAR_CAMPAIGN",
"click_tracking_url": null,
"schedule_start_time": "{{schedule_start_time}}",
"promotion_website_type": "UNSET",
"media_info_list": [
{
"media_info": {
"tiktok_item_id": null,
"aigc_disclosure_type": null,
"identity_type": null,
"video_info": {
"video_id": "{{video_id}}",
"file_name": ""
},
"image_info": [
{
"web_uri": "{{web_uri}}"
}
],
"identity_id": null
}
}
],
"video_download_disabled": false,
"page_list": null,
"deeplink_type": null,
"promotion_type": "WEBSITE",
"schedule_end_time": "{{schedule_end_time}}",
"view_attribution_window": null,
"comment_disabled": false,
"engaged_view_attribution_window": null,
"budget_mode": "BUDGET_MODE_DAY",
"campaign_id": "{{campaign_id}}",
"conversion_bid_price": null,
"call_to_action_id": null,
"location_ids": [
"2077456",
"6252001"
],
"app_promotion_type": null,
"gender": "GENDER_UNLIMITED",
"optimization_goal": "CLICK",
"deep_bid_type": null,
"placements": [
"PLACEMENT_TIKTOK"
],
"identity_id": "{{identity_id}}",
"modify_time": "{{modify_time}}",
"adgroup_secondary_status": "ADGROUP_STATUS_CAMPAIGN_DISABLE",
"campaign_app_profile_page_state": null,
"blocked_pangle_app_ids": null
}
}
(/code)
优化目标设置为落地页浏览量
出价策略为目标 CPA 且使用非 Spark Ads 认证身份
请求
(code http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/spc/create/' \
--header 'Access-Token: {{Access-Token}}' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"objective_type": "WEB_CONVERSIONS",
"spc_type": "WEB_ALL_IN_ONE",
"campaign_name": "{{campaign_name}}",
"operation_status": "DISABLE",
"promotion_type": "WEBSITE",
"exclude_age_under_eighteen": true,
"placement_type": "PLACEMENT_TYPE_NORMAL",
"placements": ["PLACEMENT_TIKTOK"],
<span style="background-color: green;">"optimization_goal": "TRAFFIC_LANDING_PAGE_VIEW",
"bid_type": "BID_TYPE_CUSTOM",
"conversion_bid_price": {{conversion_bid_price}},
"billing_event": "OCPM", </span>
"location_ids": [
"2077456",
"6252001"
],
"budget_mode": "BUDGET_MODE_DAY",
"budget": {{budget}},
"schedule_type": "SCHEDULE_FROM_NOW",
"schedule_start_time": "{{schedule_start_time}}",
<span style="background-color: green;">"identity_id": "{{identity_id}}",
"identity_type": "CUSTOMIZED_USER", </span>
"media_info_list": [
{
"media_info": {
<span style="background-color: green;"> "image_info": [
{
"web_uri": "{{web_uri}}"
}
],
"video_info": {
"video_id": "{{video_id}}"</span>
}
}
}
],
"title_list": [
{
"title": "{{title}}"
}
],
"call_to_action_list": [
{
"call_to_action": "ORDER_NOW"
}
],
"landing_page_urls": [
{
"landing_page_url": "{{landing_page_url}}"
}
]
}'
(/code)
返回
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"blocked_pangle_app_ids": null,
"promotion_type": "WEBSITE",
"is_smart_performance_campaign": true,
"identity_type": "CUSTOMIZED_USER",
"advertiser_id": "{{advertiser_id}}",
"scheduled_budget": 0,
"campaign_secondary_status": "CAMPAIGN_STATUS_DISABLE",
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"operation_status": "DISABLE",
"title_list": [
{
"title": "{{title}}"
}
],
"objective_type": "WEB_CONVERSIONS",
"campaign_type": "REGULAR_CAMPAIGN",
"pixel_id": null,
"app_id": null,
"card_list": null,
"location_ids": [
"2077456",
"6252001"
],
"identity_id": "{{identity_id}}",
"budget": {{budget}},
"deeplink": "",
"schedule_start_time": "{{schedule_start_time}}",
"app_name": null,
"billing_event": "OCPM",
"app_promotion_type": null,
"gender": "GENDER_UNLIMITED",
"page_list": null,
"optimization_event": "LANDING_PAGE_VIEW",
"call_to_action_id": null,
"optimization_goal": "TRAFFIC_LANDING_PAGE_VIEW",
"attribution_event_count": "ONCE",
"landing_page_urls": [
{
"video_id": null,
"tiktok_item_id": null,
"landing_page_url": "{{landing_page_url}}"
}
],
"share_disabled": false,
"app_type": null,
"is_advanced_dedicated_campaign": false,
"campaign_app_profile_page_state": null,
"spc_type": "WEB_ALL_IN_ONE",
"excluded_audience_ids": null,
"skip_learning_phase": true,
"placement_type": "PLACEMENT_TYPE_NORMAL",
"deep_bid_type": null,
"click_tracking_url": null,
"schedule_type": "SCHEDULE_FROM_NOW",
"conversion_bid_price": {{conversion_bid_price}},
"bid_price": null,
"campaign_id": "{{campaign_id}}",
"bid_type": "BID_TYPE_CUSTOM",
"promotion_website_type": "UNSET",
"exclude_age_under_eighteen": true,
"schedule_end_time": "{{schedule_end_time}}",
"app_download_url": null,
"view_attribution_window": "ONE_DAY",
"impression_tracking_url": null,
"budget_mode": "BUDGET_MODE_DAY",
"video_download_disabled": false,
"deeplink_type": null,
"special_industries": null,
"languages": [],
"media_info_list": [
{
"media_info": {
"identity_type": null,
"image_info": [
{
"web_uri": "{{web_uri}}"
}
],
"video_info": {
"video_id": "{{video_id}}",
"file_name": ""
},
"aigc_disclosure_type": null,
"identity_id": null,
"tiktok_item_id": null
}
}
],
"comment_disabled": false,
"engaged_view_attribution_window": null,
"modify_time": "{{modify_time}}",
"call_to_action_list": [
{
"call_to_action": "ORDER_NOW"
}
],
"click_attribution_window": "SEVEN_DAYS",
"campaign_name": "{{campaign_name}}",
"placements": [
"PLACEMENT_TIKTOK"
],
"create_time": "{{create_time}}",
"adgroup_secondary_status": "ADGROUP_STATUS_CAMPAIGN_DISABLE"
}
}
(/code)
创建 Smart+ 商品库广告
Smart+ 商品库广告指使用商品库商品投放广告的 Smart+ 网站推广系列。对于此类推广系列,您需将 web_all_in_one_catalog_status 设置为 OPEN。通过创建 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。若返回的warn_affected_products的值非空,则需查看问题详情,并返回步骤 2 重新上传商品。
4. (可选步骤)使用 /catalog/set/create/ 接口创建电商商品系列。
若您想从商品系列中选择商品,需创建商品系列。否则,可跳过此步骤。
5. (可选步骤)使用/bc/member/invite/接口邀请成员加入商务中心,并授予管理员权限。
您可以同时为受邀成员指定advertiser_role。
6. (可选步骤)使用/bc/asset/assign/接口将商品库共享给商务中心成员,并授予商品库管理权限。
请确保将asset_type字段设置为CATALOG,且将catalog_role字段设置为 ADMIN。
若想了解所有商品库接口,请查看这里。
步骤
创建 Smart+ 商品库广告需确保满足以下要求。若想了解完整的参数列表,可查看/campaign/spc/create/接口文档。
注意
Smart+ 商品库广告组不支持用于/split_test/create/创建拆分对比测试。
| 设置 | 要求 | 参数 | 如何设置该参数 |
|---|---|---|---|
| 推广目标 | 网站转化量 | objective_type |
WEB_CONVERSIONS |
| 网站推广系列类型 | Smart+ 网站推广系列 | spc_type |
WEB_ALL_IN_ONE |
| iOS 14 专属推广系列 | 未启用 | campaign_type |
REGULAR_CAMPAIGN 或不传入 |
app_id |
不传入 | ||
campaign_app_profile_page_state |
不传入 | ||
| 特殊广告分类(可选) | 启用或未启用 注意:本设置仅支持注册地为美国或加拿大的广告主使用。 |
special_industries |
传入合法值,或不传入 |
| 推广系列预算优化 | N/A Smart+ 网站推广系列默认均启用推广系列预算优化 |
N/A | N/A 注意:若您使用/campaign/get/检索 Smart+ 网站推广系列,返回的 |
| 优化位置 (推广对象类型) |
网站 | promotion_type |
WEBSITE |
promotion_website_type |
不传入 | ||
| 商品来源详情 · 使用商品库 |
启用,且指定一个至少包含一个过审商品的电商商品库 | web_all_in_one_catalog_status |
OPEN |
product_source |
CATALOG |
||
catalog_idcatalog_authorized_bc_id |
传入合法值。 商品库( catalog_id)需至少包含一个过审商品。您可通过/catalog/overview/返回的 approved 值是否大于等于 1 进行验证。若想了解如何获取商品库 ID,需遵循前提条件中的步骤。 |
||
| 商品 | 选择以下任一选项:
|
product_specific_typeproduct_set_idproduct_ids |
可将product_specific_type设置为 ALL、PRODUCT_SET 或 CUSTOMIZED_PRODUCTS。
注意:若想确认电商商品库商品是否可用于广告中,可使用/catalog/product/get/。若该商品返回的 |
| 优化目标 | 使用以下任一目标:
|
optimization_goal |
使用以下任一值:
|
| Pixel (数据连接) |
|
pixel_id |
|
| 优化事件 |
|
optimization_event |
|
| 出价策略 |
|
bid_typebid_priceconversion_bid_pricedeep_bid_typeroas_bid |
|
| 归因设置 | 在具体场景中选择对应支持的归因设置 |
|
若想了解不同场景下支持的归因设置,请查看 归因窗口期和事件统计方式 - 网站转化量。 |
| 计费事件 (计费点) |
|
billing_event |
|
| 受众定向 · 地域 |
启用 | location_ids |
传入合法值 |
| 受众定向 · 语言 (可选) |
启用或未启用 | languages |
传入合法值,或不传入 |
| 受众定向 · 性别(可选) |
需申请白名单才可启用 注意:Smart+ 推广系列中的年龄定向目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。 |
gender |
传入合法值,或不传入 |
| 受众定向 · 年龄 |
18+ | exclude_age_under_eighteen |
true |
| 受众定向 · 排除受众(可选) |
启用或未启用 | excluded_audience_ids |
传入合法值,或不传入 |
| 版位 (广告位) |
TikTok 版位(包括搜索结果)或自动版位 | placement_type placements |
不传入 注意 :自动选择版位是 Smart+ 商品库广告的一个重点功能。系统将根据您的其他设置自动配置广告投放版位,并从不同的版位中选择高质量流量,来实现更好的广告效果。若传入了
|
| 用户评论(可选) | 启用或未启用 | comment_disabled |
传入合法值,或不传入 |
| 允许下载视频(可选) | 启用或未启用 | share_disabled |
传入合法值,或不传入 |
| 允许共享视频(可选) | 启用或未启用 | video_download_disabled |
传入合法值,或不传入 |
| 预算模式 | 使用以下任一类型:
|
budget_mode |
使用以下任一值:
|
| 排期类型 | 以下任一类型:
|
schedule_typeschedule_start_timeschedule_end_time |
|
| 认证身份 (广告发布身份) |
自定义用户(自定义身份) | identity_type |
CUSTOMIZED_USER注意:需将 |
identity_id |
传入合法值 若想获取广告账号下的认证身份,可使用/identity/get/。 |
||
| 目标页面 | 网站 URL | landing_page_urlspage_list |
|
| 创意素材 · 从商品库自动选择素材 |
选择以下任一选项:
|
catalog_creative_togglevideo_infoimage_infomusic_infotitle_list tiktok_item_id |
|
| 创新互动样式 · 自动选择创新互动样式(可选) |
选择以下任一选项:
|
automatic_add_on_enabledcard_list |
若单视频或商品库视频样式可用,您可选择在生成的广告启用(推荐)或不启用创新互动样式的自动选择。
若想了解商品卡片和商品磁贴素材包的详情,请查看卡片。 |
| 行动引导文案 | 使用以下任一类型:
|
call_to_action_idcall_to_action_list |
|
自定义 Smart+ 商品库广告中的广告样式组合
若您启用商品库素材的自动选择(catalog_creative_toggle 为 true),系统将使用可用的广告样式(商品库视频、商品库轮播和单视频)自动生成广告。
下表中列出了 Smart+ 商品库广告中可能的广告样式组合。
| 商品库轮播样式是否可用? {20%}| 商品库视频样式是否可用? {20%}| 单视频样式是否可用?{20%}| Smart+ 商品库广告中的广告样式组合{40%} |
|---|---|---|---|
| ❌ | ❌ | ✅ | 仅包括单视频 |
| ❌ | ✅ | ❌ | 仅包括商品库视频|
| ❌ | ✅ | ✅ | 包括商品库视频和单视频 |
| ✅ | ❌ | ❌ | 仅包括商品库轮播 |
| ✅ | ❌ | ✅ | 包括商品库轮播和单视频 |
| ✅ | ✅ | ✅ | 包括商品库视频、商品库轮播和单视频 |
为确保广告样式对于 Smart+ 商品库广告可用,请遵循下表所列指引。
| 广告样式 | 广告样式描述 | 如何确保此样式可用 | 如何设置参数 |
|---|---|---|---|
| 商品库轮播 | 创建包含 2–20 件商品的广告,以幻灯片样式展示。 系统会进行安排,每次最多展示 20 件商品。 | 商品库需至少包含两张可用于商品库轮播广告的图片。 | 商品库(catalog_id)需至少包含两个过审商品。您可通过 /catalog/overview/返回的 approved 值是否大于等于 2 进行验证。
|
| 需指定 1 首可用于商品库轮播广告的音乐。 | 通过music_info传入一个商品库轮播广告中支持的音乐 ID。若想获取有效的音乐 ID,您可以使用以下任一方法:
|
||
| 商品库视频 | 基于商品库中的信息生成动态视频。 | 需确保商品库至少绑定了一个视频模版,或每个商品都设置了对应的视频 URL。 系统将自动为每个商品选择一个视频模板,视频模版将用于为每个商品库商品自动生成动态商品库视频或使用视频 URL 中的视频。 |
确保商品库(catalog_id)至少绑定了一个视频模版,或每个商品都设置了对应的视频 URL(video_url)。
|
| 单视频 | 利用指定的视频创意推广您的商品。 | 手动指定视频和封面图片 | 通过 video_info 指定视频,通过 image_info 指定图片 |
示例
商品来源为所有商品且优化目标为点击
请求
(code http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/spc/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"objective_type": "WEB_CONVERSIONS",
"spc_type": "WEB_ALL_IN_ONE",
"campaign_type": "REGULAR_CAMPAIGN",
"campaign_name": "{{campaign_name}}",
"promotion_type": "WEBSITE",
"web_all_in_one_catalog_status": "OPEN",
"product_source": "CATALOG",
"catalog_id": "{{catalog_id}}",
"catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
<span style="background-color: green;">"product_specific_type": "ALL",
"optimization_goal": "CLICK",
"bid_type": "BID_TYPE_NO_BID",
"billing_event": "CPC",</span>
"location_ids": [
"6252001"
],
"exclude_age_under_eighteen":true,
"budget_mode": "BUDGET_MODE_DAY",
"budget": {{budget}},
"identity_type": "CUSTOMIZED_USER",
"identity_id": "{{identity_id}}",
"landing_page_urls": [
{
"landing_page_url": "{{landing_page_url}}"
}
],
"catalog_creative_toggle": true,
"media_info_list": [
{
"media_info": {
"video_info": {
"video_id": "{{video_id}}"
},
"image_info": [
{
"web_uri": "{{web_uri}}"
}
]
}
},
{
"media_info": {
"music_info": {
"music_id": "{{music_id}}"
}
}
}
],
"title_list": [
{
"title": "{{title}}"
}
],
"automatic_add_on_enabled": true,
"schedule_type": "SCHEDULE_START_END",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_end_time": "{{schedule_end_time}}",
"call_to_action_list": [
{
"call_to_action": "LEARN_MORE"
}
]
}'
(/code)
返回
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"card_list": [
{
"card_id": "{{card_id}}"
},
{
"card_id": "{{card_id}}"
}
],
"catalog_id": "{{catalog_id}}",
"promotion_type": "WEBSITE",
"page_list": null,
"bid_price": null,
"web_all_in_one_catalog_status": "OPEN",
"title_list": [
{
"title": "{{title}}"
}
],
"deeplink": "",
"is_smart_performance_campaign": true,
"campaign_secondary_status": "CAMPAIGN_STATUS_ENABLE",
"app_type": null,
"shopping_ads_fallback_type": null,
"exclude_age_under_eighteen": true,
"identity_type": "CUSTOMIZED_USER",
"landing_page_urls": [
{
"landing_page_url": "{{landing_page_url}}",
"video_id": null,
"tiktok_item_id": null
}
],
"pixel_id": null,
"campaign_id": "{{campaign_id}}",
"skip_learning_phase": null,
"automatic_add_on_enabled": true,
"click_tracking_url": null,
"identity_id": "{{identity_id}}",
"placements": [
"PLACEMENT_TIKTOK"
],
"operation_status": "ENABLE",
"objective_type": "WEB_CONVERSIONS",
"spc_type": "WEB_ALL_IN_ONE",
"engaged_view_attribution_window": null,
"product_specific_type": "ALL",
"roas_bid": null,
"blocked_pangle_app_ids": null,
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"conversion_bid_price": null,
"billing_event": "CPC",
"app_name": null,
"share_disabled": false,
"budget": {{budget}},
"promotion_website_type": "UNSET",
"optimization_goal": "CLICK",
"gender": "GENDER_UNLIMITED",
"special_industries": null,
"carousel_image_labels": null,
"bid_type": "BID_TYPE_NO_BID",
"view_attribution_window": null,
"app_promotion_type": null,
"video_download_disabled": false,
"impression_tracking_url": null,
"click_attribution_window": null,
"schedule_start_time": "{{schedule_start_time}}",
"media_info_list": [
{
"media_info": {
"aigc_disclosure_type": null,
"image_info": [
{
"web_uri": "{{web_uri}}"
}
],
"music_info": null,
"tiktok_item_id": null,
"identity_type": null,
"identity_id": null,
"video_info": {
"file_name": "",
"video_id": "{{video_id}}"
}
}
},
{
"media_info": {
"aigc_disclosure_type": null,
"image_info": null,
"music_info": {
"music_id": "{{music_id}}"
},
"tiktok_item_id": null,
"identity_type": null,
"identity_id": null,
"video_info": null
}
}
],
"optimization_event": null,
"adgroup_secondary_status": "ADGROUP_STATUS_AUDIT",
"advertiser_id": "{{advertiser_id}}",
"app_id": null,
"app_download_url": null,
"modify_time": "{{modify_time}}",
"spc_audience_age": "18+",
"campaign_type": "REGULAR_CAMPAIGN",
"catalog_creative_toggle": true,
"carousel_image_index": null,
"catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
"attribution_event_count": null,
"comment_disabled": false,
"call_to_action_list": [
{
"call_to_action": "LEARN_MORE"
}
],
"deep_bid_type": null,
"budget_mode": "BUDGET_MODE_DAY",
"product_ids": null,
"create_time": "{{create_time}}",
"excluded_audience_ids": null,
"schedule_type": "SCHEDULE_START_END",
"location_ids": [
"6252001"
],
"placement_type": "PLACEMENT_TYPE_NORMAL",
"is_advanced_dedicated_campaign": false,
"schedule_end_time": "{{schedule_end_time}}",
"call_to_action_id": null,
"campaign_app_profile_page_state": null,
"campaign_name": "{{campaign_name}}",
"languages": [],
"scheduled_budget": 0,
"product_set_id": null,
"deeplink_type": null,
"product_source": "CATALOG"
}
(/code)
商品来源为商品系列且优化目标为价值
请求
(code http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/spc/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"objective_type": "WEB_CONVERSIONS",
"spc_type": "WEB_ALL_IN_ONE",
"campaign_type": "REGULAR_CAMPAIGN",
"campaign_name": "{{campaign_name}}",
"promotion_type": "WEBSITE",
"web_all_in_one_catalog_status": "OPEN",
"product_source": "CATALOG",
"catalog_id": "{{catalog_id}}",
"catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
<span style="background-color: green;">"product_specific_type": "PRODUCT_SET",
"product_set_id": "{{product_set_id}}",
"optimization_goal": "VALUE",
"pixel_id": "{{pixel_id}}",
"optimization_event": "SHOPPING",
"bid_type": "BID_TYPE_NO_BID",
"deep_bid_type": "VO_HIGHEST_VALUE",
"billing_event": "OCPM",</span>
"location_ids": [
"6252001"
],
"exclude_age_under_eighteen": true,
"budget_mode": "BUDGET_MODE_DAY",
"budget": {{budget}},
"identity_type": "CUSTOMIZED_USER",
"identity_id": "{{identity_id}}",
"landing_page_urls": [
{
"landing_page_url": "{{landing_page_url}}"
}
],
"catalog_creative_toggle": true,
"media_info_list": [
{
"media_info": {
"video_info": {
"video_id": "{{video_id}}"
},
"image_info": [
{
"web_uri": "{{web_uri}}"
}
]
}
},
{
"media_info": {
"music_info": {
"music_id": "{{music_id}}"
}
}
}
],
"title_list": [
{
"title": "{{title}}"
}
],
"automatic_add_on_enabled": true,
"schedule_type": "SCHEDULE_START_END",
"schedule_start_time": "{{start_time}}",
"schedule_end_time": "{{_time}}",
"call_to_action_list": [
{
"call_to_action": "LEARN_MORE"
}
]
}'
(/code)
返回
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"conversion_bid_price": null,
"deep_bid_type": "VO_HIGHEST_VALUE",
"roas_bid": null,
"identity_type": "CUSTOMIZED_USER",
"modify_time": "{{modify_time}}",
"app_name": null,
"location_ids": [
"6252001"
],
"video_download_disabled": false,
"comment_disabled": false,
"card_list": [
{
"card_id": "{{card_id}}"
},
{
"card_id": "{{card_id}}"
}
],
"bid_price": null,
"product_ids": null,
"budget_mode": "BUDGET_MODE_DAY",
"campaign_app_profile_page_state": null,
"blocked_pangle_app_ids": null,
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"app_type": null,
"billing_event": "OCPM",
"product_specific_type": "PRODUCT_SET",
"impression_tracking_url": null,
"schedule_end_time": "{{schedule_end_time}}",
"click_attribution_window": "SEVEN_DAYS",
"languages": [],
"promotion_type": "WEBSITE",
"skip_learning_phase": true,
"catalog_id": "{{catalog_id}}",
"product_source": "CATALOG",
"campaign_secondary_status": "CAMPAIGN_STATUS_ENABLE",
"campaign_name": "{{campaign_name}}",
"call_to_action_id": null,
"carousel_image_index": null,
"bid_type": "BID_TYPE_NO_BID",
"optimization_event": "SHOPPING",
"landing_page_urls": [
{
"video_id": null,
"landing_page_url": "{{landing_page_url}}",
"tiktok_item_id": null
}
],
"special_industries": null,
"placements": [
"PLACEMENT_TIKTOK"
],
"operation_status": "ENABLE",
"call_to_action_list": [
{
"call_to_action": "LEARN_MORE"
}
],
"campaign_type": "REGULAR_CAMPAIGN",
"budget": {{budget}},
"click_tracking_url": null,
"app_id": null,
"gender": "GENDER_UNLIMITED",
"exclude_age_under_eighteen": true,
"adgroup_secondary_status": "ADGROUP_STATUS_AUDIT",
"product_set_id": "{{product_set_id}}",
"excluded_audience_ids": null,
"catalog_creative_toggle": true,
"share_disabled": false,
"is_advanced_dedicated_campaign": false,
"web_all_in_one_catalog_status": "OPEN",
"carousel_image_labels": null,
"identity_id": "{{identity_id}}",
"spc_audience_age": "18+",
"pixel_id": "{{pixel_id}}",
"engaged_view_attribution_window": null,
"title_list": [
{
"title": "{{title}}"
}
],
"promotion_website_type": "UNSET",
"is_smart_performance_campaign": true,
"media_info_list": [
{
"media_info": {
"identity_id": null,
"video_info": {
"video_id": "{{video_id}}",
"file_name": ""
},
"aigc_disclosure_type": null,
"image_info": [
{
"web_uri": "{{web_uri}}"
}
],
"tiktok_item_id": null,
"identity_type": null,
"music_info": null
}
},
{
"media_info": {
"identity_id": null,
"video_info": null,
"aigc_disclosure_type": null,
"image_info": null,
"tiktok_item_id": null,
"identity_type": null,
"music_info": {
"music_id": "{{music_id}}"
}
}
}
],
"optimization_goal": "VALUE",
"spc_type": "WEB_ALL_IN_ONE",
"app_promotion_type": null,
"placement_type": "PLACEMENT_TYPE_NORMAL",
"app_download_url": null,
"deeplink_type": null,
"page_list": null,
"automatic_add_on_enabled": true,
"view_attribution_window": "ONE_DAY",
"attribution_event_count": "EVERY",
"schedule_type": "SCHEDULE_START_END",
"deeplink": "",
"campaign_id": "{{campaign_id}}",
"advertiser_id": "{{advertiser_id}}",
"schedule_start_time": "{{schedule_start_time}}",
"create_time": "{{create_time}}",
"shopping_ads_fallback_type": null,
"catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
"objective_type": "WEB_CONVERSIONS",
"scheduled_budget": 0
}
(/code)
商品来源为特定商品且优化目标为落地页浏览量
请求
(code http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/spc/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"objective_type": "WEB_CONVERSIONS",
"spc_type": "WEB_ALL_IN_ONE",
"campaign_type": "REGULAR_CAMPAIGN",
"campaign_name": "{{campaign_name}}",
"promotion_type": "WEBSITE",
"web_all_in_one_catalog_status": "OPEN",
"product_source": "CATALOG",
"catalog_id": "{{catalog_id}}",
"catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
<span style="background-color: green;">"product_specific_type": "CUSTOMIZED_PRODUCTS",
"product_ids": ["{{product_id1}}","{{product_id2}}","{{product_id3}}","{{product_id4}}","{{product_id5}}"],
"optimization_goal": "TRAFFIC_LANDING_PAGE_VIEW",
"bid_type": "BID_TYPE_NO_BID",
"billing_event": "OCPM",</span>
"location_ids": [
"6252001"
],
"exclude_age_under_eighteen": true,
"budget_mode": "BUDGET_MODE_DAY",
"budget": {{budget}},
"identity_type": "CUSTOMIZED_USER",
"identity_id": "{{identity_id}}",
"landing_page_urls": [
{
"landing_page_url": "{{landing_page_url}}"
}
],
"catalog_creative_toggle": true,
"media_info_list": [
{
"media_info": {
"video_info": {
"video_id": "{{video_id}}"
},
"image_info": [
{
"web_uri": "{{web_uri}}"
}
]
}
},
{
"media_info": {
"music_info": {
"music_id": "{{music_id}}"
}
}
}
],
"title_list": [
{
"title": "{{title}}"
}
],
"automatic_add_on_enabled": true,
"schedule_type": "SCHEDULE_START_END",
"schedule_start_time": "{{start_time}}",
"schedule_end_time": "{{end_time}}",
"call_to_action_list": [
{
"call_to_action": "LEARN_MORE"
}
]
}'
(/code)
返回
(code Success-Response http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"optimization_event": "LANDING_PAGE_VIEW",
"app_promotion_type": null,
"page_list": null,
"campaign_type": "REGULAR_CAMPAIGN",
"bid_price": null,
"landing_page_urls": [
{
"video_id": null,
"tiktok_item_id": null,
"landing_page_url": "{{landing_page_url}}"
}
],
"deeplink_type": null,
"carousel_image_index": null,
"card_list": [
{
"card_id": "{{card_id}}"
},
{
"card_id": "{{card_id}}"
}
],
"advertiser_id": "{{advertiser_id}}",
"share_disabled": false,
"attribution_event_count": "ONCE",
"modify_time": "{{modify_time}}",
"deeplink": "",
"catalog_id": "{{catalog_id}}",
"app_type": null,
"gender": "GENDER_UNLIMITED",
"schedule_end_time": "{{schedule_end_time}}",
"optimization_goal": "TRAFFIC_LANDING_PAGE_VIEW",
"is_advanced_dedicated_campaign": false,
"impression_tracking_url": null,
"click_attribution_window": "SEVEN_DAYS",
"location_ids": [
"6252001"
],
"product_source": "CATALOG",
"app_download_url": null,
"app_id": null,
"adgroup_secondary_status": "ADGROUP_STATUS_AUDIT",
"comment_disabled": false,
"promotion_type": "WEBSITE",
"blocked_pangle_app_ids": null,
"catalog_creative_toggle": true,
"conversion_bid_price": null,
"view_attribution_window": "ONE_DAY",
"languages": [],
"pixel_id": null,
"deep_bid_type": null,
"billing_event": "OCPM",
"scheduled_budget": 0,
"app_name": null,
"product_set_id": null,
"carousel_image_labels": null,
"product_specific_type": "CUSTOMIZED_PRODUCTS",
"budget_mode": "BUDGET_MODE_DAY",
"bid_type": "BID_TYPE_NO_BID",
"video_download_disabled": false,
"promotion_website_type": "UNSET",
"call_to_action_list": [
{
"call_to_action": "LEARN_MORE"
}
],
"roas_bid": null,
"title_list": [
{
"title": "{{title}}"
}
],
"web_all_in_one_catalog_status": "OPEN",
"media_info_list": [
{
"media_info": {
"image_info": [
{
"web_uri": "{{web_uri}}"
}
],
"video_info": {
"video_id": "{{video_id}}",
"file_name": ""
},
"identity_id": null,
"tiktok_item_id": null,
"identity_type": null,
"aigc_disclosure_type": null,
"music_info": null
}
},
{
"media_info": {
"image_info": null,
"video_info": null,
"identity_id": null,
"tiktok_item_id": null,
"identity_type": null,
"aigc_disclosure_type": null,
"music_info": {
"music_id": "{{music_id}}"
}
}
}
],
"schedule_start_time": "{{schedule_start_time}}",
"budget": {{budget}},
"product_ids": [
"{{product_id}}",
"{{product_id}}",
"{{product_id}}",
"{{product_id}}",
"{{product_id}}"
],
"call_to_action_id": null,
"identity_type": "CUSTOMIZED_USER",
"objective_type": "WEB_CONVERSIONS",
"excluded_audience_ids": null,
"campaign_app_profile_page_state": null,
"exclude_age_under_eighteen": true,
"placement_type": "PLACEMENT_TYPE_NORMAL",
"placements": [
"PLACEMENT_TIKTOK"
],
"campaign_name": "{{campaign_name}}",
"operation_status": "ENABLE",
"skip_learning_phase": true,
"special_industries": null,
"campaign_id": "{{campaign_id}}",
"spc_type": "WEB_ALL_IN_ONE",
"is_smart_performance_campaign": true,
"catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
"automatic_add_on_enabled": true,
"click_tracking_url": null,
"schedule_type": "SCHEDULE_START_END",
"create_time": "{{create_time}}",
"shopping_ads_fallback_type": null,
"campaign_secondary_status": "CAMPAIGN_STATUS_ENABLE",
"engaged_view_attribution_window": null,
"identity_id": "{{identity_id}}",
"spc_audience_age": "18+"
}
}
(/code)
(即将废弃)创建一个智能效果网站推广系列
需确保满足以下要求。若想了解完整的参数列表,可查看/campaign/spc/create/ 接口文档。
注意
- 智能效果网站推广系列将在下个 API 版本中废弃。为保证流畅的 API 体验,建议您尽快升级至 Smart+ 网站推广系列。Smart+ 网站推广系列是 AI 驱动的自动化解决方案,利用机器学习模型来促进广告主实现商业目标。
- 智能效果网站广告组不支持用于/split_test/create/创建拆分对比测试。
| 设置 | 要求 | 参数 | 如何设置该参数 |
|---|---|---|---|
| 推广目标 | 网站转化量 | objective_type |
WEB_CONVERSIONS |
| 网站推广系列类型 | 智能效果网站推广系列 | spc_type |
UNSET 或不传入 |
| iOS 14 专属推广系列 | 未启用 | campaign_type |
REGULAR_CAMPAIGN 或不传入 |
app_id |
不传入 | ||
campaign_app_profile_page_state |
不传入 | ||
| 特殊广告分类(可选) | 启用或未启用 注意:本设置仅支持注册地为美国或加拿大的广告主使用。 |
special_industries |
传入合法值,或不传入 |
| 推广系列预算优化 | N/A 智能效果网站推广系列默认均启用推广系列预算优化 |
N/A | N/A 注意:若您使用/campaign/get/检索智能效果网站推广系列,返回的 |
| 优化位置 (推广对象类型) |
使用以下任一类型:
|
promotion_typepromotion_website_type |
|
| 优化目标 |
|
optimization_goal |
|
| Pixel |
|
pixel_id |
|
| 优化事件 | 启用 注意:优化位置为 TikTok 即时体验页面时,优化事件仅支持“点击按钮”。 |
optimization_event |
传入合法值。 若想获取 Pixel 已配置的优化事件,可使用/pixel/list/。 若想了解相关枚举值,可查看转化事件 - Pixel 事件类型 。 注意:若 |
| 出价策略 | 最大投放量 |
|
|
| 归因设置 | 在具体场景中选择对应支持的归因设置 |
|
若想了解不同场景下支持的归因设置,请查看 归因窗口期和事件统计方式 - 网站转化量。 |
| 计费事件 (计费点) |
oCPM | billing_event |
OCPM |
| 受众定向 · 地域 |
启用 | location_ids |
传入合法值 |
| 受众定向 · 语言 (可选) |
启用或未启用 | languages |
传入合法值,或不传入 |
| 受众定向 · 排除受众(可选) |
启用或未启用 | excluded_audience_ids |
传入合法值,或不传入 |
| 受众定向 · 性别(可选) |
需申请白名单才可启用 注意:智能效果网站推广系列中的年龄定向目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。 |
gender |
传入合法值,或不传入 |
| 版位 (广告位) |
使用以下任一类型:
|
placement_typeplacements |
使用以下任一配置:
|
| 用户评论(可选) | 启用或未启用 | comment_disabled |
传入合法值,或不传入 |
| 允许下载视频(可选) | 启用或未启用 | share_disabled |
传入合法值,或不传入 |
| 允许共享视频(可选) | 启用或未启用 | video_download_disabled |
传入合法值,或不传入 |
| 预算模式 | 使用以下任一类型:
|
budget_mode |
使用以下任一值:
|
| 认证身份 (广告发布身份) |
使用以下任一类型:
|
identity_type |
使用以下任一值:
注意:对于用于 Spark Ads 的认证身份,需在 |
identity_id |
传入合法值 若想获取广告账号下的认证身份,可使用/identity/get/。 |
||
| 目标页面 |
|
landing_page_urlspage_list |
注意:多落地页模式目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。 |
| 创意素材 |
|
video_infoimage_infotitle_listtiktok_item_id |
|
| 创新互动样式(可选) | 未启用,或使用以下任一类型:
|
card_list |
不传入或指定以下任一类型的创意素材包的 ID:
若想创建创意素材包,可使用 /creative/portfolio/create/。 |
| 行动引导文案 | 使用以下任一类型:
注意:使用用于 Spark Ads 的认证身份时,仅支持使用动态优选行动引导文案。 |
call_to_action_idcall_to_action_list |
注意:若 |