(即将废弃)创建旧版 Smart+ 应用推广系列
本文介绍了创建 Smart+ 应用推广系列的具体步骤。
步骤
调用/campaign/spc/create/以创建 Smart+ 应用推广系列(objective_type = APP_PROMOTION)。
注意
智能效果应用推广系列已自动升级为 Smart+ 应用推广系列。
下表仅列出了部分相关的参数。欲了解完整的参数列表,请参考/campaign/spc/create/接口文档和代码示例。
| 设置{20%} | 要求{25%} | 参数{20%} | 如何设置该参数{35%} |
|---|---|---|
| 推广目标 | 应用推广 | `objective_type` | `APP_PROMOTION` |
| 应用推广类型 | 应用安装 | `app_promotion_type` | `APP_INSTALL` |
| 优化位置<br> (推广对象类型) | 选择以下类型之一: <ul><li>Android 应用 </li><li> iOS 应用 </li></ul>| `promotion_type`<br>`app_id` | <ul><li>若想将优化位置设置为 Android 应用, 需:<ul><li>将 `promotion_type` 设置为 `APP_ANDROID`</li><li>通过 `app_id` 指定一个 Android 应用</li></ul></li><li>若想将优化位置设置为 iOS 应用,需:<ul><li>将 `promotion_type` 设置为 `APP_IOS`</li><li>通过 `app_id` 指定一个 iOS 应用 </li></ul></li></ul>若想获取广告账户下的应用列表,需使用[/app/list/](1740859313270786.html)。 <ul><li>对于 Android 应用,返回的 `platform` 将为 `ANDROID`。</li><li>对于 iOS 应用,返回的 `platform` 将为 `IOS`。</li></ul>|
| 版位<br>(广告位) | <ul><li>对于 Android 应用,需使用<b>自动版位</b></li><li>对于 iOS 应用,需使用<b>自动版位</b></li></ul> | `placement_type`<br> `placements` | <ul><li>若 `promotion_type` 设置为 `APP_ANDROID`,无需传入 `placement_type` 和 `placements`。<ul><li>系统将根据您的其他设置自动配置广告投放版位,并从不同的版位中选择高质量流量,来实现更好的广告效果。若传入了 `placement_type` 和 `placements`,将忽略这两个字段,并将值分别覆盖成 `PLACEMENT_TYPE_AUTOMATIC` 和`["PLACEMENT_TIKTOK","PLACEMENT_PANGLE"]`。</li><li>若想获取 Smart+ 应用推广系列实际选择的版位设置,可使用[/campaign/spc/get/](1767334299811842.html)。</li></ul></li><li>若 `promotion_type` 设置为 `APP_IOS`,无需传入 `placement_type` 和 `placements`。<ul><li>自 2025 年 6 月 30 日起,系统将根据您的其他设置自动配置广告投放版位,并从不同的版位中选择高质量流量,来实现更好的广告效果。若在 2025 年 6 月 30 日后传入了 `placement_type` 和 `placements`,将忽略这两个字段,并将值分别覆盖成 `PLACEMENT_TYPE_AUTOMATIC` 和`["PLACEMENT_TIKTOK","PLACEMENT_PANGLE"]`。</li><li>若想获取 Smart+ 应用推广系列实际选择的版位设置,可使用[/campaign/spc/get/](1767334299811842.html)。</li></ul></li></ul>|
示例
请求
(code curl 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}}",
"operation_status": "ENABLE",
"objective_type": "APP_PROMOTION",
"app_promotion_type": "APP_INSTALL",
"campaign_type": "REGULAR_CAMPAIGN",
"campaign_name": "{{campaign_name}}",
"promotion_type": "APP_ANDROID",
"app_id": "{{app_id}}",
"placement_type": "PLACEMENT_TYPE_AUTOMATIC",
"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}}",
"optimization_goal": "INSTALL",
"bid_type": "BID_TYPE_NO_BID",
"billing_event": "OCPM",
"identity_type": "CUSTOMIZED_USER",
"identity_id": "{{identity_id}}",
"media_info_list": [
{
"media_info": {
"video_info": {
"video_id": "{{video_id}}",
"file_name": "{{file_name}}"
},
"image_info": [
{
"web_uri": "{{web_uri}}"
}
]
}
}
],
"title_list": [
{
"title": "{{title}}"
}
],
"call_to_action_id": "{{call_to_action_id}}"
}'
(/code)
返回
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"pixel_id": null,
"carousel_image_index": null,
"deeplink": "",
"adgroup_secondary_status": "ADGROUP_STATUS_AUDIT",
"gender": "GENDER_UNLIMITED",
"special_industries": null,
"location_ids": [
"6252001"
],
"schedule_end_time": "{{schedule_end_time}}",
"excluded_audience_ids": null,
"shopping_ads_fallback_type": null,
"promotion_type": "APP_ANDROID",
"product_ids": null,
"automatic_add_on_enabled": null,
"budget": {{budget}},
"skip_learning_phase": true,
"impression_tracking_url": null,
"share_disabled": false,
"deep_bid_type": "DEFAULT",
"engaged_view_attribution_window": "SEVEN_DAYS",
"conversion_bid_price": null,
"is_advanced_dedicated_campaign": false,
"promotion_website_type": null,
"schedule_type": "SCHEDULE_START_END",
"attribution_event_count": "ONCE",
"campaign_app_profile_page_state": "UNSET",
"product_set_id": null,
"roas_bid": null,
"call_to_action_id": "{{call_to_action_id}}",
"app_promotion_type": "APP_INSTALL",
"languages": [],
"is_smart_performance_campaign": true,
"call_to_action_list": [],
"click_tracking_url": null,
"modify_time": "{{modify_time}}",
"bid_price": null,
"media_info_list": [
{
"media_info": {
"video_info": {
"video_id": "{{video_id}}",
"file_name": "{{file_name}}"
},
"identity_type": null,
"aigc_disclosure_type": null,
"music_info": null,
"tiktok_item_id": null,
"image_info": [
{
"web_uri": "{{web_uri}}"
}
],
"identity_id": null
}
}
],
"catalog_creative_toggle": null,
"advertiser_id": "{{advertiser_id}}",
"app_id": "{{app_id}}",
"identity_type": "CUSTOMIZED_USER",
"card_list": null,
"campaign_secondary_status": "CAMPAIGN_STATUS_ENABLE",
"page_list": null,
"scheduled_budget": 0,
"bid_type": "BID_TYPE_NO_BID",
"placements": [
"PLACEMENT_TIKTOK",
"PLACEMENT_PANGLE"
],
"app_download_url": "{{app_download_url}}",
"view_attribution_window": "ONE_DAY",
"create_time": "{{create_time}",
"dayparting":
"111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
"product_specific_type": null,
"catalog_authorized_bc_id": null,
"schedule_start_time": "{{schedule_start_time}}",
"comment_disabled": false,
"campaign_type": "REGULAR_CAMPAIGN",
"deeplink_type": null,
"campaign_id": "{{campaign_id}}",
"product_source": null,
"blocked_pangle_app_ids": null,
"carousel_image_labels": null,
"billing_event": "OCPM",
"campaign_name": "{{campaign_name}}",
"app_name": "{{app_name}}",
"optimization_goal": "INSTALL",
"video_download_disabled": false,
"operation_status": "ENABLE",
"click_attribution_window": "SEVEN_DAYS",
"title_list": [
{
"title": "{{title}}"
}
],
"landing_page_urls": null,
"spc_audience_age": "18+",
"app_type": "APP_ANDROID",
"spc_type": "UNSET",
"web_all_in_one_catalog_status": null,
"optimization_event": "ACTIVE",
"objective_type": "APP_PROMOTION",
"placement_type": "PLACEMENT_TYPE_AUTOMATIC",
"exclude_age_under_eighteen": true,
"identity_id": "{{identity_id}}",
"budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
"catalog_id": null
}
}
(/code)