AdsApp.Audience
Stay organized with collections
Save and categorize content based on your preferences.
Represents a Google Ads audience. Methods:
bidding()
Provides access to this audience's bidding fields. Return values:
getAdGroup()
Returns the ad group to which this audience belongs. Return values:
getAudienceId()
Returns the audience ID of the audience. User List IDs (List IDs) are
available on the details page of a User List (found under the Audiences
section of the Shared Library). Return values:
getAudienceType()
Returns the type of the audience, either USER_INTEREST
or USER_LIST
. Return values:
getBaseAdGroup()
Returns the base ad group to which this audience belongs. Return values:
getBaseCampaign()
Returns the base campaign to which this audience belongs. Return values:
getCampaign()
Returns the campaign to which this audience belongs or null
if it does not belong to a search or display campaign. Return values:
getId()
Returns the ID of the audience. Return values:
getResourceName()
Returns the resource name of the audience. Return values:
getStatsFor(dateRange)
Returns stats for the specified date range. Supported values: TODAY, YESTERDAY, LAST_7_DAYS, THIS_WEEK_SUN_TODAY, LAST_WEEK,
LAST_14_DAYS, LAST_30_DAYS, LAST_BUSINESS_WEEK, LAST_WEEK_SUN_SAT,
THIS_MONTH, LAST_MONTH, ALL_TIME
.
Example:
var
stats
=
audience
.
getStatsFor
(
"THIS_MONTH"
);
Arguments:
Return values:
getStatsFor(dateFrom, dateTo)
Returns stats for the specified custom date range. Both parameters can be
either an object containing year, month, and day fields, or an 8-digit
string in YYYYMMDD
form. For instance, March 24th,
2013
is represented as either {year: 2013, month: 3, day:
24}
or "20130324"
. The date range is inclusive on both
ends, so forDateRange("20130324", "20130324")
defines a range
of a single day. Arguments:
Return values:
isEnabled()
Returns true
if the audience is enabled. Return values:
isPaused()
Returns true
if the audience is paused. Return values:
remove()
Removes the audience. Returns nothing.
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-09-03 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-09-03 UTC."],[[["\u003cp\u003eRepresents a Google Ads audience, providing methods to access and manage its properties.\u003c/p\u003e\n"],["\u003cp\u003eAllows retrieval of audience details like ID, type (\u003ccode\u003eUSER_INTEREST\u003c/code\u003e or \u003ccode\u003eUSER_LIST\u003c/code\u003e), and associated ad groups/campaigns.\u003c/p\u003e\n"],["\u003cp\u003eEnables access to audience performance statistics for specified date ranges.\u003c/p\u003e\n"],["\u003cp\u003eOffers methods to check if the audience is enabled or paused, and to remove it.\u003c/p\u003e\n"],["\u003cp\u003eProvides access to the audience's bidding fields for adjustments.\u003c/p\u003e\n"]]],[],null,[]]
