Contents

Ad Groups

Create and manage ad groups.

Overview

An ad group is a collection of criteria that defines who sees your ad in App Store search results. A basic ad group includes a startTime, endTime, and dailyBudgetAmount. You can add bid amounts, TargetingDimensions, and Targeting Keywords and Negative Keywords. Use the Search for Geolocations endpoint to find localities to use for targeting dimensions within ad groups.

Build a Campaign Keywords Strategy

When building a campaign promotion strategy, you define keywords relevant to your app and bid on them. Relevant keywords increase the viability of your app to rank high in user searches. You can either automate your keyword and bid strategy by using the Search Match feature, or use your own keywords and bid strategy.

The Search Match feature is an algorithm that uses multiple resources to match your ad to relevant searches in the App Store. The resources include metadata from your App Store product page, information about similar apps in the same genre, and other available search data. Search Match is a good option if you don’t want to figure out all keyword possibilities and actively bid on them.

[Image]

Enable and Disable Search Match

To enable Search Match, use Create an Ad Group or Update an Ad Group endpoints to perform the following steps:

  1. Set automatedKeywordsOptIn: true.

  2. Set the required field defaultBidAmount.

If you’re using your own keywords and bid strategy, disable Search Match using Create an Ad Group or Update an Ad Group endpoints using the following steps:

  1. Set automatedKeywordsOptIn: false.

  2. Set the required field defaultBidAmount.

  3. Use the bidAmount field in Create Targeting Keywords and Update Targeting Keywords endpoints to set a threshold price for a keyword in a bidding auction.

Automated Ad Groups

The Maximize Conversions bid strategy uses an automated ad group with Search Match to automatically optimize bids for each search query. This eliminates the need to manually set and monitor individual keyword bids, while prioritizing keywords most likely to drive conversions.

To create a campaign with a Maximize Conversions bid strategy, see the payload example in Create a Campaign.

To create an automated ad group, see the automated ad group payload example in Create an Ad Group.

For details switching between Max Conversions and manual campaigns, see the payload examples in Update a Campaign.

For reports with a Maximize Conversions bidding strategy, see campaign and ad group Get Campaign-Level Reports and Get Ad Group-Level Reports.

Topics

Ad Group Endpoints

Ad Group Request and Response Objects

Audience Refinement

Data Types

See Also

Campaigns