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

(即将废弃)创建旧版 Smart+ 线索收集推广系列

本文介绍了创建 Smart+ 线索收集推广系列的具体步骤。

基于您的优化位置偏好,您可以创建优化位置为即时表单或网站的 Smart+ 线索收集推广系列。若想了解相关创建步骤,请查看对应小节:“创建优化位置为即时表单的 Smart+ 线索收集推广系列”和“创建优化位置为落地页的 Smart+ 线索收集推广系列”。

创建优化位置为即时表单的 Smart+ 线索收集推广系列

前提条件

确保您的广告账户中已有即时表单(线索表单)。 - 若想创建即时表单,请使用即时页面编辑器 SDK 并将 businessType 设置为 1。随后调用 /page/get/ ,通过 page_id 获取即时表单的页面 ID。

步骤

创建此类 Smart+ 推广系列需确保满足以下要求。若想了解完整的参数列表,可查看/campaign/spc/create/接口文档。

注意
Smart+ 线索收集广告组不支持用于/split_test/create/ 创建拆分对比测试。

设置 要求 参数 如何配置参数
推广目标 线索收集 objective_type LEAD_GENERATION
推广系列设置 Smart+ 推广系列 N/A N/A
通过 /campaign/spc/create/ 创建的推广系列均为 Smart+ 推广系列。
推广系列名称 指定一个合法名称 campaign_name 传入合法值
特殊广告分类
(可选)
启用或未启用

注意: 本设置仅支持注册地为美国或加拿大的广告主使用。

special_industries 传入合法值或不传入
推广系列预算优化 (CBO) N/A

注意: Smart+ 推广系列默认均启用推广系列预算优化。

N/A N/A

注意: 若您使用 /campaign/get/ 检索 Smart+ 推广系列,返回的 budget_optimize_on 将为 true。

优化位置
(推广对象类型)
即时表单 promotion_type LEAD_GENERATION
promotion_target_type INSTANT_PAGE
深层漏斗优化
(可选)
启用或不启用

通过深层漏斗优化,您可以在主要优化事件之外再选择一个次要事件,这有助于提升推广系列的效果。
deep_funnel_optimization_status
deep_funnel_event_source
deep_funnel_event_source_id
deep_funnel_optimization_event
  • 若想启用深层漏斗优化,需将 deep_funnel_optimization_status 设置为 ON 且传入deep_funnel_event_source、deep_funnel_event_source_id 和 deep_funnel_optimization_event。
  • 若不想启用深层漏斗优化,需将 deep_funnel_optimization_status设置为 OFF 或不传入deep_funnel_optimization_status。无需传入deep_funnel_event_source、deep_funnel_event_source_id 和deep_funnel_optimization_event。

注意:

  • 使用 CRM 事件组的深层漏斗优化目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。
  • 使用 Pixel 或线下事件组的深层漏斗优化已全量发布。
优化目标 提交表单 optimization_goal LEAD_GENERATION
版位 TikTok 版位(包括搜索结果) placement_type PLACEMENT_TYPE_NORMAL
placements ["PLACEMENT_TIKTOK"]

注意: 默认打开自动搜索广告位。

用户评论
(可选)
启用或未启用 comment_disabled 传入合法值或不传入
允许下载视频
(可选)
启用或未启用 share_disabled 传入合法值或不传入
允许共享视频
(可选)
启用或未启用 video_download_disabled 传入合法值或不传入
受众定向
· 地域
启用 location_ids 传入合法值
受众定向
· 语言
(可选)
启用或未启用 languages 传入合法值或不传入
受众定向
· 性别
(可选)
需申请白名单才可启用

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

gender 传入合法值或不传入
受众定向
· 年龄
以下任一选项:
  • 18+
  • 25+
spc_audience_age 以下任一值:
  • 18+
  • 25+
受众定向
· 排除受众
(可选)
启用或未启用 excluded_audience_ids 传入合法值或不传入
预算模式 动态日预算 budget_mode 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。
出价策略 以下任一类型:
  • 最大投放量
  • 成本上限(或目标 CPA)
bid_type
conversion_bid_price
可将 bid_type 设置为 BID_TYPE_CUSTOM 或 BID_TYPE_NO_BID。
  • 若 bid_type 设置为 BID_TYPE_CUSTOM 时,需同时传入 conversion_bid_price。
