- Ressource: FirstAndThirdPartyAudience
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- FirstAndThirdPartyAudienceType
- AudienceType
- AudienceSource
- ContactInfoList
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- ContactInfo
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- Consentement
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- ConsentStatus
- MobileDeviceIdList
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- 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 à partir 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 des audiences propriétaires et tierces. |
firstAndThirdPartyAudienceId |
Uniquement en sortie. Identifiant unique de l'audience propriétaire et de l'audience 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. Cela ne s'applique qu'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 participation reste dans l'audience après l'événement de qualification. Si l'audience n'a pas de date d'expiration, 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. Cela ne s'applique qu'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 0 est renvoyé pour des raisons de confidentialité. Sinon, il est arrondi à deux chiffres significatifs. Uniquement renvoyé dans la requête GET. |
activeDisplayAudienceSize |
Uniquement en sortie. Estimation de la taille de l'audience sur le Réseau Display pour le mois dernier. Si la taille est inférieure à 1 000, le nombre est masqué et 0 est renvoyé pour des raisons de confidentialité. Sinon, il est arrondi à deux chiffres significatifs. Uniquement renvoyé dans la 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 0 est renvoyé pour des raisons de confidentialité. Sinon, il est arrondi à deux chiffres significatifs. Cela ne s'applique qu'aux audiences propriétaires. Uniquement renvoyé dans la 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 0 est renvoyé pour des raisons de confidentialité. Sinon, il est arrondi à deux chiffres significatifs. Cela ne s'applique qu'aux audiences propriétaires. Uniquement renvoyé dans la requête GET. |
displayMobileAppAudienceSize |
Uniquement en sortie. Taille estimée de l'audience d'une application mobile sur le Réseau Display. Si la taille est inférieure à 1 000, le nombre est masqué et 0 est renvoyé pour des raisons de confidentialité. Sinon, il est arrondi à deux chiffres significatifs. Cela ne s'applique qu'aux audiences propriétaires. Uniquement renvoyé dans la 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 0 est renvoyé pour des raisons de confidentialité. Sinon, il est arrondi à deux chiffres significatifs. Cela ne s'applique qu'aux audiences propriétaires. Uniquement renvoyé dans la 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 0 est renvoyé pour des raisons de confidentialité. Sinon, il est arrondi à deux chiffres significatifs. Cela ne s'applique qu'aux audiences propriétaires. Uniquement renvoyé dans la requête GET. |
appId |
L'appId correspond au type de mobileDeviceIds importé. Uniquement applicable à |
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. Uniquement applicable à |
mobileDeviceIdList |
Uniquement en entrée. Liste d'ID d'appareils mobiles permettant de définir les membres initiaux de l'audience. Uniquement applicable à |
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 via l'utilisation de 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 grâce à la mise 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 grâce à la mise en correspondance des clients avec des ID utilisateur connus. |
ACTIVITY_BASED |
L'audience a été créée en fonction de l'activité de la campagne. |
FREQUENCY_CAP |
L'audience a été créée sur la base de l'exclusion du nombre d'impressions pour lesquelles elles ont été diffusées. |
TAG_BASED |
L'audience a été créée sur la base de variables personnalisées associées à un pixel. |
YOUTUBE_USERS |
L'audience a été créée sur la base des interactions passées 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 |
Origine de Campaign Manager 360 |
AD_MANAGER |
Origine de Google Ad Manager. |
SEARCH_ADS_360 |
Origine de Search Ads 360. |
YOUTUBE |
Origine de YouTube. |
ADS_DATA_HUB |
Données issues 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 des objets ContactInfo définissant les membres de l'audience de ciblage par liste de clients. La taille des membres après scission 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, le consentement n'est pas spécifié. Si les champs |
ContactInfo
Coordonnées définissant un membre de l'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 d'adresses e-mail hachées en 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 de numéros de téléphone hachés SHA256 du membre. Avant le hachage, tous les numéros de téléphone doivent être au format E.164 et inclure l'indicatif de pays. |
zipCodes[] |
Liste des codes postaux du membre. Doit également être défini avec les champs suivants: |
hashedFirstName |
Prénom haché du membre sous forme hachée SHA256. 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 avec les champs suivants: |
hashedLastName |
Nom haché au format 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 avec les champs suivants: |
countryCode |
Code pays du membre. Doit également être défini avec les champs suivants: |
Consentement
État de consentement de l'utilisateur.
Représentation JSON |
---|
{ "adUserData": enum ( |
Champs | |
---|---|
adUserData |
Représente le consentement pour les données utilisateur de l'annonce. |
adPersonalization |
Représente le consentement pour la personnalisation des annonces. |
ConsentStatus
État du consentement.
Enums | |
---|---|
CONSENT_STATUS_UNSPECIFIED |
La valeur du type n'est pas spécifiée ou est inconnue dans cette version. |
CONSENT_STATUS_GRANTED |
Autorisation accordée. |
CONSENT_STATUS_DENIED |
Autorisation refusée. |
MobileDeviceIdList
Message wrapper pour une liste d'ID d'appareil mobile 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 d'une 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, le consentement n'est pas spécifié. 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 FirstAndThirdPartyAudience existante. |