REST Resource: firstAndThirdPartyAudiences

Resource: FirstAndThirdPartyAudience

Describes a first or third party audience list used for targeting. First party audiences are created via usage of client data. Third party audiences are provided by Third Party data providers and can only be licensed to customers.

JSON representation
{
  "name": string,
  "firstAndThirdPartyAudienceId": string,
  "displayName": string,
  "description": string,
  "firstAndThirdPartyAudienceType": enum (FirstAndThirdPartyAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string
}
Fields
name

string

Output only. The resource name of the first and third party audience.

firstAndThirdPartyAudienceId

string (int64 format)

Output only. The unique ID of the first and third party audience. Assigned by the system.

displayName

string

The display name of the first and third party audience.

description

string

The user-provided description of the audience.

Only applicable to first party audiences.

firstAndThirdPartyAudienceType

enum (FirstAndThirdPartyAudienceType)

Output only. Whether the audience is a first or third party audience.

audienceType

enum (AudienceType)

Output only. The type of the audience.

audienceSource

enum (AudienceSource)

Output only. The source of the audience.

membershipDurationDays

string (int64 format)

The duration in days that an entry remains in the audience after the qualifying event.

Only applicable to first party audiences.

displayAudienceSize

string (int64 format)

Output only. The estimated audience size for the Display network.

If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits.

Only returned in GET request.

activeDisplayAudienceSize

string (int64 format)

Output only. The estimated audience size for the Display network in the past month.

If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits.

Only returned in GET request.

youtubeAudienceSize

string (int64 format)

Output only. The estimated audience size for YouTube network.

If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits.

Only applicable to first party audiences.

Only returned in GET request.

gmailAudienceSize

string (int64 format)

Output only. The estimated audience size for Gmail network.

If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits.

Only applicable to first party audiences.

Only returned in GET request.

displayMobileAppAudienceSize

string (int64 format)

Output only. The estimated mobile app audience size in Display network.

If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits.

Only applicable to first party audiences.

Only returned in GET request.

displayMobileWebAudienceSize

string (int64 format)

Output only. The estimated mobile web audience size in Display network.

If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits.

Only applicable to first party audiences.

Only returned in GET request.

displayDesktopAudienceSize

string (int64 format)

Output only. The estimated desktop audience size in Display network.

If the size is less than 1000, the number will be hidden and 0 will be returned due to privacy reasons. Otherwise, the number will be rounded off to two significant digits.

Only applicable to first party audiences.

Only returned in GET request.

FirstAndThirdPartyAudienceType

Possible types of a first and third party audience resource.

Enums
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED Default value when type is not specified or is unknown.
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY Audience that is created via usage of client data.
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY Audience that is provided by Third Party data providers.

AudienceType

Possible types of audiences.

Enums
AUDIENCE_TYPE_UNSPECIFIED Default value when type is not specified or is unknown.
CUSTOMER_MATCH_CONTACT_INFO Audience was generated through matching customers to known contact information.
CUSTOMER_MATCH_DEVICE_ID Audience was generated through matching customers to known Mobile device IDs.
CUSTOMER_MATCH_USER_ID Audience was generated through matching customers to known User IDs.
ACTIVITY_BASED Audience was created based on campaign activity.
FREQUENCY_CAP Audience was created based on excluding the number of impressions they were served.
TAG_BASED Audience was created based on custom variables attached to pixel.
YOUTUBE_USERS Audience was created based on past interactions with videos, YouTube ads, or YouTube channel.
LICENSED Subtype of third party audience type.

AudienceSource

Possible audience sources.

Enums
AUDIENCE_SOURCE_UNSPECIFIED Default value when audience source is not specified or is unknown.
DISPLAY_VIDEO_360 Originated from Display & Video 360.
CAMPAIGN_MANAGER Originated from Campaign Manager.
AD_MANAGER Originated from Google Ad Manager.
SEARCH_ADS_360 Originated from Search Ads 360.
YOUTUBE Originated from Youtube.
ADS_DATA_HUB Originated from Ads Data Hub.

Methods

get

Gets a first and third party audience.

list

Lists first and third party audiences.