bid_price
deep_bid_type
roas_bid
不传入
计费事件
(计费点)
oCPM billing_event OCPM
认证身份
(广告发布身份)
使用以下任一类型:
  • 授权用户
  • TikTok 用户
  • 添加到商务中心的 TikTok 用户
identity_type 使用以下任一值:
  • AUTH_CODE
  • TT_USER
  • BC_AUTH_TT

注意: 需在 media_info 对象中的 identity_type 和 identity_id 传入合法值。

identity_id 传入合法值。
若想获取广告账号下的认证身份,可使用 /identity/get/。
identity_authorized_bc_id 若 identity_type 为 BC_AUTH_TT 时传入合法值
目标页面 即时表单 page_list 指定即时表单的页面 ID。
  • 若想获取即时表单的页面 ID,可调用 /page/get/ 并将 business_type 设置为 LEAD_GEN。
  • 若想创建即时表单,可使用即时页面编辑器 SDK 并将 businessType 设置为 1。
landing_page_urls 不传入
创意素材
  • 若使用 TikTok 用户或添加到商务中心的 TikTok 用户身份提取帖子创建 Spark Ads 或使用授权用户身份,需指定 1-30 个 TikTok 帖子。
video_info
image_info
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。
创新互动样式(可选) 未启用,或使用以下任一类型:
  • 展示卡片(又称图片卡片)
card_list 不传入或指定以下任一类型的创意素材包的 ID:
  • 展示卡片(又称图片卡片)

若想创建创意素材包,可使用 /creative/portfolio/create/。
  • 若想了解如何获取展示卡片素材包的 ID,请参考卡片。
行动引导文案 动态优选 call_to_action_id 传入合法值。

若想了解如何创建动态优选行动引导文案,请查看动态优选行动引导文案。
call_to_action_list 不传入

示例

请求

(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": "LEAD_GENERATION",
    "campaign_name": "{{campaign_name}}",
    "promotion_type": "LEAD_GENERATION",
    "promotion_target_type": "INSTANT_PAGE",
    "optimization_goal": "LEAD_GENERATION",
    "spc_audience_age": "25+",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": [
        "PLACEMENT_TIKTOK"
    ],
    "location_ids": [
        "6252001"
    ],
    "budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "bid_type": "BID_TYPE_CUSTOM",
    "conversion_bid_price": {{conversion_bid_price}},
    "billing_event": "OCPM",
    "page_list": [
        {
            "page_id": "{{page_id}}"
        }
    ],
    "media_info_list": [
        {
            "media_info": {
                "identity_type": "AUTH_CODE",
                "identity_id": "{{identity_id}}",
                "tiktok_item_id": "{{tiktok_item_id}}"
            }
        }
    ],
    "call_to_action_id": "{{call_to_action_id}}"
}'
(/code)

