/external/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 /external/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 /external/v2/advertisers/{advertiserId}/eligible/site-locations. Make sure to pass the query string parameter adGroupType with value SPA. By default, all eligible sites and locations being available at the time of the ad group creation are targeted.

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.

Notes:

• useDynamicBudget defaults to false if not passed.
• status defaults to PAUSED if not passed.
• defaultBid defaults to 0 if not passed.