Mappages de champs

Utilisez les mappages des tableaux pour mapper une requête de collecte de données du protocole de mesure (/mp/collect) à son équivalent IngestEventsRequest dans l'API Data Manager.

Champs des demandes

Requête /mp/collect (protocole de mesure) IngestEventsRequest (API Data Manager) Remarques
measurement_id (paramètre de requête) destinations Carte vers product_destination_id pour les événements Web. Pour en savoir plus, consultez Champs de destination.
firebase_app_id (paramètre de requête) destinations Mappez product_destination_id pour les événements d'application. Pour en savoir plus, consultez Champs de destination.
api_secret (paramètre de requête) Aucun équivalent Consultez Configurer l'accès à l'API pour savoir comment authentifier les requêtes dans l'API Data Manager.
consent consent Défini sur un objet Consent.
events events Définissez sur une liste de ressources Event. Pour en savoir plus, consultez la section Champs d'événement.
client_id events.client_id Obligatoire pour les événements Web.
app_instance_id events.app_instance_id Obligatoire pour les événements d'application.
user_id events.user_id Facultatif. identifiant unique d'un utilisateur.
timestamp_micros events.event_timestamp Dans le protocole de mesure, cette valeur peut être fournie au niveau de la requête ou pour un événement individuel. Dans l'API Data Manager, il n'existe pas d'horodatage au niveau de la requête. Définissez event_timestamp sur chaque événement à l'heure à laquelle il s'est produit.
  • Si vous utilisez le format JSON, définissez une valeur au format RFC 3339.
  • Si vous utilisez des tampons de protocole, utilisez Timestamp et définissez les champs seconds et (facultativement) nanoseconds.

Pour en savoir plus, consultez Format du code temporel.
user_properties events.user_properties Défini sur un objet UserProperties. L'API Data Manager ne permet pas de définir des codes temporels pour les propriétés utilisateur individuelles. Les codes temporels associés aux modifications apportées aux propriétés utilisateur sont déduits du code temporel de l'événement (event_timestamp).
user_data events.user_data Défini sur un objet UserData. Pour en savoir plus, consultez Champs d'identifiant utilisateur.
non_personalized_ads events.consent.ad_personalization Si non_personalized_ads est défini sur true, définissez ad_personalization sur DENIED.
user_location events.event_location Pour en savoir plus, consultez Champs de localisation de l'utilisateur.
ip_override events.event_device_info.ip_address
device events.event_device_info Pour en savoir plus, consultez Champs d'appareil.
user_agent events.event_device_info.user_agent
validation_behavior Aucun équivalent Utilisez Diagnostics pour récupérer l'état de votre importation, ainsi que les erreurs et les avertissements pour les événements individuels lors du traitement en aval. Si IngestEventsRequest échoue (par exemple, en raison de champs obligatoires manquants), aucun événement n'est traité. Vous devrez résoudre l'erreur et réessayer d'envoyer la requête. Pour en savoir plus, consultez Comprendre les erreurs d'API.
/debug/mp/collect validate_only Définissez validate_only sur true pour valider les événements sans ingérer de données, comme avec le serveur de validation du protocole de mesure.
Aucun équivalent encoding Obligatoire pour les importations UserData. Définissez-le sur le Encoding utilisé pour les valeurs UserIdentifier.

Champs de destination

Le protocole de mesure envoie des événements directement à un flux de données spécifique à l'aide du paramètre de requête measurement_id ou firebase_app_id.

L'API Data Manager utilise un objet Destination pour spécifier où envoyer les données. Pour en savoir plus sur les destinations, consultez Configurer des destinations.

Voici comment mapper les champs du protocole de mesure avec les champs équivalents dans un Destination :

Protocole de mesure Destination (API Data Manager) Remarques
measurement_id (paramètre de requête) product_destination_id Défini sur l'ID de mesure du flux de données Web Google Analytics
firebase_app_id (paramètre de requête) product_destination_id Défini sur l'ID d'application Firebase du flux de données de l'application Google Analytics
Aucun équivalent operating_account Définissez account_id sur l'ID de propriété Google Analytics. Définissez account_type sur GOOGLE_ANALYTICS_PROPERTY.
Aucun équivalent login_account Définissez account_id sur l'ID de propriété Google Analytics. Définissez account_type sur GOOGLE_ANALYTICS_PROPERTY.

Champs d'événement