返回

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "click_tracking_url": null,
        "carousel_image_index": null,
        "optimization_event": "FORM",
        "catalog_id": null,
        "bid_type": "BID_TYPE_CUSTOM",
        "comment_disabled": false,
        "app_id": null,
        "optimization_goal": "LEAD_GENERATION",
        "bid_price": null,
        "is_advanced_dedicated_campaign": false,
        "create_time": "{{create_time}}",
        "exclude_age_under_eighteen": true,
        "engaged_view_attribution_window": null,
        "blocked_pangle_app_ids": null,
        "deeplink_type": null,
        "scheduled_budget": 0,
        "conversion_bid_price": {{conversion_bid_price}},
        "advertiser_id": "{{advertiser_id}}",
        "impression_tracking_url": null,
        "deep_bid_type": null,
        "video_download_disabled": false,
        "catalog_creative_toggle": null,
        "promotion_type": "LEAD_GENERATION",
        "schedule_type": "SCHEDULE_START_END",
        "share_disabled": false,
        "schedule_start_time": "{{schedule_start_time}}",
        "campaign_app_profile_page_state": null,
        "promotion_target_type": "INSTANT_PAGE",
        "gender": "GENDER_UNLIMITED",
        "app_download_url": null,
        "schedule_end_time": "{{schedule_end_time}}",
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "special_industries": null,
        "web_all_in_one_catalog_status": null,
        "billing_event": "OCPM",
        "call_to_action_list": [],
        "click_attribution_window": "SEVEN_DAYS",
        "product_source": null,
        "spc_audience_age": "25+",
        "identity_type": null,
        "location_ids": [
            "6252001"
        ],
        "campaign_secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "is_smart_performance_campaign": true,
        "campaign_type": null,
        "roas_bid": null,
        "operation_status": "ENABLE",
        "app_promotion_type": null,
        "bid_align_type": null,
        "campaign_name": "{{campaign_name}}",
        "attribution_event_count": "ONCE",
        "skip_learning_phase": true,
        "campaign_id": "{{campaign_id}}",
        "identity_id": null,
        "catalog_authorized_bc_id": null,
        "media_info_list": [
            {
                "media_info": {
                    "aigc_disclosure_type": null,
                    "identity_type": "AUTH_CODE",
                    "tiktok_item_id": "{{tiktok_item_id}}",
                    "image_info": null,
                    "identity_id": "{{identity_id}}",
                    "music_info": null,
                    "identity_authorized_bc_id": "0",
                    "video_info": null
                }
            }
        ],
        "modify_time": "{{modify_time}}",
        "spc_type": "UNSET",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
        "card_list": null,
        "vbo_window": null,
        "budget": {{budget}},
        "title_list": [
            {
                "title": ""
            }
        ],
        "automatic_add_on_enabled": null,
        "app_name": null,
        "disable_skan_campaign": null,
        "excluded_audience_ids": null,
        "product_specific_type": null,
        "objective_type": "LEAD_GENERATION",
        "promotion_website_type": null,
        "app_type": null,
        "languages": [],
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "view_attribution_window": "ONE_DAY",
        "page_list": [
            {
                "page_id": "{{page_id}}"
            }
        ],
        "adgroup_secondary_status": "ADGROUP_STATUS_AUDIT",
        "call_to_action_id": "{{call_to_action_id}}",
        "landing_page_urls": null,
        "product_ids": null,
        "pixel_id": "{{pixel_id}}",
        "shopping_ads_fallback_type": null,
        "product_set_id": null,
        "carousel_image_labels": null,
        "deeplink": null
    }
}
(/code)

创建优化位置为落地页的 Smart+ 线索收集推广系列

步骤

创建此类 Smart+ 推广系列需确保满足以下要求。若想了解完整的参数列表,可查看/campaign/spc/create/接口文档。

注意
Smart+ 线索收集广告组不支持用于/split_test/create/ 创建拆分对比测试。

设置 要求 参数 如何设置该参数
推广目标 线索收集 objective_type LEAD_GENERATION
推广系列设置 Smart+ 推广系列 N/A N/A
通过 /campaign/spc/create/ 创建的推广系列均为 Smart+ 推广系列。
推广系列名称 指定一个合法名称 campaign_name 传入合法值
特殊广告分类
(可选)
启用或未启用

注意: 本设置仅支持注册地为美国或加拿大的广告主使用。

special_industries 传入合法值,或不传入
推广系列预算优化 N/A

注意: Smart+ 推广系列默认均启用推广系列预算优化

N/A N/A

注意: 若您使用 /campaign/get/ 检索 Smart+ 网站推广系列,返回的 budget_optimize_on 将为 true。

优化位置
(推广对象类型)
落地页 promotion_type LEAD_GENERATION
promotion_target_type EXTERNAL_WEBSITE
深层漏斗优化
(可选)
启用或不启用

通过深层漏斗优化,您可以在主要优化事件之外再选择一个次要事件,这有助于提升推广系列的效果。
deep_funnel_optimization_status
deep_funnel_event_source
deep_funnel_event_source_id
deep_funnel_optimization_event
  • 若想启用深层漏斗优化,需将 deep_funnel_optimization_status 设置为 ON 且传入deep_funnel_event_source、deep_funnel_event_source_id 和 deep_funnel_optimization_event。
  • 若不想启用深层漏斗优化,需将 deep_funnel_optimization_status设置为 OFF 或不传入deep_funnel_optimization_status。无需传入deep_funnel_event_source、deep_funnel_event_source_id 和deep_funnel_optimization_event。

注意:

  • 使用 CRM 事件组的深层漏斗优化目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。
  • 使用 Pixel 或线下事件组的深层漏斗优化已全量发布。
