REST Resource: firstAndThirdPartyAudiences

Ressource: FirstAndThirdPartyAudience

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

Représentation JSON 
{
  "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,
  "appId": string,

  // Union field members can be only one of the following:
  "contactInfoList": {
    object (ContactInfoList)
  },
  "mobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of list of possible types for union field members.
}
Champs
name

string

Uniquement en sortie. Nom de ressource de l'audience propriétaire et tierce.
firstAndThirdPartyAudienceId

string (int64 format)

Uniquement en sortie. ID unique de l'audience propriétaire et tierce. Attribué par le système.
displayName

string

Nom à afficher de l'audience propriétaire et tierce
description

string

Description de l'audience fournie par l'utilisateur.

Uniquement applicable aux audiences propriétaires.
firstAndThirdPartyAudienceType

enum (FirstAndThirdPartyAudienceType)

L'audience est propriétaire ou tierce.
audienceType

enum (AudienceType)

Type d'audience.
audienceSource

enum (AudienceSource)

Uniquement en sortie. Source de l'audience.
membershipDurationDays

string (int64 format)

Durée, en jours, pendant laquelle une vidéo reste dans l'audience après l'événement éligible. Si aucune date d'expiration n'est définie pour l'audience, définissez la valeur de ce champ sur 10 000. Sinon, la valeur définie doit être supérieure à 0 et inférieure ou égale à 540.

Uniquement applicable 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 est masqué et la valeur 0 est renvoyée pour des raisons de confidentialité. Sinon, il est arrondi à deux chiffres significatifs.

Renvoie uniquement dans une requête GET.
activeDisplayAudienceSize

string (int64 format)

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

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

Renvoie uniquement dans une 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 est masqué et la valeur 0 est renvoyée pour des raisons de confidentialité. Sinon, il est arrondi à deux chiffres significatifs.

Uniquement applicable aux audiences propriétaires.

Renvoie uniquement dans une 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 est masqué et la valeur 0 est renvoyée pour des raisons de confidentialité. Sinon, il est arrondi à deux chiffres significatifs.

Uniquement applicable aux audiences propriétaires.

Renvoie uniquement dans une requête GET.
displayMobileAppAudienceSize

string (int64 format)

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

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

Uniquement applicable aux audiences propriétaires.

Renvoie uniquement dans une requête GET.
displayMobileWebAudienceSize

string (int64 format)

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

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

Uniquement applicable aux audiences propriétaires.

Renvoie uniquement dans une 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 est masqué et la valeur 0 est renvoyée pour des raisons de confidentialité. Sinon, il est arrondi à deux chiffres significatifs.

Uniquement applicable aux audiences propriétaires.

Renvoie uniquement dans une requête GET.
appId

string

L'appId correspond au type des mobilesDeviceId importés.

Applicable uniquement au CUSTOMER_MATCH_DEVICE_ID audienceType
Champ d'union members. Membres initiaux de l'audience de ciblage par liste de clients. members ne peut être qu'un des éléments suivants :
contactInfoList

object (ContactInfoList)

Uniquement en entrée. Une liste de coordonnées pour définir les membres initiaux de l'audience.

Applicable uniquement au CUSTOMER_MATCH_CONTACT_INFO audienceType
mobileDeviceIdList

object (MobileDeviceIdList)

Uniquement en entrée. Liste d'ID d'appareils mobiles pour définir les membres initiaux de l'audience.

Applicable uniquement au CUSTOMER_MATCH_DEVICE_ID audienceType

FirstAndThirdPartyAudienceType

Types possibles de ressources d'audience propriétaire et tierce.

Enums
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED Valeur par défaut lorsque le type n'est pas spécifié ou est inconnu.
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY Audience créée à partir des données client.
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY 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 associant les clients à des coordonnées connues.
CUSTOMER_MATCH_DEVICE_ID L'audience a été générée en associant les clients à des ID d'appareil mobile connus.
CUSTOMER_MATCH_USER_ID L'audience a été générée en mettant en correspondance des clients avec des ID utilisateur connus.
ACTIVITY_BASED

L'audience a été créée sur la base de l'activité de la campagne.
FREQUENCY_CAP

L'audience a été créée en ne tenant pas compte du nombre d'impressions générées.
TAG_BASED L'audience a été créée en fonction de variables personnalisées associées au pixel.
YOUTUBE_USERS L'audience a été créée en fonction des précédentes interactions avec les vidéos, les annonces YouTube ou la chaîne YouTube.
LICENSED Sous-type de type d'audience tiers.

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 En provenance de Display & Video 360
CAMPAIGN_MANAGER En provenance de Campaign Manager 360
AD_MANAGER En provenance de Google Ad Manager.
SEARCH_ADS_360 En provenance de Search Ads 360
YOUTUBE En provenance de YouTube
ADS_DATA_HUB En provenance d'Ads Data Hub.

ContactInfoList

Message wrapper pour une liste de coordonnées définissant les membres de l'audience de ciblage par liste de clients.

Représentation JSON 
{
  "contactInfos": [
    {
      object (ContactInfo)
    }
  ]
}
Champs
contactInfos[]

object (ContactInfo)

Liste d'objets ContactInfo définissant les membres de l'audience de ciblage par liste de clients. La taille des membres après la division de contactInfos ne doit pas être supérieure à 500 000.

ContactInfo

Coordonnées définissant un membre d'une audience de ciblage par liste de clients.

Représentation JSON 
{
  "hashedEmails": [
    string
  ],
  "hashedPhoneNumbers": [
    string
  ],
  "zipCodes": [
    string
  ],
  "hashedFirstName": string,
  "hashedLastName": string,
  "countryCode": string
}
Champs
hashedEmails[]

string

Liste des adresses e-mail hachées SHA256 du membre. Avant le hachage, supprimez tous les espaces blancs et assurez-vous que la chaîne est tout en minuscules.
hashedPhoneNumbers[]

string

Liste des numéros de téléphone hachés SHA256 du membre. Avant le hachage, tous les numéros de téléphone doivent respecter le format E.164 et inclure l'indicatif du pays.
zipCodes[]

string

Liste des codes postaux du membre.

Doit également être défini avec les champs suivants:
hashedFirstName

string

Prénom haché SHA256 du membre. Avant le hachage, supprimez tous les espaces blancs et assurez-vous que la chaîne est tout en minuscules.

Doit également être défini avec les champs suivants:
hashedLastName

string

Nom de famille haché SHA256 du membre. Avant le hachage, supprimez tous les espaces blancs et assurez-vous que la chaîne est tout en minuscules.

Doit également être défini avec les champs suivants:
countryCode

string

Code pays du membre.

Doit également être défini avec les champs suivants:

MobileDeviceIdList

Message d'accompagnement pour une liste d'ID d'appareils mobiles définissant les membres de l'audience de ciblage par liste de clients.

Représentation JSON 
{
  "mobileDeviceIds": [
    string
  ]
}
Champs
mobileDeviceIds[]

string

Liste d'ID d'appareils mobiles définissant les membres de l'audience de ciblage par liste de clients. La taille des champs "mobileDeviceIds" ne doit pas être supérieure à 500 000.

Méthodes

create

 Crée une FirstAndThirdPartyAudience.

editCustomerMatchMembers

 Met à jour la liste des membres d'une audience de ciblage par liste de clients.

get

 Permet d'obtenir une audience propriétaire et tierce.

list

 Liste les audiences propriétaires et tierces.

patch

 Met à jour une FirstAndThirdPartyAudience existante.