创建商品 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 和广告账户
i. 获取可用于 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 推广系列将自动暂停。
ii. 确认商品未被处于启用状态的商品 GMV Max 推广系列占用。
一个 TikTok Shop 中的单个商品仅能在一个处于启用状态的商品 GMV Max 推广系列中使用。
- 对于推广 TikTok Shop 中所有商品的商品 GMV Max 推广系列，需确保 TikTok Shop 仅用于一个处于启用状态的商品 GMV Max 推广系列。
- 若想确认不存在占用了某个 TikTok Shop 中的所有商品的处于启用状态的商品 GMV Max 推广系列，可使用/gmv_max/store/shop_ad_usage_check/并查看返回的 promote_all_products_allowed。
- 若返回的 promote_all_products_allowed 为 false，您需暂停所有使用相同 TikTok Shop 且处于启用状态的商品 GMV Max 推广系列。您可使用/gmv_max/campaign/get/来获取这些推广系列。将 gmv_max_promotion_types 设置为["PRODUCT_GMV_MAX"]，通过 store_ids 指定 TikTok Shop 的 ID，并将 primary_status 设置为 STATUS_DELIVERY_OK。若想暂停这些推广系列，可使用/campaign/status/update/，并将operation_status设置为 DISABLE。
- 对于推广 TikTok Shop 中特定商品的商品 GMV Max 推广系列，请确保每个商品仅用于一个处于启用状态的商品 GMV Max 推广系列。您可以为同一个 TikTok Shop 创建多个商品 GMV Max 推广系列，只要这些推广系列推广不同的商品。
- 若想确认不存在占用了某个 TikTok Shop 中的特定商品的处于启用状态的商品 GMV Max 推广系列，可使用/store/product/get/。将ad_creation_eligible设置为 GMV_MAX 并查看您想要推广的商品的 item_group_id 对应的 gmv_max_ads_status 值是否为 UNOCCUPIED 。
iii. （可选）确认 TikTok Shop 及其中的商品未被处于启用状态的视频购物广告或商品购物广告占用。
-
在商品 GMV Max 推广系列中推广来自 TikTok Shop 的所有商品，会导致任何与该商品 GMV Max 推广系列使用相同店铺的现有处于启用状态的视频购物广告或商品购物广告都暂停投放或受到影响，无论这些视频购物广告或商品购物广告创建于哪个广告账号。
若想在商品 GMV Max 推广系列中推广来自该 TikTok Shop 的所有商品 ，可调用 /gmv_max/store/shop_ad_usage_check/来确认该 TikTok Shop 是否已被现有的处于启用状态视频购物广告组或商品购物广告组占用。 -
在商品 GMV Max 推广系列中推广来自 TikTok Shop 的特定商品，会导致任何与该商品 GMV Max 推广系列使用相同商品的现有处于启用状态的视频购物广告或商品购物广告都暂停投放或受到影响，无论这些视频购物广告或商品购物广告创建于哪个广告账号。
若想在商品 GMV Max 推广系列中推广来自该 TikTok Shop 的特定商品，可调用 /gmv_max/store/shop_ad_usage_check/ 来确认这些商品是否已被现有的处于启用状态视频购物广告或商品购物广告组占用。 - 若返回的
is_running_custom_shop_ads为true，您可以调用/gmv_max/occupied_custom_shop_ads/list/并将occupied_asset_type设置为SPU，从而找出正在使用这些商品的处于启用状态的视频购物广告或商品购物广告。
若想了解有关 GMV Max 推广系列互斥规则的更多信息，请参阅 GMV Max 推广系列的互斥规则。
2. 创建商品 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` | `PRODUCT`（商品 GMV Max 推广系列）|
|商品 | 以下任一选项：<ul><li>（推荐）推广 TikTok Shop 中的所有商品 </li><li>推广 TikTok Shop 中的特定商品</li></ul>| `product_specific_type`<br>`item_group_ids` |<ul><li>若想推广 TikTok Shop 中的所有商品，需将 `product_specific_type` 设置为 `ALL` ，且不传入`item_group_ids`。<ul><li>若想确认是否支持推广该 TikTok Shop 中的所有商品，可调用 [/gmv_max/store/shop_ad_usage_check/](1822001084174338.html)，查看返回的 `promote_all_products_allowed` 。 </li></ul></li><li>若想推广 TikTok Shop 中的特定商品，需将`product_specific_type`设置为`CUSTOMIZED_PRODUCTS` ，并通过 `item_group_ids` 指定商品的 SPU ID。<ul><li>若想获取 TikTok Shop 内商品的 SPU ID 列表，可使用[/store/product/get/](1793482248880130.html)。将`ad_creation_eligible`设置为 `GMV_MAX` 并选择 `status` 为 `AVAILABLE` 且 `gmv_max_ads_status` 为 `UNOCCUPIED` 的 `item_group_id`值。</li></ul></li></ul> |
| 定向<br> · 广告位（版位） | 自动广告位 | N/A | N/A <br><br>GMV Max 推广系列自动选择广告位。系统将根据您的其他设置自动配置广告位，并从不同的广 告位中选择高质量流量，来实现更好的广告效果。若想获取 GMV Max 推广系列实际选择的广告位设置，可使用[/campaign/gmv_max/info/](1822000968821762.html)并查看返回的`placements`。|
| 定向<br>· 地域 |店铺的注册国家或地区| N/A |N/A <br><br>GMV Max 推广系列默认投放到您的 TikTok Shop 的注册国家或地区。若想获取 GMV Max 推广系列的确切 地域定向设置，可使用[/campaign/gmv_max/info/](1822000968821762.html)并查看返回的 `location_ids`。|
| 定向<br>· 受众 | 排除不满 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> |
| 创意模式 | 以下任一类型：<ul><li>从最多 3 个视频来源（已授权的作品，即已授权的帖子、联盟作品以及自定义的作品）和最多 20 个 TikTok 账户中自动选择视频</li><li> 手动选择最多 50 个已授权的作品、 50 个要用于自定义的作品的视频或 50 个已授权的作品和要用于自定义的作品的视频的组合</li></ul> | `product_video_specific_type`<br>`identity_list` <br>`affiliate_posts_enabled`<br> `item_list` | <ul><li>若想从 3 个视频来源（授权帖子、联盟作品以及自定义的作品）和最多 20 个 TikTok 账户中自动选择视频，需：<ul><li>`product_video_specific_type` 设置为 `AUTO_SELECTION` 从而自动选择授权帖子以及自定义的作品。</li><li>通过 `identity_list`指定与 TikTok 账户关联的最多 20 个认证身份。<ul><li>若想获取可用于使用同一 TikTok Shop 的商品 GMV Max 推广系列的认证身份列表，可使用 [/gmv_max/identity/get/](1822001101474882.html)，并选择 `product_gmv_max_available` 为 `true` 的认证身份。</li></ul></li><li>如需自动选择自定义作品，你的配置取决于自定义作品的类型：<ul><li>如果你使用<b>推广系列级自定义作品</b>（在创建商品 GMV Max 推广系列过程中将商品关联到视频的帖子），可使用`custom_anchor_video_list`指定最多 200 个用于自动选择的视频。</li><li>如果你使用<b>店铺层级自定义作品</b>（在 TikTok Shop 层级直接将商品关联到视频的帖子），请不要指定`custom_anchor_video_list`。如果关联的商品是投放中推广系列的一部分，那么与该商品关联的视频将会添加到该推广系列。</li><li><p><span style="color:DarkRed"><b>重要提示</b></span>：推广系列级自定义作品功能将在下一 API 版本中弃用。为确保无缝集成，可使用<a href="https://business-api.tiktok.com/portal/docs/create-shop-level-customized-tiktok-posts/v1.3" target="_blank">/gmv_max/creation/custom_anchor_video_list/create/</a>创建店铺层级自定义作品，并使用<a href="https://business-api.tiktok.com/portal/docs/get-customized-tiktok-posts/v1.3" target="_blank">/gmv_max/creation/custom_anchor_video_list/get/</a>和<a href="https://business-api.tiktok.com/portal/docs/get-product-linkage-details-of-videos-in-customized-posts/v1.3" target="_blank">/gmv_max/creation/shop_video/video_anchors/</a>获取自定义作品中视频的详情。</li></ul></li><li>无需传入 `item_list`。</li><li>`affiliate_posts_enabled` 将默认为 `true`，从而为商品 GMV Max 推广系列启用联盟作品。</li></ul></li><li>若想手动选择最多 50 个授权帖子、 50 个要用于自定义的作品的视频或 50 个授权帖子和要用于自定义的作品的视频的组合，需：<ul><li>将 `product_video_specific_type` 设置为 `CUSTOM_SELECTION`。</li><li>通过 `item_list` 指定最多 50 个授权帖子、 50 个要用于自定义的作品的视频或 50 个授权帖子和要用于自定义的作品的视频的组合。<ul><li>如果`item_list`中包含用于推广系列级自定义作品的视频，请同时在`custom_anchor_video_list`中指定这些视频。</li><li>如果`item_list`中包含用于店铺层级自定义作品的视频，则不需要在`custom_anchor_video_list`中指定这些视频。</li><li>若想获取可用于使用同一 TikTok Shop 的商品 GMV Max 推广系列的 TikTok 帖子列表，可使用[/gmv_max/video/get/](1822001168512129.html)。<br><p><span style="color:darkred"><b>注意</b></span>：若 `/gmv_max/video/get/` 返回空列表，可遵循以下步骤将带有商品链接的帖子授权给广告账户：<br>1. 使用 [/tt_video/authorize/](1738376435339265.html) 将帖子授权给广告账户。<br>2. 使用 [/tt_video/info/](1738376324021250.html) 或 [/tt_video/list/](1738376465972226.html) 检查帖子是否带有商品信息（`spu_id`、`spu_name` 和 `store_id`）。</p></li></ul></li><li>无需传入 `identity_list`。</li></ul></li></ul> |
| 推广系列名称 | 指定一个合法的名称 | `campaign_name` | 传入合法值 |
示例
推广 TikTok Shop 中的所有商品且从已授权的作品、联盟作品和自定义的作品自动选择视频
请求
(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": "PRODUCT",
//promote all products using the "ALL" value
"product_specific_type": "ALL",
"optimization_goal": "VALUE",
"deep_bid_type": "VO_MIN_ROAS",
"roas_bid": "{{roas_bid}}",
"budget": "{{budget}}",
"schedule_type": "SCHEDULE_START_END",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_end_time": "{{schedule_end_time}}",
"product_video_specific_type": "AUTO_SELECTION",
"identity_list":[
{
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER"
},
{
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT"
},
{
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT"
}
],
//specify the videos to be auto-selected for customized posts
//authorized posts will be automatically pulled
//"affiliate_posts_enabled" will default to "true" to automatically pull affiliate posts
"custom_anchor_video_list": [
{
"identity_info": {
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER"
},
"item_id": "{{item_id}}",
"spu_id_list": [
"{{spu_id}}"
]
}
],
"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}}",
"affiliate_posts_enabled": true,
"age_groups": [
"AGE_18_24",
"AGE_25_34",
"AGE_35_44",
"AGE_45_54",
"AGE_55_100"
],
"budget": "{{budget}}",
"campaign_custom_anchor_video_id": "{{campaign_custom_anchor_video_id}}",
"campaign_id": "{{campaign_id}}",
"campaign_name": "{{campaign_name}}",
"custom_anchor_video_list": [
{
"identity_info": {
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER"
},
"item_id": "{{item_id}}",
"spu_id_list": [
"{{spu_id}}"
]
}
],
"deep_bid_type": "VO_MIN_ROAS",
"identity_list": [
{
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER"
},
{
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT"
},
{
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT"
}
],
"item_list": [],
"location_ids": [
"6252001"
],
"operation_status": "ENABLE",
"optimization_goal": "VALUE",
"placements": [
"PLACEMENT_TIKTOK"
],
"product_specific_type": "ALL",
"product_video_specific_type": "AUTO_SELECTION",
"roas_bid": "{{roas_bid}}",
"schedule_end_time": "{{schedule_end_time}}",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_type": "SCHEDULE_START_END",
"shopping_ads_type": "PRODUCT",
"store_authorized_bc_id": "{{store_authorized_bc_id}}",
"store_id": "{{store_id}}"
}
}
(/code)
推广 TikTok Shop 中的所有商品且从已授权的作品和联盟作品自动选择视频
请求
(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": "PRODUCT",
//promote all products using the "ALL" value
"product_specific_type": "ALL",
"optimization_goal": "VALUE",
"deep_bid_type": "VO_MIN_ROAS",
"roas_bid": {{roas_bid}},
"budget": {{budget}},
"schedule_type": "SCHEDULE_START_END",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_end_time": "{{schedule_end_time}}",
"product_video_specific_type": "AUTO_SELECTION",
"identity_list": [
{
"identity_id": "{{identity_id}}",
"identity_type": "TTS_TT",
"store_id": "{{store_id}}"
},
{
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER"
},
{
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT"
}
],
//authorized posts will be automatically pulled
//"affiliate_posts_enabled" will default to "true" to automatically pull affiliate posts
"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}}",
"affiliate_posts_enabled": true,
"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_id": "{{identity_id}}",
"identity_type": "TTS_TT",
"store_id": "{{store_id}}"
},
{
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER"
},
{
"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"
],
"product_specific_type": "ALL",
"product_video_specific_type": "AUTO_SELECTION",
"roas_bid": {{roas_bid}},
"schedule_end_time": "{{schedule_end_time}}",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_type": "SCHEDULE_START_END",
"shopping_ads_type": "PRODUCT",
"store_authorized_bc_id": "{{store_authorized_bc_id}}",
"store_id": "{{store_id}}"
}
}
(/code)
推广 TikTok Shop 中的特定商品且从已授权的作品、联盟作品和自定义的作品自动选择视频
请求
(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": "PRODUCT",
//promote specific products using the "CUSTOMIZED_PRODUCTS" value and the parameter"item_group_ids"
"product_specific_type": "CUSTOMIZED_PRODUCTS",
"item_group_ids":[ "{{item_group_id}}", "{{item_group_id}}"],
"optimization_goal": "VALUE",
"deep_bid_type": "VO_MIN_ROAS",
"roas_bid": "{{roas_bid}}",
"budget": "{{budget}}",
"schedule_type": "SCHEDULE_START_END",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_end_time": "{{schedule_end_time}}",
"product_video_specific_type": "AUTO_SELECTION",
"identity_list":[
{
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER"
},
{
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT"
},
{
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT"
}
],
//specify the videos to be auto-selected for customized posts
//authorized posts will be automatically pulled
//"affiliate_posts_enabled" will default to "true" to automatically pull affiliate posts
"custom_anchor_video_list": [
{
"identity_info": {
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER"
},
"item_id": "{{item_id}}",
"spu_id_list": [
"{{spu_id}}"
]
}
],
"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}}",
"affiliate_posts_enabled": true,
"age_groups": [
"AGE_18_24",
"AGE_25_34",
"AGE_35_44",
"AGE_45_54",
"AGE_55_100"
],
"budget": {{budget}},
"campaign_custom_anchor_video_id": "{{campaign_custom_anchor_video_id}}",
"campaign_id": "{{campaign_id}}",
"campaign_name": "{{campaign_name}}",
"custom_anchor_video_list": [
{
"identity_info": {
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER"
},
"item_id": "{{item_id}}",
"spu_id_list": [
"{{spu_id}}"
]
}
],
"deep_bid_type": "VO_MIN_ROAS",
"identity_list": [
{
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER"
},
{
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT"
},
{
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT"
}
],
"item_group_ids": [
"{{item_group_id}}",
"{{item_group_id}}"
],
"item_list": [],
"location_ids": [
"6252001"
],
"operation_status": "ENABLE",
"optimization_goal": "VALUE",
"placements": [
"PLACEMENT_TIKTOK"
],
"product_specific_type": "CUSTOMIZED_PRODUCTS",
"product_video_specific_type": "AUTO_SELECTION",
"roas_bid": "{{roas_bid}}",
"schedule_end_time": "{{schedule_end_time}}",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_type": "SCHEDULE_START_END",
"shopping_ads_type": "PRODUCT",
"store_authorized_bc_id": "{{store_authorized_bc_id}}",
"store_id": "{{store_id}}"
}
}
(/code)
推广 TikTok Shop 中的特定商品且从已授权的作品和联盟作品自动选择视频
请求
(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": "PRODUCT",
//promote specific products using the "CUSTOMIZED_PRODUCTS" value and the parameter"item_group_ids"
"product_specific_type": "CUSTOMIZED_PRODUCTS",
"item_group_ids":["{{item_group_id}}","{{item_group_id}}"],
"optimization_goal": "VALUE",
"deep_bid_type": "VO_MIN_ROAS",
"roas_bid": {{roas_bid}},
"budget": {{budget}},
"schedule_type": "SCHEDULE_START_END",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_end_time": "{{schedule_end_time}}",
"product_video_specific_type": "AUTO_SELECTION",
"identity_list": [
{
"identity_id": "{{identity_id}}",
"identity_type": "TTS_TT",
"store_id": "{{store_id}}"
},
{
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER"
},
{
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT"
}
],
//authorized posts will be automatically pulled
//"affiliate_posts_enabled" will default to "true" to automatically pull affiliate posts
"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}}",
"affiliate_posts_enabled": true,
"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_id": "{{identity_id}}",
"identity_type": "TTS_TT",
"store_id": "{{store_id}}"
},
{
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER"
},
{
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT"
}
],
"item_group_ids": [
"{{item_group_id}}",
"{{item_group_id}}"
],
"item_list": [],
"location_ids": [
"1562822"
],
"operation_status": "ENABLE",
"optimization_goal": "VALUE",
"placements": [
"PLACEMENT_TIKTOK"
],
"product_specific_type": "CUSTOMIZED_PRODUCTS",
"product_video_specific_type": "AUTO_SELECTION",
"roas_bid": {{roas_bid}},
"schedule_end_time": "{{schedule_end_time}}",
"schedule_start_time": "{{chedule_start_time}}",
"schedule_type": "SCHEDULE_START_END",
"shopping_ads_type": "PRODUCT",
"store_authorized_bc_id": "{{store_authorized_bc_id}}",
"store_id": "{{store_id}}"
}
}
(/code)
推广 TikTok Shop 中的所有商品且从已授权的作品和自定义的作品手动选择视频
请求
(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": "PRODUCT",
//promote all products using the "ALL" value
"product_specific_type": "ALL",
"optimization_goal": "VALUE",
"deep_bid_type": "VO_MIN_ROAS",
"roas_bid": "{{roas_bid}}",
"budget": "{{budget}}",
"schedule_type": "SCHEDULE_START_END",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_end_time": "{{schedule_end_time}}",
"product_video_specific_type": "CUSTOM_SELECTION",
"identity_list":[
{
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER"
},
{
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT"
},
{
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT"
}
],
//specify the manually selected authorized posts and videos to be used in customized posts using "item_list"
// also repeat the videos to be used in customized posts using "custom_anchor_video_list"
// For example, if you want to use one authorized post and one video to be used in a customized post, specify the two videos in "item_list" and repeat the one video for customized post in "custom_anchor_video_list"
"item_list": [
{
"identity_info": {
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT",
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}"
},
"item_id": "{{item_id}}",
"spu_id_list": [
"{{spu_id}}"
],
"video_info": {
"video_id": "{{video_id}}"
}
},
{
"identity_info": {
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER"
},
"item_id": "{{item_id}}",
"spu_id_list": [
"{{spu_id}}"
],
"video_info": {
"video_id": "{{video_id}}"
}
}
],
// specify the videos to be used in customized posts, which are repeated in "item_list", using "custom_anchor_video_list".
"custom_anchor_video_list": [
{
"identity_info": {
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER"
},
"item_id": "{{item_id}}",
"spu_id_list": [
"{{spu_id}}"
],
"video_info": {
"video_id": "{{video_id}}"
}
}
],
"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_custom_anchor_video_id": "{{campaign_custom_anchor_video_id}}",
"campaign_id": "{{campaign_id}}",
"campaign_name": "{{campaign_name}}",
"custom_anchor_video_list": [
{
"identity_info": {
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER"
},
"item_id": "{{item_id}}",
"spu_id_list": [
"{{spu_id}}"
]
}
],
"deep_bid_type": "VO_MIN_ROAS",
"item_list": [
{
"identity_info": {
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"identity_id": "{{identity_id}}",
"identity_type": "BC_AUTH_TT",
"profile_image": "{{profile_image}}",
"user_name": "{{user_name}}"
},
"item_id": "{{item_id}}",
"spu_id_list": [
"{{spu_id}}"
],
"text": "{{text}}",
"video_info": {
"bit_rate": 3240646,
"definition": "1080p",
"duration": 3.367,
"format": "mp4",
"fps": 30,
"height": 1920,
"preview_url": "{{preview_url}}",
"signature": "{{signature}}",
"size": 1363907,
"video_cover_url": "{{video_cover_url}}",
"video_id": "{{video_id}}",
"width": 1080
}
},
{
"identity_info": {
"identity_id": "{{identity_id}}",
"identity_type": "TT_USER",
"profile_image": "{{profile_image}}",
"user_name": "{{user_name}}"
},
"item_id": "{{item_id}}",
"spu_id_list": [
"{{spu_id}}"
],
"text": "{{text}}",
"video_info": {
"bit_rate": 824497,
"definition": "540p",
"duration": 10.444,
"format": "mp4",
"fps": 30,
"height": 960,
"preview_url": "{{preview_url}}",
"signature": "{{signature}}",
"size": 1076382,
"video_cover_url": "{{video_cover_url}}",
"video_id": "{{video_id}}",
"width": 540
}
}
],
"location_ids": [
"6252001"
],
"operation_status": "ENABLE",
"optimization_goal": "VALUE",
"placements": [
"PLACEMENT_TIKTOK"
],
"product_specific_type": "ALL",
"product_video_specific_type": "CUSTOM_SELECTION",
"roas_bid": "{{roas_bid}}",
"schedule_end_time": "{{schedule_end_time}}",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_type": "SCHEDULE_START_END",
"shopping_ads_type": "PRODUCT",
"store_authorized_bc_id": "{{store_authorized_bc_id}}",
"store_id": "{{store_id}}"
}
}
(/code)
推广 TikTok Shop 中的所有商品且从已授权的作品手动选择视频
请求
(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": "PRODUCT",
//promote all products using the "ALL" value
"product_specific_type": "ALL",
"optimization_goal": "VALUE",
"deep_bid_type": "VO_MIN_ROAS",
"roas_bid": {{roas_bid}},
"budget": {{budget}},
"schedule_type": "SCHEDULE_START_END",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_end_time": "{{schedule_end_time}}",
"product_video_specific_type": "CUSTOM_SELECTION",
//specify the manually selected authorized posts using "item_list"
"item_list": [
{
"identity_info": {
"identity_id": "{{identity_id}}",
"identity_type": "TTS_TT",
"store_id": "{{store_id}}"
},
"item_id": "{{item_id}}",
"spu_id_list": [
"{{spu_id}}"
],
"video_info": {
"video_id": "{{video_id}}"
}
},
{
"identity_info": {
"identity_id": "{{identity_id}}",
"identity_type": "TTS_TT",
"store_id": "{{store_id}}"
},
"item_id": "{{item_id}}",
"spu_id_list": [
"{{spu_id}}"
],
"video_info": {
"video_id": "{{video_id}}"
}
}
],
"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",
"item_list": [
{
"identity_info": {
"identity_id": "{{identity_id}}",
"identity_type": "TTS_TT",
"profile_image": "{{profile_image}}",
"store_id": "{{store_id}}",
"user_name": ""
},
"item_id": "{{item_id}}",
"spu_id_list": [
"{{spu_id}}"
],
"text": "{{text}}",
"video_info": {
"bit_rate": 22697262,
"definition": "1080p",
"duration": 4.621,
"format": "mp4",
"fps": 30,
"height": 1080,
"preview_url": "{{preview_url}}",
"signature": "{{signature}}",
"size": 13110506,
"video_cover_url": "{{video_cover_url}}",
"video_id": "{{video_id}}",
"width": 1920
}
},
{
"identity_info": {
"identity_id": "{{identity_id}}",
"identity_type": "TTS_TT",
"profile_image": "{{profile_image}}",
"store_id": "{{store_id}}",
"user_name": ""
},
"item_id": "{{item_id}}",
"spu_id_list": [
"{{spu_id}}"
],
"text": "",
"video_info": {
"bit_rate": 9696015,
"definition": "1080p",
"duration": 2.114,
"format": "mp4",
"fps": 60,
"height": 1080,
"preview_url": "{{preview_url}}",
"signature": "{{signature}}",
"size": 2562172,
"video_cover_url": "{{video_cover_url}}",
"video_id": "{{video_id}}",
"width": 1920
}
}
],
"location_ids": [
"1562822"
],
"operation_status": "ENABLE",
"optimization_goal": "VALUE",
"placements": [
"PLACEMENT_TIKTOK"
],
"product_specific_type": "ALL",
"product_video_specific_type": "CUSTOM_SELECTION",
"roas_bid": 2,
"schedule_end_time": "{{schedule_end_time}}",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_type": "SCHEDULE_START_END",
"shopping_ads_type": "PRODUCT",
"store_authorized_bc_id": "{{store_authorized_bc_id}}",
"store_id": "{{store_id}}"
}
}
(/code)
后续步骤
创建 GMV Max 推广系列后，您可以使用/gmv_max/report/get/请求 GMV Max 推广系列报表。