优化目标 转化 optimization_goal CONVERT
Pixel 启用 pixel_id 传入合法值。
若想获取广告账户中的 Pixel 列表,可使用 /pixel/list/。
优化事件 启用 optimization_event 传入合法值。
若想获取 Pixel 已配置的优化事件,可使用 /pixel/list/。
若想了解相关枚举值,可查看转化事件 - Pixel 事件类型。
版位 TikTok 版位(包括搜索结果) placement_type PLACEMENT_TYPE_NORMAL
placements ["PLACEMENT_TIKTOK"]

注意: 默认打开自动搜索广告位。

用户评论
(可选)
启用或未启用 comment_disabled 传入合法值,或不传入
允许下载视频
(可选)
启用或未启用 share_disabled 传入合法值,或不传入
允许共享视频
(可选)
启用或未启用 video_download_disabled 传入合法值,或不传入
受众定向
· 地域
启用 location_ids 传入合法值
受众定向
· 语言
(可选)
启用或未启用 languages 传入合法值,或不传入
受众定向
· 性别
(可选)
需申请白名单才可启用

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

gender 传入合法值,或不传入
受众定向
· 年龄
以下任一选项:
  • 18+
  • 25+
spc_audience_age 以下任一值:
  • 18+
  • 25+
受众定向
· 排除受众
(可选)
启用或未启用 excluded_audience_ids 传入合法值,或不传入
预算模式 动态日预算 budget_mode 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。
出价策略 以下任一类型:
  • 最大投放量
  • 成本上限(或目标 CPA)
bid_type
conversion_bid_price
可将 bid_type 设置为 BID_TYPE_CUSTOM 或 BID_TYPE_NO_BID。
  • 若 bid_type 设置为 BID_TYPE_CUSTOM 时,需同时传入 conversion_bid_price。
bid_price
deep_bid_type
roas_bid
不传入
计费事件
(计费点)
oCPM billing_event OCPM
认证身份
(广告发布身份)
使用以下任一类型:
  • 授权用户
  • TikTok 用户
  • 添加到商务中心的 TikTok 用户
identity_type 使用以下任一值:
  • AUTH_CODE
  • TT_USER
  • BC_AUTH_TT

注意: 需在 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
  • 若想将目标页面设置为 URL,需通过 landing_page_urls 传入包含第三方网站表单的网站落地页 URL。
  • 若想将目标页面设置为自定义页面,需通过 page_list 传入可以重定向至包含第三方网站表单的网站的 TikTok 即时体验页面。
创意素材
  • 若使用 TikTok 用户或添加到商务中心的 TikTok 用户身份提取帖子创建 Spark Ads 或使用授权用户身份,需指定 1-30 个 TikTok 帖子。
video_info
image_info
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。
创新互动样式(可选) 未启用,或使用以下任一类型:
  • 展示卡片(又称图片卡片)
card_list 不传入或指定以下任一类型的创意素材包的 ID:
  • 展示卡片(又称图片卡片)

若想创建创意素材包,可使用 /creative/portfolio/create/。
  • 若想了解如何获取展示卡片素材包的 ID,请参考卡片。
行动引导文案 动态优选 call_to_action_id 传入合法值。

若想了解如何创建动态优选行动引导文案,请查看动态优选行动引导文案。
call_to_action_list 不传入

示例

目标页面为 URL

请求

(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": "LEAD_GENERATION",
    "campaign_name": "{{campaign_name}}",
    "promotion_type": "LEAD_GENERATION",
    "promotion_target_type": "EXTERNAL_WEBSITE",
    "optimization_goal": "CONVERT",
    "pixel_id": "{{pixel_id}}",
    "optimization_event": "ON_WEB_DETAIL",
    "spc_audience_age": "25+",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": [
        "PLACEMENT_TIKTOK"
    ],
    "location_ids": [
        "6252001"
    ],
    "budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "bid_type": "BID_TYPE_CUSTOM",
    "conversion_bid_price":{{conversion_bid_price}},
    "billing_event": "OCPM",
    "landing_page_urls": [
        {
            "landing_page_url": "{{landing_page_url}}"
        }
    ],
    "media_info_list": [
        {
            "media_info": {
                "identity_type": "AUTH_CODE",
                "identity_id": "{{identity_id}}",
                "tiktok_item_id": "{{tiktok_item_id}}"
            }
        }
    ],
    "call_to_action_id": "{{call_to_action_id}}"
}'
(/code)

