Audiences

Audiences are lists of users. Use audiences to direct ads towards users or try to avoid users.

In the Display & Video 360 API, audiences use different resource types. Target all of them under the targeting type TARGETING_TYPE_AUDIENCE_GROUP. Read about how to target audiences in the audience list targeting guide.

Audience types

In the Display & Video 360 API, the audience source determines the resource type.

Google audiences

Google Audiences are created and managed by Google. Users are grouped by affinity, life event, or purchase intent.

These are GoogleAudience resources in the API. Get these audiences using the googleAudiences service. These audiences can't be created or updated with the API.

Caution: Extended Demographic audiences aren't fully supported by the Display & Video 360 API. They can't be added or retrieved in assigned targeting.

First-party and partner audiences

Important: Upgrade your Customer Match workflows to the Data Manager API for an improved developer experience and access to additional features. We don't recommend implementing new Customer Match workflows using the Display & Video 360 API.

First-party and partner audiences are user lists that use provided data. The audience type defines the data used to build the audience.

These are FirstPartyAndPartnerAudience resources in the API. Get these audiences using the firstPartyAndPartnerAudiences service. The service will only give access to audiences available to the given advertiser or partner.

Note: Estimated audience size fields will only be included when using the get method.

The Display & Video 360 API supports creating and updating Customer Match audiences. See more in the Upload a Customer Match Audience guide.

Custom lists

Custom lists are built in Display & Video 360 and are based on given inputs. They group users by interest or purchase intent. They are built in the Display & Video 360 UI.

These are CustomList resources in the API. Get these audiences using the customLists service. These audiences can't be created or updated with the API.

Combined audiences

Combined audiences are created by joining many audiences using logic operators. They are built in the Display & Video 360 UI.

These are CombinedAudience resources in the API. Get these audiences using the combinedAudiences service. These audiences can't be created or updated with the API.