创建直播 GMV Max 推广系列

本文介绍了创建直播 GMV Max 推广系列的步骤。

简介

直播 GMV Max 推广系列可优化访问量，为您的直播活动带来最高的商品销量。

您可以使用 GMV Max API 创建直播 GMV Max 推广系列。这将帮助您简化推广系列创建流程，提高运营效率和管理规模。

支持的市场

请查看下表，了解支持直播 GMV Max 推广系列的国家或地区。

| 国家或地区代码 {30%}| 市场{60%} |
|---|---|
| `ID` | 印度尼西亚 |
| `MY` | 马来西亚 |
| `PH` | 菲律宾 |
| `SG` | 新加坡 |
| `TH` | 泰国 |
| `US` | 美国 |
| `VN` | 越南 |

前提条件

您已经拥有 TikTok API for Business 的使用权限。详见快速入门 - 具体步骤。
若要创建直播 GMV Max 推广系列，您需要获取相关的权限。参阅 API 参考了解使用相关接口（包括“步骤”部分列出的接口）所需的权限。参阅更新应用权限范围了解如何设置权限。
创建 GMV Max 推广系列需要首先在商务中心设置 TikTok Shop。 1. 将 TikTok Shop 添加到商务中心。您可以在商家中心创建 TikTok Shop，并以店铺管理员身份将 TikTok Shop 添加到商务中心，或者在商务中心中请求其他人的 TikTok Shop 权限。 2. 确保您具有商务中心的管理员权限。若想查询相关权限，可调用/bc/get/。
- 若返回中未包含此商务中心，代表您还不是此商务中心的成员。需请求商务中心的管理员邀请您加入商务中心，并使用 /bc/member/invite/ 授予管理员权限。
- 若返回中对此商务中心的 user_role 是 STANDARD，代表您是此商务中心的标准成员。需请求商务中心的管理员使用 /bc/member/update/ 将您的商务中心权限修改为管理员权限。 3. 确保您具有想要用于创建 GMV Max 推广系列的 TikTok Shop 的访问权限。若想查询相关权限，可调用 /bc/asset/get/ 并将 asset_type 设置为 TIKTOK_SHOP。
  若对该 TikTok Shop 的 store_role 不是 AD_PROMOTION，代表您对此 TikTok Shop 无访问权限。需请求商务中心管理员使用 /bc/asset/assign/ 与您分享此 TikTok Shop 并授予访问权限。商务中心管理员需将 asset_type 设置为 TIKTOK_SHOP 且将 store_role 设置为 AD_PROMOTION。 4. 确保您具有想要用于创建 GMV Max 推广系列的广告账户的操作员或管理员权限。若想查询相关权限，可调用 /bc/asset/get/ 并将 asset_type 设置为 ADVERTISER。
  若对该广告账户的 advertiser_role 不是 OPERATOR 或 ADMIN，代表您对此广告账户无操作员或管理员权限。需请求商务中心管理员使用 /bc/asset/assign/ 与您分享此广告账户并授予操作员或管理员权限。商务中心管理员需将 asset_type 设置为 ADVERTISER 且将 advertiser_role 设置为 ADMIN 或 OPERATOR。

步骤

1. 选择可用于直播 GMV Max 推广系列的 TikTok Shop 和广告账户

获取可用于 GMV Max 推广系列的 TikTok Shop，并确保广告账户具有 TikTok Shop 的 GMV Max 授权。

您可使用 /gmv_max/store/list/，并确认返回的 is_gmv_max_available 为 true 且返回的 exclusive_authorized_advertiser_info 中的 advertiser_id 与您想要用来创建 GMV Max 推广系列的广告账户是否一致。

若不一致，则可使用 /gmv_max/exclusive_authorization/create/ 授予此广告账户该 TikTok Shop 的专属 GMV Max 授权。

重要提示

对于每个 TikTok Shop，只能授权一个广告账户使用该 TikTok Shop 创建 GMV Max 推广系列，以优化收入和销售活动。
若您授予此广告账户该 TikTok Shop 的专属 GMV Max 授权，则之前的广告账户将失去使用了相同 TikTok Shop 的 GMV Max 推广系列的权限，且之前的广告账户中使用了相同 TikTok Shop 的现有 GMV Max 推广系列将自动暂停。

## 2. 确认您有可用于直播 GMV Max 推广系列的直播来源认证身份若要获取此类认证身份，可调用 /gmv_max/identity/get/并检查返回的 live_gmv_max_available 是否为 true。

