- JSON representation
- AudienceStatus
- AudienceDimension
- AgeDimension
- AgeSegment
- GenderDimension
- HouseholdIncomeDimension
- ParentalStatusDimension
- AudienceSegmentDimension
- AudienceSegment
- UserListSegment
- UserInterestSegment
- LifeEventSegment
- DetailedDemographicSegment
- CustomAudienceSegment
- AudienceExclusionDimension
- ExclusionSegment
Audience is an effective targeting option that lets you intersect different segment attributes, such as detailed demographics and affinities, to create audiences that represent sections of your target segments.
JSON representation |
---|
{ "resourceName": string, "id": string, "status": enum ( |
Fields | |
---|---|
resourceName |
Immutable. The resource name of the audience. Audience names have the form:
|
id |
Output only. ID of the audience. |
status |
Output only. Status of this audience. Indicates whether the audience is enabled or removed. |
name |
Required. Name of the audience. It should be unique across all audiences. It must have a minimum length of 1 and maximum length of 255. |
description |
Description of this audience. |
dimensions[] |
Positive dimensions specifying the audience composition. |
exclusionDimension |
Negative dimension specifying the audience composition. |
AudienceStatus
Enum containing possible audience status types.
Enums | |
---|---|
UNSPECIFIED |
Not specified. |
UNKNOWN |
Used for return value only. Represents value unknown in this version. |
ENABLED |
Enabled status - audience is enabled and can be targeted. |
REMOVED |
Removed status - audience is removed and cannot be used for targeting. |
AudienceDimension
Positive dimension specifying user's audience.
JSON representation |
---|
{ // Union field |
Fields | |
---|---|
Union field dimension . Dimension specifying users who belong to the audience. dimension can be only one of the following: |
|
age |
Dimension specifying users by their age. |
gender |
Dimension specifying users by their gender. |
householdIncome |
Dimension specifying users by their household income. |
parentalStatus |
Dimension specifying users by their parental status. |
audienceSegments |
Dimension specifying users by their membership in other audience segments. |
AgeDimension
Dimension specifying users by their age.
JSON representation |
---|
{
"ageRanges": [
{
object ( |
Fields | |
---|---|
ageRanges[] |
Contiguous age range to be included in the dimension. |
includeUndetermined |
Include users whose age is not determined. |
AgeSegment
Contiguous age range.
JSON representation |
---|
{ "minAge": integer, "maxAge": integer } |
Fields | |
---|---|
minAge |
Minimum age to include. A minimum age must be specified and must be at least 18. Allowed values are 18, 25, 35, 45, 55, and 65. |
maxAge |
Maximum age to include. A maximum age need not be specified. If specified, maxAge must be greater than minAge, and allowed values are 24, 34, 44, 54, and 64. |
GenderDimension
Dimension specifying users by their gender.
JSON representation |
---|
{
"genders": [
enum ( |
Fields | |
---|---|
genders[] |
Included gender demographic segments. |
includeUndetermined |
Include users whose gender is not determined. |
HouseholdIncomeDimension
Dimension specifying users by their household income.
JSON representation |
---|
{
"incomeRanges": [
enum ( |
Fields | |
---|---|
incomeRanges[] |
Included household income demographic segments. |
includeUndetermined |
Include users whose household income is not determined. |
ParentalStatusDimension
Dimension specifying users by their parental status.
JSON representation |
---|
{
"parentalStatuses": [
enum ( |
Fields | |
---|---|
parentalStatuses[] |
Included parental status demographic segments. |
includeUndetermined |
Include users whose parental status is undetermined. |
AudienceSegmentDimension
Dimension specifying users by their membership in other audience segments.
JSON representation |
---|
{
"segments": [
{
object ( |
Fields | |
---|---|
segments[] |
Included audience segments. Users are included if they belong to at least one segment. |
AudienceSegment
Positive audience segment.
JSON representation |
---|
{ // Union field |
Fields | |
---|---|
Union field segment . Positive segment. segment can be only one of the following: |
|
userList |
User list segment. |
userInterest |
Affinity or In-market segment. |
lifeEvent |
Live-event audience segment. |
detailedDemographic |
Detailed demographic segment. |
customAudience |
Custom audience segment. |
UserListSegment
User list segment. The Similar Audiences sunset starts May 2023. Refer to https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html for other options.
JSON representation |
---|
{ "userList": string } |
Fields | |
---|---|
userList |
The user list resource. |
UserInterestSegment
User interest segment.
JSON representation |
---|
{ "userInterestCategory": string } |
Fields | |
---|---|
userInterestCategory |
The user interest resource. |
LifeEventSegment
Live event segment.
JSON representation |
---|
{ "lifeEvent": string } |
Fields | |
---|---|
lifeEvent |
The life event resource. |
DetailedDemographicSegment
Detailed demographic segment.
JSON representation |
---|
{ "detailedDemographic": string } |
Fields | |
---|---|
detailedDemographic |
The detailed demographic resource. |
CustomAudienceSegment
Custom audience segment.
JSON representation |
---|
{ "customAudience": string } |
Fields | |
---|---|
customAudience |
The custom audience resource. |
AudienceExclusionDimension
Negative dimension specifying users to exclude from the audience.
JSON representation |
---|
{
"exclusions": [
{
object ( |
Fields | |
---|---|
exclusions[] |
Audience segment to be excluded. |
ExclusionSegment
An audience segment to be excluded from an audience.
JSON representation |
---|
{ // Union field |
Fields | |
---|---|
Union field segment . Segment to be excluded. segment can be only one of the following: |
|
userList |
User list segment to be excluded. |