- 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 |
Audience 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 vous utilisez l'une des options
|
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. Uniquement renvoyé dans une requête GET. |
activeDisplayAudienceSize |
Uniquement en sortie. Taille estimée de l'audience 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. Uniquement renvoyé 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. Uniquement renvoyé 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. Uniquement renvoyé 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. Uniquement renvoyé dans une requête GET. |
displayMobileWebAudienceSize |
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 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. Uniquement renvoyé 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. Uniquement renvoyé dans une requête GET. |
appId |
L'appId correspond au type des mobilesDeviceId en cours d'importation. S'applique uniquement à |
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. S'applique uniquement à |
mobileDeviceIdList |
Uniquement en entrée. Liste d'ID d'appareils mobiles pour définir les membres initiaux de l'audience. S'applique uniquement à |
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 grâce à l'utilisation 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 mettant en correspondance des clients avec des coordonnées connues. |
CUSTOMER_MATCH_DEVICE_ID |
L'audience a été générée grâce à la mise 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 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 sur la base de l'exclusion du nombre d'impressions qui ont été diffusées. |
TAG_BASED |
L'audience a été créée sur la base de variables personnalisées associées au pixel. |
YOUTUBE_USERS |
L'audience a été créée en fonction des précédentes interactions avec des vidéos, des annonces YouTube ou une chaîne YouTube. |
LICENSED |
Sous-type du 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 le fractionnement 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 entièrement 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 de pays. |
zipCodes[] |
Liste des codes postaux du membre. Doit également être défini à l'aide des 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 entièrement en minuscules. Doit également être défini à l'aide des 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 entièrement en minuscules. Doit également être défini à l'aide des champs suivants: |
countryCode |
Code pays du membre. Doit également être défini à l'aide des champs suivants: |
Consentement
État du consentement de l'utilisateur.
Représentation JSON |
---|
{ "adUserData": enum ( |
Champs | |
---|---|
adUserData |
Représente le consentement pour les données des utilisateurs de l'annonce. |
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 |
Consentement obtenu. |
CONSENT_STATUS_DENIED |
Autorisation refusée. |
MobileDeviceIdList
Message wrapper 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 de "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 un objet FirstAndThirdPartyAudience. |
|
Met à jour la liste des membres d'une audience de ciblage par liste de clients. |
|
Permet d'obtenir une audience propriétaire et une audience tierce. |
|
Liste les audiences propriétaires et tierces. |
|
Met à jour une valeur FirstAndThirdPartyAudience existante. |