Audience

  • Audiences allow targeting by intersecting different segment attributes like demographics and affinities.

  • Key fields for an audience include resource_name, id, status, description, dimensions, exclusion_dimension, scope, asset_group, and name.

  • An audience's status indicates if it is enabled or removed.

  • The scope defines where the audience can be used, either at the customer level or asset group level.

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

resource_name

string

Immutable. The resource name of the audience. Audience names have the form:

customers/{customer_id}/audiences/{audience_id}

id

int64

Output only. ID of the audience.

status

AudienceStatus

Output only. Status of this audience. Indicates whether the audience is enabled or removed.

description

string

Description of this audience.

dimensions[]

AudienceDimension

Positive dimensions specifying the audience composition.

exclusion_dimension

AudienceExclusionDimension

Negative dimension specifying the audience composition.

scope

AudienceScope

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.

asset_group

string

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.

name

string

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.