若返回的 live_gmv_max_available 为 false 且 unavailable_reason 为 OCCUPIED，则代表该认证身份已被处于启用状态的直播购物广告组或直播 GMV Max 推广系列占用。您可根据返回的 is_running_custom_shop_ads 值判断占用的类型。 - is_running_custom_shop_ads 为 false 时，代表该认证身份已被处于启用状态的直播 GMV Max 推广系列占用，且您需暂停此推广系列。您可使用/gmv_max/campaign/get/来获取此推广系列。将 gmv_max_promotion_types 设置为 ["LIVE_GMV_MAX"]，通过 store_ids 指定 TikTok Shop 的 ID，并将 primary_status 设置为STATUS_DELIVERY_OK。若想暂停此推广系列，可使用/campaign/status/update/，并将operation_status设置为 DISABLE。 - is_running_custom_shop_ads 为 true 时，代表该认证身份已被处于启用状态的直播购物广告组占用。若想找到对应的直播购物广告组，您可调用 /gmv_max/occupied_custom_shop_ads/list/ 并将 occupied_asset_type 设置为 IDENTITY_TT_USER、IDENTITY_BC_AUTH_TT 或 IDENTITY_TTS_TT。

重要提示

在直播 GMV Max 推广系列中使用与 TikTok Shop 的官方 TikTok 账号绑定的认证身份，会导致任何使用同一认证身份的现有处于启用状态的直播购物广告组自动暂停投放或受到影响，无论这些直播购物广告组创建于哪个广告账号。
若处于启用状态的直播购物广告组已占用某个认证身份，且该认证身份绑定的 TikTok 账号非 TikTok Shop 的官方 TikTok 账号，您将无法在处于启用状态的直播 GMV Max 推广系列中使用此认证身份。您需先手动暂停占用了同一认证身份且处于启用状态的直播购物广告组。可暂停这些广告组。若想暂停这些直播购物广告组，可使用 /adgroup/status/update/，并将operation_status 设置为 DISABLE。
若店铺的官方 TikTok 账号与店铺、TikTok 商务中心解除关联，或不再作为广告账号的 TikTok 企业号，那么使用该店铺以及与该 TikTok 账号绑定的认证身份的直播 GMV Max 推广系列将暂停投放。

3. 创建直播 GMV Max 推广系列

使用 /campaign/gmv_max/create/ 创建直播 GMV Max 推广系列。需确保满足以下要求：

