Suivi des événements

storekit collecte des événements comportementaux pour vous aider à comprendre les parcours clients, optimiser les conversions et alimenter les intégrations marketing. Cette page explique ce que nous suivons, comment les données circulent et comment les événements s’intègrent aux plateformes tierces.

Collecte native d’événements

storekit collecte automatiquement des événements sur le web et les applications natives, sans nécessiter de code supplémentaire.

Événements commerce principaux

active_on_site

Déclenché lorsqu’un client arrive sur le magasin.

{
  "event": "active_on_site",
  "properties": {
    "accountId": "40586258-8a99-4651-b79f-0a1ab602a926",
    "id": 8709,
    "slug": "your-store"
  }
}

menu_loaded

viewed_product

Déclenché lorsqu’un client ouvre la modale d’un produit.

{
  "event": "viewed_product",
  "properties": {
    "id": 98765,
    "name": "Flat White",
    "currency": "GBP",
    "price": 350,
    "image": "https://cdn.storekit.com/products/flat-white.jpg",
    "plu": "FW001",
    "sku": "SKU-FW-001"
  }
}

add_to_cart

Déclenché lorsqu’un article est ajouté au panier.

{
  "event": "add_to_cart",
  "properties": {
    "id": 98765,
    "name": "Flat White",
    "price": 400,
    "image": "https://cdn.storekit.com/products/flat-white.jpg",
    "modifiers": [
      {
        "id": 111,
        "name": "Oat Milk",
        "price": 50
      }
    ]
  }
}

remove_from_cart

Déclenché lorsqu’un article est retiré du panier.

{
  "event": "remove_from_cart",
  "properties": {
    "id": 98765,
    "name": "Flat White",
    "price": 400,
    "image": "https://cdn.storekit.com/products/flat-white.jpg",
    "modifiers": []
  }
}

started_checkout

Déclenché lorsque le client ouvre l’écran de paiement.

{
  "event": "started_checkout",
  "properties": {
    "currency": "GBP",
    "items": [
      {
        "id": 98765,
        "name": "Flat White",
        "price": 400,
        "quantity": 2,
        "modifiers": []
      }
    ],
    "venueSlug": "your-store",
    "value": 8.00
  }
}

order_completed

Déclenché lorsque le paiement est confirmé et la commande passée.

{
  "event": "order_completed",
  "properties": {
    "orderId": "ord_789xyz",
    "total": 12.50,
    "currency": "GBP",
    "venueSlug": "your-store",
    "order": {
      "items": [...],
      "fulfillmentMethod": "delivery",
      "customer": {...}
    }
  }
}

Événements de recherche et de découverte

products_searched

Déclenché lorsqu’un client effectue une recherche (avec un debounce de 1 seconde).

{
  "event": "products_searched",
  "properties": {
    "query": "coffee",
    "resultCount": 12
  }
}

Déclenché lorsque la modale upsell/cross-sell est affichée.

{
  "event": "cross_sell_modal_view",
  "properties": {
    "productCount": 4,
    "crossSellType": "product"
  }
}

crossSellType vaut soit "product", soit "category" selon la configuration.

Événements de remise

discount_entered

Déclenché lorsqu’un client soumet un code de remise.

{
  "event": "discount_entered",
  "properties": {
    "code": "SUMMER20"
  }
}

discount_applied

Déclenché lorsqu’un code de remise est appliqué avec succès.

{
  "event": "discount_applied",
  "properties": {
    "discount_id": 456,
    "discount_name": "Summer Sale",
    "discount_amount": 500,
    "discount_type": "percentage"
  }
}

discount_denied

Déclenché lorsqu’un code de remise est rejeté.

{
  "event": "discount_denied",
  "properties": {
    "discount_code": "EXPIRED10",
    "reason": "Code has expired",
    "status_code": 400
  }
}

Événements d’offres promotionnelles

viewed_offer

Déclenché lorsqu’une offre promotionnelle devient visible.

{
  "event": "viewed_offer",
  "properties": {
    "offerId": 123,
    "linkId": "link_abc",
    "type": "banner",
    "value": "20% off"
  }
}

click_offer

Déclenché lorsqu’un client clique sur une offre promotionnelle.

{
  "event": "click_offer",
  "properties": {
    "offerId": 123,
    "linkId": "link_abc",
    "type": "banner",
    "value": "20% off"
  }
}

Événements Stories

story_viewer_opened

