← 返回目录
📁 Use Cases › Campaign creation › (To be deprecated) Create a Legacy Smart+ Campaign

(即将废弃)创建旧版 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+ 网站推广系列,返回的budget_optimize_on 将为 true。

优化位置
(推广对象类型)
网站 promotion_type WEBSITE
promotion_website_type 不传入
商品来源详情
· 使用商品库
未启用 web_all_in_one_catalog_status UNSET 或不传入
优化目标 使用以下任一目标:
  • 点击
  • 转化
  • 落地页浏览量
  • 价值
optimization_goal 使用以下任一值:
  • CLICK
  • CONVERT
  • TRAFFIC_LANDING_PAGE_VIEW
  • VALUE
Pixel
(数据连接)
  • 优化目标为转化或价值时必须指定 Pixel。
  • 优化目标为点击或落地页浏览量时不支持 Pixel。
pixel_id
  • optimization_goal 设置为 CONVERT 或 VALUE时,本字段必填。
  • optimization_goal设置为 CLICK 或 TRAFFIC_LANDING_PAGE_VIEW时,不支持本字段。
优化事件
  • 优化目标为转化或价值时必须指定优化事件。
    • 优化目标为价值时,优化事件需设置为“支付完成”。
  • 优化目标为点击或落地页浏览量时不支持优化事件。
optimization_event
  • optimization_goal 设置为 CONVERT 或 VALUE时,本字段必填。
  • optimization_goal 设置为 CLICK时 ,不支持本字段。
  • optimization_goal 设置为 TRAFFIC_LANDING_PAGE_VIEW时,可省略本字段。此时optimization_event 将默认为 LANDING_PAGE_VIEW。
出价策略
  • 若优化目标为点击、转化或落地页浏览量,可设置为最大投放量或成本上限(或目标 CPA)。
  • 若优化目标为价值,可设置为最高价值或目标 ROAS。
bid_type
bid_price
conversion_bid_price
deep_bid_type
roas_bid
  • optimization_goal 设置为 CLICK、 CONVERT 或 TRAFFIC_LANDING_PAGE_VIEW时:
    • 可将 bid_type 设置为 BID_TYPE_CUSTOM 或 BID_TYPE_NO_BID。无需传入deep_bid_type。
      • optimization_goal 设置为 CONVERT 或 TRAFFIC_LANDING_PAGE_VIEW ,且 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_HIGHEST_VALUE 或 VO_MIN_ROAS,且将 bid_type 设置为 BID_TYPE_NO_BID。无需传入 conversion_bid_price 和 bid_price。
      • deep_bid_type 设置为 VO_MIN_ROAS时,需同时传入 roas_bid。
归因设置 在具体场景中选择对应支持的归因设置
  • click_attribution_window
  • view_attribution_window
  • attribution_event_count
若想了解不同场景下支持的归因设置,请查看 归因窗口期和事件统计方式 - 网站转化量。
计费事件
(计费点)
  • 若优化目标为点击数,计费事件需为 CPC。
  • 若优化目标为转化、落地页浏览量或价值,计费事件需为 oCPM。
billing_event
  • optimization_goal 设置为 CLICK时,本字段需设置为CPC。
  • optimization_goal 设置为 CONVERT 、TRAFFIC_LANDING_PAGE_VIEW 或 VALUE时,本字段需设置为 OCPM。
受众定向
· 地域
启用 location_ids 传入合法值
受众定向
· 语言 (可选)
启用或未启用 languages 传入合法值,或不传入
受众定向
· 性别(可选)
需申请白名单才可启用

注意:Smart+ 推广系列中的年龄定向目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。

gender 传入合法值,或不传入
受众定向
· 年龄
18+ exclude_age_under_eighteen true
受众定向
· 排除受众(可选)
启用或未启用 excluded_audience_ids 传入合法值,或不传入
版位
(广告位)
TikTok 版位(包括搜索结果)或自动版位 placement_type
placements
不传入

