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.
Fields from the above resources may be selected along with this
resource in your SELECT and WHERE clauses. These fields will not segment
metrics in your SELECT clause.
audience.asset_group
Field description
Immutable. The asset group that this audience is scoped under. Must be set if and only if scope is ASSET_GROUP. Immutable after creation. If an audience with ASSET_GROUP scope is upgraded to CUSTOMER scope, this field will automatically be cleared.
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
audience.description
Field description
Description of this audience.
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
audience.dimensions
Field description
Positive dimensions specifying the audience composition.
Name of the audience. It should be unique across all audiences within the account. It must have a minimum length of 1 and maximum length of 255. Required when scope is not set or is set to CUSTOMER. Cannot be set or updated when scope is ASSET_GROUP.
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
audience.resource_name
Field description
Immutable. The resource name of the audience. Audience names have the form: customers/{customer_id}/audiences/{audience_id}
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
audience.scope
Field description
Defines the scope this audience can be used in. By default, the scope is CUSTOMER. Audiences can be created with a scope of ASSET_GROUP for exclusive use by a single asset_group. Scope may change from ASSET_GROUP to CUSTOMER but not from CUSTOMER to ASSET_GROUP.
[null,null,["Last updated 2024-12-18 UTC."],[[["Audience targeting lets you combine demographics and affinities to create specific customer segments."],["You can select fields from `asset_group` and `customer` resources in your queries, but they won't segment metrics."],["Audiences can be scoped under an asset group or at the customer level, allowing for flexible targeting strategies."],["An audience's composition is defined by positive dimensions (inclusions) and can be further refined with negative dimensions (exclusions)."],["Each audience has a unique ID, name, resource name, scope, and status, all of which are accessible through API fields."]]],[]]
