AdsApp.​ShoppingAdGroupTargeting

AI-generated Key Takeaways

• Access and manage targeting criteria for Shopping ad groups within Google Ads.

• Utilize the provided methods to retrieve, add, and modify audience targeting settings.

• Leverage the targetingSetting property to control bid-only or target-and-bid strategies for user lists and interests.

• Script examples demonstrate how to interact with ad group targeting using the Google Ads Scripts API.

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:

Member	Type	Description
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:

Type	Description
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:

Name	Type	Description
criterionTypeGroup	String	The criterion type group to check.

Return values:

Type	Description
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:

Type	Description
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:

Name	Type	Description
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'.