工具 API

campaign_gmv_max_session_create

Creates a session in a Product GMV Max Campaign for either max delivery on a specific product or creative boost on a specific video. Max delivery uses additional budget to maximize gross revenue for selected products over a selected period. Creative boost lets sellers manually promote specific videos with extra daily budget. Prerequisites vary by `session.bid_type`: for max delivery (`NO_BID`), verify the campaign uses Target ROI by calling `/gmv_max/report/get/` and confirming `bid_type` is `CUSTOM`; obtain a valid Product GMV Max `campaign_id` from `/campaign/gmv_max/create/` with `shopping_ads_type=PRODUCT` or `/gmv_max/campaign/get/` filtered to `gmv_max_promotion_types=["PRODUCT_GMV_MAX"]`. For creative boost (`CREATIVE_NO_BID`), the campaign must be active, there must be no max delivery session already set for the product, there can be at most 100 creative boost videos per Product GMV Max Campaign, the new session must not overlap any existing creative boost session for the same video, and the video must not have `creative_delivery_status` of `AUTHORIZATION_NEEDED`, `EXCLUDED`, `REJECTED`, or `UNAVAILABLE`. Use `/campaign/gmv_max/session/list/` to check existing sessions and `/gmv_max/report/get/` to check creative-level status.

ecommerceOAuth1 积分

调用信息

工具标识
tiktok-ads.campaign_gmv_max_session_create
服务提供方
TikTok 广告
平均响应
0 ms
近 7 天调用
0

输入参数

advertiser_id必填

Advertiser ID.

campaign_id必填

ID of the Product GMV Max Campaign. To create and obtain a campaign ID, use `/campaign/gmv_max/create/` with `shopping_ads_type` set to `PRODUCT`. To find existing Product GMV Max campaigns, use `/gmv_max/campaign/get/` with `filtering={"gmv_max_promotion_types":["PRODUCT_GMV_MAX"]}`.

session必填

Session details for either max delivery or creative boost. The required and supported nested fields depend on `bid_type`: use `NO_BID` or omit `bid_type` for a max delivery session, and use `CREATIVE_NO_BID` for a creative boost session.

store_id必填

ID of the TikTok Shop associated with the GMV Max campaign. Obtain this ID using `/campaign/gmv_max/info/`.