← 返回目录
📁 API Reference › GMV Max

创建最大投放量或创意作品加热时段

您可以使用本接口为商品 GMV Max 推广系列中的特定商品创建最大投放量时段，或为商品 GMV Max 推广系列中的特定视频创建创意作品加热时段。

  • GMV Max 的最大投放量模式通过追加预算，在选定时段内最大限度提升推广系列中所选商品的总收入。更多详情参考关于 GMV Max 的最大投放量优化。
  • 商品 GMV Max 推广系列中的创意作品加热功能允许商家手动为特定视频配置额外日预算，用于视频推广。

使用前需知

创建最大投放量时段的前提条件

  • 需确保推广系列当前的优化模式为目标 ROI（投资回报率）。可使用/gmv_max/report/get/ 获取推广系列详情，并确认 bid_type 指标为 CUSTOM。了解支持的 GMV Max 推广系列报表指标。
  • 若要获取有效的 campaign_id，您可以使用以下任一方法：
  • 创建新的商品 GMV Max 推广系列。使用/campaign/gmv_max/create/，并将 shopping_ads_type 设置为 PRODUCT。
  • 筛选广告账户中已有的商品 GMV Max 推广系列。使用 /gmv_max/campaign/get/ 并将 filtering 设置为 {"gmv_max_promotion_types":["PRODUCT_GMV_MAX"]}。

### 创建创意作品加热时段的前提条件 - 确保推广系列处于生效状态。 - 若想在广告账户中筛选处于生效状态的商品 GMV Max 推广系列，可使用 /gmv_max/campaign/get/ 并将 filtering 设置为 {"gmv_max_promotion_types":["PRODUCT_GMV_MAX"], "primary_status":"STATUS_DELIVERY_OK"}。 - 确保与希望启用创意作品加热的视频关联的商品当前没有设置最大投放量时段。 - 若想确认这一点，可使用 /campaign/gmv_max/session/list/ 并检查 spu_id 是否绑定了 bid_type 为 NO_BID 的时段。 - 确保已启用创意作品加热的视频少于 100 个。在一个商品 GMV Max 推广系列中，您最多可以为 100 个视频启用创意作品加热。 - 若想确认这一点，可使用 /campaign/gmv_max/session/list/ 并检查 bid_type 为 CREATIVE_NO_BID 且关联了唯一 item_id 的时段数量。 - 确保您想为某个视频创建的创意作品加热时段未与任何现有的创意作品加热时段重叠。每个视频在任意时间只允许一个生效的创意作品加热时段。 - 若想确认这一点，可使用 /campaign/gmv_max/session/list/ 并检查bid_type 为 CREATIVE_NO_BID 的时段的 schedule_start_time 和 schedule_end_time。 - 确保希望启用创意作品加热的视频不处于需要授权、已排除、不可用或拒绝状态。 - 若想确认这一点，可使用 /gmv_max/report/get/ 并检索创意素材层级数据，包括指标 creative_delivery_status。视频的 creative_delivery_status 不可为 AUTHORIZATION_NEEDED、EXCLUDED、REJECTED 或 UNAVAILABLE。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/campaign/gmv_max/session/create/

方法 POST

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。<br>可以通过[获取访问令牌](1738373164380162.html)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式：`application/json`。|

参数

