Contents

TargetingDimensions

The optional criteria to use with ad groups to narrow the audience that views your ads.

Declaration

object TargetingDimensions

Properties

NameTypeDescription
adminAreaAdminAreaCriteria

The dimension to target users by adminArea. An adminArea is a state or the equivalent according to its associated country.

Use Search for Geolocations with entity to search for and retrieve geolocations. Then use geotargeting dimensions country, adminArea, and locality in the TargetingDimensions payload with the Create an Ad Group and Update an Ad Group endpoints.

ageAgeCriteria

The dimension to target users by age demographic. Limit the age group you want to show your ad to. You must set a minimum age. To include multiple ranges, input them as a list.****

appCategoriesAppCategoryCriteria

The dimension to include target audience by app category. Only applicable to campaigns using a SupplySource of APPSTORE_PRODUCT_PAGES_BROWSE. See the App Store for more details about categories.

appDownloadersAppDownloaderCriteria

The dimension to include users who have downloaded your app or to exclude users who haven’t downloaded your app. Each campaign can promote only one app per adamId.

countryCountryCriteria

The dimension to target users by country or region.

Use Search for Geolocations with entity to search for and retrieve geolocations. Then use geotargeting dimensions country, adminArea, and locality in the TargetingDimensions payload with the Create an Ad Group and Update an Ad Group endpoints. For the country dimension, use a single country code in an ISO alpha-2 country code format. Campaigns that serve multiple countries or regions can’t use geotargeting. Use UpdateCampaignRequest to clear geotargeting from a campaign.

daypartDaypartCriteria

The dimension to target users by a specific time of day. Numbers ranging from 0 to 167 represent the hours of a week beginning at Sunday 12:00 midnight. For example, the hour beginning Monday at 1:00 a.m. is 25.

deviceClassDeviceClassCriteria

The dimension to target users by device class. This defaults to the device classes that the promoted app supports.

genderGenderCriteria

The dimension to target users by gender demographic. Specify the gender you want to show your ad to. To specify all genders, set the value to null.

localityLocalityCriteria

The dimension to target users by locality. A locality is a city or the equivalent according to its associated adminArea. See Search for Geolocations to retrieve geolocations.

Discussion

Specify targeting criteria in the TargetingDimensions object and apply it to ad groups using Create an Ad Group and Update an Ad Group endpoints.

See Also

Audience Refinement