注意 :自动选择版位是 Smart+ 网站推广系列的一个重点功能。系统将根据您的其他设置自动配置广告投放版位,并从不同的版位中选择高质量流量,来实现更好的广告效果。若传入了 placement_type 和 placements,将忽略这两个字段。若想获取 Smart+ 网站推广系列实际选择的版位设置,可使用 /campaign/spc/get/。

  • 若所有的定向地域(location_ids)均不支持 Pangle 版位,则返回的placement_type 将为 PLACEMENT_TYPE_NORMAL, 且 placements 为 ["PLACEMENT_TIKTOK"]。
  • 若一个或多个定向地域(location_ids)不支持 Pangle 版位,则返回的placement_type 将为 PLACEMENT_TYPE_AUTOMATIC 且placements 为 ["PLACEMENT_TIKTOK","PLACEMENT_PANGLE"]。
用户评论(可选) 启用或未启用 comment_disabled 传入合法值,或不传入
允许下载视频(可选) 启用或未启用 share_disabled 传入合法值,或不传入
允许共享视频(可选) 启用或未启用 video_download_disabled 传入合法值,或不传入
预算模式 使用以下任一类型:
  • 日预算
  • 动态日预算
budget_mode 使用以下任一值:
  • BUDGET_MODE_DAY
  • BUDGET_MODE_DYNAMIC_DAILY_BUDGET
排期类型 以下任一类型:
  • 在排定的开始时间之后持续投放推广系列
  • 在排定的开始时间和结束时间之间投放推广系列
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。
认证身份
(广告发布身份)
使用以下任一类型:
  • 自定义用户(自定义身份)
  • 授权用户
  • TikTok 用户
  • 添加到商务中心的 TikTok 用户
identity_type 使用以下任一值:
  • CUSTOMIZED_USER
  • AUTH_CODE
  • TT_USER
  • BC_AUTH_TT

注意:对于用于 Spark Ads 的认证身份,需在media_info 对象中的 identity_type 和 identity_id传入合法值。

identity_id 传入合法值
若想获取广告账号下的认证身份,可使用/identity/get/。
identity_authorized_bc_id identity_type 为 BC_AUTH_TT时传入合法值
目标页面 网站 URL landing_page_urls
page_list
  • 通过 landing_page_urls 指定一个网站 URL。
  • 无需传入 page_list。
创意素材
  • 若使用自定义用户,需指定 1-30 个带视频封面的视频和 1-5 个广告文案。
  • 若使用 TikTok 用户身份或添加到商务中心的 TikTok 用户身份提取帖子创建 Spark Ads 或使用授权用户,需指定 1-30 个 TikTok 帖子。
video_info
image_info
title_list
tiktok_item_id
  • 若 media_info 对象外的 identity_type 设置为 CUSTOMIZED_USER,需指定 1-30 个带视频封面(image_info)的视频(video_info)和 1-5 个广告文案(title_list)。无需传入tiktok_item_id。
  • 若 media_info 对象内的 identity_type 设置为 TT_USER 或 BC_AUTH_TT,您可通过提取帖子创建 Spark Ads :
    • 提取帖子创建 Spark Ads:需通过tiktok_item_id指定 1-30 个 TikTok 帖子。 无需传入 video_info,image_info和title_list。
    若想了解 Spark Ads 详情,请查看创建 Spark Ads。
  • 若 media_info 对象内的 identity_type 设置为 AUTH_CODE,需通过 tiktok_item_id 指定 1-30 个 TikTok 帖子。无需传入 video_info,image_info和title_list。
添加商品信息
· 添加促销码或优惠
(可选)
不启用,或启用最多 10 个促销码或优惠 promo_info_list 不传入,或传入合法值
创新互动样式(可选) 未启用,或使用以下任一类型:
  • 倒计时贴纸
  • 礼品码贴纸
  • 展示卡片(又称图片卡片)
card_list 不传入或指定以下任一类型的创意素材包的 ID:
  • 倒计时贴纸
  • 礼品码贴纸
  • 展示卡片(又称图片卡片)

若想创建创意素材包,可使用 /creative/portfolio/create/。
  • 若想了解如何获取展示卡片素材包的 ID,请参考卡片。
  • 若想了解如何获取倒计时贴纸或礼品码贴纸素材包的 ID,请参考贴纸。
