← 返回目录
📁 Use Cases › Campaign creation › Create Shopping Ads › Create Video Shopping Ads › Create Catalog Ads

优化视频购物广告中的目标页面访问

本文介绍了创建优化目标为目标页面访问的视频购物广告的具体步骤。使用目标页面访问这一优化目标可以将用户引导至应用内页面,或回退到网站。

前提条件

  • 优化目标目标页面访问目前为白名单功能。如需使用此功能,请联系您的 TikTok 销售代表。

步骤

1. 创建推广系列

使用/campaign/create/接口创建一个推广系列。需注意在满足创建商品来源为商品库的视频购物广告-1.创建推广系列小节所列出的参数要求的基础上,还需满足以下参数要求:

设置 要求 参数 如何设置该参数
Smart+ 推广系列 未启用

若您想查看推广系列是否启用了 Smart+ 推广系列设置,可使用/campaign/get/返回的is_smart_performance_campaign字段进行确认。
/
/
iOS 14专属推广系列 未启用 campaign_type 设置为REGULAR_CAMPAIGN或不传入
app_id 不支持
campaign_app_profile_page_state 不支持

示例

请求

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/create/' \
--header 'Access-token: {{Access-token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "objective_type": "PRODUCT_SALES",
    "campaign_product_source": "CATALOG",
    "campaign_name": "{{campaign_name}}",
    "budget_mode": "BUDGET_MODE_TOTAL",
    "budget": {{budget}}
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "modify_time": "{{modify_time}}",
        "is_new_structure": true,
        "operation_status": "ENABLE",
        "create_time": "{{create_time}}",
        "advertiser_id": "{{advertiser_id}}",
        "objective": "LANDING_PAGE",
        "campaign_app_profile_page_state": "UNSET",
        "campaign_type": "REGULAR_CAMPAIGN",
        "deep_bid_type": null,
        "objective_type": "PRODUCT_SALES",
        "campaign_id": "{{campaign_id}}",
        "campaign_name": "{{campaign_name}}",
        "roas_bid": 0.0,
        "is_search_campaign": false,
        "campaign_product_source": "CATALOG",
        "is_smart_performance_campaign": false,
        "budget": {{budget}},
        "secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "budget_mode": "BUDGET_MODE_TOTAL"
    }
}
(/code)

2. 创建、管理商品库

相关步骤可参考创建商品来源为商品库的视频购物广告-2.创建、管理商品库小节。

3. 创建广告组

使用/adgroup/create/接口创建一个广告组。需注意在满足创建商品来源为商品库的视频购物广告-3.创建广告组小节所列出的参数要求基础上,还需满足以下参数要求:

| 设置 {18%}| 要求{25%} | 参数 {28%}| 如何设置该参数 {28%}|
|---|---|---|---|
| 推广对象类型 (优化位置) | 安卓应用或 iOS 应用 | `promotion_type` | `APP_ANDROID`  或 `APP_IOS` |
| 优化事件 | 未设置。<br>默认设置为目标页面访问。 | `optimization_event` | `DESTINATION_VISIT` 或不传入(推荐做法) |
| 版位 | <strong>编辑版位</strong>,同时将版位设置为仅 TikTok |<ul><li>`placement_type` </li><li> `placements` </li></ul> | `placement_type` 设置为`PLACEMENT_TYPE_NORMAL`,且 `placements` 设置为`["PLACEMENT_TIKTOK"]` |
| 对受众再营销 | 未启用 |<ul><li>`shopping_ads_retargeting_type`</li><li> `shopping_ads_retargeting_actions_days`</li><li> `included_custom_actions`</li><li>  `excluded_custom_actions` </li></ul>|  <ul><li>`shopping_ads_retargeting_type` 设置为 `OFF`。</li><li>不传入`shopping_ads_retargeting_actions_days`, `included_custom_actions` 和 `excluded_custom_actions` 。 </li></ul> |
| 优化目标 | 目标页面访问 | `optimization_goal` | `DESTINATION_VISIT` |
| 归因设置 | <ul><li>归因窗口期:未设置。<br>默认设置为 7 天(点击) 和 1 天(展示)</li><li>事件统计方式:未设置。<br>默认设置为仅一次。 </li></ul> | <ul><li>`click_attribution_window`</li><li>`view_attribution_window`</li><li>`attribution_event_count` </li></ul>| 不传入<ul><li>`click_attribution_window` 将默认设置为`SEVEN_DAYS` 。</li><li>`view_attribution_window` 将默认设置为`ONE_DAY`。</li><li> `attribution_event_count` 将默认设置为 `ONCE` 。</li></ul>  |
| 计费事件 | oCPM | `billing_event` | `OCPM` |
| 程序化创意 & 智能创意 | 未启用 | `creative_material_mode` | 不传入 |
| 拆分对比测试 | 未启用 <br><br>优化目标为目标页面访问的访问量广告组不支持传入[/split_test/create/](1742666471475201.html)中创建拆分对比测试。| / | / |