Déclenché lorsqu’un client ouvre le lecteur de stories.

{
  "event": "story_viewer_opened",
  "properties": {
    "storyId": 789,
    "storyIndex": 0,
    "storyTitle": "New Summer Menu",
    "totalStories": 5,
    "source": "menu_page"
  }
}

story_viewed

Déclenché lorsqu’une page de story est vue.

{
  "event": "story_viewed",
  "properties": {
    "storyId": 789,
    "storyTitle": "New Summer Menu",
    "pageIndex": 2,
    "totalPages": 4,
    "hasVideo": true,
    "hasCta": true
  }
}

story_navigation

Déclenché lorsqu’un client navigue entre les pages d’une story.

{
  "event": "story_navigation",
  "properties": {
    "storyId": 789,
    "fromPage": 1,
    "toPage": 2,
    "direction": "forward",
    "method": "tap"
  }
}

story_cta_clicked

Déclenché lorsqu’un client clique sur un CTA dans une story.

{
  "event": "story_cta_clicked",
  "properties": {
    "storyId": 789,
    "pageIndex": 2,
    "ctaType": "product",
    "ctaLabel": "Order Now",
    "ctaData": { "productId": 456 },
    "videoProgressPercent": 75
  }
}

story_completed

Déclenché lorsqu’un client visualise toutes les pages d’une story.

{
  "event": "story_completed",
  "properties": {
    "storyId": 789,
    "storyTitle": "New Summer Menu",
    "totalPages": 4,
    "timeSpentSeconds": 32
  }
}

story_viewer_closed

Déclenché lorsque le lecteur de stories est fermé.

{
  "event": "story_viewer_closed",
  "properties": {
    "storyId": 789,
    "pageIndex": 2,
    "totalStoriesViewed": 3,
    "totalPagesViewed": 8,
    "timeSpentSeconds": 45,
    "closeMethod": "swipe_down"
  }
}

Événements d’expérimentation

viewed_experiment

Déclenché lorsqu’un client est exposé à une variante d’un test A/B.

{
  "event": "viewed_experiment",
  "properties": {
    "experimentId": "checkout-flow-v2",
    "variationId": 1,
    "venueId": 8709,
    "accountId": "40586258-8a99-4651-b79f-0a1ab602a926",
    "venueSlug": "your-store"
  }
}

Résolution de l’ID d’article

Lors de l’envoi d’événements aux plateformes d’analytique, storekit résout l’item_id selon la priorité suivante :

PLU — Code de recherche du point de vente (préféré pour les magasins connectés à un POS)
SKU — Stock keeping unit
POS ID — Identifiant du système POS externe
ID — ID interne du produit storekit (par défaut)

Cela garantit que vos données d’analytique utilisent les mêmes identifiants que votre système POS pour un reporting et une attribution précis.

item_id = product.plu || product.sku || product.posId || product.id

Pour de meilleurs résultats, assurez-vous que vos produits disposent de codes PLU configurés si vous utilisez une intégration POS. Cela maintient la cohérence entre vos données d’analytique et vos rapports POS.

Intégrations avec les plateformes

storekit transmet les événements aux plateformes tierces dans leur format natif. Les événements sont transformés automatiquement — aucun mapping requis.

Meta (Facebook) Pixel

Les événements sont envoyés à l’API Pixel de Meta. Un événement PageView se déclenche automatiquement à l’initialisation.

AddToCart

Déclenché par add_to_cart

{
  "content_ids": [98765],
  "content_name": "Flat White",
  "currency": "GBP",
  "value": "4.00",
  "content_type": "product"
}

InitiateCheckout

Déclenché par started_checkout

{
  "currency": "GBP",
  "value": 8.00
}

Purchase

Déclenché par order_completed

{
  "currency": "GBP",
  "value": "12.50",
  "content_type": "product"
}

Meta Pixel offre une meilleure attribution que les pixels côté navigateur uniquement, en particulier face aux changements de confidentialité iOS et aux bloqueurs de publicité.

Google Analytics 4 / Google Tag Manager

Les événements sont poussés dans le dataLayer en suivant le schéma e-commerce de GA4.

active_on_site

{
  "event": "active_on_site",
  "userId": null,
  "sessionId": null,
  "pagePath": null
}

view_item

Déclenché par viewed_product

{
  "event": "view_item",
  "currency": "GBP",
  "value": 3.50,
  "items": [
    {
      "item_id": "FW001",
      "item_name": "Flat White"
    }
  ]
}