行动引导文案 使用以下任一类型:
  • 动态优选
  • 标准

注意:使用用于 Spark Ads 的认证身份时,仅支持使用动态优选行动引导文案。

call_to_action_id
call_to_action_list
  • 若要使用动态优选行动引导文案,需传入call_to_action_id。
  • 若要使用标准行动引导文案,需传入call_to_action_list。

注意:若media_info对象中的identity_type 设置为 TT_USER或 AUTH_CODE,必须传入call_to_action_id。

示例

优化目标设置为转化

出价策略为目标 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+ 网站推广系列,返回的budget_optimize_on 将为 true。

优化位置
(推广对象类型)
网站 promotion_type WEBSITE
promotion_website_type 不传入
商品来源详情
· 使用商品库
启用,且指定一个至少包含一个过审商品的电商商品库 web_all_in_one_catalog_status OPEN
product_source CATALOG
catalog_id
catalog_authorized_bc_id
传入合法值。
商品库(catalog_id)需至少包含一个过审商品。您可通过/catalog/overview/返回的 approved 值是否大于等于 1 进行验证。

若想了解如何获取商品库 ID,需遵循前提条件中的步骤。
商品 选择以下任一选项:
  • 所有商品
  • 商品系列
  • 特定商品,最多选择 20 个商品
product_specific_type
product_set_id
product_ids
可将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 个可用的电商商品库商品的商品 ID。无需传入product_set_id。

注意:若想确认电商商品库商品是否可用于广告中,可使用/catalog/product/get/。若该商品返回的 ad_creation_eligible 为 AVAILABLE,则该商品可用于广告中。

优化目标 使用以下任一目标:
  • 点击
  • 转化
  • 落地页浏览量
  • 价值
optimization_goal 使用以下任一值:
  • CLICK
  • CONVERT
  • TRAFFIC_LANDING_PAGE_VIEW
  • VALUE
Pixel
(数据连接)
  • 优化目标为转化或价值时必须指定 Pixel。
  • 优化目标为点击或落地页浏览量时不支持 Pixel。
pixel_id
  • optimization_goal 设置为 CONVERT 或 VALUE时,本字段必填。
  • optimization_goal设置为 CLICK 或 TRAFFIC_LANDING_PAGE_VIEW时,不支持本字段。
优化事件
  • 优化目标为转化或价值时必须指定优化事件。
    • 优化目标为价值时,优化事件需设置为“支付完成”。
  • 优化目标为点击或落地页浏览量时不支持优化事件。
optimization_event
  • optimization_goal 设置为 CONVERT 或 VALUE时,本字段必填。
  • optimization_goal 设置为 CLICK时 ,不支持本字段。
  • optimization_goal 设置为 TRAFFIC_LANDING_PAGE_VIEW时,可省略本字段。此时optimization_event 将默认为 LANDING_PAGE_VIEW。
出价策略
  • 若优化目标为点击或转化,可设置为最大投放量或成本上限(或目标 CPA)。
  • 若优化目标为落地页浏览量,仅可设置为最大投放量。
  • 若优化目标为价值,可设置为最高价值或目标 ROAS。
bid_type
bid_price
conversion_bid_price
deep_bid_type
roas_bid
  • optimization_goal 设置为 CLICK或CONVERT时,可将 bid_type 设置为 BID_TYPE_CUSTOM 或 BID_TYPE_NO_BID。无需传入deep_bid_type。
    • optimization_goal 设置为 CONVERT,且 bid_type 设置为 BID_TYPE_CUSTOM时,需同时传入 conversion_bid_price。
    • optimization_goal 设置为 CLICK 且 bid_type 设置为 BID_TYPE_CUSTOM时,需同时传入bid_price。
  • optimization_goal 设置为 TRAFFIC_LANDING_PAGE_VIEW 时,将 bid_type 设置为 BID_TYPE_NO_BID。无需传入 deep_bid_type。
  • optimization_goal 设置为 VALUE时,可将 deep_bid_type 设置为 VO_HIGHEST_VALUE 或 VO_MIN_ROAS,且将 bid_type 设置为 BID_TYPE_NO_BID。无需传入 conversion_bid_price 和 bid_price。
    • deep_bid_type 设置为 VO_MIN_ROAS时,需同时传入 roas_bid。