Protocole de mesure events[] Event (API Data Manager) Remarques
name event_name Si event_name utilise un nom réservé, l'API rejette l'événement avec une erreur INVALID_EVENT_NAME.
Aucun équivalent event_source Définissez la valeur sur WEB si l'événement a été généré à partir d'un navigateur Web et sur APP s'il a été généré à partir d'une application.
Aucun équivalent destination_references Obligatoire si la liste destinations au niveau de la requête contient plusieurs Destination Google Analytics. Ajoutez une entrée pour spécifier la destination qui doit recevoir l'événement.
timestamp_micros event_timestamp
  • Si vous utilisez le format JSON, définissez une valeur au format RFC 3339.
  • Si vous utilisez des tampons de protocole, utilisez Timestamp et définissez les champs seconds et (facultativement) nanoseconds.

Pour en savoir plus, consultez Format du code temporel.
params.currency currency
params.value conversion_value
params.customer_type user_properties.customer_type Dans le protocole de mesure, le paramètre customer_type est défini comme paramètre d'événement. Dans l'API Data Manager, définissez-le dans le champ customer_type de l'objet UserProperties de l'événement.
params.transaction_id transaction_id Obligatoire pour certains événements et cas d'utilisation. Pour en savoir plus, consultez Convertir les données en objets Event.
params.items cart_data.items Pour en savoir plus, consultez Champs d'article pour les données du panier.
params.coupon cart_data.coupon_codes Utilisez le champ coupon_codes pour indiquer les bons de réduction appliqués au panier. Ne fournissez qu'un seul bon de réduction pour Google Analytics. Cela est indépendant des bons de réduction au niveau Item, qui peuvent être définis à l'aide de cart_data.items.additional_item_parameters pour des articles individuels.
params.session_id additional_event_parameters Mappez une entrée avec parameter_name défini sur session_id.
params.engagement_time_msec additional_event_parameters Mappez une entrée avec parameter_name défini sur engagement_time_msec.
Autre params additional_event_parameters

Mappez d'autres paramètres sous forme de liste d'objets avec parameter_name et value.

Remarque : N'ajoutez pas d'entrées pour transaction_id, currency ou value ici. Utilisez plutôt les champs de premier niveau sur Event.

Champs d'identifiant utilisateur

Measurement Protocol user_data UserIdentifier (API Data Manager) Remarques
sha256_email_address[] email_address Définissez l'adresse e-mail mise en forme et hachée. Vous pouvez également chiffrer l'adresse e-mail hachée.
sha256_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é.
address[] address Défini sur un objet AddressInfo. Suivez les consignes de mise en forme et de hachage.
address[].sha256_first_name address.given_name Définissez le nom donné mis en forme et haché. Vous pouvez également chiffrer le prénom haché.
address[].sha256_last_name address.family_name Définissez le nom de famille mis en forme et haché. Vous pouvez également chiffrer le nom de famille haché.
address[].country address.region_code
address[].postal_code address.postal_code
address[].city Aucun équivalent Non disponible dans la version actuelle de l'API Data Manager.
address[].region Aucun équivalent Non disponible dans la version actuelle de l'API Data Manager.
address[].sha256_street Aucun équivalent Non disponible dans la version actuelle de l'API Data Manager.

Champs d'article pour les données du panier

Protocole de mesure items[] Item (API Data Manager) Remarques
item_id item_id Obligatoire.
item_name additional_item_parameters Mappez une entrée avec parameter_name défini sur item_name.
quantity quantity Obligatoire.
price unit_price Obligatoire.
Autres champs d'article additional_item_parameters

Mappez d'autres paramètres d'article (tels que discount, affiliation, item_brand, etc.) sous forme de liste d'objets avec parameter_name et value.

Remarque : N'ajoutez pas d'entrées pour quantity, price ni item_id ici. Utilisez plutôt les champs de premier niveau sur Item.

Champs de localisation de l'utilisateur

Measurement Protocol user_location EventLocation (API Data Manager) Remarques
city city Le nom de la ville où l'événement s'est produit.
country_id region_code Définissez le code région CLDR à deux lettres.
region_id subdivision_code Défini sur le code de subdivision ISO 3166-2.
continent_id continent_code Définissez le code du continent au format M49 de l'ONU.
subcontinent_id subcontinent_code Définissez le code du sous-continent au format UN M49.

Champs de l'appareil

Measurement Protocol device DeviceInfo (API Data Manager) Remarques
category category
language language_code
screen_resolution screen_height et screen_width Dans le protocole de mesure, screen_resolution est fourni sous forme de chaîne ("1280x720"). Dans l'API Data Manager, envoyez screen_height et screen_width sous forme de valeurs entières distinctes.
operating_system operating_system
operating_system_version operating_system_version
model model
brand brand
browser browser
browser_version browser_version
Précédent
Procédure de mise à jour