返回

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "click_tracking_url": null,
        "carousel_image_index": null,
        "optimization_event": "ON_WEB_DETAIL",
        "catalog_id": null,
        "bid_type": "BID_TYPE_CUSTOM",
        "comment_disabled": false,
        "app_id": null,
        "optimization_goal": "CONVERT",
        "bid_price": null,
        "is_advanced_dedicated_campaign": false,
        "create_time": "{{create_time}}",
        "exclude_age_under_eighteen": true,
        "engaged_view_attribution_window": "OFF",
        "blocked_pangle_app_ids": null,
        "deeplink_type": null,
        "scheduled_budget": 0,
        "conversion_bid_price": {{conversion_bid_price}},
        "advertiser_id": "75960823018",
        "impression_tracking_url": null,
        "deep_bid_type": null,
        "video_download_disabled": false,
        "catalog_creative_toggle": null,
        "promotion_type": "LEAD_GENERATION",
        "schedule_type": "SCHEDULE_START_END",
        "share_disabled": false,
        "schedule_start_time": "{{schedule_start_time}}",
        "campaign_app_profile_page_state": null,
        "promotion_target_type": "EXTERNAL_WEBSITE",
        "gender": "GENDER_UNLIMITED",
        "app_download_url": null,
        "schedule_end_time": "{{schedule_end_time}}",
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "special_industries": null,
        "web_all_in_one_catalog_status": null,
        "billing_event": "OCPM",
        "call_to_action_list": [],
        "click_attribution_window": "SEVEN_DAYS",
        "product_source": null,
        "spc_audience_age": "25+",
        "identity_type": null,
        "location_ids": [
            "6252001"
        ],
        "campaign_secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "is_smart_performance_campaign": true,
        "campaign_type": null,
        "roas_bid": null,
        "operation_status": "ENABLE",
        "app_promotion_type": null,
        "bid_align_type": null,
        "campaign_name": "{{campaign_name}}",
        "attribution_event_count": "EVERY",
        "skip_learning_phase": true,
        "campaign_id": "{{campaign_id}}",
        "identity_id": null,
        "catalog_authorized_bc_id": null,
        "media_info_list": [
            {
                "media_info": {
                    "aigc_disclosure_type": null,
                    "identity_type": "AUTH_CODE",
                    "tiktok_item_id": "{{tiktok_item_id}}",
                    "image_info": null,
                    "identity_id": "{{identity_id}}",
                    "music_info": null,
                    "identity_authorized_bc_id": "0",
                    "video_info": null
                }
            }
        ],
        "modify_time": "{{modify_time}}",
        "spc_type": "UNSET",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
        "card_list": null,
        "vbo_window": null,
        "budget": {{budget}},
        "title_list": [
            {
                "title": ""
            }
        ],
        "automatic_add_on_enabled": null,
        "app_name": null,
        "disable_skan_campaign": null,
        "excluded_audience_ids": null,
        "product_specific_type": null,
        "objective_type": "LEAD_GENERATION",
        "promotion_website_type": null,
        "app_type": null,
        "languages": [],
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "view_attribution_window": "ONE_DAY",
        "page_list": null,
        "adgroup_secondary_status": "ADGROUP_STATUS_AUDIT",
        "call_to_action_id": "{{call_to_action_id}}",
        "landing_page_urls": [
            {
                "tiktok_item_id": null,
                "video_id": null,
                "landing_page_url": "{{landing_page_url}}"
            }
        ],
        "product_ids": null,
        "pixel_id": "{{pixel_id}}",
        "shopping_ads_fallback_type": null,
        "product_set_id": null,
        "carousel_image_labels": null,
        "deeplink": null
    }
}
(/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": "LEAD_GENERATION",
    "campaign_name": "{{campaign_name}}",
    "promotion_type": "LEAD_GENERATION",
    "promotion_target_type": "EXTERNAL_WEBSITE",
    "optimization_goal": "CONVERT",
    "pixel_id": "{{pixel_id}}",
    "optimization_event": "ON_WEB_DETAIL",
    "spc_audience_age": "25+",
    "placement_type": "PLACEMENT_TYPE_NORMAL",
    "placements": [
        "PLACEMENT_TIKTOK"
    ],
    "location_ids": [
        "6252001"
    ],
    "budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
    "budget": {{budget}},
    "schedule_type": "SCHEDULE_START_END",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "bid_type": "BID_TYPE_CUSTOM",
    "conversion_bid_price": {{conversion_bid_price}},
    "billing_event": "OCPM",
    "page_list": [
        {
            "page_id": "{{page_id}}"
        }
    ],
    "media_info_list": [
        {
            "media_info": {
                "identity_type": "AUTH_CODE",
                "identity_id": "{{identity_id}}",
                "tiktok_item_id": "{{tiktok_item_id}}"
            }
        }
    ],
    "call_to_action_id": "{{call_to_action_id}}"
}'
(/code)