归因设置 在具体场景中选择对应支持的归因设置
  • click_attribution_window
  • view_attribution_window
  • attribution_event_count
若想了解不同场景下支持的归因设置,请查看 归因窗口期和事件统计方式 - 网站转化量。
计费事件
(计费点)
  • 若优化目标为点击数,计费事件需为 CPC。
  • 若优化目标为转化、落地页浏览量或价值,计费事件需为 oCPM。
billing_event
  • optimization_goal 设置为 CLICK时,本字段需设置为CPC。
  • optimization_goal 设置为 CONVERT 、TRAFFIC_LANDING_PAGE_VIEW 或 VALUE时,本字段需设置为 OCPM。
受众定向
· 地域
启用 location_ids 传入合法值
受众定向
· 语言 (可选)
启用或未启用 languages 传入合法值,或不传入
受众定向
· 性别(可选)
需申请白名单才可启用

注意:Smart+ 推广系列中的年龄定向目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。

gender 传入合法值,或不传入
受众定向
· 年龄
18+ exclude_age_under_eighteen true
受众定向
· 排除受众(可选)
启用或未启用 excluded_audience_ids 传入合法值,或不传入
版位
(广告位)
TikTok 版位(包括搜索结果)或自动版位 placement_type
placements
不传入

注意 :自动选择版位是 Smart+ 商品库广告的一个重点功能。系统将根据您的其他设置自动配置广告投放版位,并从不同的版位中选择高质量流量,来实现更好的广告效果。若传入了 placement_type 和 placements,将忽略这两个字段。若想获取 Smart+ 商品库广告实际选择的版位设置,可使用 /campaign/spc/get/。

  • 若所有的定向地域(location_ids)均不支持 Pangle 版位,则返回的placement_type 将为 PLACEMENT_TYPE_NORMAL, 且 placements 为 ["PLACEMENT_TIKTOK"]。
  • 若一个或多个定向地域(location_ids)不支持 Pangle 版位,则返回的placement_type 将为 PLACEMENT_TYPE_AUTOMATIC 且placements 为 ["PLACEMENT_TIKTOK","PLACEMENT_PANGLE"]。
用户评论(可选) 启用或未启用 comment_disabled 传入合法值,或不传入
允许下载视频(可选) 启用或未启用 share_disabled 传入合法值,或不传入
允许共享视频(可选) 启用或未启用 video_download_disabled 传入合法值,或不传入
预算模式 使用以下任一类型:
  • 日预算
  • 动态日预算
budget_mode 使用以下任一值:
  • BUDGET_MODE_DAY
  • BUDGET_MODE_DYNAMIC_DAILY_BUDGET
排期类型 以下任一类型:
  • 在排定的开始时间之后持续投放推广系列
  • 在排定的开始时间和结束时间之间投放推广系列
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。
认证身份
(广告发布身份)
自定义用户(自定义身份) identity_type CUSTOMIZED_USER

注意:需将 media_info 对象之外的 identity_type 字段设置为 CUSTOMIZED_USER。

identity_id 传入合法值
若想获取广告账号下的认证身份,可使用/identity/get/。
目标页面 网站 URL landing_page_urls
page_list
  • 通过 landing_page_urls 指定一个网站 URL。
  • 无需传入 page_list。
创意素材
· 从商品库自动选择素材
选择以下任一选项:
  • 启用(推荐)
  • 未启用
    • 要求:
      • 指定 1-30 个带封面的视频
      • 指定 1-5 个广告文案

      注意:若不使用商品库的素材,您的广告表现潜力可能受限。

