Cette page explique comment utiliser gtag.js pour collecter des données d'e-commerce amélioré. Si vous avez configuré Google Analytics dans gtag.js et que vous avez activé l'e-commerce amélioré dans Google Analytics, vous pouvez utiliser gtag.js pour envoyer à Google Analytics des données sur les impressions, les produits, les promotions et les actions.
Types de données et actions d'e-commerce amélioré
Vous pouvez envoyer plusieurs types de données d'e-commerce:
Données sur les impressions
Représente les informations relatives à un produit consulté. Il est appelé impressionFieldObject
et contient les valeurs suivantes:
Clé | Type de valeur | Obligatoire | Description |
---|---|---|---|
id |
text | *Oui |
Identifiant produit ou SKU (par exemple, P67890).
* Vous devez définir |
name |
text | *Oui |
Nom du produit (par exemple, "T-shirt Android").
* Vous devez définir |
list |
text | Non | Liste ou collection à laquelle appartient le produit (par exemple, les résultats de recherche) |
list_name |
text | Non | Liste ou collection à laquelle appartient le produit (par exemple, les résultats de recherche) |
brand |
text | Non | Marque associée au produit (par exemple, Google). |
category |
text | Non |
Catégorie à laquelle appartient le produit (par exemple, "Vêtements"). Utilisez / comme délimiteur pour spécifier jusqu'à cinq niveaux de hiérarchie (par exemple, Vêtements/Hommes/T-shirts).
|
variant |
text | Non | Variante du produit (par exemple, noir). |
position |
integer | Non | Position du produit dans une liste ou une collection (par exemple, 2). |
list_position |
integer | Non | Position du produit dans une liste ou une collection (par exemple, 2). |
price |
Nombre | Non | Prix d'un produit (par exemple, 29.20). |
Données relatives aux produits
Les données produit représentent des produits individuels qui ont été consultés, ajoutés au panier, etc. Elles sont appelées productFieldObject
et contiennent les valeurs suivantes:
Clé | Type de valeur | Obligatoire | Description |
---|---|---|---|
id |
text | *Oui |
Identifiant produit ou SKU (par exemple, P67890).
* Vous devez définir l'ID ou |
name |
text | *Oui |
Nom du produit (par exemple, "T-shirt Android").
* Vous devez définir l'ID ou |
brand |
text | Non | Marque associée au produit (par exemple, Google). |
category |
text | Non | Catégorie à laquelle appartient le produit (par exemple, "Vêtements"). Utilisez / comme délimiteur pour spécifier jusqu'à cinq niveaux de hiérarchie (par exemple, Vêtements/Hommes/T-shirts). |
variant |
text | Non | Variante du produit (par exemple, noir). |
price |
Nombre | Non | Prix d'un produit (par exemple, 29.20). |
quantity |
integer | Non | Quantité d'un produit (par exemple, 2). |
coupon |
text | Non | Code promotionnel associé à un produit (par exemple, SUMMER_SALE13). |
position |
integer | Non | Position du produit dans une liste ou une collection (par exemple, 2). |
list_position |
integer | Non | Position du produit dans une liste ou une collection (par exemple, 2). |
Données de promotion
Représente les informations sur une promotion ayant été consultée. Il est appelé promoFieldObject
et contient les valeurs suivantes:
Clé | Type de valeur | Obligatoire | Description |
---|---|---|---|
id |
text | *Oui |
Identifiant de la promotion (par exemple, PROMO_1234).
* Vous devez définir |
name |
text | *Oui |
Nom de la promotion (par exemple, "Soldes d'été").
* Vous devez définir |
creative |
text | Non | Création associée à la promotion (par exemple, bannière_été2). |
creative_name |
text | Non | Nom de la création (par exemple, bannière_été2). |
position |
text | Non | Position de la création (par exemple, "Banner_slot_1"). |
creative_slot |
text | Non | Nom de l'emplacement de la création (par exemple, espace_bannière_1). |
Données d'action
Représente les informations sur une action effectuée concernant l'e-commerce.
Il est appelé actionFieldObject
et contient les valeurs suivantes:
Clé | Type de valeur | Obligatoire | Description |
---|---|---|---|
id |
text | *Oui |
ID de la transaction (par exemple, T1234).
* Obligatoire si le type d'action est |
affiliation |
text | Non | Magasin ou affiliation à partir duquel la transaction a été effectuée (par exemple, Google Store). |
revenue |
Nombre | Non |
Spécifie le revenu total ou le total général associé à la transaction (par exemple, 11,99). Cette valeur peut inclure les frais de livraison, les frais fiscaux ou d'autres ajustements au revenu total que vous souhaitez inclure dans votre calcul de revenus. |
valeur | Nombre | Non | Valeur (revenus) associée à l'événement. |
tax |
Nombre | Non | Montant total des taxes associées à la transaction. |
shipping |
Nombre | Non | Frais de port associés à la transaction. |
coupon |
text | Non | Bon de réduction utilisé lors de la transaction. |
list |
text | Non | Liste à laquelle appartiennent les produits associés. Facultatif. |
items |
tableau | Non | Tableau contenant les produits associés. |
step |
integer | Non | Numéro représentant une étape du processus de règlement. Facultatif pour les actions de paiement. |
checkout_step |
integer | Non | Numéro représentant une étape du processus de règlement. |
option |
text | Non |
Champ supplémentaire pour les actions checkout et checkout_option pouvant décrire les informations des options sur la page de paiement, comme le mode de paiement sélectionné.
|
checkout_option |
text | Non | Option de paiement (mode de paiement sélectionné). |
Clé | Type de valeur | Obligatoire | Description |
---|---|---|---|
coupon |
chaîne | Non | Code promotionnel d'un article pouvant être acheté. |
Actions liées aux produits et à la promotion
Les actions spécifient comment interpréter les données sur les produits et les promotions que vous envoyez à Google Analytics.
Action | Événement | Description |
---|---|---|
click |
Clic sur un produit ou un lien de produit pour un ou plusieurs produits. | |
detail |
Affichage des informations détaillées sur le produit. | |
add |
Ajout d'un ou plusieurs produits à un panier | |
remove |
Supprimer un ou plusieurs produits d'un panier | |
checkout |
Lancement du processus de règlement pour un ou plusieurs produits... | |
checkout_option |
Envoi de la valeur de l'option pour une étape de règlement donnée. | |
purchase |
La vente d'un ou de plusieurs produits | |
refund |
Remboursement d'un ou de plusieurs produits. | |
promo_click |
Clic sur une promotion interne. | |
add_to_cart |
Un utilisateur ajoute un ou plusieurs produits à son panier. | |
begin_checkout |
Un utilisateur commence le processus de paiement pour un ou plusieurs produits. | |
checkout_progress |
Un utilisateur finalise le règlement après la première étape. | |
purchase |
Un utilisateur effectue un achat. | |
refund |
Un ou plusieurs produits sont remboursés à l'utilisateur. | |
remove_from_cart |
Un utilisateur supprime un ou plusieurs produits d'un panier. | |
select_content |
Un utilisateur clique sur un produit ou un lien de produit. | |
set_checkout_option |
Étape de règlement effectuée par un utilisateur. | |
view_item |
Un utilisateur consulte les détails d'un produit. | |
view_item_list |
Un utilisateur consulte une liste d'un ou plusieurs produits. | |
view_promotion |
Un utilisateur clique sur une promotion interne. | |
view_refund |
Un utilisateur consulte un remboursement pour un ou plusieurs produits. |
Exemples
Mesurer les impressions des produits
Pour mesurer les impressions de produits, envoyez une view_item_list
avec les informations sur les produits:
gtag('event', 'view_item_list', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": 3
}
]
});
Mesurer les clics sur les produits
Pour mesurer un clic sur un produit, envoyez un événement select_content
, spécifiez product
comme content_type
et fournissez les informations sur le produit:
gtag('event', 'select_content', {
"content_type": "product",
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
}
]
});
Mesurer les vues des informations détaillées sur les produits
Après avoir cliqué sur une fiche produit, l'utilisateur peut afficher la page d'informations détaillées sur le produit. Pour mesurer les vues des informations détaillées sur le produit, envoyez un événement view_item
avec les informations détaillées sur le produit:
gtag('event', 'view_item', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
Mesurer les ajouts et les suppressions de paniers
Pour mesurer l'ajout d'un produit au panier, envoyez un événement add_to_cart
avec les informations sur le produit:
gtag('event', 'add_to_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
Pour mesurer le retrait d'un produit d'un panier, envoyez un événement remove_from_cart
avec les informations sur le produit:
gtag('event', 'remove_from_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
Mesurer les paiements
Pour mesurer chaque étape d'un processus de paiement:
- Ajoutez un code de mesure pour mesurer chaque étape du processus de paiement.
- Le cas échéant, ajoutez un code de mesure pour enregistrer les options de paiement.
1. Mesurer les étapes de paiement
Pour mesurer la première étape de règlement, envoyez un événement begin_checkout
avec les articles du règlement:
gtag('event', 'begin_checkout', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": ""
});
Pour mesurer chaque étape de règlement ultérieure, envoyez un événement checkout_progress
avec les articles du règlement:
gtag('event', 'checkout_progress', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": "SUMMER_DISCOUNT"
});
2. Mesurer les options de paiement
Pour mesurer une option de paiement, envoyez un événement set_checkout_option
avec l'option de paiement:
gtag('event', 'set_checkout_option', {
"checkout_step": 1,
"checkout_option": "shipping method",
"value": 3
});
Mesurer les impressions de promotion
Pour mesurer les impressions de promotion, envoyez un événement view_promotion
contenant des informations sur la promotion:
gtag('event', 'view_promotion', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
},
{
"id": "xyz987",
"name": "spring savings"
}
]
});
Mesurer les clics sur les promotions
Pour mesurer un clic sur une promotion, envoyez un événement select_content
et indiquez la promotion:
gtag('event', 'select_content', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
}
]
});
Mesurer les achats
Pour mesurer une transaction, envoyez un événement purchase
avec les articles inclus dans la transaction:
gtag('event', 'purchase', {
"transaction_id": "24.031608523954162",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});
Mesurer les remboursements
Pour mesurer le remboursement total d'une transaction, envoyez un événement refund
avec l'ID de transaction:
gtag('event', 'refund', { "transaction_id": "T12345" })
Pour mesurer un remboursement partiel, envoyez un événement refund
avec l'ID de transaction et les articles à rembourser:
gtag('event', 'refund', {
"transaction_id": "79.18502354114992",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});