示例

请求

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/adgroup/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
        "advertiser_id": "{{advertiser_id}}",
        "campaign_id": "{{campaign_id}}",
        "adgroup_name": "{{adgroup_name}}",
        "shopping_ads_type": "VIDEO",
        "product_source": "CATALOG",
        "catalog_id": "{{catalog_id}}",
        "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
        "promotion_type": "APP_ANDROID",
        "app_id": "{{app_id}}",
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "placements": ["PLACEMENT_TIKTOK"],
        "shopping_ads_retargeting_type": "OFF",
        "location_ids": ["{{location_id}}", "{{location_id}}"],
        "gender": "GENDER_UNLIMITED",
        "operating_systems": ["ANDROID"],
        "budget_mode": "BUDGET_MODE_TOTAL",
        "budget": {{budget}},
        "schedule_type": "SCHEDULE_START_END",
        "schedule_start_time": "{{schedule_start_time}}",
        "schedule_end_time": "{{schedule_end_time}}",
        "optimization_goal": "DESTINATION_VISIT",
        "bid_type": "BID_TYPE_NO_BID",
        "billing_event": "OCPM",
        "pacing": "PACING_MODE_SMOOTH",
        "operation_status": "ENABLE"
    }'
(/code)

返回

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "attribution_event_count": "ONCE",
        "shopping_ads_type": "VIDEO",
        "creative_material_mode": "CATALOG_SALES",
        "statistic_type": null,
        "adgroup_app_profile_page_state": null,
        "auto_targeting_enabled": false,
        "excluded_audience_ids": [],
        "rf_estimated_cpr": null,
        "next_day_retention": null,
        "rf_purchased_type": null,
        "scheduled_budget": 0.0,
        "frequency": null,
        "click_attribution_window": "SEVEN_DAYS",
        "gender": "GENDER_UNLIMITED",
        "deep_bid_type": null,
        "isp_ids": [],
        "deep_cpa_bid": 0.0,
        "interest_keyword_ids": [],
        "shopping_ads_retargeting_type": "OFF",
        "schedule_start_time": "{{schedule_start_time}}",
        "package": "{{package}}",
        "app_id": "{{app_id}}",
        "inventory_filter_enabled": false,
        "location_ids": [
            "{{location_id}}",
            "{{location_id}}"
        ],
        "budget": {{budget}},
        "billing_event": "OCPM",
        "optimization_goal": "DESTINATION_VISIT",
        "ios14_quota_type": "UNOCCUPIED",
        "keywords": null,
        "campaign_id": "{{campaign_id}}",
        "search_result_enabled": false,
        "campaign_name": "{{campaign_name}}",
        "app_type": "APP_ANDROID",
        "purchased_impression": null,
        "secondary_optimization_event": null,
        "purchased_reach": null,
        "languages": [],
        "comment_disabled": false,
        "is_hfss": false,
        "frequency_schedule": null,
        "schedule_infos": null,
        "actions": [],
        "adgroup_id": "{{adgroup_id}}",
        "pacing": "PACING_MODE_SMOOTH",
        "bid_display_mode": "CPMV",
        "device_price_ranges": null,
        "age_groups": null,
        "operating_systems": [
            "ANDROID"
        ],
        "category_id": "0",
        "conversion_bid_price": 0.0,
        "dayparting": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
        "network_types": [],
        "conversion_window": null,
        "is_new_structure": true,
        "brand_safety_type": "NO_BRAND_SAFETY",
        "catalog_id": "{{catalog_id}}",
        "bid_price": 0.0,
        "brand_safety_partner": null,
        "view_attribution_window": "ONE_DAY",
        "advertiser_id": "{{advertiser_id}}",
        "schedule_type": "SCHEDULE_START_END",
        "skip_learning_phase": true,
        "bid_type": "BID_TYPE_NO_BID",
        "interest_category_ids": [],
        "create_time": "{{create_time}}",
        "product_source": "CATALOG",
        "pixel_id": null,
        "adgroup_name": "{{adgroup_name}}",
        "operation_status": "ENABLE",
        "category_exclusion_ids": [],
        "delivery_mode": null,
        "catalog_authorized_bc_id": "{{catalog_authorized_bc_id}}",
        "app_download_url": "{{app_download_url}}",
        "budget_mode": "BUDGET_MODE_TOTAL",
        "placement_type": "PLACEMENT_TYPE_NORMAL",
        "optimization_event": "DESTINATION_VISIT",
        "audience_ids": [],
        "feed_type": null,
        "promotion_type": "APP_ANDROID",
        "is_smart_performance_campaign": false,
        "rf_estimated_frequency": null,
        "schedule_end_time": "{{schedule_end_time}}",
        "modify_time": "{{modify_time}}",
        "video_download_disabled": false,
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "secondary_status": "ADGROUP_STATUS_CREATE",
        "share_disabled": false
    }
}
(/code)

