REST Resource: firstPartyAndPartnerAudiences

Ressource : FirstPartyAndPartnerAudience

Décrit une liste d'audience propriétaire ou partenaire utilisée pour le ciblage. Les audiences first party sont créées à l'aide des données client. Les audiences partenaires sont fournies par des fournisseurs de données tiers et ne peuvent être concédées sous licence qu'aux clients.

Représentation JSON 
{
  "name": string,
  "firstPartyAndPartnerAudienceId": string,
  "displayName": string,
  "description": string,
  "firstPartyAndPartnerAudienceType": enum (FirstPartyAndPartnerAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string
}
Champs
name

string

Uniquement en sortie. Nom de ressource de l'audience propriétaire et partenaire.
firstPartyAndPartnerAudienceId

string (int64 format)

Identifiant. Identifiant unique de l'audience propriétaire et partenaire. Attribué par le système.
displayName

string

Facultatif. Nom à afficher de l'audience propriétaire et partenaire.
description

string

Facultatif. Description de l'audience fournie par l'utilisateur.

Il ne s'applique qu'aux audiences propriétaires.
firstPartyAndPartnerAudienceType

enum (FirstPartyAndPartnerAudienceType)

Uniquement en sortie. Indique si l'audience est une audience propriétaire et partenaire.
audienceType

enum (AudienceType)

Immuable. Type de l'audience.
audienceSource

enum (AudienceSource)

Uniquement en sortie. Source de l'audience.
membershipDurationDays

string (int64 format)

Facultatif. Durée, en jours, pendant laquelle une entrée reste dans l'audience après l'événement éligible. La valeur définie doit être supérieure à 0 et inférieure ou égale à 540.

Il ne s'applique qu'aux audiences propriétaires.

Ce champ est obligatoire si l'un des audienceType suivants est utilisé :

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

Uniquement en sortie. Taille estimée de l'audience pour le Réseau Display.

Si la taille est inférieure à 1 000, le nombre sera masqué et 0 sera renvoyé pour des raisons de confidentialité. Sinon, le nombre sera arrondi à deux chiffres significatifs.

Renvoyé uniquement dans la requête GET.
activeDisplayAudienceSize

string (int64 format)

Uniquement en sortie. Taille estimée de l'audience pour le Réseau Display au cours du mois dernier.

Si la taille est inférieure à 1 000, le nombre sera masqué et 0 sera renvoyé pour des raisons de confidentialité. Sinon, le nombre sera arrondi à deux chiffres significatifs.

Renvoyé uniquement dans la requête GET.
youtubeAudienceSize

string (int64 format)

Uniquement en sortie. Taille estimée de l'audience pour le réseau YouTube.

Si la taille est inférieure à 1 000, le nombre sera masqué et 0 sera renvoyé pour des raisons de confidentialité. Sinon, le nombre sera arrondi à deux chiffres significatifs.

Ne s'applique qu'aux audiences propriétaires.

Renvoyé uniquement dans la requête GET.
gmailAudienceSize

string (int64 format)

Uniquement en sortie. Taille estimée de l'audience pour le réseau Gmail.

Si la taille est inférieure à 1 000, le nombre sera masqué et 0 sera renvoyé pour des raisons de confidentialité. Sinon, le nombre sera arrondi à deux chiffres significatifs.

Ne s'applique qu'aux audiences propriétaires.

Renvoyé uniquement dans la requête GET.
displayMobileAppAudienceSize

string (int64 format)

Uniquement en sortie. Taille estimée de l'audience de l'application mobile sur le Réseau Display.

Si la taille est inférieure à 1 000, le nombre sera masqué et 0 sera renvoyé pour des raisons de confidentialité. Sinon, le nombre sera arrondi à deux chiffres significatifs.

Ne s'applique qu'aux audiences propriétaires.

Renvoyé uniquement dans la requête GET.
displayMobileWebAudienceSize

string (int64 format)

Uniquement en sortie. Taille estimée de l'audience Web mobile sur le Réseau Display.

Si la taille est inférieure à 1 000, le nombre sera masqué et 0 sera renvoyé pour des raisons de confidentialité. Sinon, le nombre sera arrondi à deux chiffres significatifs.

Ne s'applique qu'aux audiences propriétaires.

Renvoyé uniquement dans la requête GET.
displayDesktopAudienceSize

string (int64 format)

Uniquement en sortie. Taille estimée de l'audience sur ordinateur sur le Réseau Display.

Si la taille est inférieure à 1 000, le nombre sera masqué et 0 sera renvoyé pour des raisons de confidentialité. Sinon, le nombre sera arrondi à deux chiffres significatifs.

Ne s'applique qu'aux audiences propriétaires.

Renvoyé uniquement dans la requête GET.
appId

string

Facultatif. L'appId correspond au type de mobileDeviceIds importé.

S'applique uniquement à audienceType CUSTOMER_MATCH_DEVICE_ID

FirstPartyAndPartnerAudienceType

Types possibles d'une ressource d'audience propriétaire et partenaire.

Enums
FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED Valeur par défaut lorsque le type n'est pas spécifié ou est inconnu.
TYPE_FIRST_PARTY Audience créée à l'aide des données client.
TYPE_PARTNER Audience fournie par des fournisseurs de données tiers.

AudienceType

Types d'audiences possibles.

Enums
AUDIENCE_TYPE_UNSPECIFIED Valeur par défaut lorsque le type n'est pas spécifié ou est inconnu.
CUSTOMER_MATCH_CONTACT_INFO L'audience a été générée en mettant en correspondance les clients avec des coordonnées connues.
CUSTOMER_MATCH_DEVICE_ID L'audience a été générée en mettant en correspondance des clients avec des ID d'appareils mobiles connus.
CUSTOMER_MATCH_USER_ID L'audience a été générée en mettant en correspondance les clients avec des ID utilisateur connus.
ACTIVITY_BASED

Obsolète : l'audience a été créée en fonction de l'activité de la campagne.
FREQUENCY_CAP

Obsolète : l'audience a été créée en excluant le nombre d'impressions qui ont été diffusées auprès d'elle.
TAG_BASED L'audience a été créée en fonction des variables personnalisées associées au pixel.
YOUTUBE_USERS L'audience a été créée en fonction des interactions passées avec des vidéos, des annonces YouTube ou une chaîne YouTube.
THIRD_PARTY L'audience a été concédée sous licence par un tiers.
COMMERCE Audience fournie par des partenaires commerciaux moyennant des frais.
LINEAR Audience pour le contenu de TV linéaire.
AGENCY Audience fournie par une agence.

AudienceSource

Sources d'audience possibles.

Enums
AUDIENCE_SOURCE_UNSPECIFIED Valeur par défaut lorsque la source d'audience n'est pas spécifiée ou est inconnue.
DISPLAY_VIDEO_360 Origine : Display & Video 360.
CAMPAIGN_MANAGER Origine : Campaign Manager 360.
AD_MANAGER Origine : Google Ad Manager.
SEARCH_ADS_360 Origine : Search Ads 360.
YOUTUBE Origine : YouTube.
ADS_DATA_HUB Origine : Ads Data Hub.

Méthodes

get

 Récupère une audience propriétaire ou partenaire.

list

 Répertorie les audiences propriétaires et partenaires.