catalog_creative_toggle
video_info
image_info
music_info
title_list
tiktok_item_id
  • 不传入 tiktok_item_id。
  • 若想启用商品库素材的自动选择,需将 catalog_creative_toggle 设置为 true 且通过music_info指定一首音乐。若想了解具体的设置和要求,可查看 自定义 Smart+ 商品库广告中的广告样式组合 。

    注意:catalog_creative_toggle 为 true 时,music_info必填。

  • 若不想启用商品库素材的自动选择,需将 catalog_creative_toggle 设置为 false,且指定 1-30 个带封面(image_info)的视频(video_info)和 1-5 个广告文案(title_list)。
创新互动样式
· 自动选择创新互动样式(可选)
选择以下任一选项:
  • 启用(推荐)
    • 系统将在广告中自动应用最合适的创新互动样式。
  • 未启用
automatic_add_on_enabled
card_list
若单视频或商品库视频样式可用,您可选择在生成的广告启用(推荐)或不启用创新互动样式的自动选择。

  • 若想启用创新互动样式的自动选择,需将automatic_add_on_enabled 设置为 true,且不传入card_list。系统将自动生成商品卡片和商品磁贴素材包,并通过 card_list字段返回。
  • 若不想启用创新互动样式的自动选择,需将 automatic_add_on_enabled 设置为false,且不传入card_list。返回的card_list字段将为 null。

若想了解商品卡片和商品磁贴素材包的详情,请查看卡片。
行动引导文案 使用以下任一类型:
  • 动态优选
  • 标准
call_to_action_id
call_to_action_list
  • 若要使用动态优选行动引导文案,需传入call_to_action_id。
  • 若要使用标准行动引导文案,需传入call_to_action_list。

自定义 Smart+ 商品库广告中的广告样式组合

若您启用商品库素材的自动选择(catalog_creative_toggle 为 true),系统将使用可用的广告样式(商品库视频、商品库轮播和单视频)自动生成广告。

下表中列出了 Smart+ 商品库广告中可能的广告样式组合。

| 商品库轮播样式是否可用? {20%}| 商品库视频样式是否可用? {20%}| 单视频样式是否可用?{20%}| Smart+ 商品库广告中的广告样式组合{40%} |
|---|---|---|---|
| ❌ | ❌ | ✅ | 仅包括单视频 |
| ❌ | ✅ | ❌ | 仅包括商品库视频|
| ❌ | ✅ | ✅ | 包括商品库视频和单视频 |
| ✅ | ❌ | ❌ | 仅包括商品库轮播 |
| ✅ | ❌ | ✅ | 包括商品库轮播和单视频 |
| ✅ | ✅ | ✅ | 包括商品库视频、商品库轮播和单视频 |

为确保广告样式对于 Smart+ 商品库广告可用,请遵循下表所列指引。

广告样式 广告样式描述 如何确保此样式可用 如何设置参数
商品库轮播 创建包含 2–20 件商品的广告,以幻灯片样式展示。 系统会进行安排,每次最多展示 20 件商品。 商品库需至少包含两张可用于商品库轮播广告的图片。 商品库(catalog_id)需至少包含两个过审商品。您可通过 /catalog/overview/返回的 approved 值是否大于等于 2 进行验证。
  • 轮播图片选择范围:投放中的轮播广告将从商品库(catalog_id)中商品的对应图片中动态选取轮播图片。您可以通过product_specific_type参数指定商品图片的选取范围:
    • 若想设置从商品库的所有商品中动态选取轮播图片,可将product_specific_type设置为ALL。
    • 若想设置从商品系列(product_set_id)的商品中动态选取轮播图片,可将product_specific_type设置为PRODUCT_SET。
    • 若想设置从自定义的商品范围(最多 20 个商品(product_ids))中动态选取轮播图片,可将product_specific_type设置为CUSTOMIZED_PRODUCTS。
  • 轮播图片类型:
    • 使用商品主图:轮播图片默认使用动态选取的商品库商品的主图 URL。
需指定 1 首可用于商品库轮播广告的音乐。 通过music_info传入一个商品库轮播广告中支持的音乐 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。
商品库视频 基于商品库中的信息生成动态视频。 需确保商品库至少绑定了一个视频模版,或每个商品都设置了对应的视频 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/检索智能效果网站推广系列,返回的budget_optimize_on 将为 true。

