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

POST

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

Creates a SPA ad group.

The ad group can be only associated to publishers the user has access to, publishers being associated to the advertiser of the ad group and publishers having a product feed in the market of the ad groups campaign. The eligible values for publisherId can be retrieved from the API endpoint GET /v2/advertisers/{advertiserId}/eligible/publisher-markets. Make sure to pass the query string parameter marketId representing the market of the ad groups campaign as well as adGroupType with value SPA.

The ad group can only target sites available for the ad groups publisher and campaigns market. The site must contain at least one SPA ad unit. Furthermore, the ad group can only target locations available in the site the ad group is targeting. The eligible values for targetingSiteIds and targetingLocations can be retrieved from the API endpoint GET /v2/advertisers/{advertiserId}/eligible/site-locations. Make sure to pass the query string parameter adGroupType with value SPA. By default, all eligible sites are targeted available at the time of the ad group creation are targeted. The locations HOME_PAGE, CHECKOUT and EMAIL 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.

Notes:

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

advertiserIdinteger<int32>

campaignIdinteger<int32>

bodyobject

200OK

401Unauthorized

403Forbidden

404Not Found

409Conflict

422Unprocessable Entity

curl --request POST \
     --url https://<pcm-domain>/v2/advertisers/{advertiserId}/campaigns/{campaignId}/spa/ad-groups \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "publisherId": 0,
     "name": "",
     "startDate": "",
     "budget": "",
     "bidOptimization": ""
     }'