### 对于创建最大投放量时段的参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| advertiser_id {必填} | string | 广告主 ID。 |
| campaign_id {必填} | string | 商品 GMV Max 推广系列的 ID。<br><br><ul><li>若要创建商品 GMV Max 推广系列并获取推广系列 ID，可使用[/campaign/gmv_max/create/](1822000988713089.html)，并将 `shopping_ads_type` 设置为 `PRODUCT`。</li><li>若要筛选广告账户中已有的商品 GMV Max 推广系列，可使用 [/gmv_max/campaign/get/](1826463372290177.html) 并将 `filtering` 设置为 `&#123;"gmv_max_promotion_types":["PRODUCT_GMV_MAX"]&#125;`。</li></ul>|
| store_id {必填} | string | TikTok Shop ID。<br><br>若想获取和 GMV Max 推广系列绑定的 TikTok Shop 的 ID，可使用 [/campaign/gmv_max/info/](1822000968821762.html)。 |
| session {必填} | object | 有关该推广系列最大投放量模式的详情。 |
#| bid_type{必填} | string | 时段类型。<br><br>枚举值: <ul><li>`NO_BID`: 最大投放量时段。参见<a href="#item-link-创建最大投放量时段的前提条件">创建最大投放量时段的前提条件</a>。</li></ul>默认值: `NO_BID`。<br><br><p><span style="color:darkred"><b>注意</b></span>: 若想创建创意作品加热时段，请参阅<a href="#item-link-对于创建创意作品加热时段的参数">对于创建创意作品加热时段的参数</a>并将 `bid_type` 设置为 `CREATIVE_NO_BID`。</p> |
#| product_list {必填} | object[] | 有关特定商品的详情。<br><br>最大数量：1。 |
##| spu_id {必填} | string | 商品 SPU（标准化产品单元） ID。<br><br>若想获取 TikTok Shop 内商品的 SPU ID 列表，可使用[/store/product/get/](1793482248880130.html)。将 `ad_creation_eligible` 设置为 `GMV_MAX` 并选择 `item_group_id` 值为 `AVAILABLE`。 |
#| budget {必填} | float | 最大投放量日预算。<br>最大投放量使用额外的预算，与目标 ROI 优化的预算分开，并按照更可预测的广告支出节奏进行投放。在启用最大投放量时，您的目标 ROI 预算将不会用于采用最大投放量的商品。<br><br>取值范围：≥ 10（USD）。 |
#| schedule_type | string | 最大投放量的排期类型。<br><br>枚举值：<ul><li>`SCHEDULE_FROM_NOW`：从 `schedule_start_time` 开始，为该商品持续启用最大投放量模式，直到推广系列的排期结束时间。</li><li>`SCHEDULE_START_END`：在 `schedule_start_time` 和 `schedule_end_time` 排期期间为该商品启用最大投放量模式。</li></ul><br>默认值：`SCHEDULE_FROM_NOW`。 |
#| schedule_start_time | string | 最大投放量模式的开始时间，格式为 `YYYY-MM-DD HH:MM:SS` （UTC+0）。<br><br>若未指定本字段，本字段默认为当前时间。<br><br><p><span style="color:darkred"><b>注意</b></span>: <ul><li>开始时间不能早于当前时间。</li><li>开始时间应晚于或等于推广系列的开始时间。</li><li>您的每日预算将在全天内均匀分配。如果某一天内的最大投放量优化时长不足 24 小时，您的预算仍将全部消耗。</li><li>在您为选定商品设置的开始和结束时间之间，最大投放量优化将保持启用状态。如果在最大投放量优化结束时，您的推广系列仍然处于有效状态，这些商品的优化模式将自动切换回目标 ROI。</li></ul> |
#| schedule_end_time {+条件必填} | string | <ul><li>当 `schedule_type` 为 `SCHEDULE_START_END` 时本字段必填。</li><li>当 `schedule_type` 为 `SCHEDULE_FROM_NOW` 时不支持本字段。</li></ul><br>最大投放量模式的结束时间，格式为 `YYYY-MM-DD HH:MM:SS` （UTC+0）。<br><br><p><span style="color:darkred"><b>注意</b></span>: <ul><li>结束时间不能早于当前时间。</li><li>结束时间应早于或等于推广系列的结束时间。</li></ul> |

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/gmv_max/session/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "store_id": "{{store_id}}",
    "campaign_id": "{{campaign_id}}",
    "session":{
        "bid_type":"NO_BID",
        "product_list":[
            {
                "spu_id": "{{spu_id}}"
            }
        ],
        "budget": {{budget}},
        "schedule_start_time": "{{schedule_start_time}}"
    }
}'
(/code)

### 对于创建创意作品加热时段的参数

