AdsApp.ShoppingCampaignAudienceBuilder
Stay organized with collections
Save and categorize content based on your preferences.
Builder for
ShoppingCampaignAudience
objects.
Example usage:
var audienceBuilder = shoppingCampaign.targeting().newUserListBuilder();
var audienceOperation = audienceBuilder
.withAudienceId(3) // required
.build(); // add the audience
var audience = audienceOperation.getResult();
Methods:
build()
Builds the audience. Returns a
ShoppingCampaignAudienceOperation
that corresponds to the addition of the
ShoppingCampaignAudience.
Return values:
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:
Name | Type | Description |
audienceId |
String |
The audience ID of the audience. |
Return values:
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 Google Ads Help
Center article.
Arguments:
Name | Type | Description |
modifier |
double |
The bid modifier value. |
Return values:
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-25 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eThis page documents the \u003ccode\u003eShoppingCampaignAudienceBuilder\u003c/code\u003e, used for creating or modifying Shopping Campaign Audiences in Google Ads Scripts.\u003c/p\u003e\n"],["\u003cp\u003eThe builder allows setting the \u003ccode\u003eaudienceId\u003c/code\u003e, which is required, and optionally setting a \u003ccode\u003ebidModifier\u003c/code\u003e to adjust bids for the audience.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ebuild()\u003c/code\u003e method finalizes the audience configuration and returns a \u003ccode\u003eShoppingCampaignAudienceOperation\u003c/code\u003e to execute the changes.\u003c/p\u003e\n"]]],[],null,["Builder for [ShoppingCampaignAudience](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingcampaignaudience) objects.\n\nExample usage:\n\n```gdscript\nvar audienceBuilder = shoppingCampaign.targeting().newUserListBuilder();\nvar audienceOperation = audienceBuilder\n .withAudienceId(3) // required\n .build(); // add the audience\nvar audience = audienceOperation.getResult();\n```\n\nMethods:\n\n| Member | Type | Description |\n|---------------------------------------|--------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------|\n| [build](#build_0) | [AdsApp.ShoppingCampaignAudienceOperation](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingcampaignaudienceoperation) | Builds the audience. |\n| [withAudienceId](#withAudienceId_1) | [AdsApp.ShoppingCampaignAudienceBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingcampaignaudiencebuilder) | Sets the audience ID of the audience. |\n| [withBidModifier](#withBidModifier_1) | [AdsApp.ShoppingCampaignAudienceBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingcampaignaudiencebuilder) | Sets the bid modifier value for this audience to the specified value. |\n\n`build()` Builds the audience. Returns a [ShoppingCampaignAudienceOperation](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingcampaignaudienceoperation) that corresponds to the addition of the [ShoppingCampaignAudience](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingcampaignaudience).\n\nReturn values:\n\n| Type | Description |\n|--------------------------------------------------------------------------------------------------------------------------------|----------------------------------------|\n| [AdsApp.ShoppingCampaignAudienceOperation](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingcampaignaudienceoperation) | The ShoppingCampaignAudienceOperation. |\n\n`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).\n\nArguments:\n\n| Name | Type | Description |\n|------------|----------|----------------------------------|\n| audienceId | `String` | The audience ID of the audience. |\n\nReturn values:\n\n| Type | Description |\n|----------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------|\n| [AdsApp.ShoppingCampaignAudienceBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingcampaignaudiencebuilder) | An audience builder for the specified audience ID. |\n\n`withBidModifier(modifier)` Sets the bid modifier value for this audience to the specified value.\n\nThe bid modifier is a multiplier applied to the audience's bids, with an\nacceptable range from `0.1` (a `90%` decrease) to\n`10.0` (a `900%` increase).\n\nFor more information about bid modifiers please see the [Google Ads Help\nCenter article](//support.google.com/google-ads/answer/2732132).\n\nArguments:\n\n| Name | Type | Description |\n|----------|----------|-------------------------|\n| modifier | `double` | The bid modifier value. |\n\nReturn values:\n\n| Type | Description |\n|----------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------|\n| [AdsApp.ShoppingCampaignAudienceBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingcampaignaudiencebuilder) | An audience builder configured to use the specified bid modifier. |"]]