优化位置
(推广对象类型)
使用以下任一类型:
  • 网站
  • TikTok 即时体验页面
promotion_type
promotion_website_type
  • 若要将优化位置设置为网站,需:
    • 将 promotion_type 设置为 WEBSITE。
    • 将 promotion_website_type设置为 UNSET 或不传入 promotion_website_type。
  • 若要将优化位置设置为 TikTok 即时体验页面,需:
    • 将 promotion_type 设置为 WEBSITE。
    • 将 promotion_website_type 设置为 TIKTOK_NATIVE_PAGE。
优化目标
  • 优化位置为网站时,支持的优化目标为点击、转化和价值。
  • 优化位置为 TikTok 即时体验页面时,支持的优化目标仅为转化。
optimization_goal
  • 若 promotion_website_type设置为 UNSET 或不传入 promotion_website_type,可将 optimization_goal 设置为 CLICK、CONVERT 或 VALUE。
  • 若 promotion_website_type 设置为 TIKTOK_NATIVE_PAGE,需将optimization_goal 设置为 CONVERT。
Pixel
  • 优化位置为网站时,必须指定 Pixel。
  • 优化位置为 TikTok 即时体验页面时,不支持 Pixel。
pixel_id
  • 若 promotion_website_type 设置为 UNSET 或未传入promotion_website_type,本字段必填。
  • 若 promotion_website_type 设置为 TIKTOK_NATIVE_PAGE,不支持本字段。
优化事件 启用

注意:优化位置为 TikTok 即时体验页面时,优化事件仅支持“点击按钮”。

optimization_event 传入合法值。
若想获取 Pixel 已配置的优化事件,可使用/pixel/list/。
若想了解相关枚举值,可查看转化事件 - Pixel 事件类型 。

注意:若 promotion_website_type 设置为 TIKTOK_NATIVE_PAGE ,本字段仅可设置为BUTTON。

出价策略 最大投放量
  • bid_type
  • deep_bid_type
  • 若 optimization_goal 设置为 CLICK 或 CONVERT:
    • 将 bid_type 设置为 BID_TYPE_NO_BID。无需传入deep_bid_type。
  • 若 optimization_goal 设置为 VALUE:
    • 将 deep_bid_type 设置为 VO_MIN_ROAS,且将bid_type设置为BID_TYPE_NO_BID。
归因设置 在具体场景中选择对应支持的归因设置
  • click_attribution_window
  • view_attribution_window
  • attribution_event_count
若想了解不同场景下支持的归因设置,请查看 归因窗口期和事件统计方式 - 网站转化量。
计费事件
(计费点)
oCPM billing_event OCPM
受众定向
· 地域
启用 location_ids 传入合法值
受众定向
· 语言 (可选)
启用或未启用 languages 传入合法值,或不传入
受众定向
· 排除受众(可选)
启用或未启用 excluded_audience_ids 传入合法值,或不传入
受众定向
· 性别(可选)
需申请白名单才可启用

注意:智能效果网站推广系列中的年龄定向目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。

gender 传入合法值,或不传入
版位
(广告位)
使用以下任一类型:
  • 自动版位
  • 编辑版位 且仅包括 TikTok、仅包括 Pangle 或仅包括 TikTok 和 Pangle
placement_type
placements
使用以下任一配置:
  • 将 placement_type 设置为 PLACEMENT_TYPE_AUTOMATIC。
  • 将 placement_type 设置为 PLACEMENT_TYPE_NORMAL且在placements的值中包含PLACEMENT_TIKTOK 或 PLACEMENT_PANGLE或 PLACEMENT_TIKTOK 和 PLACEMENT_PANGLE。
用户评论(可选) 启用或未启用 comment_disabled 传入合法值,或不传入
允许下载视频(可选) 启用或未启用 share_disabled 传入合法值,或不传入
允许共享视频(可选) 启用或未启用 video_download_disabled 传入合法值,或不传入
预算模式 使用以下任一类型:
  • 日预算
  • 动态日预算
