- Ressource: FirstAndThirdPartyAudience
- FirstAndThirdPartyAudienceType
- AudienceType
- AudienceSource
- ContactInfoList
- ContactInfo
- Consentement
- ConsentStatus
- MobileDeviceIdList
- Méthodes
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 ( |
Champs | |
---|---|
name |
Uniquement en sortie. Nom de ressource de l'audience propriétaire et tierce. |
firstAndThirdPartyAudienceId |
Uniquement en sortie. ID unique de l'audience propriétaire et tierce. Attribué par le système. |
displayName |
Nom à afficher de l'audience propriétaire et tierce |
description |
Description de l'audience fournie par l'utilisateur. Uniquement applicable aux audiences propriétaires. |
firstAndThirdPartyAudienceType |
L'audience est propriétaire ou tierce. |
audienceType |
Type d'audience. |
audienceSource |
Uniquement en sortie. Source de l'audience. |
membershipDurationDays |
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
|
displayAudienceSize |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
L'appId correspond au type des mobilesDeviceId importés. Applicable uniquement au |
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 |
Uniquement en entrée. Une liste de coordonnées pour définir les membres initiaux de l'audience. Applicable uniquement au |
mobileDeviceIdList |
Uniquement en entrée. Liste d'ID d'appareils mobiles pour définir les membres initiaux de l'audience. Applicable uniquement au |
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 ( |
Champs | |
---|---|
contactInfos[] |
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. |
consent |
Uniquement en entrée. Paramètre de consentement pour les utilisateurs de Si ce champ n'est pas défini, cela signifie que l'autorisation n'est pas spécifiée. Si les champs |
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[] |
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[] |
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[] |
Liste des codes postaux du membre. Doit également être défini avec les champs suivants: |
hashedFirstName |
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 |
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 |
Code pays du membre. Doit également être défini avec les champs suivants: |
l'autorisation des personnes impliquées ;
État du consentement de l'utilisateur.
Représentation JSON |
---|
{ "adUserData": enum ( |
Champs | |
---|---|
adUserData |
Représente le consentement pour les données sur les utilisateurs des annonces. |
adPersonalization |
Représente le consentement pour la personnalisation des annonces. |
ConsentStatus
État de l'autorisation.
Enums | |
---|---|
CONSENT_STATUS_UNSPECIFIED |
La valeur de type n'est pas spécifiée ou est inconnue dans cette version. |
CONSENT_STATUS_GRANTED |
Le consentement est accordé. |
CONSENT_STATUS_DENIED |
Autorisation refusée. |
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
],
"consent": {
object ( |
Champs | |
---|---|
mobileDeviceIds[] |
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. |
consent |
Uniquement en entrée. Paramètre de consentement pour les utilisateurs de Si ce champ n'est pas défini, cela signifie que l'autorisation n'est pas spécifiée. Si les champs |
Méthodes |
|
---|---|
|
Crée une FirstAndThirdPartyAudience. |
|
Met à jour la liste des membres d'une audience de ciblage par liste de clients. |
|
Permet d'obtenir une audience propriétaire et tierce. |
|
Liste les audiences propriétaires et tierces. |
|
Met à jour une FirstAndThirdPartyAudience existante. |