AdsApp.​Targeting

  • This page details how to access targeting criteria for campaigns in Google Ads scripts.

  • It provides methods to select various criteria like ad schedules, audiences, locations, languages, platforms, and content labels.

  • Each method specializes the selector to return specific criteria, allowing you to retrieve and work with those settings.

  • The example demonstrates retrieving ad schedules for all campaigns using the adSchedules() method and a loop.

  • Refer to the provided tables for a comprehensive list of available methods and their corresponding return types and descriptions.

Access to the targeting criteria for campaigns.

For example, to select the ad schedules for all campaigns:

var adSchedules = AdsApp.targeting().adSchedules().get();
while (adSchedules.hasNext()) {
  var adSchedule = adSchedules.next();
}

Methods:

MemberTypeDescription
adSchedules() AdsApp.AdScheduleSelector Specializes this selector to return AdSchedule criteria.
audiences() AdsApp.SearchCampaignAudienceSelector Specializes this selector to return SearchCampaignAudience criteria.
excludedAudiences() AdsApp.SearchCampaignExcludedAudienceSelector Specializes this selector to return SearchCampaignExcludedAudience criteria.
excludedContentLabels() AdsApp.ExcludedContentLabelSelector Specializes this selector to return ExcludedContentLabel criteria.
excludedLocations() AdsApp.ExcludedLocationSelector Specializes this selector to return ExcludedLocation criteria.
languages() AdsApp.LanguageSelector Specializes this selector to return Language criteria.
platforms() AdsApp.PlatformSelector Specializes this selector to return Platform criteria.
targetedLocations() AdsApp.TargetedLocationSelector Specializes this selector to return TargetedLocation criteria.
targetedProximities() AdsApp.TargetedProximitySelector Specializes this selector to return TargetedProximity criteria.

adSchedules()

Specializes this selector to return AdSchedule criteria.

Return values:

TypeDescription
AdsApp.AdScheduleSelector A selector for AdSchedule criteria.

audiences()

Specializes this selector to return SearchCampaignAudience criteria.

Return values:

TypeDescription
AdsApp.SearchCampaignAudienceSelector A selector for SearchCampaignAudience criteria.

excludedAudiences()

Specializes this selector to return SearchCampaignExcludedAudience criteria.

Return values:

TypeDescription
AdsApp.SearchCampaignExcludedAudienceSelector A selector for SearchCampaignExcludedAudience criteria.

excludedContentLabels()

Specializes this selector to return ExcludedContentLabel criteria.

Return values:

TypeDescription
AdsApp.ExcludedContentLabelSelector A selector for ExcludedContentLabel criteria.

excludedLocations()

Specializes this selector to return ExcludedLocation criteria.

Return values:

TypeDescription
AdsApp.ExcludedLocationSelector A selector for ExcludedLocation criteria.

languages()

Specializes this selector to return Language criteria.

Return values:

TypeDescription
AdsApp.LanguageSelector A selector for Language criteria.

platforms()

Specializes this selector to return Platform criteria.

Return values:

TypeDescription
AdsApp.PlatformSelector A selector for Platform criteria.

targetedLocations()

Specializes this selector to return TargetedLocation criteria.

Return values:

TypeDescription
AdsApp.TargetedLocationSelector A selector for TargetedLocation criteria.

targetedProximities()

Specializes this selector to return TargetedProximity criteria.

Return values:

TypeDescription
AdsApp.TargetedProximitySelector A selector for TargetedProximity criteria.