Le commerce en ligne

eodia analytics suit le parcours d’achat par une convention d’événements, alignée sur les noms de GA4 pour faciliter une migration. Ces huit événements sont prédéclarés et sont les seuls à accepter une liste d’articles, items.

Événement	Quand l’envoyer
view_item_list	une liste de produits s’affiche (catégorie, résultats, sélection)
view_item	la fiche d’un produit s’affiche
add_to_cart	des articles entrent dans le panier
remove_from_cart	des articles en sortent
begin_checkout	le tunnel de commande commence
add_payment_info	le moyen de paiement est renseigné
purchase	la commande est passée
refund	la commande est remboursée, en tout ou en partie

Une commande

EodiaAnalytics.track('purchase', {
  transaction_id: 'C-2026-10412',
  value: 129.9,
  currency: 'EUR',
  tax: 21.65,
  shipping: 4.9,
  coupon: 'AUTOMNE',
  items: [
    { id: 'KA2', name: 'Kerys Air 2', category: 'Audio', brand: 'Kerys', variant: 'noir', price: 125, quantity: 1 },
  ],
})

Propriété	Événements	Rôle
currency	tous	la devise, code ISO 4217 (EUR)
value	tous	la valeur totale de l’action, dans la devise
transaction_id	purchase, refund	l’identifiant unique de la commande
tax, shipping, coupon	purchase, refund	taxes, frais de livraison, code de réduction
item_list	view_item_list	le nom de la liste
items	tous	les articles, 50 au plus

Un article porte au moins un id ou un name, et, au choix : category, brand, variant, price, quantity, coupon, discount.

EodiaAnalytics.track('add_to_cart', {
  currency: 'EUR',
  value: 59,
  items: [{ id: 'PL-ROUGE', name: 'Plaid Arvor', category: 'Maison', variant: 'rouge', price: 59, quantity: 1 }],
})

Mal formé, refusé

Le contrat de la charge valide la forme de ces événements : un événement du commerce en ligne mal formé (un article sans id ni name, plus de 50 articles, une quantité négative) est refusé plutôt que gardé à moitié, et apparaît dans l’onglet Vérification.

Une commande compte une fois

La vue analytics.purchases garde une ligne par transaction_id : une page de confirmation rechargée, ou une commande envoyée à la fois par le navigateur et par le serveur, ne double pas le chiffre d’affaires. Les montants envoyés par le serveur du site l’emportent ; received dit combien d’envois sont arrivés, confirmed si le serveur a confirmé.

refund compte en négatif, pour toute la commande ou pour quelques articles (avec items).

Ce que donnent les vues

• analytics.purchases : une ligne par commande ou remboursement — montant, devise, taxes, livraison, coupon, nombre d’articles, visite, et le canal par une jointure à sessions ;
• analytics.commerce_items : une ligne par article et par étape — step, produit, catégorie, marque, variante, prix, quantité, revenue (prix × quantité) ;
• analytics.attribution : chaque commande attribuée aux visites qui l’ont précédée, selon six modèles. Voir l’attribution.

-- Le tunnel d’achat de la semaine, étape par étape
SELECT step, count(DISTINCT session_id) AS visites
FROM analytics.commerce_items
WHERE day >= current_date - INTERVAL '7' DAY
GROUP BY step

Les devises

Aucune conversion : currency est une colonne. Les tableaux de bord filtrent ou groupent dessus. Un site qui vend en plusieurs devises garde ses montants tels quels.

Les objectifs

Un objectif (onglet Métadonnées) peut viser un événement — purchase, par exemple — et prendre sa valeur, value, ou une valeur fixe. La vue analytics.conversions reporte cette valeur.

Plus fiable : depuis le serveur

Le navigateur peut ne jamais afficher la page de confirmation : un paiement en trois étapes, un onglet fermé, un bloqueur. La commande la plus fiable part de votre serveur, une fois le paiement confirmé. Voir la collecte côté serveur.