budget_mode 使用以下任一值:
  • BUDGET_MODE_DAY
  • BUDGET_MODE_DYNAMIC_DAILY_BUDGET
认证身份
(广告发布身份)
使用以下任一类型:
  • 自定义用户(自定义身份)
  • 授权用户
  • TikTok 用户
identity_type 使用以下任一值:
  • CUSTOMIZED_USER
  • AUTH_CODE
  • TT_USER

注意:对于用于 Spark Ads 的认证身份,需在media_info 对象中的 identity_type 和 identity_id传入合法值。

identity_id 传入合法值
若想获取广告账号下的认证身份,可使用/identity/get/。
目标页面
  • 若优化位置为网站,目标页面可设置为网站 URL 或 TikTok 即时体验页面。
  • 若优化位置为TikTok 即时体验页面,目标页面仅可设置为 TikTok 即时体验页面。
landing_page_urls
page_list
  • 若promotion_website_type设置为 UNSET或未传入promotion_website_type,您需要通过 landing_page_urls 指定一个或多个网站 URL 或通过 page_list 指定一个 TikTok 即时体验页面。
    • 若想筛选您的广告账户下的 TikTok 即时体验页面,可使用/page/get/。传入 advertiser_id 并将 business_type 设置为 TIKTOK_INSTANT_PAGE。
  • 若promotion_website_type 设置为 TIKTOK_NATIVE_PAGE,您需要通过 page_list 指定一个 TikTok 即时体验页面。

注意:多落地页模式目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。

创意素材
  • 若使用 TikTok 用户身份推送帖子创建 Spark Ads 或使用自定义用户身份,需指定 1-30 个带视频封面的视频和 1-5 个广告文案。
  • 若使用 TikTok 用户身份提取帖子创建 Spark Ads 或使用授权用户身份,需指定 1-30 个 TikTok 帖子。
video_info
image_info
title_list
tiktok_item_id
  • 若 media_info 对象外的 identity_type 设置为 CUSTOMIZED_USER,需指定 1-30 个带视频封面(image_info)的视频(video_info)和 1-5 个广告文案(title_list)。无需传入tiktok_item_id。
  • 若 media_info 对象内的 identity_type 设置为 TT_USER,您可通过推送帖子或提取帖子创建 Spark Ads :
    • 推送帖子创建 Spark Ads :需指定 1-30 个带视频封面(image_info)的视频(video_info)和 1-5 个广告文案(title_list)。无需传入tiktok_item_id。
    • 提取帖子创建 Spark Ads:需通过tiktok_item_id指定 1-30 个 TikTok 帖子。 无需传入 video_info,image_info和title_list。
    若想了解 Spark Ads 详情,请查看创建 Spark Ads。
  • 若 media_info 对象内的 identity_type 设置为 AUTH_CODE,需通过 tiktok_item_id 指定 1-30 个 TikTok 帖子。无需传入 video_info,image_info和title_list。
创新互动样式(可选) 未启用,或使用以下任一类型:
  • 倒计时贴纸
  • 礼品码贴纸
  • 展示卡片(又称图片卡片)
card_list 不传入或指定以下任一类型的创意素材包的 ID:
  • 倒计时贴纸
  • 礼品码贴纸
  • 展示卡片(又称图片卡片)

若想创建创意素材包,可使用 /creative/portfolio/create/。
  • 若想了解如何获取展示卡片素材包的 ID,请参考卡片。
  • 若想了解如何获取倒计时贴纸或礼品码贴纸素材包的 ID,请参考贴纸。
行动引导文案 使用以下任一类型:
  • 动态优选
  • 标准

注意:使用用于 Spark Ads 的认证身份时,仅支持使用动态优选行动引导文案。

call_to_action_id
call_to_action_list
  • 若要使用动态优选行动引导文案,需传入call_to_action_id。
  • 若要使用标准行动引导文案,需传入call_to_action_list。

注意:若media_info对象中的identity_type 设置为 TT_USER或 AUTH_CODE,必须传入call_to_action_id。

内容来源: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 每日平台更新简报 →