AdWordsApp.​SearchAdGroupAudienceBuilder

Builder for SearchAdGroupAudience objects.

Example usage:

 var audienceBuilder = adGroup.targeting().newUserListBuilder();
 var audienceOperation = audienceBuilder
   .withAudienceId(3)              // required
   .withBidModifier(1)             // optional
   .build();                       // add the audience
 var audience = audienceOperation.getResult();

Methods:

MemberTypeDescription
build AdWordsApp.SearchAdGroupAudienceOperation Builds the audience.
exclude AdWordsApp.SearchAdGroupExcludedAudienceOperation Builds the excluded audience.
withAudience AdWordsApp.SearchAdGroupAudienceBuilder Sets the user list of the audience.
withAudienceId AdWordsApp.SearchAdGroupAudienceBuilder Sets the audience ID of the audience.
withBidModifier AdWordsApp.SearchAdGroupAudienceBuilder Sets the bid modifier value for this audience to the specified value.

build()

Builds the audience. Returns a SearchAdGroupAudienceOperation that corresponds to the addition of the SearchAdGroupAudience.

Return values:

TypeDescription
AdWordsApp.SearchAdGroupAudienceOperation The SearchAdGroupAudienceOperation.

exclude()

Builds the excluded audience. Returns an SearchAdGroupExcludedAudienceOperation that corresponds to the addition of the SearchAdGroupExcludedAudience. Use of this method while also setting a bid modifier is not supported.

Return values:

TypeDescription
AdWordsApp.SearchAdGroupExcludedAudienceOperation The SearchAdGroupExcludedAudienceOperation.

withAudience(userList)

Sets the user list of the audience.

Arguments:

NameTypeDescription
userList AdWordsApp.UserList The user list of the audience.

Return values:

TypeDescription
AdWordsApp.SearchAdGroupAudienceBuilder An audience builder with the specified user list.

withAudienceId(audienceId)

Sets the audience ID of the audience. This field is required. User List IDs (List IDs) are available on the details page of a User List (found under the Audiences section of the Shared Library).

Arguments:

NameTypeDescription
audienceId Long The audience ID of the audience.

Return values:

TypeDescription
AdWordsApp.SearchAdGroupAudienceBuilder An audience builder for the specified audience ID.

withBidModifier(modifier)

Sets the bid modifier value for this audience to the specified value.

The bid modifier is a multiplier applied to the audience's bids, with an acceptable range from 0.1 (a 90% decrease) to 10.0 (a 900% increase).

For more information about bid modifiers please see the AdWords Help Center article.

Use of this method when adding an excluded audience is not supported.

Arguments:

NameTypeDescription
modifier double The bid modifier value.

Return values:

TypeDescription
AdWordsApp.SearchAdGroupAudienceBuilder An audience builder configured to use the specified bid modifier.

发送以下问题的反馈:

此网页
AdWords Scripts
AdWords Scripts
需要帮助?请访问我们的支持页面