| 设置{20%} | 要求{25%} | 参数{23%} | 如何设置该参数{32%} |
|---|---|---|---|
| TikTok Shop | 指定一个可用于 GMV Max 推广系列的 TikTok Shop | `store_id`<br> `store_authorized_bc_id`| 指定一个从<a href="#item-link-1. 选择可用于直播 GMV Max 推广系列的 TikTok Shop 和广告账户">步骤 1</a> 中获取的可用于直播 GMV Max 推广系列的 TikTok Shop。 |
| 广告账户 | 选择具有使用该 TikTok Shop 创建 GMV Max 推广系列的专属授权的唯一广告账户 | `advertiser_id` | 指定从<a href="#item-link-1. 选择可用于直播 GMV Max 推广系列的 TikTok Shop 和广告账户">步骤 1</a> 中获取的具有该 TikTok Shop 的专属 GMV Max 授权的广告账户。 |
| 直播推广 | 启用| `shopping_ads_type` | `LIVE`（直播 GMV Max 推广系列）|
| 直播来源 | 选择要推广的直播来源 TikTok 账号| `identity_list` | 指定从<a href="#item-link-2. 确认您有可用于直播 GMV Max 推广系列的直播来源认证身份">步骤 2</a> 中获取的一个与 TikTok 账号绑定的认证身份|
| 定向<br>&nbsp;&nbsp;&#183;&nbsp;广告位（版位） | 自动广告位 | N/A | N/A <br><br>GMV Max 推广系列自动选择广告位。系统将根据您的其他设置自动配置广告位，并从不同的广 告位中选择高质量流量，来实现更好的广告效果。若想获取 GMV Max 推广系列实际选择的广告位设置，可使用[/campaign/gmv_max/info/](1822000968821762.html)并查看返回的`placements`。|
| 定向<br>&#183;&nbsp;地域 |店铺的注册国家或地区| N/A |N/A <br><br>GMV Max 推广系列默认投放到您的 TikTok Shop 的注册国家或地区。若想获取 GMV Max 推广系列的确切 地域定向设置，可使用[/campaign/gmv_max/info/](1822000968821762.html)并查看返回的 `location_ids`。|
| 定向<br>&#183;&nbsp;受众  | 排除不满 18 岁的用户 |N/A |N/A <br><br>GMV Max 推广系列默认投放到 18 岁以上的年龄区间。若想获取 GMV Max 推广系列的确切年龄区间定向设置，可使用[/campaign/gmv_max/info/](1822000968821762.html)并查看返回的 `age_groups`。|
| 优化目标 | 总收入 | `optimization_goal` | `VALUE` |
| 直播 ROI 目标 | 指定一个合法的 ROI 目标 | `roas_bid` | 传入合法值。<br><br>若想获取推荐 ROI 目标，可使用 [/gmv_max/bid/recommend/](1822001024720897.html)，并查看返回的 `roas_bid`。 |
| 目标投资回报率 (ROI) 预算 | 指定一个合法的预算 | `budget` | 传入合法值。<br><br>若想获取推荐预算，可使用 [/gmv_max/bid/recommend/](1822001024720897.html)，并查看返回的 `budget`。 |
| 排期类型 | 以下任一类型：<ul><li>在排定的开始时间之后持续投放推广系列</li><li>在排定的开始时间和结束时间之间投放推广系列 </li></ul> | `schedule_type`<br>`schedule_start_time`<br>`schedule_end_time` | <ul><li>若想在排定的开始时间之后持续投放推广系列，需将 `schedule_type` 设置为 `SCHEDULE_FROM_NOW` 并指定`schedule_start_time`。无需传入`schedule_end_time`。</li><li>若想在排定的开始时间和结束时间之间投放推广系列，需将 `schedule_type` 设置为 `SCHEDULE_START_END` 且同时指定 `schedule_start_time` 和`schedule_end_time`。</li></ul> |
| 推广系列名称 | 指定一个合法的名称 | `campaign_name` | 传入合法值 |

示例

请求

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/gmv_max/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "request_id": "{{request_id}}",
    "advertiser_id": "{{advertiser_id}}",
    "store_id": "{{store_id}}",
    "store_authorized_bc_id": "{{store_authorized_bc_id}}",
    "shopping_ads_type": "LIVE",
    "identity_list": [
        {
            "identity_id": "{{identity_id}}",
            "identity_type": "BC_AUTH_TT",
            "identity_authorized_bc_id": "{{identity_authorized_bc_id}}"
        }
    ],
    "optimization_goal": "VALUE",
    "deep_bid_type": "VO_MIN_ROAS",
    "roas_bid": {{roas_bid}},
    "budget": {{budget}},
    "schedule_type": "{{schedule_type}}",
    "schedule_start_time": "{{schedule_start_time}}",
    "schedule_end_time": "{{schedule_end_time}}",
    "campaign_name": "{{campaign_name}}"
}'
(/code)

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "advertiser_id": "{{advertiser_id}}",
        "age_groups": [
            "AGE_18_24",
            "AGE_25_34",
            "AGE_35_44",
            "AGE_45_54",
            "AGE_55_100"
        ],
        "budget": {{budget}},
        "campaign_id": "{{campaign_id}}",
        "campaign_name": "{{campaign_name}}",
        "custom_anchor_video_list": [],
        "deep_bid_type": "VO_MIN_ROAS",
        "identity_list": [
            {
                "identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
                "identity_id": "{{identity_id}}",
                "identity_type": "BC_AUTH_TT"
            }
        ],
        "item_list": [],
        "location_ids": [
            "1562822"
        ],
        "operation_status": "ENABLE",
        "optimization_goal": "VALUE",
        "placements": [
            "PLACEMENT_TIKTOK"
        ],
        "roas_bid": {{roas_bid}},
        "schedule_end_time": "{{schedule_end_time}}",
        "schedule_start_time": "{{schedule_start_time}}",
        "schedule_type": "SCHEDULE_START_END",
        "shopping_ads_type": "LIVE",
        "store_authorized_bc_id": "{{store_authorized_bc_id}}",
        "store_id": "{{store_id}}"
    }
}
(/code)

后续步骤

创建 GMV Max 推广系列后，您可以使用/gmv_max/report/get/请求 GMV Max 推广系列报表。