Audience

  • Audiences are a targeting option that allows the intersection of different segment attributes like demographics and affinities to create audiences representing sections of target segments.

  • An audience resource includes fields like resource_name, id, status, description, dimensions, exclusion_dimension, scope, asset_group, and name.

  • The status field indicates if an audience is enabled or removed.

  • The scope defines where an audience can be used, defaulting to CUSTOMER scope, but can also be ASSET_GROUP.

  • The name field is the unique identifier for the audience and has length requirements.

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.