4. 创建广告

使用/ad/create/接口创建一个广告。需注意在满足创建商品来源为商品库的视频购物广告-4.创建广告小节所列出的参数要求基础上,还需满足以下参数要求:

| 设置{20%} | 要求 {20%} | 参数{25%}  | 如何设置该参数{35%} |
|---|---|---|---|
| 目标页面 - 深度链接 | 以下任意一种类型:<ul><li>商品库深度链接</li><li> 自定义深度链接</li></ul> | <ul><li>`deeplink_format_type` </li><li>`deeplink`</li><li> `shopping_ads_deeplink_type` </li><li>`fallback_type`</li><li> `shopping_ads_fallback_type` </li><li>`landing_page_url`</li></ul>| <ul><li>不传入 `deeplink_format_type` 。</li><li>`shopping_ads_deeplink_type` 设置为`SHOPPING_ADS` 或 `NORMAL` 。<ul><li>若 `shopping_ads_deeplink_type` 设置为`NORMAL`, 需传入 `deeplink`。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>:以下场景中 `shopping_ads_deeplink_type` 不可设置为 `SHOPPING_ADS`:<ul><li>`ad_format` 为 `SINGLE_VIDEO` 且`vertical_video_strategy` 为 `SINGLE_VIDEO` 。</li><li> `ad_format` 为 `CATALOG_CAROUSEL` 。</li></ul></li><li>`fallback_type` 设置为 `UNSET`。 </li><li>若想设置失败路径,需传入 `shopping_ads_fallback_type` 。<ul><li>若想将失败路径设置为应用商店,需将 `shopping_ads_fallback_type` 设置为 `DEFAULT`,且不传入 `landing_page_url` 。</li><li>若想将失败路径设置为商品库链接,需将`shopping_ads_fallback_type` 设置为 `SHOPPING_ADS`,且不传入 `landing_page_url` 。<br><br><p><span style="color:darkred"><b>注意</b></span>:以下场景中 `shopping_ads_fallback_type` 不可设置为 `SHOPPING_ADS`:<ul><li>`ad_format` 为 `SINGLE_VIDEO` 且`vertical_video_strategy`为 `SINGLE_VIDEO` 。</li><li>`ad_format` 为 `CATALOG_CAROUSEL` 。</li></ul> </li><li>若想将失败路径设置为自定义链接,需将`shopping_ads_fallback_type` 设置为 `CUSTOM`,且传入 `landing_page_url` 。</li></ul> </li></ul>|
| 目标页面 - 深度链接类型 | 非延迟深度链接 | `deeplink_type` | `NORMAL` 或不传入 |
| TikTok 即时体验页面 | 未启用 | `page_id` | 不传入 |

