TOOL 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 credits

Call information

Tool slug
tiktok-ads.campaign_gmv_max_session_create
Provider
TikTok for Business
Average response
0 ms
Calls in 7 days
0

Input parameters

advertiser_idrequired

Advertiser ID.

campaign_idrequired

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"]}`.

sessionrequired

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_idrequired

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