|字段{30%}|数据类型{15%}|描述{55%}|
|--- |--- |--- |
| advertiser_id  {必填} | string | 广告主 ID。 |
| campaign_id  {必填} | string | 商品 GMV Max 推广系列的 ID。<br><br><ul><li>若要创建商品 GMV Max 推广系列并获取推广系列 ID，可使用 [/campaign/gmv_max/create/](1822000988713089.html) 并将 `shopping_ads_type` 设置为 `PRODUCT`。</li><li>若要筛选广告账户中已有的商品 GMV Max 推广系列，可使用 [/gmv_max/campaign/get/](1826463372290177.html) 并将 `filtering` 设置为 `&#123;"gmv_max_promotion_types":["PRODUCT_GMV_MAX"]&#125;`。</li></ul>|
| store_id  {必填} | string | TikTok Shop ID。<br><br>若想获取和 GMV Max 推广系列绑定的 TikTok Shop 的 ID，可使用 [/campaign/gmv_max/info/](1822000968821762.html)。 |
| session  {必填} | object | 有关该推广系列创意作品加热设置的详情。 |
#| bid_type{必填} | string | 时段类型。<br><br>枚举值: <ul><li>`CREATIVE_NO_BID`: 创意作品加热时段。参见<a href="#item-link-创建创意作品加热时段的前提条件">创建创意作品加热时段的前提条件</a>。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>: 若想创建最大投放量时段，请参阅<a href="#item-link-对于创建最大投放量时段的参数">对于创建最大投放量时段的参数</a>并将 `bid_type` 设置为 `NO_BID` 或不传入 `bid_type`。</p> |
#| product_list {必填}  | object[] | 有关特定商品的详情。<br><br>最大数量: 1。 |
##| spu_id {必填}  | string | 商品 SPU（标准化产品单元） ID。<br><br>若想获取 TikTok Shop 内商品的 SPU ID 列表，可使用 [/store/product/get/](1793482248880130.html) 并将 `ad_creation_eligible` 设置为 `GMV_MAX` 并选择 `item_group_id` 值为 `AVAILABLE`。 |
#| item_id{必填} | string | 要启用创意作品加热的视频的 ID。<br><br>若想获取现有 GMV Max 推广系列中 TikTok 视频的列表，可使用 [/gmv_max/report/get/](1824721673497601.html) 并[检索创意素材层级数据](https://business-api.tiktok.com/portal/docs?id=1824722485971009#item-link-%E5%88%9B%E6%84%8F%E7%B4%A0%E6%9D%90%E5%B1%82%E7%BA%A7%E6%8C%87%E6%A0%87)。您可通过 `item_id` 指标获取 TikTok 视频的 ID。需确保视频的 `creative_delivery_status` 不是 `AUTHORIZATION_NEEDED`、`EXCLUDED`、`REJECTED` 或 `UNAVAILABLE`。 |
#| budget{必填} | float | 创意作品加热的日预算。<br>创意作品加热使用的预算独立于推广系列的预算，在整个排期内按一定的节奏消耗，以实现更可预测的广告支出。<br><br>创意作品加热预算不纳入推广系列投资回报率（ROI）保障的计算范围。 <br><br>取值范围: ≥ 10 (USD)。 |
#| schedule_type{必填} | string | 创意作品加热的排期类型。<br><br>枚举值: <ul><li>`SCHEDULE_FROM_NOW`: 从现在开始为视频持续启用创意作品加热模式，直到推广系列的排期结束时间。</li><li>`SCHEDULE_START_END`: 在现在和 `schedule_end_time` 排期期间为视频启用创意作品加热模式。</li></ul>默认值: `SCHEDULE_FROM_NOW`。 |
#| schedule_end_time{+条件必填} | string | <ul><li> 当 `schedule_type` 为 `SCHEDULE_START_END` 时本字段必填。</li><li>当 `schedule_type` 为 `SCHEDULE_FROM_NOW` 时不支持本字段。</li></ul><br>创意作品加热模式的结束时间，格式为 `YYYY-MM-DD HH:MM:SS` (UTC+0)。<br><br><p><span style="color:darkred"><b>注意</b></span>: <ul><li>结束时间不能早于当前时间。</li><li>结束时间应早于或等于推广系列的结束时间。</li></ul></p> |

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/campaign/gmv_max/session/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": "{{advertiser_id}}",
    "store_id": "{{store_id}}",
    "campaign_id": "{{campaign_id}}",
    "session":{
        "bid_type":"CREATIVE_NO_BID",
        "product_list":[
            {
                "spu_id": "{{spu_id}}"
            }
        ],
        "item_id":"{{item_id}}",
        "budget": {{budget}}
    }
}'
(/code)

返回

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number| 返回码。完整返回码列表及描述，参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string| 返回信息。更多信息参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|request_id |string| 请求的日志 ID，唯一标识一个请求。 |
|data |object| 返回数据。 |
#|session_id| string |商品 GMV Max 推广系列中商品的最大投放量时段 ID 或视频的创意作品加热时段 ID。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "session_id": "{{session_id}}"
    }
}
(/code)
← 获取推广系列中的最大投放量或创意作品加热时段获取 GMV Max 推广系列可用的 TikTok Shop →

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