add_to_cart

{
  "event": "add_to_cart",
  "value": 4.00,
  "currency": "GBP",
  "items": [
    {
      "item_name": "Flat White",
      "item_id": "FW001",
      "price": 4.00,
      "quantity": 1
    }
  ]
}

begin_checkout

Déclenché par started_checkout

{
  "event": "begin_checkout",
  "value": 8.00,
  "currency": "GBP",
  "items": [
    {
      "item_name": "Flat White",
      "affiliation": "your-store",
      "item_id": "FW001",
      "price": 4.00,
      "quantity": 2,
      "category": "Hot Drinks",
      "item_variant": "Oat Milk"
    }
  ]
}

purchase

Déclenché par order_completed

{
  "event": "purchase",
  "transaction_id": "ord_789xyz",
  "value": 12.50,
  "currency": "GBP",
  "items": [
    {
      "item_name": "Flat White",
      "affiliation": "your-store",
      "item_id": "FW001",
      "price": 4.00,
      "quantity": 2,
      "category": "Hot Drinks",
      "item_variant": "Oat Milk"
    }
  ]
}

Klaviyo

Les événements sont envoyés à Klaviyo pour l’automatisation email marketing. L’identité client est liée par e-mail lorsque disponible via klaviyo.identify().

Active on Site

Déclenché par active_on_site

{
  "AccountId": "40586258-8a99-4651-b79f-0a1ab602a926",
  "VenueId": 8709,
  "VenueSlug": "your-store"
}

Viewed Product

Déclenché par viewed_product

{
  "ProductId": 98765,
  "ProductName": "Flat White",
  "ProductPrice": 350,
  "ProductImage": "https://cdn.storekit.com/products/flat-white.jpg"
}

Added to Cart

Déclenché par add_to_cart

{
  "ProductId": 98765,
  "ProductName": "Flat White",
  "ProductPrice": 400,
  "ProductImage": "https://cdn.storekit.com/products/flat-white.jpg"
}

Started Checkout

Déclenché par started_checkout

{
  "Currency": "GBP",
  "Value": 8.00
}

Collecte d’événements 1st party

Pour les clients qui souhaitent une pleine propriété des données, storekit peut envoyer les événements directement vers votre propre entrepôt de données. Tous les événements incluent automatiquement des propriétés de contexte de base. Contexte de base (inclus dans tous les événements) :

{
  "account_id": "40586258-8a99-4651-b79f-0a1ab602a926",
  "venue_id": 8709,
  "venue_slug": "your-store"
}

venue_loaded

Déclenché par active_on_site. Identifie également l’utilisateur.

{
  "event": "venue_loaded"
}

menu_loaded

Déclenché par viewed_product

{
  "event": "product_modal_view",
  "product_id": 98765,
  "product_name": "Flat White",
  "product_price": 350,
  "product_image": "https://cdn.storekit.com/products/flat-white.jpg",
  "product_plu": "FW001"
}

add_to_cart

{
  "event": "add_to_cart",
  "product_id": 98765,
  "product_name": "Flat White",
  "product_price": 400,
  "product_image": "https://cdn.storekit.com/products/flat-white.jpg",
  "product_quantity": 1,
  "product_plu": "FW001",
  "add_to_cart_source": null
}

remove_from_cart

{
  "event": "remove_from_cart",
  "product_id": 98765,
  "product_name": "Flat White",
  "product_price": 400,
  "product_image": "https://cdn.storekit.com/products/flat-white.jpg",
  "product_quantity": 1,
  "product_plu": "FW001"
}

order_completed

{
  "event": "order_completed",
  "orderId": "ord_789xyz",
  "total": 12.50,
  "currency": "GBP"
}

viewed_offer

{
  "event": "viewed_offer",
  "offer_id": 123,
  "link_id": "link_abc",
  "type": "banner",
  "value": "20% off"
}

clicked_offer

Déclenché par click_offer

{
  "event": "clicked_offer",
  "offer_id": 123,
  "link_id": "link_abc",
  "type": "banner",
  "value": "20% off"
}

products_searched

{
  "event": "products_searched",
  "query": "coffee",
  "result_count": 12
}

experiment_viewed

Déclenché par viewed_experiment

{
  "event": "experiment_viewed",
  "experiment_key": "checkout-flow-v2",
  "variation_id": 1,
  "account_id": "40586258-8a99-4651-b79f-0a1ab602a926",
  "venue_id": 8709,
  "venue_slug": "your-store"
}

