Mappages de champs

Utilisez les mappages dans les tableaux pour mapper un UploadClickConversionRequest dans l'API Google Ads à son équivalent IngestEventsRequest dans l'API Data Manager.

Champs des demandes

`UploadClickConversionRequest` (API Google Ads)	`IngestEventsRequest` (API Data Manager)	Remarques
`customer_id` `developer-token` en-tête de requête `login-customer_id` en-tête de requête `linked-customer-id` en-tête de requête `conversion_action`	`destinations`	Consultez Champs "Client" et "Action de conversion".
Aucun équivalent	`consent`	Paramètres de consentement par défaut facultatifs pour les événements de la requête. Vous pouvez remplacer cette valeur pour un événement individuel en définissant le champ `consent` de `Event`.
Aucun équivalent	`encoding`	Obligatoire : définissez sur `Encoding` utilisé pour les valeurs `UserIdentifier`.
Aucun équivalent	`encryption_info`	Indique si la requête contient des valeurs chiffrées. Pour en savoir plus, consultez Chiffrement.
`job_id`	Aucun équivalent	Utilisez le `request_id` renvoyé dans la réponse pour récupérer les diagnostics.
`partial_failure`	Aucun équivalent	L'API Gestionnaire de données n'est pas compatible avec les échecs partiels. Si la validation d'un champ d'un `IngestEventsRequest` échoue, l'API Data Manager rejette l'intégralité de la requête.
`validate_only`	`validate_only`
`conversions`	`events`	Liste des conversions ou des événements. Pour en savoir plus, consultez la section Champs de conversion.

Champs "Client" et "Action de conversion"

L'API Google Ads nécessite l'en-tête de requête developer-token. Vous devez définir les en-têtes de requête login-customer-id et linked-customer-id pour différents scénarios d'authentification.

L'API Data Manager ne nécessite pas de jeton de développeur. Vous spécifiez les informations de connexion et les informations client associées à l'aide des champs d'un Destination au lieu des en-têtes de requête. Pour en savoir plus sur les destinations, consultez Configurer des destinations.

Voici comment mapper les champs de l'API Google Ads pour un seul conversion_action avec les champs équivalents dans un Destination :

API Google Ads	`Destination` (API Data Manager)	Remarques
`customer_id` de la demande	`operating_account`	Définissez `account_id` sur le numéro client du compte de conversion Google Ads. Définissez la valeur `account_type` de `operating_account` sur `GOOGLE_ADS`. L'API Data Manager peut nécessiter un numéro client différent de celui que vous utilisez pour l'API Google Ads. Pour en savoir plus, consultez Différences au niveau des exigences concernant les comptes de destination.
`developer-token` en-tête de requête	Aucun équivalent	Un jeton de développeur n'est pas requis pour l'API Gestionnaire de données.
`login-customer-id` en-tête de requête	`login_account`	Définissez `account_id` sur le numéro client du compte de connexion. Définissez `account_type` sur `GOOGLE_ADS` si le compte de connexion est un compte Google Ads, ou sur `DATA_PARTNER` s'il s'agit d'un compte de partenaire de données.
`linked-customer-id` en-tête de requête	`linked_account`	Définissez `account_id` sur le numéro client du compte associé. Définissez `account_type` sur `DATA_PARTNER`.
`conversion_action` sur `ClickConversion`	`product_destination_id`	Définissez l'ID numérique de l'action de conversion. N'utilisez pas le nom de ressource de `ConversionAction`.
Aucun équivalent	`reference`	Identifiant défini par l'utilisateur pour `Destination`. Définissez ce champ si vous envoyez des conversions pour plusieurs actions de conversion dans une même requête.

Champs de conversion