返回

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "skip_learning_phase": true,
        "product_specific_type": null,
        "disable_skan_campaign": null,
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "app_id": null,
        "exclude_age_under_eighteen": true,
        "objective_type": "LEAD_GENERATION",
        "pixel_id": "{{pixel_id}}",
        "video_download_disabled": false,
        "spc_type": "UNSET",
        "deeplink_type": null,
        "identity_id": null,
        "optimization_event": "ON_WEB_DETAIL",
        "shopping_ads_fallback_type": null,
        "bid_align_type": null,
        "schedule_type": "SCHEDULE_START_END",
        "automatic_add_on_enabled": null,
        "roas_bid": null,
        "call_to_action_list": [],
        "modify_time": "{{modify_time}}",
        "schedule_start_time": "{{schedule_start_time}}",
        "location_ids": [
            "6252001"
        ],
        "optimization_goal": "CONVERT",
        "promotion_type": "LEAD_GENERATION",
        "scheduled_budget": 0,
        "promotion_target_type": "EXTERNAL_WEBSITE",
        "promotion_website_type": null,
        "product_source": null,
        "impression_tracking_url": null,
        "catalog_authorized_bc_id": null,
        "app_name": null,
        "engaged_view_attribution_window": "OFF",
        "budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
        "deeplink": null,
        "app_download_url": null,
        "view_attribution_window": "ONE_DAY",
        "vbo_window": null,
        "gender": "GENDER_UNLIMITED",
        "bid_type": "BID_TYPE_CUSTOM",
        "campaign_type": null,
        "bid_price": null,
        "landing_page_urls": null,
        "operation_status": "ENABLE",
        "excluded_audience_ids": null,
        "advertiser_id": "{{advertiser_id}}",
        "app_type": null,
        "carousel_image_index": null,
        "spc_audience_age": "25+",
        "share_disabled": false,
        "click_attribution_window": "SEVEN_DAYS",
        "blocked_pangle_app_ids": null,
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "page_list": [
            {
                "page_id": "{{page_id}}"
            }
        ],
        "catalog_creative_toggle": null,
        "schedule_end_time": "{{schedule_end_time}}",
        "card_list": null,
        "special_industries": null,
        "campaign_app_profile_page_state": null,
        "billing_event": "OCPM",
        "languages": [],
        "click_tracking_url": null,
        "product_ids": null,
        "web_all_in_one_catalog_status": null,
        "app_promotion_type": null,
        "product_set_id": null,
        "comment_disabled": false,
        "campaign_secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "is_advanced_dedicated_campaign": false,
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "budget": {{budget}},
        "identity_type": null,
        "deep_bid_type": null,
        "carousel_image_labels": null,
        "media_info_list": [
            {
                "media_info": {
                    "identity_type": "AUTH_CODE",
                    "identity_id": "{{identity_id}}",
                    "tiktok_item_id": "{{tiktok_item_id}}",
                    "identity_authorized_bc_id": "0",
                    "image_info": null,
                    "aigc_disclosure_type": null,
                    "music_info": null,
                    "video_info": null
                }
            }
        ],
        "call_to_action_id": "{{call_to_action_id}}",
        "adgroup_secondary_status": "ADGROUP_STATUS_AUDIT",
        "title_list": [
            {
                "title": ""
            }
        ],
        "attribution_event_count": "EVERY",
        "conversion_bid_price": {{conversion_bid_price}},
        "campaign_name": "{{campaign_name}}",
        "campaign_id": "{{campaign_id}}",
        "is_smart_performance_campaign": true,
        "create_time": "{{create_time}}",
        "catalog_id": null
    }
}
(/code)

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