示例

请求

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/ad/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "adgroup_id": "{{adgroup_id}}",
    "creatives": [
        {
            "ad_name": "{{ad_name}}",
            "identity_type": "CUSTOMIZED_USER",
            "identity_id": "{{identity_id}}",
            "catalog_id": "{{catalog_id}}",
            "product_specific_type": "ALL",
            "ad_format": "SINGLE_VIDEO",
            "vertical_video_strategy": "SINGLE_VIDEO",
            "dynamic_format": "UNSET",
            "video_id": "{{video_id}}",
            "image_ids": [
                "{{image_id}}"
            ],
            "ad_text": "{{ad_text}}",
            "call_to_action": "SHOP_NOW",
            "landing_page_url": "{{landing_page_url}}",
            "deeplink": "{{deeplink}}",
            "deeplink_type": "NORMAL",
            "shopping_ads_deeplink_type": "CUSTOM",
            "shopping_ads_fallback_type": "CUSTOM",
            "dynamic_destination": "UNSET",
            "instant_product_page_used": false
        }
    ]
}'
(/code)

返回

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "ad_ids": [
            "{{ad_id}}"
        ],
        "need_audit": false,
        "creatives": [
            {
                "ad_name": "{{ad_name}}",
                "card_id": null,
                "call_to_action_id": null,
                "profile_image_url": "{{profile_image_url}}",
                "fallback_type": "UNSET",
                "creative_authorized": false,
                "vast_moat_enabled": false,
                "image_ids": [
                    "{{image_id}}"
                ],
                "is_aco": false,
                "campaign_id": "{{campaign_id}}",
                "video_id": "{{video_id}}",
                "click_tracking_url": null,
                "display_name": "",
                "campaign_name": "{{campaign_name}}",
                "app_name": "{{app_name}}",
                "dynamic_destination": "UNSET",
                "ad_texts": null,
                "tracking_pixel_id": 0,
                "call_to_action": "SHOP_NOW",
                "product_specific_type": "ALL",
                "shopping_ads_fallback_type": "CUSTOM",
                "ad_id": "{{ad_id}}",
                "shopping_ads_deeplink_type": "CUSTOM",
                "tracking_app_id": "{{tracking_app_id}}",
                "is_new_structure": true,
                "creative_type": null,
                "catalog_id": "{{catalog_id}}",
                "identity_type": "CUSTOMIZED_USER",
                "playable_url": "",
                "vertical_video_strategy": "SINGLE_VIDEO",
                "impression_tracking_url": null,
                "advertiser_id": "{{advertiser_id}}",
                "adgroup_id": "{{adgroup_id}}",
                "landing_page_urls": null,
                "dynamic_format": "UNSET",
                "create_time": "{{create_time}}",
                "ad_format": "SINGLE_VIDEO",
                "operation_status": "ENABLE",
                "identity_id": "{{identity_id}}",
                "adgroup_name": "{{adgroup_name}}",
                "viewability_vast_url": null,
                "tracking_offline_event_set_ids": [
                    "{{tracking_offline_event_set_id}}"
                ],
                "viewability_postbid_partner": "UNSET",
                "shopping_ads_video_package_id": "",
                "music_id": null,
                "brand_safety_vast_url": null,
                "optimization_event": "DESTINATION_VISIT",
                "deeplink": "{{deeplink}}",
                "deeplink_type": "NORMAL",
                "page_id": null,
                "brand_safety_postbid_partner": "UNSET",
                "landing_page_url": "{{landing_page_url}}",
                "modify_time": "{{modify_time}}",
                "ad_text": "{{ad_text}}",
                "avatar_icon_web_uri": "{{avatar_icon_web_uri}}"
            }
        ]
    }
}
(/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 每日平台更新简报 →