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.
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 |
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 |
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 |
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 |