/display/v2/advertisers/{advertiserId}/campaigns/{campaignId}/display/ad-groups

POST

https://<pcm-domain>/display/v2/advertisers/{advertiserId}/campaigns/{campaignId}/display/ad-groups

Creates an ad-group of type DISPLAY or SPONSORED_BRAND.

The API endpoint GET /display/v2/advertisers/{advertiserId}/campaigns/{campaignId}/eligible/display/targeting can be used to retrieve all the sites, publishers and ad-units targetable by the specified campaign. The creatives in an ad-group must be of the sizes supported by the targeted site.

The ad-unit locations HOME_PAGE, CHECKOUT, EMAIL and EMAIL_ABANDONED_CART are not targeted by default. All other available locations are targeted by default.

Rules:

name of an ad group under a campaign must be unique.
startDate must be before endDate.
startDate must be a present or future date.
dailyBudget must always be less than or equal to budget.
dailyBudget must always be less than or equal to monthBudget.
dailyBudget must always be less than or equal to weeklyBudget.
weeklyBudget must always be less than or equal to budget.
weeklyBudget must always be less than or equal to monthBudget.
monthlyBudget must always be less than or equal to budget.
dailySpendPacing can only be EVEN whenever dailyBudget is set or useDynamicBudget is true.
clickThroughUrl must be a well-formed, reachable and a valid subdomain of the selected site's domain.
targetingGtins A maximum of 20 and 10 products can be targeted for ad-groups of type DISPLAY and SPONSORED_BRAND respectively.

Notes:

useDynamicBudget defaults to false if not passed.
dailySpendPacing defaults to ASAP if not passed.

advertiserIdinteger<int32>

campaignIdinteger<int32>

acceptstringGenerated from available response content types

bodyobject

201Created

401Unauthorized

403Forbidden

404Not Found

curl --request POST \
     --url https://<pcm-domain>/display/v2/advertisers/{advertiserId}/campaigns/{campaignId}/display/ad-groups \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "publisherId": "",
     "name": "",
     "budget": "",
     "startDate": "",
     "targetedSiteIds": [],
     "clickThroughUrl": "",
     "maxBid": "",
     "targetedGtins": [],
     "creatives": [
     {
     "creativeSizeId": "",
     "assetId": ""
     }
     ],
     "type": ""
     }'