AI-generated Key Takeaways
-
Provides access to ad group-level targeting criteria, specifically audiences and excluded audiences, allowing for refined campaign reach.
-
Enables management of targeting settings for user interest and list criterion type groups, controlling how ads are served to specific audiences.
-
Offers a builder to create and manage new user lists within the ad group, facilitating custom audience targeting strategies.
-
Includes methods to retrieve and adjust targeting settings, ensuring ads are shown to the desired audience segments with optimal bidding strategies.
-
Grants access to both audiences and excluded audiences via dedicated selectors, providing flexibility in audience management for campaigns.
Methods:
| Member | Type | Description |
|---|---|---|
| audiences() | AdsApp.SearchAdGroupAudienceSelector |
Specializes this selector to return SearchAdGroupAudience criteria. |
| excludedAudiences() | AdsApp.SearchAdGroupExcludedAudienceSelector |
Specializes this selector to return SearchAdGroupExcludedAudience criteria. |
| getTargetingSetting(criterionTypeGroup) | String |
Returns the current targeting setting of the specified criterion type group for this ad group. |
| newUserListBuilder() | AdsApp.SearchAdGroupAudienceBuilder |
Returns a new user list builder for this ad group. |
| setTargetingSetting(criterionTypeGroup, targetingSetting) | void |
Sets the targeting setting for this ad group. |
audiences()
Specializes this selector to return SearchAdGroupAudience
criteria. Return values:
| Type | Description |
|---|---|
AdsApp.SearchAdGroupAudienceSelector |
A selector for SearchAdGroupAudience criteria. |
excludedAudiences()
Specializes this selector to return SearchAdGroupExcludedAudience
criteria. Return values:
| Type | Description |
|---|---|
AdsApp.SearchAdGroupExcludedAudienceSelector |
A selector for SearchAdGroupExcludedAudience criteria. |
getTargetingSetting(criterionTypeGroup)
Returns the current targeting setting of the specified criterion type group
for this 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 builder for this ad group. When SearchAdGroupAudienceBuilder.build()
is called, an audience will be added in this ad group. When SearchAdGroupAudienceBuilder.exclude()
is called, an excluded audience will be added in this ad group. Return values:
| Type | Description |
|---|---|
AdsApp.SearchAdGroupAudienceBuilder |
The builder used to add or exclude an 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'. |