story_viewer_opened

{
  "event": "story_viewer_opened",
  "story_id": 789,
  "story_index": 0,
  "story_title": "New Summer Menu",
  "total_stories": 5,
  "source": "menu_page"
}

story_viewed

{
  "event": "story_viewed",
  "story_id": 789,
  "story_title": "New Summer Menu",
  "page_index": 2,
  "total_pages": 4,
  "has_video": true,
  "has_cta": true
}

story_navigation

story_cta_clicked

{
  "event": "story_cta_clicked",
  "story_id": 789,
  "page_index": 2,
  "cta_type": "product",
  "cta_label": "Order Now",
  "cta_data": { "productId": 456 },
  "video_progress_percent": 75
}

story_completed

{
  "event": "story_completed",
  "story_id": 789,
  "story_title": "New Summer Menu",
  "total_pages": 4,
  "time_spent_seconds": 32
}

story_viewer_closed

{
  "event": "story_viewer_closed",
  "story_id": 789,
  "page_index": 2,
  "total_stories_viewed": 3,
  "total_pages_viewed": 8,
  "time_spent_seconds": 45,
  "close_method": "swipe_down"
}

Configuration

Activer les intégrations

Rendez-vous dans Settings > Integrations dans votre tableau de bord
Sélectionnez la plateforme d’analytique
Saisissez votre ID de pixel/mesure ou clé API :
- Google Tag Manager : Container ID (GTM-XXXXX)
- Meta Pixel : Pixel ID
- Klaviyo : API Key
Les événements commencent à circuler immédiatement

Intégrations de chat prises en charge

Le système d’analytique initialise également les widgets de chat lorsqu’ils sont configurés :

Front Chat
Superchat
Tawk.to
Intercom

Dépannage

Les événements n'apparaissent pas dans Meta/Google

Vérifiez que votre ID de pixel est correct et que l’intégration est activée. Les événements côté serveur peuvent prendre jusqu’à 24 heures pour apparaître dans certains tableaux de bord en raison des délais de traitement des plateformes.

Les valeurs de revenus ne correspondent pas

Assurez-vous que votre plateforme d’analytique est configurée pour la bonne devise. storekit envoie les valeurs dans la devise locale du magasin. Notez que les prix dans les événements sont en unités mineures (pence/cents) sauf indication contraire.

Identité utilisateur manquante

Les visiteurs anonymes sont suivis avec un ID basé sur l’appareil. L’identité utilisateur est associée dès qu’ils fournissent leur e-mail au paiement.

Mode Store Designer

L’analytique est désactivée lors de la consultation du magasin en mode Store Designer, afin d’éviter de polluer vos données avec du trafic de test.

Getting Started

Orders

Fulfillment

Pay at Table

Menu

Direct Printing

Payments

Discounts

Marketing

Store Settings

Account

Integrations

Reports

Notifications

Platform, Privacy & Security

Suivi des événements

Collecte native d’événements

Événements commerce principaux

Événements de recherche et de découverte

Événements de remise

Événements d’offres promotionnelles

Événements Stories

Événements d’expérimentation

Résolution de l’ID d’article

Intégrations avec les plateformes

Meta (Facebook) Pixel

Google Analytics 4 / Google Tag Manager

Klaviyo

Collecte d’événements 1st party

Configuration

Activer les intégrations

Intégrations de chat prises en charge

Dépannage

​Collecte native d’événements

​Événements commerce principaux

​Événements de recherche et de découverte

​Événements de remise

​Événements d’offres promotionnelles

​Événements Stories

​Événements d’expérimentation

​Résolution de l’ID d’article

​Intégrations avec les plateformes

​Meta (Facebook) Pixel

​Google Analytics 4 / Google Tag Manager

​Klaviyo

​Collecte d’événements 1st party

​Configuration

​Activer les intégrations

​Intégrations de chat prises en charge

​Dépannage

Collecte native d’événements

Événements commerce principaux

Événements de recherche et de découverte

Événements de remise

Événements d’offres promotionnelles

Événements Stories

Événements d’expérimentation

Résolution de l’ID d’article

Intégrations avec les plateformes

Meta (Facebook) Pixel

Google Analytics 4 / Google Tag Manager

Klaviyo

Collecte d’événements 1st party

Configuration

Activer les intégrations

Intégrations de chat prises en charge

Dépannage