Vous pouvez configurer des événements d'e-commerce pour collecter des informations sur le comportement d'achat de vos utilisateurs. Les événements vous permettent de quantifier vos produits les plus populaires, et d'observer l'influence des promotions et du placement de produit sur les revenus.
Cet article décrit chaque événement d'e-commerce et à quel moment le configurer. Pour obtenir un exemple détaillé de configuration d'un événement d'e-commerce, consultez Configurer un événement d'achat.
Avant de commencer
Assurez-vous d'avoir ajouté la balise Google à votre site Web et de pouvoir accéder à Analytics et au code source du site Web.
Recommandations
- Activez le mode débogage pour voir les événements en temps réel et résoudre plus facilement les problèmes.
- Examinez les limites des dimensions et des métriques personnalisées lors de l'envoi de paramètres personnalisés avec des événements d'e-commerce.
- Définissez
currencylors de l'envoi des donnéesvalue(revenus) pour vous assurer que les métriques sur les revenus sont calculées correctement. - Définissez chaque paramètre d'e-commerce pour lequel vous disposez de données, qu'il soit facultatif ou non.
- Utilisez l'exemple de site Web d'e-commerce pour découvrir comment ajouter des balises à votre site Web.
Implémentation
En général, une implémentation de l'e-commerce mesure l'une des actions suivantes:
- Sélectionner un élément dans une liste
- Afficher les détails de l'article
- Ajouter/Supprimer un produit d'un panier
- Lancer le processus de règlement
- Effectuer des achats ou des remboursements
- Appliquer les promotions
Les produits et services que vous vendez se trouvent au cœur de ces actions. Vous pouvez représenter des produits et des services sous la forme d'un tableau d'articles pouvant être ajoutés à des événements d'e-commerce. Vous pouvez inclure jusqu'à 27 paramètres personnalisés dans le tableau "items", en plus des paramètres prescrits.
L'exemple suivant montre comment créer la collection de items référencées tout au long de ce guide. Le tableau items peut inclure jusqu'à 200 éléments.
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
},
{
item_id: "SKU_12346",
item_name: "Google Grey Women's Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 3.33,
index: 1,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "gray",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 21.01,
quantity: 2
}
]
Migrer depuis une implémentation de l'e-commerce UA
Si vous avez déjà implémenté l'e-commerce pour Universal Analytics, vous pouvez effectuer l'une des opérations suivantes pour migrer vers Google Analytics 4:
- Utilisez votre implémentation de l'e-commerce UA pour renseigner les événements d'e-commerce GA4.
- Remplacez votre implémentation de l'e-commerce UA par les événements d'e-commerce GA4
- Envoyer des données d'e-commerce à Analytics via les implémentations UA et GA4
Pour savoir comment migrer votre implémentation de l'e-commerce d'Universal Analytics vers Google Analytics 4, consultez le guide de migration de l'e-commerce GA4 pour la balise Google.
Sélectionner un élément dans une liste
Lorsqu'une liste de résultats s'affiche à l'utilisateur, envoyez un événement view_item_list incluant un paramètre de tableau items contenant les articles affichés. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.
gtag("event", "view_item_list", {
item_list_id: "related_products",
item_list_name: "Related products",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
});
Lorsqu'un utilisateur sélectionne un article dans la liste, envoyez l'événement select_item avec l'article sélectionné dans un paramètre de tableau items. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.
gtag("event", "select_item", {
item_list_id: "related_products",
item_list_name: "Related products",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
});
Afficher les détails de l'article
Pour mesurer le nombre de fois où les détails d'un article sont consultés, envoyez un événement view_item chaque fois qu'un utilisateur consulte l'écran d'informations d'un article. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.
gtag("event", "view_item", {
currency: "USD",
value: 30.03,
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
});
Ajouter un article à un panier ou en supprimer
Mesurez l'ajout d'un article à un panier en envoyant un événement add_to_cart avec les articles pertinents dans un tableau items. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.
gtag("event", "add_to_cart", {
currency: "USD",
value: 30.03,
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
});
Vous pouvez également mesurer l'ajout d'un article à une liste de souhaits en envoyant un événement add_to_wishlist avec les articles concernés dans un tableau items. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.
gtag("event", "add_to_wishlist", {
currency: "USD",
value: 30.03,
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
],
});
Lorsqu'un utilisateur consulte ensuite le panier, envoyez l'événement view_cart avec tous les articles qu'il contient. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.
gtag("event", "view_cart", {
currency: "USD",
value: 30.03,
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
});
Pour mesurer le moment où un utilisateur supprime un article d'un panier, envoyez l'événement remove_from_cart. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.
gtag("event", "remove_from_cart", {
currency: "USD",
value: 30.03,
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
});
Lancer le processus de paiement
Mesurez la première étape d'un processus de paiement en envoyant un événement begin_checkout avec un ou plusieurs articles définis avec les champs appropriés. À ce stade, un bon de réduction peut également être ajouté à l'ensemble de la commande en l'ajoutant à l'événement ou appliqué à un article particulier en l'ajoutant à des éléments spécifiques du tableau items. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.
gtag("event", "begin_checkout", {
currency: "USD",
value: 30.03,
coupon: "SUMMER_FUN",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
});
Lorsqu'un utilisateur passe à l'étape suivante du processus de règlement et ajoute des informations de livraison, envoyez un événement add_shipping_info. Utilisez le paramètre shipping_tier pour spécifier l'option de livraison de l'utilisateur, par exemple "Ground", "Air" ou "Next-day" (Le jour suivant). Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.
gtag("event", "add_shipping_info", {
currency: "USD",
value: 30.03,
coupon: "SUMMER_FUN",
shipping_tier: "Ground",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
});
Envoyez l'événement add_payment_info lorsqu'un utilisateur envoie ses informations de paiement.
Le cas échéant, incluez payment_type à cet événement pour le mode de paiement choisi. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.
gtag("event", "add_payment_info", {
currency: "USD",
value: 30.03,
coupon: "SUMMER_FUN",
payment_type: "Credit Card",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
});
Effectuer un achat ou émettre un remboursement
Mesurez un achat en envoyant un événement purchase avec un ou plusieurs articles définis avec les champs appropriés. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.
gtag("event", "purchase", {
transaction_id: "T_12345",
// Sum of (price * quantity) for all items.
value: 72.05,
tax: 3.60,
shipping: 5.99,
currency: "USD",
coupon: "SUMMER_SALE",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
},
{
item_id: "SKU_12346",
item_name: "Google Grey Women's Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 3.33,
index: 1,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "gray",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 21.01,
promotion_id: "P_12345",
promotion_name: "Summer Sale",
quantity: 2
}]
});
Mesurez les remboursements en envoyant un événement refund avec le transaction_id approprié spécifié et un ou plusieurs éléments définis avec item_id et quantity. Nous vous recommandons d'inclure les informations sur les articles dans votre événement refund pour consulter les métriques de remboursement au niveau de l'article dans Analytics.
Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.
gtag("event", "refund", {
currency: "USD",
transaction_id: "T_12345", // Transaction ID. Required for purchases and refunds.
value: 30.03,
coupon: "SUMMER_FUN",
shipping: 3.33,
tax: 1.11,
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
});
Appliquer les promotions
L'e-commerce comprend une prise en charge de la mesure des impressions et des clics pour les promotions internes, telles que les bannières affichées pour promouvoir une vente.
Les impressions issues de la promotion sont généralement mesurées avec le visionnage initial de l'écran en envoyant l'événement view_promotion avec un paramètre "items" pour spécifier l'article promu. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.
gtag("event", "view_promotion", {
creative_name: "Summer Banner",
creative_slot: "featured_app_1",
promotion_id: "P_12345",
promotion_name: "Summer Sale",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
]
});
Pour indiquer qu'un utilisateur a cliqué sur une promotion, envoyez un événement select_promotion avec cet article en tant que paramètre d'article. Pour en savoir plus sur les paramètres à envoyer, consultez la documentation de référence sur les événements.
gtag("event", "select_promotion", {
creative_name: "Summer Banner",
creative_slot: "featured_app_1",
promotion_id: "P_12345",
promotion_name: "Summer Sale",
items: [
{
item_id: "SKU_12345",
item_name: "Stan and Friends Tee",
affiliation: "Google Merchandise Store",
coupon: "SUMMER_FUN",
discount: 2.22,
index: 0,
item_brand: "Google",
item_category: "Apparel",
item_category2: "Adult",
item_category3: "Shirts",
item_category4: "Crew",
item_category5: "Short sleeve",
item_list_id: "related_products",
item_list_name: "Related Products",
item_variant: "green",
location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
price: 10.01,
quantity: 3
}
],
});