`ClickConversion` (API Google Ads)	`Event` (API Data Manager)	Remarques
`cart_data`	`cart_data`	Pour en savoir plus, consultez Champs de données du panier.
`consent`	`consent`	Les deux API utilisent un objet `Consent` similaire (`ad_user_data`, `ad_personalization`). Pour l'API Data Manager, vous pouvez également définir le consentement pour tous les événements d'une requête en définissant le champ `consent` au niveau de la requête.
`conversion_action`	`destination_references`	Si vous envoyez des conversions pour plusieurs actions de conversion dans une même requête, définissez ce champ sur le `reference` correspondant de la destination.
`conversion_date_time`	`event_timestamp`	Si vous utilisez le format JSON, définissez une valeur au format RFC 3339, qui diffère légèrement du format de date et d'heure de l'API Google Ads. Si vous utilisez des tampons de protocole, utilisez un `Timestamp` et définissez les champs `seconds` et (facultativement) `nanoseconds`. Pour en savoir plus, consultez Format du code temporel.
`conversion_environment`	Aucun équivalent
`conversion_value`	`conversion_value`	Définissez la valeur de la devise, et non la valeur en micros. Par exemple, pour une valeur de conversion de 5,23 $, utilisez la valeur `5.23`.
`currency_code`	`currency`
`custom_variables`	`custom_variables`	Pour en savoir plus, consultez Champs de variables personnalisées.
`customer_type`
Aucun équivalent	`event_source`
Aucun équivalent	`event_device_info`
`external_attribution_data`	Aucun équivalent
`gbraid`	`ad_identifiers.gbraid`
`gclid`	`ad_identifiers.gclid`
Aucun équivalent	`last_updated_timestamp`
`order_id`	`transaction_id`
`session_attributes_encoded`	`ad_identifiers.session_attributes`	Pour en savoir plus, consultez Ajouter des attributs de session.
`session_attributes_key_value_pairs`	`experimental_fields`	Pour en savoir plus, consultez Ajouter des attributs de session.
`user_identifiers`	`user_data.user_identifiers`	Pour en savoir plus, consultez Champs d'identifiant utilisateur.
`user_ip_address`	`landing_page_device_info.ip_address`
`wbraid`	`ad_identifiers.wbraid`

Champs de données du panier

`CartData` (API Google Ads)	`CartData` (API Data Manager)	Remarques
`feed_country_code`	`merchant_feed_label`	Définissez-le sur le libellé du flux.
`feed_language_code`	`merchant_feed_language_code`
`items`	`items`
`local_transaction_cost`	`transaction_discount`
`merchant_id`	`merchant_id`

Champs d'article pour les données du panier

`Item` (API Google Ads)	`Item` (API Data Manager)	Remarques
`product_id`	`merchant_product_id`
`quantity`	`quantity`
`unit_price`	`unit_price`
Aucun équivalent	`item_id`
Aucun équivalent	`additional_item_parameters`

Champs de variables personnalisées

`CustomVariable` (API Google Ads)	`CustomVariable` (API Data Manager)	Remarques
Aucun équivalent	`destination_references`	L'API Google Ads nécessite des requêtes distinctes pour chaque action de conversion. L'API Data Manager permet d'envoyer des conversions pour plusieurs actions de conversion dans une même requête, ainsi que d'utiliser le champ `destination_references` pour indiquer les destinations qui doivent recevoir une variable personnalisée spécifique.
`conversion_custom_variable`	`variable`	Définissez le nom de la variable au lieu d'un nom de ressource.
`value`	`value`

Champs d'identifiant utilisateur

`UserIdentifier` (API Google Ads)	`UserIdentifier` (API Data Manager)
`address_info`	`address`	Suivez les consignes de mise en forme et de hachage. Vous pouvez également chiffrer les attributs hachés d'une adresse.
`hashed_email`	`email_address`	Définissez l'adresse e-mail mise en forme et hachée. Vous pouvez également chiffrer l'adresse e-mail hachée.
`hashed_phone_number`	`phone_number`	Définissez le numéro de téléphone mis en forme et haché. Vous pouvez également chiffrer le numéro de téléphone haché.
Autres champs : `mobile_id` `third_party_user_id` `user_identifier_source`	Non pertinent	Aucune des deux API n'accepte ces identifiants pour les conversions hors connexion ni pour le suivi avancé des conversions pour les prospects. De plus, l'API Data Manager ne les accepte pas lorsque vous envoyez des événements de conversion en tant que source de données supplémentaire.

Champs de réponse

`UploadClickConversionResponse` (API Google Ads)	`IngestEventsResponse` (API Data Manager)	Remarques
`job_id`	Aucun équivalent	Utilisez le `request_id` renvoyé dans la réponse pour récupérer les diagnostics.
`partial_failure_error`	Aucun équivalent	L'API Gestionnaire de données n'est pas compatible avec les échecs partiels. Si la validation d'un champ d'un `IngestEventsRequest` échoue, l'API Data Manager rejette l'intégralité de la requête.
`request-id` en-tête de réponse	`request_id`	L'ID de la requête est renvoyé en tant que champ de réponse dans l'API Data Manager, et non en tant qu'en-tête de réponse.
`results`	Aucun équivalent	L'API Data Manager traite les événements de manière asynchrone. Vérifiez les résultats du traitement à l'aide des diagnostics.

Procédure de mise à jour