AdsApp.​ShoppingAdGroupTargeting

  • You can access ad group-level targeting criteria using the provided methods.

  • The audiences() method specializes the selector to return ShoppingAdGroupAudience criteria.

  • The getTargetingSetting() method returns the current targeting setting for a specified criterion type group.

  • The newUserListBuilder() method returns a builder to add a new user list audience to the ad group.

  • The setTargetingSetting() method sets the targeting setting for a specified criterion type group.

 Access to ad group-level targeting criteria.

For instance, to select all audiences targeted by an ad group you might use: 

var adgroup = AdsApp.shoppingAdGroups().get().next();
var audiences = adgroup.targeting().audiences().get();
while (audiences.hasNext()) {
  var audience = audiences.next();
}

Methods:

MemberTypeDescription
audiences() AdsApp.ShoppingAdGroupAudienceSelector Specializes this selector to return ShoppingAdGroupAudience criteria.
getTargetingSetting(criterionTypeGroup) String Returns the current targeting setting of the specified criterion type group for this shopping ad group.
newUserListBuilder() AdsApp.ShoppingAdGroupAudienceBuilder Returns a new user list audience builder for this ad group.
setTargetingSetting(criterionTypeGroup, targetingSetting) void Sets the targeting setting for this ad group.

audiences()

Specializes this selector to return ShoppingAdGroupAudience criteria.

Return values:

TypeDescription
AdsApp.ShoppingAdGroupAudienceSelector A selector for ShoppingAdGroupAudience criteria.

getTargetingSetting(criterionTypeGroup)

Returns the current targeting setting of the specified criterion type group for this shopping ad group.

Currently the only supported criterion type group value is USER_INTEREST_AND_LIST.

The returned setting will be either 'TARGET_ALL_TRUE' or 'TARGET_ALL_FALSE', corresponding to 'Bid only' and 'Target and bid', respectively.

Arguments:

NameTypeDescription
criterionTypeGroup String The criterion type group to check.

Return values:

TypeDescription
String The targeting setting for the criterion type group, either 'TARGET_ALL_TRUE' or 'TARGET_ALL_FALSE'.

newUserListBuilder()

Returns a new user list audience builder for this ad group. When ShoppingAdGroupAudienceBuilder.build() is called, an audience will be added in this ad group.

Return values:

TypeDescription
AdsApp.ShoppingAdGroupAudienceBuilder The builder used to add a new audience in the ad group.

setTargetingSetting(criterionTypeGroup, targetingSetting)

Sets the targeting setting for this ad group.

Currently the targeting setting may be set for the USER_INTEREST_AND_LIST criterion type group only.

Returns nothing.

Arguments:

NameTypeDescription
criterionTypeGroup String The criterion type group to receive the new setting.
targetingSetting String The new targeting setting, either 'TARGET_ALL_TRUE' or 'TARGET_ALL_FALSE'.