Index
IngestionService(interface)MarketingDataInsightsService(interface)PartnerLinkService(interface)UserListDirectLicenseService(interface)UserListGlobalLicenseService(interface)UserListService(interface)AdIdentifiers(message)AddressInfo(message)AgeRange(enum)AudienceMember(message)AwsWrappedKeyInfo(message)AwsWrappedKeyInfo.KeyType(enum)Baseline(message)Baseline.Location(message)CartData(message)Consent(message)ConsentStatus(enum)ContactIdInfo(message)CreatePartnerLinkRequest(message)CreateUserListDirectLicenseRequest(message)CreateUserListGlobalLicenseRequest(message)CreateUserListRequest(message)CustomVariable(message)CustomerType(enum)CustomerValueBucket(enum)DataSourceType(enum)DeletePartnerLinkRequest(message)DeleteUserListRequest(message)Destination(message)DeviceInfo(message)Encoding(enum)EncryptionInfo(message)ErrorCount(message)ErrorInfo(message)ErrorReason(enum)Event(message)EventParameter(message)EventSource(enum)ExperimentalField(message)GcpWrappedKeyInfo(message)GcpWrappedKeyInfo.KeyType(enum)Gender(enum)GetUserListDirectLicenseRequest(message)GetUserListGlobalLicenseRequest(message)GetUserListRequest(message)IngestAudienceMembersRequest(message)IngestAudienceMembersResponse(message)IngestEventsRequest(message)IngestEventsResponse(message)IngestedUserListInfo(message)IngestedUserListInfo.UploadKeyType(enum)Item(message)ItemParameter(message)ListUserListDirectLicensesRequest(message)ListUserListDirectLicensesResponse(message)ListUserListGlobalLicenseCustomerInfosRequest(message)ListUserListGlobalLicenseCustomerInfosResponse(message)ListUserListGlobalLicensesRequest(message)ListUserListGlobalLicensesResponse(message)ListUserListsRequest(message)ListUserListsResponse(message)MatchRateRange(enum)MobileData(message)MobileIdInfo(message)MobileIdInfo.KeySpace(enum)PairData(message)PairIdInfo(message)PartnerAudienceInfo(message)PartnerAudienceInfo.PartnerAudienceSource(enum)PartnerLink(message)PpidData(message)ProcessingErrorReason(enum)ProcessingWarningReason(enum)Product(enum) (obsolète)ProductAccount(message)ProductAccount.AccountType(enum)PseudonymousIdInfo(message)PseudonymousIdInfo.SyncStatus(enum)RemoveAudienceMembersRequest(message)RemoveAudienceMembersResponse(message)RequestStatusPerDestination(message)RequestStatusPerDestination.IngestAudienceMembersStatus(message)RequestStatusPerDestination.IngestEventsStatus(message)RequestStatusPerDestination.IngestMobileDataStatus(message)RequestStatusPerDestination.IngestPairDataStatus(message)RequestStatusPerDestination.IngestPpidDataStatus(message)RequestStatusPerDestination.IngestUserDataStatus(message)RequestStatusPerDestination.IngestUserIdDataStatus(message)RequestStatusPerDestination.RemoveAudienceMembersStatus(message)RequestStatusPerDestination.RemoveMobileDataStatus(message)RequestStatusPerDestination.RemovePairDataStatus(message)RequestStatusPerDestination.RemovePpidDataStatus(message)RequestStatusPerDestination.RemoveUserDataStatus(message)RequestStatusPerDestination.RemoveUserIdDataStatus(message)RequestStatusPerDestination.RequestStatus(enum)RetrieveInsightsRequest(message)RetrieveInsightsResponse(message)RetrieveInsightsResponse.MarketingDataInsight(message)RetrieveInsightsResponse.MarketingDataInsight.AudienceInsightsDimension(enum)RetrieveInsightsResponse.MarketingDataInsight.MarketingDataInsightsAttribute(message)RetrieveRequestStatusRequest(message)RetrieveRequestStatusResponse(message)SearchPartnerLinksRequest(message)SearchPartnerLinksResponse(message)SizeInfo(message)TargetNetworkInfo(message)TermsOfService(message)TermsOfServiceStatus(enum)UpdateUserListDirectLicenseRequest(message)UpdateUserListGlobalLicenseRequest(message)UpdateUserListRequest(message)UserData(message)UserIdData(message)UserIdInfo(message)UserIdentifier(message)UserList(message)UserList.AccessReason(enum)UserList.AccessStatus(enum)UserList.ClosingReason(enum)UserList.MembershipStatus(enum)UserListDirectLicense(message)UserListGlobalLicense(message)UserListGlobalLicenseCustomerInfo(message)UserListGlobalLicenseType(enum)UserListLicenseClientAccountType(enum)UserListLicenseMetrics(message)UserListLicensePricing(message)UserListLicensePricing.UserListPricingBuyerApprovalState(enum)UserListLicensePricing.UserListPricingCostType(enum)UserListLicenseStatus(enum)UserProperties(message)UserProperty(message)WarningCount(message)WarningInfo(message)
IngestionService
Service permettant d'envoyer des données d'audience vers des destinations compatibles.
| IngestAudienceMembers |
|---|
|
Importe une liste de ressources
|
| IngestEvents |
|---|
|
Importe une liste de ressources
|
| RemoveAudienceMembers |
|---|
|
Supprime une liste de ressources
|
| RetrieveRequestStatus |
|---|
|
Obtient l'état d'une requête à partir de son ID.
|
MarketingDataInsightsService
Service permettant de renvoyer des insights sur les données marketing.
Cette fonctionnalité n'est disponible que pour les partenaires de données.
| RetrieveInsights |
|---|
|
Récupère des insights sur les données marketing pour une liste d'utilisateurs donnée. Cette fonctionnalité n'est disponible que pour les partenaires de données. En-têtes d'autorisation : Cette méthode accepte les en-têtes facultatifs suivants pour définir la façon dont l'API autorise l'accès à la requête :
|
PartnerLinkService
Service permettant de gérer les liens de partenaires.
| CreatePartnerLink |
|---|
|
Crée un lien de partenaire pour le compte donné. En-têtes d'autorisation : Cette méthode accepte les en-têtes facultatifs suivants pour définir la façon dont l'API autorise l'accès à la requête :
|
| DeletePartnerLink |
|---|
|
Supprime un lien partenaire pour le compte donné. En-têtes d'autorisation : Cette méthode accepte les en-têtes facultatifs suivants pour définir la façon dont l'API autorise l'accès à la requête :
|
| SearchPartnerLinks |
|---|
|
Recherche tous les liens partenaires vers et depuis un compte donné. En-têtes d'autorisation : Cette méthode accepte les en-têtes facultatifs suivants pour définir la façon dont l'API autorise l'accès à la requête :
|
UserListDirectLicenseService
Service permettant de gérer les licences directes de listes d'utilisateurs. La suppression n'est pas une opération acceptée pour UserListDirectLicenses. Les appelants doivent définir l'état de la licence sur "DISABLED" (DÉSACTIVÉE) pour la désactiver.
Cette fonctionnalité n'est disponible que pour les partenaires de données.
| CreateUserListDirectLicense |
|---|
|
Crée une licence directe pour une liste d'utilisateurs. Cette fonctionnalité n'est disponible que pour les partenaires de données.
|
| GetUserListDirectLicense |
|---|
|
Récupère une licence directe pour une liste d'utilisateurs. Cette fonctionnalité n'est disponible que pour les partenaires de données.
|
| ListUserListDirectLicenses |
|---|
|
Liste toutes les licences directes de listes d'utilisateurs détenues par le compte parent. Cette fonctionnalité n'est disponible que pour les partenaires de données.
|
| UpdateUserListDirectLicense |
|---|
|
Met à jour une licence directe de liste d'utilisateurs. Cette fonctionnalité n'est disponible que pour les partenaires de données.
|
UserListGlobalLicenseService
Service permettant de gérer les licences globales de listes d'utilisateurs. La suppression n'est pas une opération acceptée pour UserListGlobalLicenses. Les appelants doivent définir l'état de la licence sur "DISABLED" (DÉSACTIVÉE) pour la désactiver.
Cette fonctionnalité n'est disponible que pour les partenaires de données.
| CreateUserListGlobalLicense |
|---|
|
Crée une licence globale pour une liste d'utilisateurs. Cette fonctionnalité n'est disponible que pour les partenaires de données.
|
| GetUserListGlobalLicense |
|---|
|
Récupère une licence globale de liste d'utilisateurs. Cette fonctionnalité n'est disponible que pour les partenaires de données.
|
| ListUserListGlobalLicenseCustomerInfos |
|---|
|
Liste toutes les informations client pour une licence globale de liste d'utilisateurs. Cette fonctionnalité n'est disponible que pour les partenaires de données.
|
| ListUserListGlobalLicenses |
|---|
|
Liste toutes les licences globales de listes d'utilisateurs détenues par le compte parent. Cette fonctionnalité n'est disponible que pour les partenaires de données.
|
| UpdateUserListGlobalLicense |
|---|
|
Met à jour une licence globale de liste d'utilisateurs. Cette fonctionnalité n'est disponible que pour les partenaires de données.
|
UserListService
Service permettant de gérer les ressources UserList.
| CreateUserList |
|---|
|
Crée une UserList. En-têtes d'autorisation : Cette méthode accepte les en-têtes facultatifs suivants pour définir la façon dont l'API autorise l'accès à la requête :
|
| DeleteUserList |
|---|
|
Supprime une UserList. En-têtes d'autorisation : Cette méthode accepte les en-têtes facultatifs suivants pour définir la façon dont l'API autorise l'accès à la requête :
|
| GetUserList |
|---|
|
Obtient une UserList. En-têtes d'autorisation : Cette méthode accepte les en-têtes facultatifs suivants pour définir la façon dont l'API autorise l'accès à la requête :
|
| ListUserLists |
|---|
|
Liste les listes d'utilisateurs. En-têtes d'autorisation : Cette méthode accepte les en-têtes facultatifs suivants pour définir la façon dont l'API autorise l'accès à la requête :
|
| UpdateUserList |
|---|
|
Met à jour une liste d'utilisateurs. En-têtes d'autorisation : Cette méthode accepte les en-têtes facultatifs suivants pour définir la façon dont l'API autorise l'accès à la requête :
|
AdIdentifiers
Identifiants et autres informations utilisés pour faire correspondre l'événement de conversion à d'autres activités en ligne (comme les clics sur les annonces).
| Champs | |
|---|---|
session_attributes |
Facultatif. Attributs de session pour l'attribution et la modélisation des événements. |
gclid |
Facultatif. ID de clic Google (gclid) associé à cet événement. |
gbraid |
Facultatif. Identifiant des clics associés aux événements d'application et provenant d'appareils iOS (à partir d'iOS 14). |
wbraid |
Facultatif. Identifiant des clics associés aux événements Web et provenant d'appareils iOS (à partir d'iOS 14). |
landing_page_device_info |
Facultatif. Informations recueillies sur l'appareil utilisé (le cas échéant) au moment de l'accès au site de l'annonceur après l'interaction avec l'annonce. |
AddressInfo
Informations sur l'adresse de l'utilisateur.
| Champs | |
|---|---|
given_name |
Obligatoire. Prénom de l'utilisateur, en minuscules, sans ponctuation, sans espace de début ni de fin, et haché au format SHA-256. |
family_name |
Obligatoire. Nom de famille de l'utilisateur, en minuscules, sans ponctuation, sans espace de début ni de fin, et haché au format SHA-256. |
region_code |
Obligatoire. Code de région à deux lettres au format ISO-3166-1 alpha-2 de l'adresse de l'utilisateur. |
postal_code |
Obligatoire. Code postal de l'adresse de l'utilisateur. |
Âge
Tranches d'âge démographiques
| Enums | |
|---|---|
AGE_RANGE_UNSPECIFIED |
Non spécifié. |
AGE_RANGE_UNKNOWN |
Inconnu. |
AGE_RANGE_18_24 |
Avoir entre 18 et 24 ans |
AGE_RANGE_25_34 |
Entre 25 et 34 ans |
AGE_RANGE_35_44 |
Entre 35 et 44 ans |
AGE_RANGE_45_54 |
Entre 45 et 54 ans |
AGE_RANGE_55_64 |
Entre 55 et 64 ans |
AGE_RANGE_65_UP |
65 ans et plus |
AudienceMember
Membre de l'audience sur lequel effectuer l'opération.
| Champs | |
|---|---|
destination_references[] |
Facultatif. Définit la |
consent |
Facultatif. Paramètre de consentement de l'utilisateur. |
Champ d'union data. Type de données d'identification à traiter. data ne peut être qu'un des éléments suivants : |
|
user_data |
Données fournies par l'utilisateur qui l'identifient. |
pair_data |
ID Publisher Advertiser Identity Reconciliation (PAIR) Cette fonctionnalité n'est disponible que pour les partenaires de données. |
mobile_data |
Données permettant d'identifier les appareils mobiles de l'utilisateur. |
user_id_data |
Données liées aux identifiants uniques d'un utilisateur, tels que définis par l'annonceur. |
ppid_data |
Données liées aux identifiants fournis par l'éditeur. Cette fonctionnalité n'est disponible que pour les partenaires de données. |
AwsWrappedKeyInfo
Clé de chiffrement des données encapsulée par une clé AWS KMS.
| Champs | |
|---|---|
key_type |
Obligatoire. Type d'algorithme utilisé pour chiffrer les données. |
role_arn |
Obligatoire. Nom de ressource Amazon du rôle IAM à assumer pour l'accès au déchiffrement KMS. Doit être au format |
kek_uri |
Obligatoire. URI de la clé AWS KMS utilisée pour déchiffrer la DEK. Doit être au format |
encrypted_dek |
Obligatoire. Clé de chiffrement des données chiffrées encodée en base64. |
KeyType
Type d'algorithme utilisé pour chiffrer les données.
| Enums | |
|---|---|
KEY_TYPE_UNSPECIFIED |
Type de clé non spécifié. Ce type ne doit jamais être utilisé. |
XCHACHA20_POLY1305 |
Algorithme XChaCha20-Poly1305 |
Référence
Critères de référence par rapport auxquels les insights sont comparés.
| Champs | |
|---|---|
Champ d'union baseline. Emplacement de référence auquel les insights sont comparés. baseline ne peut être qu'un des éléments suivants : |
|
baseline_location |
Emplacement de référence de la demande. L'emplacement de référence est une liste OR des régions demandées. |
location_auto_detection_enabled |
Si la valeur est définie sur "true", le service tente de détecter automatiquement le lieu de référence pour les insights. |
Emplacement
Emplacement de référence de la demande. La zone géographique de référence figure dans la liste OR des codes régionaux ISO 3166-1 alpha-2 des régions demandées.
| Champs | |
|---|---|
region_codes[] |
Liste des codes régionaux ISO 3166-1 alpha-2. |
CartData
Données du panier associées à l'événement.
| Champs | |
|---|---|
merchant_id |
Facultatif. ID Merchant Center associé aux articles. |
merchant_feed_label |
Facultatif. Libellé du flux Merchant Center associé au flux des articles. |
merchant_feed_language_code |
Facultatif. Code de langue ISO 639-1 associé au flux Merchant Center des articles que vous importez. |
transaction_discount |
Facultatif. Somme de toutes les remises associées à la transaction. |
items[] |
Facultatif. Liste des éléments associés à l'événement. |
Consentement
Paramètres de consentement de l'utilisateur pour la loi sur les marchés numériques (DMA, Digital Markets Act).
| Champs | |
|---|---|
ad_user_data |
Facultatif. Indique si l'utilisateur consent à ce que ses données soient utilisées pour les annonces. |
ad_personalization |
Facultatif. Indique si l'utilisateur accepte la personnalisation des annonces. |
ConsentStatus
Indique si l'utilisateur a accordé ou refusé son consentement, ou s'il ne l'a pas spécifié.
| Enums | |
|---|---|
CONSENT_STATUS_UNSPECIFIED |
Non spécifié. |
CONSENT_GRANTED |
Accordé. |
CONSENT_DENIED |
Refusée. |
ContactIdInfo
Informations supplémentaires lorsque CONTACT_ID fait partie des upload_key_types.
| Champs | |
|---|---|
match_rate_percentage |
Uniquement en sortie. Taux de correspondance pour les listes d'utilisateurs pour le ciblage par liste de clients. |
data_source_type |
Facultatif. Immuable. Source des données importées |
CreatePartnerLinkRequest
Demande de création d'une ressource PartnerLink. Renvoie un PartnerLink.
| Champs | |
|---|---|
parent |
Obligatoire. Parent qui possède cette collection de liens partenaires. Format : accountTypes/{account_type}/accounts/{account} |
partner_link |
Obligatoire. Lien de partenaire à créer. |
CreateUserListDirectLicenseRequest
Demande de création d'une ressource UserListDirectLicense.
| Champs | |
|---|---|
parent |
Obligatoire. Compte propriétaire de la liste d'utilisateurs pour laquelle une licence est accordée. Doit être au format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} |
user_list_direct_license |
Obligatoire. Licence directe de la liste d'utilisateurs à créer. |
CreateUserListGlobalLicenseRequest
Demande de création d'une ressource UserListGlobalLicense.
| Champs | |
|---|---|
parent |
Obligatoire. Compte propriétaire de la liste d'utilisateurs pour laquelle une licence est accordée. Doit être au format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} |
user_list_global_license |
Obligatoire. Licence globale de liste d'utilisateurs à créer. |
CreateUserListRequest
Message de requête pour CreateUserList.
| Champs | |
|---|---|
parent |
Obligatoire. Compte parent dans lequel cette liste d'utilisateurs sera créée. Format : accountTypes/{account_type}/accounts/{account} |
user_list |
Obligatoire. Liste d'utilisateurs à créer. |
validate_only |
Facultatif. Si la valeur est "true", la requête est validée, mais pas exécutée. |
Variable personnalisée
Variable personnalisée pour les conversions d'annonces.
| Champs | |
|---|---|
variable |
Facultatif. Nom de la variable personnalisée à définir. Si la variable n'est pas trouvée pour la destination indiquée, elle sera ignorée. |
value |
Facultatif. Valeur à stocker pour la variable personnalisée. |
destination_references[] |
Facultatif. Chaîne de référence utilisée pour déterminer à quel |
CustomerType
Type de client associé à l'événement.
| Enums | |
|---|---|
CUSTOMER_TYPE_UNSPECIFIED |
Type de client non spécifié. Ce type ne doit jamais être utilisé. |
NEW |
Le client est nouveau pour l'annonceur. |
RETURNING |
Le client revient vers l'annonceur. |
REENGAGED |
Le client a de nouveau interagi avec l'annonceur. |
CustomerValueBucket
Valeur du client évaluée par l'annonceur.
| Enums | |
|---|---|
CUSTOMER_VALUE_BUCKET_UNSPECIFIED |
Unspecified CustomerValueBucket. Ce type ne doit jamais être utilisé. |
LOW |
Le client a un faible potentiel. |
MEDIUM |
Le client a un potentiel moyen. |
HIGH |
Le client est à fort potentiel. |
DataSourceType
Indique la source des données importées.
| Enums | |
|---|---|
DATA_SOURCE_TYPE_UNSPECIFIED |
Non spécifié. |
DATA_SOURCE_TYPE_FIRST_PARTY |
Les données importées sont des données first party. |
DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU |
Les données importées proviennent d'un organisme de crédit tiers. |
DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE |
Les données importées proviennent d'un fichier d'électeurs tiers. |
DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA |
Les données importées sont des données de partenaires tiers. |
DeletePartnerLinkRequest
Demande de suppression d'une ressource PartnerLink. Renvoie un google.protobuf.Empty.
| Champs | |
|---|---|
name |
Obligatoire. Nom de ressource du lien partenaire à supprimer. Format : accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link} |
DeleteUserListRequest
Message de requête pour DeleteUserList.
| Champs | |
|---|---|
name |
Obligatoire. Nom de la liste d'utilisateurs à supprimer. Format : accountTypes/{account_type}/accounts/{account}/userLists/{user_list} |
validate_only |
Facultatif. Si la valeur est "true", la requête est validée, mais pas exécutée. |
Destination
Produit Google vers lequel vous envoyez des données. (par exemple, un compte Google Ads).
| Champs | |
|---|---|
reference |
Facultatif. ID de cette ressource |
login_account |
Facultatif. Compte utilisé pour effectuer cet appel d'API. Pour ajouter ou supprimer des données du |
linked_account |
Facultatif. Compte auquel le |
operating_account |
Obligatoire. Compte vers lequel envoyer les données ou depuis lequel les supprimer. |
product_destination_id |
Obligatoire. Objet du compte produit à ingérer. Par exemple, un ID d'audience Google Ads, un ID d'audience Display & Video 360 ou un ID d'action de conversion Google Ads. |
DeviceInfo
Informations sur l'appareil utilisé (le cas échéant) lors de l'événement.
| Champs | |
|---|---|
user_agent |
Facultatif. Chaîne user-agent de l'appareil pour le contexte donné. |
ip_address |
Facultatif. Adresse IP de l'appareil pour le contexte donné. Remarque : Google Ads n'accepte pas la mise en correspondance des adresses IP pour les utilisateurs finaux situés dans l'Espace économique européen (EEE), au Royaume-Uni (UK) ou en Suisse (CH). Ajoutez une logique pour exclure conditionnellement le partage des adresses IP des utilisateurs de ces régions. Assurez-vous également de fournir aux utilisateurs des informations claires et complètes sur les données que vous collectez sur vos sites, applications et autres propriétés, et d'obtenir leur consentement lorsque la loi ou les règles Google applicables l'exigent. Pour en savoir plus, consultez la page À propos de l'importation des conversions hors connexion. |
Encodage
Type d'encodage des informations d'identification hachées.
| Enums | |
|---|---|
ENCODING_UNSPECIFIED |
Type d'encodage non spécifié. Ce type ne doit jamais être utilisé. |
HEX |
Encodage hexadécimal. |
BASE64 |
Encodage Base64. |
EncryptionInfo
Informations sur le chiffrement des données ingérées.
| Champs | |
|---|---|
Champ d'union wrapped_key. La clé encapsulée utilisée pour chiffrer les données. La wrapped_key ne peut être qu'un des éléments suivants : |
|
gcp_wrapped_key_info |
Informations sur la clé encapsulée Google Cloud Platform. |
aws_wrapped_key_info |
Informations sur la clé encapsulée Amazon Web Services. |
ErrorCount
Nombre d'erreurs pour une raison donnée.
| Champs | |
|---|---|
record_count |
Nombre d'enregistrements dont l'importation a échoué pour une raison donnée. |
reason |
Motif de l'erreur pour les enregistrements ayant échoué. |
Information sur l'erreur
Nombre d'erreurs pour chaque type d'erreur.
| Champs | |
|---|---|
error_counts[] |
Liste des erreurs et du nombre d'erreurs par motif. Il est possible qu'il ne soit pas renseigné dans tous les cas. |
ErrorReason
Motifs d'erreur pour l'API Data Manager. REMARQUE : Cette énumération n'est pas figée et de nouvelles valeurs pourront être ajoutées à l'avenir.
| Enums | |
|---|---|
ERROR_REASON_UNSPECIFIED |
N'utilisez pas cette valeur par défaut. |
INTERNAL_ERROR |
Une erreur interne s'est produite. |
DEADLINE_EXCEEDED |
La requête a mis trop de temps à répondre. |
RESOURCE_EXHAUSTED |
Trop de requêtes. |
NOT_FOUND |
Ressource introuvable. |
PERMISSION_DENIED |
L'utilisateur ne dispose pas des autorisations nécessaires ou la ressource est introuvable. |
INVALID_ARGUMENT |
Un problème est survenu concernant cette demande. |
REQUIRED_FIELD_MISSING |
Un champ obligatoire n'est pas renseigné. |
INVALID_FORMAT |
Le format n'est pas valide. |
INVALID_HEX_ENCODING |
Le format de la valeur encodée en HEX est incorrect. |
INVALID_BASE64_ENCODING |
Le format de la valeur encodée en base64 est incorrect. |
INVALID_SHA256_FORMAT |
Le format de la valeur encodée en SHA256 est incorrect. |
INVALID_POSTAL_CODE |
Le code postal n'est pas valide. |
INVALID_COUNTRY_CODE |
Le code pays n'est pas valide. |
INVALID_ENUM_VALUE |
La valeur enum ne peut pas être utilisée. |
INVALID_USER_LIST_TYPE |
Le type de la liste d'utilisateurs n'est pas applicable à cette demande. |
INVALID_AUDIENCE_MEMBER |
Ce membre de l'audience n'est pas valide. |
TOO_MANY_AUDIENCE_MEMBERS |
Le nombre maximal de membres d'audience autorisé par requête est de 10 000. |
TOO_MANY_USER_IDENTIFIERS |
Le nombre maximal d'identifiants utilisateur autorisé par membre de l'audience est de 10. |
TOO_MANY_DESTINATIONS |
Le nombre maximal de destinations autorisées par demande est de 10. |
INVALID_DESTINATION |
Cette destination n'est pas valide. |
DATA_PARTNER_USER_LIST_MUTATE_NOT_ALLOWED |
Le partenaire de données n'a pas accès à la liste des utilisateurs propriétaires du compte d'exploitation. |
INVALID_MOBILE_ID_FORMAT |
Le format de l'ID mobile n'est pas valide. |
INVALID_USER_LIST_ID |
La liste d'utilisateurs n'est pas valide. |
MULTIPLE_DATA_TYPES_NOT_ALLOWED |
Vous ne pouvez pas ingérer plusieurs types de données dans une même requête. |
DIFFERENT_LOGIN_ACCOUNTS_NOT_ALLOWED_FOR_DATA_PARTNER |
Les configurations de destination contenant un compte de connexion DataPartner doivent avoir le même compte de connexion dans toutes les configurations de destination. |
TERMS_AND_CONDITIONS_NOT_SIGNED |
Les conditions d'utilisation requises n'ont pas été acceptées. |
INVALID_NUMBER_FORMAT |
Format de nombre non valide. |
INVALID_CONVERSION_ACTION_ID |
L'ID de l'action de conversion n'est pas valide. |
INVALID_CONVERSION_ACTION_TYPE |
Le type d'action de conversion n'est pas valide. |
INVALID_CURRENCY_CODE |
Le code de devise n'est pas accepté. |
INVALID_EVENT |
Cet événement n'est pas valide. |
TOO_MANY_EVENTS |
Le nombre maximal d'événements autorisés par requête est de 10 000. |
DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS |
Le suivi avancé des conversions pour les prospects n'est pas activé dans le compte de destination. |
DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS |
Impossible d'utiliser le suivi avancé des conversions pour le compte de destination en raison des règles Google sur les données client. Contactez votre représentant Google. |
DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED |
Le compte de destination n'a pas accepté les conditions d'utilisation du suivi avancé des conversions. |
DUPLICATE_DESTINATION_REFERENCE |
Au moins deux destinations de la demande ont la même référence. |
UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER |
Compte d'exploitation non compatible pour l'autorisation des partenaires de données. |
UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER |
Compte associé non accepté pour l'autorisation du partenaire pour les données. |
NO_IDENTIFIERS_PROVIDED |
Les données d'événements ne contiennent aucun identifiant utilisateur ni aucun identifiant publicitaire. |
INVALID_PROPERTY_TYPE |
Le type de propriété n'est pas accepté. |
INVALID_STREAM_TYPE |
Le type de flux n'est pas accepté. |
LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT |
L'association de compte n'est possible que si le compte de connexion est un compte DATA_PARTNER. |
OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH |
Le compte de connexion doit être le même que le compte d'exploitation pour le cas d'utilisation donné. |
EVENT_TIME_INVALID |
L'événement ne s'est pas produit dans le délai acceptable. |
RESERVED_NAME_USED |
Le paramètre utilise un nom réservé. |
INVALID_EVENT_NAME |
Le nom de l'événement n'est pas accepté. |
NOT_ALLOWLISTED |
Le compte n'est pas autorisé à utiliser la fonctionnalité indiquée. |
INVALID_REQUEST_ID |
L'ID de demande utilisé pour récupérer l'état d'une demande n'est pas valide. L'état ne peut être récupéré que pour les requêtes qui aboutissent et qui ne comportent pas validate_only=true. |
MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT |
Un événement comportait au moins deux destinations Google Analytics. |
FIELD_VALUE_TOO_LONG |
La valeur du champ est trop longue. |
TOO_MANY_ELEMENTS |
La requête contient trop d'éléments dans une liste. |
ALREADY_EXISTS |
La ressource existe déjà. |
IMMUTABLE_FIELD_FOR_UPDATE |
Tentative de définition d'un champ immuable pour une demande de mise à jour. |
INVALID_RESOURCE_NAME |
Le nom de la ressource n'est pas valide. |
INVALID_FILTER |
Le filtre de requête n'est pas valide. |
INVALID_UPDATE_MASK |
Le masque de mise à jour n'est pas valide. |
INVALID_PAGE_TOKEN |
Le jeton de page n'est pas valide. |
CANNOT_UPDATE_DISABLED_LICENSE |
Vous ne pouvez pas mettre à jour une licence qui a été désactivée. |
CANNOT_CREATE_LICENSE_FOR_SENSITIVE_USERLIST |
Les listes d'utilisateurs sensibles ne peuvent pas être concédées sous licence à ce client. |
INSUFFICIENT_COST |
Le coût est trop faible pour cette licence. |
CANNOT_DISABLE_LICENSE |
La licence de revendeur ne peut pas être désactivée, car elle est en cours d'utilisation. |
INVALID_CLIENT_ACCOUNT_ID |
Numéro de compte client incorrect. |
PRICING_ONLY_ZERO_COST_ALLOWED |
Un coût non nul n'est pas autorisé pour ce compte client. |
PRICE_TOO_HIGH |
Le coût est trop élevé pour cette licence. |
CUSTOMER_NOT_ALLOWED_TO_CREATE_LICENSE |
Le client n'est pas autorisé à créer une licence. |
INVALID_PRICING_END_DATE |
La date de fin de la tarification n'est pas valide pour cette licence. |
CANNOT_LICENSE_LOGICAL_LIST_WITH_LICENSED_OR_SHARED_SEGMENT |
Il est impossible d'autoriser une liste d'utilisateurs logique avec un segment partagé ou autorisé. |
MISMATCHED_ACCOUNT_TYPE |
Le type de compte client dans la demande ne correspond pas au type de compte réel du client. |
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_LICENSE_TYPE |
Le type de licence ne permet pas de partager les coûts des contenus multimédias. |
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_CLIENT_CUSTOMER |
Le type de client n'est pas compatible avec le coût de partage média. |
INVALID_MEDIA_SHARE_COST |
Coût de part média non valide. |
INVALID_COST_TYPE |
Type de coût non valide. |
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_NON_COMMERCE_USER_LIST |
Le type UserList n'est pas compatible avec le coût de partage de contenu multimédia. |
MAX_COST_NOT_ALLOWED |
Le coût maximal n'est autorisé que pour le cost_type MEDIA_SHARE. |
COMMERCE_AUDIENCE_CAN_ONLY_BE_DIRECTLY_LICENSED |
L'audience commerciale ne peut être concédée sous licence que directement. |
INVALID_DESCRIPTION |
La description n'est pas valide. |
INVALID_DISPLAY_NAME |
Le nom à afficher n'est pas valide. |
DISPLAY_NAME_ALREADY_USED |
Le nom à afficher est déjà utilisé pour une autre liste d'utilisateurs du compte. |
OWNERSHIP_REQUIRED_FOR_UPDATE |
Vous devez être propriétaire pour modifier la liste des utilisateurs. |
USER_LIST_MUTATION_NOT_SUPPORTED |
Le type de liste d'utilisateurs est en lecture seule et n'est pas compatible avec la mutation. |
SENSITIVE_USER_LIST_IMMUTABLE |
Les utilisateurs externes ne peuvent pas modifier une liste d'utilisateurs refusée pour des raisons juridiques ou de confidentialité. |
BILLABLE_RECORD_COUNT_IMMUTABLE |
Une fois défini, le champ "Enregistrement facturable" de la liste d'utilisateurs pour le remarketing ne peut plus être modifié. |
USER_LIST_NAME_RESERVED |
Le nom de la liste d'utilisateurs est réservé aux listes système. |
ADVERTISER_NOT_ALLOWLISTED_FOR_UPLOADED_DATA |
L'annonceur doit être ajouté à la liste d'autorisation pour pouvoir utiliser les listes de remarketing créées à partir des données qu'il a importées. |
UNSUPPORTED_PARTNER_AUDIENCE_SOURCE |
La source d'audience partenaire n'est pas compatible avec le type de liste d'utilisateurs. |
COMMERCE_PARTNER_NOT_ALLOWED |
La définition du champ commerce_partner n'est acceptée que si partner_audience_source est COMMERCE_AUDIENCE. |
UNSUPPORTED_PARTNER_AUDIENCE_INFO |
Le champ partner_audience_info n'est pas compatible avec le type de liste d'utilisateurs. |
PARTNER_MATCH_FOR_MANAGER_ACCOUNT_DISALLOWED |
Les comptes administrateur ne peuvent pas créer de listes d'utilisateurs pour le ciblage par liste de partenaires. |
DATA_PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA |
Le partenaire de données ne figure pas dans la liste d'autorisation pour THIRD_PARTY_PARTNER_DATA. |
ADVERTISER_TOS_NOT_ACCEPTED |
L'annonceur n'a pas accepté les conditions d'utilisation du partenaire. |
ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA |
L'annonceur ne figure pas sur la liste autorisée pour THIRD_PARTY_PARTNER_DATA. |
USER_LIST_TYPE_NOT_SUPPORTED_FOR_ACCOUNT |
Ce type de liste d'utilisateurs n'est pas compatible avec ce compte. |
INVALID_COMMERCE_PARTNER |
Le champ commerce_partner n'est pas valide. |
CUSTOMER_NOT_ALLOWLISTED_FOR_COMMERCE_AUDIENCE |
Le fournisseur de données ne figure pas sur la liste autorisée à créer des audiences commerciales. |
UNSUPPORTED_USER_LIST_UPLOAD_KEY_TYPES |
Les types de clés d'importation de listes d'utilisateurs ne sont pas acceptés. |
UNSUPPORTED_INGESTED_USER_LIST_INFO_CONFIG |
La configuration des informations de la liste d'utilisateurs ingérée n'est pas acceptée. |
UNSUPPORTED_ACCOUNT_TYPES_FOR_USER_LIST_TYPE |
Les types de comptes ne sont pas compatibles avec le type de liste d'utilisateurs. |
UNSUPPORTED_ACCOUNT_TYPE_FOR_PARTNER_LINK |
Les types de comptes ne sont pas acceptés pour l'association de partenaire. |
Événement
Événement représentant une interaction utilisateur avec le site Web ou l'application d'un annonceur.
| Champs | |
|---|---|
destination_references[] |
Facultatif. Chaîne de référence utilisée pour déterminer la destination. Si ce champ est vide, l'événement sera envoyé à tous les |
transaction_id |
Facultatif. Identifiant unique de cet événement. Obligatoire pour les conversions utilisant plusieurs sources de données. |
event_timestamp |
Obligatoire. Heure à laquelle l'événement s'est produit. |
last_updated_timestamp |
Facultatif. Date de la dernière mise à jour de l'événement. |
user_data |
Facultatif. Éléments de données fournies par l'utilisateur, représentant l'utilisateur auquel l'événement est associé. |
consent |
Facultatif. Informations indiquant si l'utilisateur associé a donné différents types de consentement. |
ad_identifiers |
Facultatif. Identifiants et autres informations utilisés pour faire correspondre l'événement de conversion à d'autres activités en ligne (comme les clics sur les annonces). |
currency |
Facultatif. Code de devise associé à toutes les valeurs monétaires de cet événement. |
event_source |
Facultatif. Signal indiquant où l'événement s'est produit (sur le Web, dans une application, en magasin, etc.). |
event_device_info |
Facultatif. Informations recueillies sur l'appareil utilisé (le cas échéant) au moment de l'événement. |
cart_data |
Facultatif. Informations sur la transaction et les articles associés à l'événement. |
custom_variables[] |
Facultatif. Informations supplémentaires sur les paires clé/valeur à envoyer aux conteneurs de conversion (action de conversion ou activité Floodlight). |
experimental_fields[] |
Facultatif. Liste de paires clé/valeur pour les champs expérimentaux qui pourront éventuellement être promus pour faire partie de l'API. |
user_properties |
Facultatif. Informations évaluées par l'annonceur sur l'utilisateur au moment de l'événement. |
event_name |
Facultatif. Nom de l'événement. Obligatoire pour les événements GA4. |
client_id |
Facultatif. Identifiant unique de l'instance utilisateur d'un client Web pour ce flux Web GA4. |
user_id |
Facultatif. Identifiant unique d'un utilisateur, tel que défini par l'annonceur. |
additional_event_parameters[] |
Facultatif. Un bucket de paramètres d'événement à inclure dans l'événement qui n'ont pas déjà été spécifiés à l'aide d'autres champs structurés. |
conversion_value |
Facultatif. Valeur de conversion associée à l'événement, pour les conversions basées sur la valeur. |
EventParameter
Paramètre d'événement pour les événements GA4.
| Champs | |
|---|---|
parameter_name |
Obligatoire. Nom du paramètre à utiliser. |
value |
Obligatoire. Représentation sous forme de chaîne de la valeur du paramètre à définir. |
EventSource
Source de l'événement.
| Enums | |
|---|---|
EVENT_SOURCE_UNSPECIFIED |
EventSource non spécifié. Ce type ne doit jamais être utilisé. |
WEB |
L'événement a été généré à partir d'un navigateur Web. |
APP |
L'événement a été généré à partir d'une application. |
IN_STORE |
L'événement a été généré à partir d'une transaction en magasin. |
PHONE |
L'événement a été généré à partir d'un appel téléphonique. |
OTHER |
L'événement a été généré à partir d'autres sources. |
ExperimentalField
Champ expérimental représentant les champs non officiels.
| Champs | |
|---|---|
field |
Facultatif. Nom du champ à utiliser. |
value |
Facultatif. Valeur à définir pour le champ. |
GcpWrappedKeyInfo
Informations sur la clé de chiffrement Google Cloud Platform.
| Champs | |
|---|---|
key_type |
Obligatoire. Type d'algorithme utilisé pour chiffrer les données. |
wip_provider |
Obligatoire. Fournisseur de pool Workload Identity requis pour utiliser la clé de chiffrement de clé. |
kek_uri |
Obligatoire. ID de ressource Cloud Key Management Service de Google Cloud Platform. Doit être au format |
encrypted_dek |
Obligatoire. Clé de chiffrement des données chiffrées encodée en base64. |
KeyType
Type d'algorithme utilisé pour chiffrer les données.
| Enums | |
|---|---|
KEY_TYPE_UNSPECIFIED |
Type de clé non spécifié. Ce type ne doit jamais être utilisé. |
XCHACHA20_POLY1305 |
Algorithme XChaCha20-Poly1305 |
Sexe
Type de genre démographique (par exemple, "féminin").
| Enums | |
|---|---|
GENDER_UNSPECIFIED |
Non spécifié. |
GENDER_UNKNOWN |
Inconnu. |
GENDER_MALE |
Homme. |
GENDER_FEMALE |
Femme. |
GetUserListDirectLicenseRequest
Requête permettant d'obtenir une ressource UserListDirectLicense.
| Champs | |
|---|---|
name |
Obligatoire. Nom de ressource de la licence directe de la liste d'utilisateurs. |
GetUserListGlobalLicenseRequest
Requête permettant d'obtenir une ressource UserListGlobalLicense.
| Champs | |
|---|---|
name |
Obligatoire. Nom de ressource de la licence globale de la liste d'utilisateurs. |
GetUserListRequest
Message de requête pour GetUserList.
| Champs | |
|---|---|
name |
Obligatoire. Nom de ressource de la UserList à récupérer. Format : accountTypes/{account_type}/accounts/{account}/userLists/{user_list} |
IngestAudienceMembersRequest
Demande d'importer des membres d'audience vers les destinations fournies. Renvoie un IngestAudienceMembersResponse.
| Champs | |
|---|---|
destinations[] |
Obligatoire. Liste des destinations vers lesquelles envoyer les membres de l'audience. |
audience_members[] |
Obligatoire. Liste des utilisateurs à envoyer vers les destinations spécifiées. Vous ne pouvez pas envoyer plus de 10 000 ressources |
consent |
Facultatif. Consentement au niveau de la demande à appliquer à tous les utilisateurs de la demande. Le consentement au niveau de l'utilisateur remplace celui au niveau de la demande et peut être spécifié dans chaque |
validate_only |
Facultatif. À des fins de test. Si la valeur est |
encoding |
Facultatif. Obligatoire pour les importations |
encryption_info |
Facultatif. Informations sur le chiffrement des importations |
terms_of_service |
Facultatif. Conditions d'utilisation que l'utilisateur a acceptées ou refusées. |
IngestAudienceMembersResponse
Réponse de IngestAudienceMembersRequest.
| Champs | |
|---|---|
request_id |
ID généré automatiquement pour la demande. |
IngestEventsRequest
Demande d'importer des membres d'audience vers les destinations fournies. Renvoie un IngestEventsResponse.
| Champs | |
|---|---|
destinations[] |
Obligatoire. Liste des destinations auxquelles envoyer les événements. |
events[] |
Obligatoire. Liste des événements à envoyer aux destinations spécifiées. Vous ne pouvez envoyer que 2 000 ressources |
consent |
Facultatif. Consentement au niveau de la demande à appliquer à tous les utilisateurs de la demande. Le consentement au niveau de l'utilisateur remplace celui au niveau de la demande et peut être spécifié dans chaque |
validate_only |
Facultatif. À des fins de test. Si la valeur est |
encoding |
Facultatif. Obligatoire pour les importations |
encryption_info |
Facultatif. Informations sur le chiffrement des importations |
IngestEventsResponse
Réponse de IngestEventsRequest.
| Champs | |
|---|---|
request_id |
ID généré automatiquement pour la demande. |
IngestedUserListInfo
Représente une liste d'utilisateurs renseignée à partir des données fournies par l'utilisateur.
| Champs | |
|---|---|
upload_key_types[] |
Obligatoire. Immuable. Types de clés d'importation de cette liste d'utilisateurs. |
contact_id_info |
Facultatif. Informations supplémentaires lorsque |
mobile_id_info |
Facultatif. Informations supplémentaires lorsque |
user_id_info |
Facultatif. Informations supplémentaires lorsque |
pair_id_info |
Facultatif. Informations supplémentaires lorsque Cette fonctionnalité n'est disponible que pour les partenaires de données. |
pseudonymous_id_info |
Facultatif. Les informations supplémentaires pour |
partner_audience_info |
Facultatif. Informations supplémentaires pour les audiences partenaires. Cette fonctionnalité n'est disponible que pour les partenaires de données. |
UploadKeyType
Énumération contenant les types de clés d'importation possibles d'une liste d'utilisateurs.
| Enums | |
|---|---|
UPLOAD_KEY_TYPE_UNSPECIFIED |
Non spécifié. |
CONTACT_ID |
Informations sur les clients, telles que leur adresse e-mail, leur numéro de téléphone ou leur adresse physique. |
MOBILE_ID |
Identifiants publicitaires pour mobile. |
USER_ID |
ID utilisateur fournis par des tiers. |
PAIR_ID |
ID de rapprochement de l'identité des annonceurs et des éditeurs. |
PSEUDONYMOUS_ID |
ID de plate-forme de gestion des données : - ID utilisateur Google ; - ID fourni par le partenaire ; - ID fourni par l'éditeur ; - IDFA iOS ; - Identifiant publicitaire Android ; - ID Roku ; - ID Amazon Fire TV ; - ID Xbox ou Microsoft |
Élément
Représente un article du panier associé à l'événement.
| Champs | |
|---|---|
merchant_product_id |
Facultatif. ID du produit dans le compte Merchant Center. |
quantity |
Facultatif. Nombre de cet article associé à l'événement. |
unit_price |
Facultatif. Prix unitaire hors taxes, frais de port et toute remise appliquée aux transactions. |
item_id |
Facultatif. Identifiant unique permettant de faire référence à l'élément. |
additional_item_parameters[] |
Facultatif. Un bucket de paramètres d'événement liés à un élément à inclure dans l'événement qui n'ont pas déjà été spécifiés à l'aide d'autres champs structurés. |
ItemParameter
Un bucket de paramètres d'événement liés à un élément à inclure dans l'événement qui n'ont pas déjà été spécifiés à l'aide d'autres champs structurés.
| Champs | |
|---|---|
parameter_name |
Obligatoire. Nom du paramètre à utiliser. |
value |
Obligatoire. Représentation sous forme de chaîne de la valeur du paramètre à définir. |
ListUserListDirectLicensesRequest
Demande de liste de toutes les ressources UserListDirectLicense pour un compte donné.
| Champs | |
|---|---|
parent |
Obligatoire. Compte dont les licences sont interrogées. Doit être au format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} |
filter |
Facultatif. Filtres à appliquer à la requête de liste. Tous les champs doivent se trouver à gauche de chaque condition (par exemple, user_list_id = 123). Opérations compatibles :
Champs non compatibles :
|
page_size |
Facultatif. Nombre maximal de licences à renvoyer par page. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 licences au maximum sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000. |
page_token |
Facultatif. Jeton de page reçu d'un appel Lors de la pagination, tous les autres paramètres fournis à |
ListUserListDirectLicensesResponse
Réponse de ListUserListDirectLicensesRequest.
| Champs | |
|---|---|
user_list_direct_licenses[] |
Licences pour la liste d'utilisateurs spécifiée dans la requête. |
next_page_token |
Jeton pouvant être envoyé en tant que |
ListUserListGlobalLicenseCustomerInfosRequest
Demande de liste de toutes les ressources UserListGlobalLicenseCustomerInfo pour une licence globale de liste d'utilisateurs donnée.
| Champs | |
|---|---|
parent |
Obligatoire. Licence mondiale dont les informations client sont demandées. Format requis : |
filter |
Facultatif. Filtres à appliquer à la requête de liste. Tous les champs doivent se trouver à gauche de chaque condition (par exemple, user_list_id = 123). Opérations compatibles :
Champs non compatibles :
|
page_size |
Facultatif. Nombre maximal de licences à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 licences au maximum sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000. |
page_token |
Facultatif. Jeton de page reçu d'un appel Lors de la pagination, tous les autres paramètres fournis à |
ListUserListGlobalLicenseCustomerInfosResponse
Réponse à la requête [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest].
| Champs | |
|---|---|
user_list_global_license_customer_infos[] |
Informations sur le client pour la licence donnée dans la requête. |
next_page_token |
Jeton pouvant être envoyé en tant que |
ListUserListGlobalLicensesRequest
Demande de liste de toutes les ressources UserListGlobalLicense pour un compte donné.
| Champs | |
|---|---|
parent |
Obligatoire. Compte dont les licences sont interrogées. Doit être au format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} |
filter |
Facultatif. Filtres à appliquer à la requête de liste. Tous les champs doivent se trouver à gauche de chaque condition (par exemple, user_list_id = 123). Opérations compatibles :
Champs non compatibles :
|
page_size |
Facultatif. Nombre maximal de licences à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 licences au maximum sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000. |
page_token |
Facultatif. Jeton de page reçu d'un appel Lors de la pagination, tous les autres paramètres fournis à |
ListUserListGlobalLicensesResponse
Réponse de ListUserListGlobalLicensesRequest.
| Champs | |
|---|---|
user_list_global_licenses[] |
Licences pour la liste d'utilisateurs spécifiée dans la requête. |
next_page_token |
Jeton pouvant être envoyé en tant que |
ListUserListsRequest
Message de requête pour ListUserLists.
| Champs | |
|---|---|
parent |
Obligatoire. Compte parent qui possède cette collection de listes d'utilisateurs. Format : accountTypes/{account_type}/accounts/{account} |
page_size |
Facultatif. Nombre maximal de listes d'utilisateurs à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 listes d'utilisateurs au maximum sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000. |
page_token |
Facultatif. Jeton de page reçu d'un appel Lors de la pagination, tous les autres paramètres fournis à |
filter |
Facultatif. Une chaîne de filtre. Tous les champs doivent se trouver à gauche de chaque condition (par exemple, Opérations compatibles :
Champs acceptés :
|
ListUserListsResponse
Message de réponse pour ListUserLists.
| Champs | |
|---|---|
user_lists[] |
Liste des utilisateurs du compte spécifié. |
next_page_token |
Jeton pouvant être envoyé en tant que |
MatchRateRange
Plage du taux de correspondance de la liste importée ou de la liste d'utilisateurs.
| Enums | |
|---|---|
MATCH_RATE_RANGE_UNKNOWN |
La plage du taux de correspondance est inconnue. |
MATCH_RATE_RANGE_NOT_ELIGIBLE |
La plage de taux de correspondance n'est pas éligible. |
MATCH_RATE_RANGE_LESS_THAN_20 |
La plage du taux de correspondance est inférieure à 20 % (dans l'intervalle [0, 20)). |
MATCH_RATE_RANGE_20_TO_30 |
Le taux de correspondance est compris entre 20 % et 30 % (dans l'intervalle [20, 31)). |
MATCH_RATE_RANGE_31_TO_40 |
La plage du taux de correspondance est comprise entre 31 % et 40 % (dans l'intervalle [31, 41)). |
MATCH_RATE_RANGE_41_TO_50 |
Le taux de correspondance est compris entre 41 % et 50 % (dans l'intervalle [41, 51)). |
MATCH_RATE_RANGE_51_TO_60 |
Le taux de correspondance est compris entre 51 % et 60 % (dans l'intervalle [51, 61)). |
MATCH_RATE_RANGE_61_TO_70 |
La plage du taux de correspondance est comprise entre 61 % et 70 % (dans l'intervalle [61, 71)). |
MATCH_RATE_RANGE_71_TO_80 |
La plage du taux de correspondance est comprise entre 71 % et 80 % (dans l'intervalle [71, 81)). |
MATCH_RATE_RANGE_81_TO_90 |
Le taux de correspondance est compris entre 81 % et 90 % (dans l'intervalle [81, 91)). |
MATCH_RATE_RANGE_91_TO_100 |
La plage du taux de correspondance est comprise entre 91 % et 100 % (dans l'intervalle |
MobileData
ID mobiles pour l'audience. Vous devez indiquer au moins un identifiant mobile.
| Champs | |
|---|---|
mobile_ids[] |
Obligatoire. Liste des ID d'appareils mobiles (identifiant publicitaire/IDFA). Vous ne pouvez pas fournir plus de 10 |
MobileIdInfo
Informations supplémentaires lorsque MOBILE_ID fait partie des upload_key_types.
| Champs | |
|---|---|
data_source_type |
Facultatif. Immuable. Source des données importées. |
key_space |
Obligatoire. Immuable. Espace de clés des ID mobiles. |
app_id |
Obligatoire. Immuable. Chaîne qui identifie de manière unique une application mobile à partir de laquelle les données ont été collectées. |
KeySpace
Espace de clés pour l'identité mobile.
| Enums | |
|---|---|
KEY_SPACE_UNSPECIFIED |
Non spécifié. |
IOS |
Espace de clés iOS. |
ANDROID |
Espace de clés Android. |
PairData
ID PAIR pour l'audience. Veuillez indiquer au moins un ID PAIR.
Cette fonctionnalité n'est disponible que pour les partenaires de données.
| Champs | |
|---|---|
pair_ids[] |
Obligatoire. Données permettant d'identifier personnellement l'utilisateur fournies par la cleanroom, hachées avec SHA256 et chiffrées avec un chiffrement EC commutatif à l'aide de la clé de l'éditeur pour la liste des utilisateurs PAIR. Vous ne pouvez pas fournir plus de 10 |
PairIdInfo
Informations supplémentaires lorsque PAIR_ID fait partie des upload_key_types.
Cette fonctionnalité n'est disponible que pour les partenaires de données.
| Champs | |
|---|---|
match_rate_percentage |
Uniquement en sortie. Ce champ indique le pourcentage de membres de cette liste d'utilisateurs correspondant aux données first party de l'éditeur. Doit être compris entre 0 et 100 (inclus). |
advertiser_identifier_count |
Uniquement en sortie. Nombre d'enregistrements de données first party de l'annonceur importés chez un fournisseur de data clean room. Cela n'indique pas la taille d'une liste d'utilisateurs PAIR. |
publisher_id |
Obligatoire. Immuable. Identifie l'éditeur avec lequel la liste d'utilisateurs Publisher Advertiser Identity Reconciliation est réconciliée. Ce champ est fourni par le fournisseur de salle blanche et n'est unique que dans le champ d'application de cette salle blanche. Cette chaîne ne peut pas être utilisée comme identifiant global dans plusieurs cleanrooms. |
publisher_name |
Facultatif. Nom descriptif de l'éditeur à afficher dans l'UI pour une meilleure expérience de ciblage. |
clean_room_identifier |
Obligatoire. Immuable. Identifie une relation unique entre un annonceur et un éditeur avec un ou plusieurs fournisseurs de salles blanches. |
PartnerAudienceInfo
Informations supplémentaires pour les audiences partenaires.
Cette fonctionnalité n'est disponible que pour les partenaires de données.
| Champs | |
|---|---|
partner_audience_source |
Obligatoire. Immuable. Source de l'audience partenaire. |
commerce_partner |
Facultatif. Nom du partenaire commercial. Uniquement autorisé si |
PartnerAudienceSource
Source d'audience partenaire.
| Enums | |
|---|---|
PARTNER_AUDIENCE_SOURCE_UNSPECIFIED |
Non spécifié. |
COMMERCE_AUDIENCE |
La source d'audience partenaire est une audience pour le commerce. |
LINEAR_TV_AUDIENCE |
La source d'audience partenaire est l'audience de la TV linéaire. |
AGENCY_PROVIDER_AUDIENCE |
La source d'audience partenaire est une audience d'agence/fournisseur. |
PartnerLink
Association de partenaire entre un compte propriétaire et un compte partenaire.
| Champs | |
|---|---|
name |
Identifiant. Nom du lien partenaire. Format : accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link} |
partner_link_id |
Uniquement en sortie. ID du lien de partenaire. |
owning_account |
Obligatoire. Compte propriétaire qui accorde l'accès au compte partenaire. |
partner_account |
Obligatoire. Compte partenaire auquel le compte propriétaire a accordé l'accès. |
PpidData
Données des identifiants fournis par l'éditeur contenant les PPID. Veuillez indiquer au moins un PPID.
Cette fonctionnalité n'est disponible que pour les partenaires de données.
| Champs | |
|---|---|
ppids[] |
Obligatoire. Liste des identifiants fournis par l'éditeur pour un utilisateur. |
ProcessingErrorReason
Raison de l'erreur de traitement.
| Enums | |
|---|---|
PROCESSING_ERROR_REASON_UNSPECIFIED |
Le motif de l'erreur de traitement est inconnu. |
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE |
La variable personnalisée n'est pas valide. |
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED |
L'état de la variable personnalisée n'est pas "Activée". |
PROCESSING_ERROR_REASON_EVENT_TOO_OLD |
La conversion est plus ancienne que l'ancienneté maximale autorisée. |
PROCESSING_ERROR_REASON_DENIED_CONSENT |
L'accès aux données utilisateur des annonces est refusé, soit par l'utilisateur, soit dans les paramètres par défaut de l'annonceur. |
PROCESSING_ERROR_REASON_NO_CONSENT |
L'annonceur n'a pas donné son consentement à un tiers pour les services de la plate-forme principale Ads. |
PROCESSING_ERROR_REASON_UNKNOWN_CONSENT |
Le consentement global (déterminé à partir du consentement au niveau de la ligne, du consentement au niveau de la demande et des paramètres du compte) n'a pas pu être déterminé pour cet utilisateur. |
PROCESSING_ERROR_REASON_DUPLICATE_GCLID |
Une conversion associée au même GCLID, et aux mêmes date et heure existe déjà dans le système. |
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID |
Une conversion présentant la même combinaison d'ID de commande et d'action de conversion a déjà été importée. |
PROCESSING_ERROR_REASON_INVALID_GBRAID |
Impossible de décoder le gbraid. |
PROCESSING_ERROR_REASON_INVALID_GCLID |
Impossible de décoder l'ID de clic Google. |
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID |
L'ID du marchand contient des caractères non numériques. |
PROCESSING_ERROR_REASON_INVALID_WBRAID |
Impossible de décoder le wbraid. |
PROCESSING_ERROR_REASON_INTERNAL_ERROR |
Erreur interne. |
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED |
Les conditions d'utilisation du suivi avancé des conversions n'ont pas été signées dans le compte de destination. |
PROCESSING_ERROR_REASON_INVALID_EVENT |
L'événement n'est pas valide. |
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS |
Le nombre de transactions correspondantes est inférieur au seuil minimal. |
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS |
Les transactions sont inférieures au seuil minimal. |
PROCESSING_ERROR_REASON_INVALID_FORMAT |
L'événement présente une erreur de format. |
PROCESSING_ERROR_REASON_DECRYPTION_ERROR |
L'événement présente une erreur de déchiffrement. |
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR |
Échec du déchiffrement de la clé DEK. |
PROCESSING_ERROR_REASON_INVALID_WIP |
Le format du numéro de série n'est pas valide ou le numéro de série n'existe pas. |
PROCESSING_ERROR_REASON_INVALID_KEK |
La KEK ne peut pas déchiffrer les données, car elle est incorrecte ou n'existe pas. |
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED |
Le pool d'identités de charge de travail n'a pas pu être utilisé, car il a été refusé par sa condition d'attestation. |
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED |
Le système ne disposait pas des autorisations nécessaires pour accéder à la clé KEK. |
PROCESSING_ERROR_REASON_AWS_AUTH_FAILED |
Le système n'a pas réussi à s'authentifier auprès d'AWS. |
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
Échec du déchiffrement des données UserIdentifier à l'aide de la clé DEK. |
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER |
L'utilisateur a tenté d'ingérer des événements avec un identifiant publicitaire qui ne provient pas des annonces du compte d'exploitation. |
ProcessingWarningReason
Motif de l'avertissement de traitement.
| Enums | |
|---|---|
PROCESSING_WARNING_REASON_UNSPECIFIED |
Le motif de l'avertissement de traitement est inconnu. |
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED |
Le système ne disposait pas des autorisations nécessaires pour accéder à la clé KEK. |
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR |
Échec du déchiffrement de la clé DEK. |
PROCESSING_WARNING_REASON_DECRYPTION_ERROR |
L'événement présente une erreur de déchiffrement. |
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED |
Le pool d'identités de charge de travail n'a pas pu être utilisé, car il a été refusé par sa condition d'attestation. |
PROCESSING_WARNING_REASON_INVALID_WIP |
Le format du numéro de série n'est pas valide ou le numéro de série n'existe pas. |
PROCESSING_WARNING_REASON_INVALID_KEK |
La KEK ne peut pas déchiffrer les données, car elle est incorrecte ou n'existe pas. |
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
Échec du déchiffrement des données UserIdentifier à l'aide de la clé DEK. |
PROCESSING_WARNING_REASON_INTERNAL_ERROR |
Erreur interne. |
PROCESSING_WARNING_REASON_AWS_AUTH_FAILED |
Le système n'a pas réussi à s'authentifier auprès d'AWS. |
Produit
Obsolète. Utilisez à la place. Représente un produit Google spécifique.AccountType
| Enums | |
|---|---|
PRODUCT_UNSPECIFIED |
Produit non spécifié. Ce type ne doit jamais être utilisé. |
GOOGLE_ADS |
Google Ads |
DISPLAY_VIDEO_PARTNER |
Partenaire Display & Video 360. |
DISPLAY_VIDEO_ADVERTISER |
Annonceur Display & Video 360. |
DATA_PARTNER |
Partenaire pour les données. |
ProductAccount
Représente un compte spécifique.
| Champs | |
|---|---|
product |
Obsolète. Utilisez |
account_id |
Obligatoire. ID du compte. Par exemple, l'ID de votre compte Google Ads. |
account_type |
Facultatif. Type de compte. Par exemple : |
AccountType
Représente les types de comptes Google. Permet de localiser les comptes et les destinations.
| Enums | |
|---|---|
ACCOUNT_TYPE_UNSPECIFIED |
Produit non spécifié. Ce type ne doit jamais être utilisé. |
GOOGLE_ADS |
Google Ads |
DISPLAY_VIDEO_PARTNER |
Partenaire Display & Video 360. |
DISPLAY_VIDEO_ADVERTISER |
Annonceur Display & Video 360. |
DATA_PARTNER |
Partenaire pour les données. |
GOOGLE_ANALYTICS_PROPERTY |
Google Analytics. |
GOOGLE_AD_MANAGER_AUDIENCE_LINK |
Association d'audience Google Ad Manager. |
PseudonymousIdInfo
Informations supplémentaires lorsque PSEUDONYMOUS_ID fait partie des upload_key_types.
| Champs | |
|---|---|
sync_status |
Uniquement en sortie. État de la synchronisation de la liste d'utilisateurs. |
billable_record_count |
Facultatif. Immuable. Nombre d'enregistrements facturables (par exemple, importés ou mis en correspondance). |
SyncStatus
État de la synchronisation de la liste d'utilisateurs.
| Enums | |
|---|---|
SYNC_STATUS_UNSPECIFIED |
Non spécifié. |
CREATED |
La liste d'utilisateurs a été créée en tant qu'espace réservé. Le contenu et/ou les métadonnées de la liste sont toujours en cours de synchronisation. La liste d'utilisateurs n'est pas prête à être utilisée. |
READY_FOR_USE |
La liste des utilisateurs est prête à être utilisée. Le contenu et les cookies ont été correctement synchronisés. |
FAILED |
Une erreur s'est produite lors de la synchronisation du contenu et/ou des métadonnées de la liste des utilisateurs. Impossible d'utiliser la liste des utilisateurs. |
RemoveAudienceMembersRequest
Demande de suppression d'utilisateurs d'une audience dans les destinations fournies. Renvoie un objet RemoveAudienceMembersResponse.
| Champs | |
|---|---|
destinations[] |
Obligatoire. Liste des destinations desquelles supprimer les utilisateurs. |
audience_members[] |
Obligatoire. Liste des utilisateurs à supprimer. |
validate_only |
Facultatif. À des fins de test. Si la valeur est |
encoding |
Facultatif. Obligatoire pour les importations |
encryption_info |
Facultatif. Informations sur le chiffrement des importations |
RemoveAudienceMembersResponse
Réponse de RemoveAudienceMembersRequest.
| Champs | |
|---|---|
request_id |
ID généré automatiquement pour la demande. |
RequestStatusPerDestination
Un état de la demande par destination.
| Champs | |
|---|---|
destination |
Destination dans une requête API DM. |
request_status |
État de la demande de la destination. |
error_info |
Informations sur l'erreur contenant le motif et le nombre d'erreurs liées à l'importation. |
warning_info |
Informations d'avertissement contenant le motif et le nombre d'avertissements liés à l'importation. |
Champ d'union status. État de la destination. status ne peut être qu'un des éléments suivants : |
|
audience_members_ingestion_status |
État de la demande d'importation des membres de l'audience. |
events_ingestion_status |
État de la demande d'événements d'ingestion. |
audience_members_removal_status |
État de la demande de suppression de membres de l'audience. |
IngestAudienceMembersStatus
État de la demande d'importation des membres de l'audience.
| Champs | |
|---|---|
Champ d'union status. État de l'importation des membres de l'audience vers la destination. status ne peut être qu'un des éléments suivants : |
|
user_data_ingestion_status |
État de l'ingestion des données utilisateur dans la destination. |
mobile_data_ingestion_status |
État de l'ingestion des données mobiles dans la destination. |
pair_data_ingestion_status |
État de l'ingestion des données de la paire dans la destination. |
user_id_data_ingestion_status |
État de l'ingestion des données d'ID utilisateur dans la destination. |
ppid_data_ingestion_status |
État de l'ingestion des données PPID dans la destination. |
IngestEventsStatus
État de l'ingestion des événements dans la destination.
| Champs | |
|---|---|
record_count |
Nombre total d'événements envoyés dans la demande d'importation. Inclut tous les événements de la requête, qu'ils aient été ingérés ou non. |
IngestMobileDataStatus
État de l'ingestion des données mobiles dans la destination contenant des statistiques liées à l'ingestion.
| Champs | |
|---|---|
record_count |
Nombre total de membres de l'audience envoyés dans la demande d'importation pour la destination. Inclut tous les membres de l'audience dans la requête, qu'ils aient été ingérés ou non. |
mobile_id_count |
Nombre total d'ID mobiles envoyés dans la demande d'importation pour la destination. Inclut tous les ID mobiles de la requête, qu'ils aient été ingérés ou non. |
IngestPairDataStatus
État de l'ingestion des données de paire dans la destination contenant des statistiques liées à l'ingestion.
| Champs | |
|---|---|
record_count |
Nombre total de membres de l'audience envoyés dans la demande d'importation pour la destination. Inclut tous les membres de l'audience dans la requête, qu'ils aient été ingérés ou non. |
pair_id_count |
Nombre total d'ID de paires envoyés dans la demande d'importation pour la destination. Inclut tous les ID de paires dans la requête, qu'ils aient été ingérés ou non. |
IngestPpidDataStatus
État de l'ingestion des données PPID dans la destination contenant des statistiques liées à l'ingestion.
| Champs | |
|---|---|
record_count |
Nombre total de membres de l'audience envoyés dans la demande d'importation pour la destination. Inclut tous les membres de l'audience dans la requête, qu'ils aient été ingérés ou non. |
ppid_count |
Nombre total de ppids envoyés dans la demande d'importation pour la destination. Inclut tous les ppids de la demande, qu'ils aient été ingérés ou non. |
IngestUserDataStatus
État de l'ingestion des données utilisateur dans la destination contenant des statistiques liées à l'ingestion.
| Champs | |
|---|---|
record_count |
Nombre total de membres de l'audience envoyés dans la demande d'importation pour la destination. Inclut tous les membres de l'audience dans la requête, qu'ils aient été ingérés ou non. |
user_identifier_count |
Nombre total d'identifiants utilisateur envoyés dans la demande d'importation pour la destination. Inclut tous les identifiants utilisateur de la requête, qu'ils aient été ingérés ou non. |
upload_match_rate_range |
Plage du taux de correspondance de l'importation. |
IngestUserIdDataStatus
État de l'ingestion des données d'ID utilisateur dans la destination contenant des statistiques liées à l'ingestion.
| Champs | |
|---|---|
record_count |
Nombre total de membres de l'audience envoyés dans la demande d'importation pour la destination. Inclut tous les membres de l'audience dans la requête, qu'ils aient été ingérés ou non. |
user_id_count |
Nombre total d'ID utilisateur envoyés dans la demande d'importation pour la destination. Inclut tous les ID utilisateur de la requête, qu'ils aient été ingérés ou non. |
RemoveAudienceMembersStatus
État de la demande de suppression de membres de l'audience.
| Champs | |
|---|---|
Champ d'union status. État de la suppression des membres de l'audience de la destination. status ne peut être qu'un des éléments suivants : |
|
user_data_removal_status |
État de la suppression des données utilisateur de la destination. |
mobile_data_removal_status |
État de la suppression des données mobiles de la destination. |
pair_data_removal_status |
État de la suppression des données d'association de la destination. |
user_id_data_removal_status |
État de la suppression des données d'ID utilisateur de la destination. |
ppid_data_removal_status |
État de la suppression des données PPID de la destination. |
RemoveMobileDataStatus
État de la suppression des données mobiles de la destination.
| Champs | |
|---|---|
record_count |
Nombre total de membres de l'audience inclus dans la demande de suppression. Inclut tous les membres de l'audience dans la demande, qu'ils aient été supprimés ou non. |
mobile_id_count |
Nombre total d'ID mobiles envoyés dans la demande de suppression. Inclut tous les ID mobiles de la requête, qu'ils aient été supprimés ou non. |
RemovePairDataStatus
État de la suppression des données d'association de la destination.
| Champs | |
|---|---|
record_count |
Nombre total de membres de l'audience inclus dans la demande de suppression. Inclut tous les membres de l'audience dans la demande, qu'ils aient été supprimés ou non. |
pair_id_count |
Nombre total d'ID de paires envoyés dans la demande de suppression. Inclut tous les ID de paires dans la requête, qu'ils aient été supprimés ou non. |
RemovePpidDataStatus
État de la suppression des données PPID de la destination.
| Champs | |
|---|---|
record_count |
Nombre total de membres de l'audience inclus dans la demande de suppression. Inclut tous les membres de l'audience dans la demande, qu'ils aient été supprimés ou non. |
ppid_count |
Nombre total de ppids envoyés dans la demande de suppression. Inclut tous les ppids de la demande, qu'ils aient été supprimés ou non. |
RemoveUserDataStatus
État de la suppression des données utilisateur de la destination.
| Champs | |
|---|---|
record_count |
Nombre total de membres de l'audience inclus dans la demande de suppression. Inclut tous les membres de l'audience dans la demande, qu'ils aient été supprimés ou non. |
user_identifier_count |
Nombre total d'identifiants utilisateur envoyés dans la demande de suppression. Inclut tous les identifiants utilisateur de la demande, qu'ils aient été supprimés ou non. |
RemoveUserIdDataStatus
État de la suppression des données d'ID utilisateur de la destination.
| Champs | |
|---|---|
record_count |
Nombre total de membres de l'audience inclus dans la demande de suppression. Inclut tous les membres de l'audience dans la demande, qu'ils aient été supprimés ou non. |
user_id_count |
Nombre total d'ID utilisateur envoyés dans la demande de suppression. Inclut tous les ID utilisateur de la requête, qu'ils aient été supprimés ou non. |
RequestStatus
État de la demande.
| Enums | |
|---|---|
REQUEST_STATUS_UNKNOWN |
L'état de la demande est inconnu. |
SUCCESS |
La demande a été traitée. |
PROCESSING |
La demande est en cours de traitement. |
FAILED |
Échec de la requête. |
PARTIAL_SUCCESS |
La demande a été partiellement traitée. |
RetrieveInsightsRequest
Message de requête pour DM API MarketingDataInsightsService.RetrieveInsights
| Champs | |
|---|---|
parent |
Obligatoire. Compte parent propriétaire de la liste d'utilisateurs. Format : |
baseline |
Obligatoire. Valeur de référence pour les insights demandés. |
user_list_id |
Obligatoire. ID de la liste d'utilisateurs pour laquelle des insights sont demandés. |
RetrieveInsightsResponse
Message de réponse pour DM API MarketingDataInsightsService.RetrieveInsights
| Champs | |
|---|---|
marketing_data_insights[] |
Contient les insights pour les données marketing. |
MarketingDataInsight
Insights pour les données marketing
Cette fonctionnalité n'est disponible que pour les partenaires de données.
| Champs | |
|---|---|
dimension |
Dimension à laquelle appartient l'insight. |
attributes[] |
Insights pour les valeurs d'une dimension donnée. |
AudienceInsightsDimension
Dimensions possibles à utiliser pour générer des insights.
| Enums | |
|---|---|
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED |
Non spécifié. |
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN |
La valeur est inconnue dans cette version. |
AFFINITY_USER_INTEREST |
Un Affinity UserInterest. |
IN_MARKET_USER_INTEREST |
Un UserInterest sur le marché. |
AGE_RANGE |
Tranche d'âge. |
GENDER |
Genre |
MarketingDataInsightsAttribute
Insights pour une collection d'attributs associés de la même dimension.
| Champs | |
|---|---|
user_interest_id |
ID du centre d'intérêt de l'utilisateur. |
lift |
Mesure de l'impact de l'audience pour la valeur de l'attribut par rapport à la référence. Plage [0-1]. |
age_range |
Tranche d'âge de l'audience pour laquelle l'impact est fourni. |
gender |
Genre de l'audience pour laquelle l'impact est fourni. |
RetrieveRequestStatusRequest
Requête permettant d'obtenir l'état d'une requête envoyée à l'API DM pour un ID de requête donné. Renvoie un objet RetrieveRequestStatusResponse.
| Champs | |
|---|---|
request_id |
Obligatoire. Obligatoire. ID de la requête API Data Manager. |
RetrieveRequestStatusResponse
Réponse de RetrieveRequestStatusRequest.
| Champs | |
|---|---|
request_status_per_destination[] |
Liste des états des demandes par destination. L'ordre des états correspond à celui des destinations dans la demande d'origine. |
SearchPartnerLinksRequest
Demande de recherche de ressources PartnerLink. Renvoie un SearchPartnerLinksResponse.
| Champs | |
|---|---|
parent |
Obligatoire. Compte à utiliser pour rechercher des liens de partenaire. Si aucun Format : |
page_size |
Nombre maximal de liens partenaires à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 10 liens partenaires au maximum sont renvoyés. La valeur maximale est 100. Les valeurs supérieures sont réduites à 100. |
page_token |
Jeton de page reçu d'un appel Lors de la pagination, tous les autres paramètres fournis à |
filter |
Facultatif. Une chaîne de filtre. Tous les champs doivent se trouver à gauche de chaque condition (par exemple, Opérations compatibles :
Champs acceptés :
Exemple : |
SearchPartnerLinksResponse
Réponse de SearchPartnerLinksRequest.
| Champs | |
|---|---|
partner_links[] |
Liens partenaires pour le compte spécifié. |
next_page_token |
Jeton pouvant être envoyé en tant que |
SizeInfo
Nombre estimé de membres de cette liste d'utilisateurs dans différents réseaux cibles.
| Champs | |
|---|---|
display_network_members_count |
Uniquement en sortie. Nombre estimé de membres de cette liste d'utilisateurs sur le Réseau Display de Google. |
search_network_members_count |
Uniquement en sortie. Nombre estimé de membres de cette liste d'utilisateurs dans le domaine google.com. Voici les membres disponibles pour le ciblage dans les campagnes sur le Réseau de Recherche. |
TargetNetworkInfo
Informations sur l'éligibilité pour différents réseaux cibles.
| Champs | |
|---|---|
eligible_for_display |
Uniquement en sortie. Indique que cette liste d'utilisateurs est éligible au Réseau Display de Google. |
eligible_for_search |
Facultatif. Indique si cette liste d'utilisateurs est éligible au Réseau de Recherche Google. |
TermsOfService
Conditions d'utilisation que l'utilisateur a acceptées ou refusées.
| Champs | |
|---|---|
customer_match_terms_of_service_status |
Facultatif. Conditions d'utilisation du ciblage par liste de clients : https://support.google.com/adspolicy/answer/6299717 Vous devez l'accepter lorsque vous ingérez |
TermsOfServiceStatus
Représente la décision de l'appelant d'accepter ou de refuser les conditions d'utilisation.
| Enums | |
|---|---|
TERMS_OF_SERVICE_STATUS_UNSPECIFIED |
Non spécifié. |
ACCEPTED |
État indiquant que l'appelant a choisi d'accepter les conditions d'utilisation. |
REJECTED |
État indiquant que l'appelant a choisi de refuser les conditions d'utilisation. |
UpdateUserListDirectLicenseRequest
Requête de mise à jour d'une ressource UserListDirectLicense.
| Champs | |
|---|---|
user_list_direct_license |
Obligatoire. Le champ |
update_mask |
Facultatif. Liste des champs à mettre à jour. Le caractère spécial |
UpdateUserListGlobalLicenseRequest
Requête de mise à jour d'une ressource UserListGlobalLicense.
| Champs | |
|---|---|
user_list_global_license |
Obligatoire. Le champ |
update_mask |
Facultatif. Liste des champs à mettre à jour. Le caractère spécial |
UpdateUserListRequest
Message de requête pour UpdateUserList.
| Champs | |
|---|---|
user_list |
Obligatoire. Liste d'utilisateurs à mettre à jour. Le champ |
update_mask |
Facultatif. Liste des champs à mettre à jour. |
validate_only |
Facultatif. Si la valeur est "true", la requête est validée, mais pas exécutée. |
UserData
Données permettant d'identifier l'utilisateur. Vous devez indiquer au moins un identifiant.
| Champs | |
|---|---|
user_identifiers[] |
Obligatoire. Identifiants de l'utilisateur. Il est possible de fournir plusieurs instances du même type de données (par exemple, plusieurs adresses e-mail). Pour augmenter la probabilité d'une correspondance, fournissez autant d'identifiants que possible. Vous ne pouvez pas fournir plus de 10 |
UserIdData
Données d'ID utilisateur contenant l'ID utilisateur.
| Champs | |
|---|---|
user_id |
Obligatoire. Identifiant unique d'un utilisateur, tel que défini par l'annonceur. |
UserIdInfo
Informations supplémentaires lorsque USER_ID fait partie des upload_key_types.
| Champs | |
|---|---|
data_source_type |
Facultatif. Immuable. Source des données importées. |
UserIdentifier
Identifiant unique de l'utilisateur.
| Champs | |
|---|---|
Champ d'union identifier. Vous ne devez en spécifier qu'un seul. identifier ne peut être qu'un des éléments suivants : |
|
email_address |
Adresse e-mail hachée à l'aide de la fonction de hachage SHA-256 après normalisation. |
phone_number |
Numéro de téléphone haché à l'aide de la fonction de hachage SHA-256 après normalisation (norme E164). |
address |
Composants connus de l'adresse d'un utilisateur. Contient un regroupement d'identifiants mis en correspondance simultanément. |
UserList
Ressource de liste d'utilisateurs.
| Champs | |
|---|---|
name |
Identifiant. Nom de ressource de la liste d'utilisateurs. Format : accountTypes/{account_type}/accounts/{account}/userLists/{user_list} |
id |
Uniquement en sortie. ID unique de la liste d'utilisateurs. |
read_only |
Uniquement en sortie. Option indiquant si un utilisateur peut modifier une liste. |
membership_duration |
Facultatif. Durée pendant laquelle un utilisateur reste dans la liste des utilisateurs. Les durées valides sont des multiples exacts de 24 heures (86 400 secondes). Si vous fournissez une valeur qui n'est pas un multiple exact de 24 heures, une erreur INVALID_ARGUMENT sera générée. |
access_reason |
Uniquement en sortie. Raison pour laquelle ce compte a été autorisé à accéder à la liste. |
size_info |
Uniquement en sortie. Nombre estimé de membres de cette liste d'utilisateurs dans différents réseaux cibles. |
target_network_info |
Facultatif. Informations sur l'éligibilité pour différents réseaux cibles. |
display_name |
Obligatoire. Nom à afficher de la liste des utilisateurs. |
description |
Facultatif. Description de la liste d'utilisateurs. |
membership_status |
Facultatif. État d'appartenance à cette liste d'utilisateurs. |
integration_code |
Facultatif. ID provenant d'un système externe. Les vendeurs de listes d'utilisateurs l'utilisent pour corréler les ID dans leurs systèmes. |
closing_reason |
Uniquement en sortie. Motif de la clôture de l'état d'appartenance à cette liste d'utilisateurs. |
account_access_status |
Facultatif. Indique si ce partage est toujours activé. Lorsque la liste d'utilisateurs est partagée avec le compte, ce champ est défini sur |
Champ d'union user_list_info. Informations supplémentaires sur la liste d'utilisateurs. user_list_info ne peut être qu'un des éléments suivants : |
|
ingested_user_list_info |
Facultatif. Représente une liste d'utilisateurs renseignée par les données ingérées par l'utilisateur. |
AccessReason
Énumération décrivant les raisons possibles d'accès.
| Enums | |
|---|---|
ACCESS_REASON_UNSPECIFIED |
Non spécifié. |
OWNED |
La ressource appartient à l'utilisateur. |
SHARED |
La ressource est partagée avec l'utilisateur. |
LICENSED |
L'utilisateur dispose de la licence pour la ressource. |
SUBSCRIBED |
L'utilisateur s'est abonné à la ressource. |
AFFILIATED |
La ressource est accessible à l'utilisateur. |
AccessStatus
Indique si ce client a toujours accès à la liste.
| Enums | |
|---|---|
ACCESS_STATUS_UNSPECIFIED |
Non spécifié. |
ENABLED |
L'accès est activé. |
DISABLED |
L'accès est désactivé. |
ClosingReason
Indique la raison pour laquelle la liste des utilisateurs a été fermée. Cette énumération n'est utilisée que lorsqu'une liste est fermée automatiquement par le système.
| Enums | |
|---|---|
CLOSING_REASON_UNSPECIFIED |
Non spécifié. |
UNUSED |
La liste d'utilisateurs a été fermée, car elle n'a pas été utilisée récemment pour le ciblage. Pour en savoir plus, consultez https://support.google.com/google-ads/answer/2472738. |
MembershipStatus
État de la liste d'utilisateurs.
| Enums | |
|---|---|
MEMBERSHIP_STATUS_UNSPECIFIED |
Non spécifié. |
OPEN |
Ouverte : la liste d'utilisateurs s'enrichit de membres et peut être ciblée. |
CLOSED |
État "Fermée" : aucun nouveau membre n'est ajouté. |
UserListDirectLicense
Une licence directe pour une liste d'utilisateurs.
Cette fonctionnalité n'est disponible que pour les partenaires de données.
| Champs | |
|---|---|
name |
Identifiant. Nom de ressource de la licence directe de la liste d'utilisateurs. |
user_list_display_name |
Uniquement en sortie. Nom de la liste d'utilisateurs sous licence. Ce champ est en lecture seule. |
client_account_display_name |
Uniquement en sortie. Nom du client auquel la liste d'utilisateurs est concédée sous licence. Ce champ est en lecture seule. |
pricing |
Facultatif. Tarifs de UserListDirectLicense. |
historical_pricings[] |
Uniquement en sortie. Historique des prix de cette licence de liste d'utilisateurs. Ce champ est en lecture seule. |
metrics |
Uniquement en sortie. Métriques liées à cette licence Ce champ est en lecture seule et n'est renseigné que si les dates de début et de fin sont définies dans l'appel ListUserListDirectLicenses. |
user_list_id |
Immuable. ID de la liste d'utilisateurs pour laquelle une licence est accordée. |
client_account_type |
Immuable. Type de compte client auquel la liste d'utilisateurs est concédée sous licence. |
client_account_id |
Immuable. ID du compte client auquel la liste d'utilisateurs est concédée sous licence. |
status |
Facultatif. État de UserListDirectLicense : ENABLED ou DISABLED. |
UserListGlobalLicense
Une licence globale pour une liste d'utilisateurs.
Cette fonctionnalité n'est disponible que pour les partenaires de données.
| Champs | |
|---|---|
name |
Identifiant. Nom de ressource de la licence globale de la liste d'utilisateurs. |
user_list_display_name |
Uniquement en sortie. Nom de la liste d'utilisateurs sous licence. Ce champ est en lecture seule. |
pricing |
Facultatif. Tarification de UserListGlobalLicense. |
historical_pricings[] |
Uniquement en sortie. Historique des prix de cette licence de liste d'utilisateurs. Ce champ est en lecture seule. |
metrics |
Uniquement en sortie. Métriques liées à cette licence Ce champ est en lecture seule et n'est renseigné que si les dates de début et de fin sont définies dans l'appel ListUserListGlobalLicenses. |
user_list_id |
Immuable. ID de la liste d'utilisateurs pour laquelle une licence est accordée. |
license_type |
Immuable. Type de produit du client auquel la liste d'utilisateurs est concédée. |
status |
Facultatif. État de UserListGlobalLicense : ENABLED ou DISABLED. |
UserListGlobalLicenseCustomerInfo
Informations sur un client d'une licence globale de liste d'utilisateurs. Il sera automatiquement créé par le système lorsqu'un client achètera une licence mondiale.
| Champs | |
|---|---|
name |
Identifiant. Nom de ressource du client de licence globale de la liste d'utilisateurs. |
user_list_id |
Uniquement en sortie. ID de la liste d'utilisateurs pour laquelle une licence est accordée. |
user_list_display_name |
Uniquement en sortie. Nom de la liste d'utilisateurs sous licence. |
license_type |
Uniquement en sortie. Type de produit du client auquel la liste d'utilisateurs est concédée. |
status |
Uniquement en sortie. État de UserListDirectLicense : ENABLED ou DISABLED. |
pricing |
Uniquement en sortie. Tarifs de UserListDirectLicense. |
client_account_type |
Uniquement en sortie. Type de produit du client auquel la liste d'utilisateurs est concédée. |
client_account_id |
Uniquement en sortie. ID du compte client auquel la liste d'utilisateurs est concédée sous licence. |
client_account_display_name |
Uniquement en sortie. Nom du client auquel la liste d'utilisateurs est concédée sous licence. |
historical_pricings[] |
Uniquement en sortie. Historique des prix de cette licence de liste d'utilisateurs. |
metrics |
Uniquement en sortie. Métriques liées à cette licence Ce champ n'est renseigné que si les dates de début et de fin sont définies dans l'appel ListUserListGlobalLicenseCustomerInfos. |
UserListGlobalLicenseType
Types de licence globaux pour les listes d'utilisateurs.
| Enums | |
|---|---|
USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED |
NON SPÉCIFIÉ. |
USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER |
Licence de revendeur. |
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE |
Licence DataMart Sell Side. |
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE |
Licence DataMart Buy Side. |
UserListLicenseClientAccountType
Produit possible d'un compte client pour une licence de liste d'utilisateurs.
| Enums | |
|---|---|
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN |
Inconnu. |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS |
Client Google Ads. |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER |
Partenaire Display & Video 360. |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER |
Annonceur Display & Video 360. |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_AD_MANAGER_AUDIENCE_LINK |
Association d'audience Google Ad Manager. |
UserListLicenseMetrics
Métriques liées à une licence de liste d'utilisateurs.
| Champs | |
|---|---|
click_count |
Uniquement en sortie. Nombre de clics pour la licence de la liste d'utilisateurs. |
impression_count |
Uniquement en sortie. Nombre d'impressions pour la licence de liste d'utilisateurs. |
revenue_usd_micros |
Uniquement en sortie. Revenus générés par la licence de la liste d'utilisateurs en millionièmes de dollars américains. |
start_date |
Uniquement en sortie. Date de début (incluse) des métriques au format AAAAMMJJ. Par exemple, 20260102 représente le 2 janvier 2026. Si |
end_date |
Uniquement en sortie. Date de fin (incluse) des métriques au format AAAAMMJJ. Par exemple, 20260102 représente le 2 janvier 2026. Si |
UserListLicensePricing
Tarification des licences pour les listes d'utilisateurs.
| Champs | |
|---|---|
pricing_id |
Uniquement en sortie. ID de ce prix. |
start_time |
Uniquement en sortie. Heure de début de la tarification. |
end_time |
Facultatif. Heure de fin de la tarification. |
pricing_active |
Uniquement en sortie. Indique si ces tarifs sont actifs. |
buyer_approval_state |
Uniquement en sortie. État d'approbation de ce prix par l'acheteur. Ce champ est en lecture seule. |
cost_micros |
Facultatif. Coût associé au modèle, en micro-unités (10^-6), dans la devise spécifiée par le champ "currency_code". Par exemple, si |
currency_code |
Facultatif. Devise dans laquelle le coût et max_cost sont spécifiés. Doit être un code de devise à trois lettres défini dans la norme ISO 4217. |
cost_type |
Immuable. Type de coût de ce prix. Ne peut être défini que dans l'opération |
max_cost_micros |
Facultatif. CPM maximal pouvant être facturé à une audience commerciale lorsque le type de coût MEDIA_SHARE est utilisé. La valeur est exprimée en micro-unités (10^-6) et dans la devise spécifiée par le champ currency_code. Par exemple, si Cela n'est pertinent que lorsque cost_type est défini sur MEDIA_SHARE. Si cost_type n'est pas défini sur MEDIA_SHARE et que ce champ est défini, une erreur MAX_COST_NOT_ALLOWED est renvoyée. Si elle n'est pas définie ou si elle est définie sur |
UserListPricingBuyerApprovalState
État d'approbation de l'acheteur pour le prix de la liste d'utilisateurs.
| Enums | |
|---|---|
USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED |
NON SPÉCIFIÉ. |
PENDING |
Le client de la liste d'utilisateurs n'a pas encore accepté les conditions tarifaires définies par le propriétaire de la liste d'utilisateurs. |
APPROVED |
Le client de la liste d'utilisateurs a accepté les conditions tarifaires définies par le propriétaire de la liste d'utilisateurs. |
REJECTED |
Le client de la liste d'utilisateurs a refusé les conditions tarifaires définies par le propriétaire de la liste d'utilisateurs. |
UserListPricingCostType
Type de coût de tarification de la liste d'utilisateurs.
| Enums | |
|---|---|
USER_LIST_PRICING_COST_TYPE_UNSPECIFIED |
Non spécifié. |
CPC |
Coût par clic. |
CPM |
Coût pour mille impressions. |
MEDIA_SHARE |
Partage de contenus multimédias. |
UserListLicenseStatus
État de la licence de la liste d'utilisateurs.
| Enums | |
|---|---|
USER_LIST_LICENSE_STATUS_UNSPECIFIED |
Inconnu. |
USER_LIST_LICENSE_STATUS_ENABLED |
État actif : la liste d'utilisateurs est toujours sous licence. |
USER_LIST_LICENSE_STATUS_DISABLED |
État inactif : la liste d'utilisateurs n'est plus concédée sous licence. |
UserProperties
Informations évaluées par l'annonceur sur l'utilisateur au moment de l'événement. Pour en savoir plus, consultez https://support.google.com/google-ads/answer/14007601.
| Champs | |
|---|---|
customer_type |
Facultatif. Type de client associé à l'événement. |
customer_value_bucket |
Facultatif. Valeur du client évaluée par l'annonceur. |
additional_user_properties[] |
Facultatif. Ensemble de propriétés utilisateur supplémentaires pour l'utilisateur associé à cet événement. |
UserProperty
Ensemble de propriétés utilisateur supplémentaires pour l'utilisateur associé à cet événement.
| Champs | |
|---|---|
property_name |
Obligatoire. Nom de la propriété utilisateur à utiliser. |
value |
Obligatoire. Représentation sous forme de chaîne de la valeur de la propriété utilisateur à utiliser. |
WarningCount
Nombre d'avertissements pour un motif donné.
| Champs | |
|---|---|
record_count |
Nombre d'enregistrements comportant un avertissement. |
reason |
Motif de l'avertissement. |
WarningInfo
Nombre d'avertissements pour chaque type d'avertissement.
| Champs | |
|---|---|
warning_counts[] |
Liste des avertissements et du nombre d'avertissements par motif. |