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

(即将废弃)创建旧版 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` 和`&#91;"PLACEMENT_TIKTOK","PLACEMENT_PANGLE"&#93;`。</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` 和`&#91;"PLACEMENT_TIKTOK","PLACEMENT_PANGLE"&#93;`。</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)

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