Event tracking

storekit verzamelt gedragsevents om je te helpen klantreizen te begrijpen, conversies te optimaliseren en marketingintegraties aan te sturen. Deze pagina legt uit wat we tracken, hoe data stroomt en hoe events integreren met platforms van derden.

Native event-verzameling

storekit verzamelt automatisch events op web- en native apps zonder dat er extra code nodig is.

Kern-commerce-events

active_on_site

Wordt afgevuurd wanneer een klant op de store terechtkomt.

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

menu_loaded

viewed_product

Wordt afgevuurd wanneer een klant een productmodal opent.

{
  "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

Wordt afgevuurd wanneer een item aan het mandje wordt toegevoegd.

{
  "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

Wordt afgevuurd wanneer een item uit het mandje wordt verwijderd.

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

started_checkout

Wordt afgevuurd wanneer de klant het checkout-scherm opent.

{
  "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

Wordt afgevuurd wanneer de betaling is bevestigd en de order is geplaatst.

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

Zoek- en discovery-events

products_searched

Wordt afgevuurd wanneer een klant een zoekopdracht uitvoert (gedebounced met 1 seconde).

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

Wordt afgevuurd wanneer de upsell/cross-sell-modal wordt getoond.

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

crossSellType is "product" of "category" afhankelijk van de configuratie.

Kortings-events

discount_entered

Wordt afgevuurd wanneer een klant een kortingscode indient.

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

discount_applied

Wordt afgevuurd wanneer een kortingscode succesvol wordt toegepast.

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

discount_denied

Wordt afgevuurd wanneer een kortingscode wordt geweigerd.

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

Promotie-events

viewed_offer

Wordt afgevuurd wanneer een promotionele aanbieding zichtbaar wordt.

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

click_offer

Wordt afgevuurd wanneer een klant op een promotionele aanbieding klikt.

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

Stories-events

story_viewer_opened

Wordt afgevuurd wanneer een klant de story viewer opent.

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

story_viewed

Wordt afgevuurd wanneer een storypagina wordt bekeken.

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

story_navigation

Wordt afgevuurd wanneer een klant tussen storypagina’s navigeert.

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

story_cta_clicked

Wordt afgevuurd wanneer een klant op een CTA binnen een story klikt.

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

story_completed

Wordt afgevuurd wanneer een klant alle pagina’s van een story heeft bekeken.

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

story_viewer_closed

Wordt afgevuurd wanneer de story viewer wordt gesloten.

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

Experiment-events

viewed_experiment

Wordt afgevuurd wanneer een klant aan een A/B-testvariant wordt blootgesteld.

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

Item-ID-resolutie

Bij het versturen van events naar analytics-platforms bepaalt storekit het item_id volgens de volgende prioriteit:

PLU — Point of sale-lookupcode (voorkeur voor stores met een POS-koppeling)
SKU — Stock keeping unit
POS-ID — Externe POS-systeemidentifier
ID — Interne product-ID van storekit (fallback)

Dit zorgt ervoor dat je analytics-data dezelfde identifiers gebruikt als je POS-systeem voor accurate rapportage en attributie.

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

Voor de beste resultaten zorg je dat je producten PLU-codes hebben ingesteld als je een POS-integratie gebruikt. Zo blijft je analytics-data consistent met je POS-rapporten.

Platformintegraties

storekit stuurt events door naar platforms van derden in hun eigen formaat. Events worden automatisch getransformeerd — geen mapping vereist.

Meta (Facebook) Pixel

Events worden naar Meta’s Pixel-API gestuurd. Een PageView-event wordt automatisch bij initialisatie afgevuurd.

AddToCart

Getriggerd door add_to_cart

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

InitiateCheckout

Getriggerd door started_checkout

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

Purchase

Getriggerd door order_completed

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

Meta Pixel biedt betere attributie dan alleen browser-pixels, vooral met iOS-privacywijzigingen en ad blockers.

Google Analytics 4 / Google Tag Manager

Events worden naar de dataLayer gepusht volgens het e-commerce-schema van GA4.

active_on_site

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

view_item

Getriggerd door 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

Getriggerd door 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

Getriggerd door 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

Events worden naar Klaviyo gestuurd voor e-mailmarketingautomatisering. Klantidentiteit wordt gekoppeld via e-mail, indien beschikbaar, met klaviyo.identify().

Active on Site

Getriggerd door active_on_site

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

Viewed Product

Getriggerd door viewed_product

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

Added to Cart

Getriggerd door add_to_cart

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

Started Checkout

Getriggerd door started_checkout

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

1st-party event-verzameling

Voor klanten die volledig eigenaarschap over hun data willen, kan storekit events rechtstreeks naar je eigen datawarehouse sturen. Alle events bevatten automatisch basis-contextproperties. Basiscontext (opgenomen in alle events):

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

venue_loaded

Getriggerd door active_on_site. Identificeert ook de gebruiker.

{
  "event": "venue_loaded"
}

menu_loaded

Getriggerd door 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

Getriggerd door 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

Getriggerd door 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"
}

Configuratie

Integraties inschakelen

Ga in je dashboard naar Settings > Integrations
Selecteer het analytics-platform
Voer je pixel-/measurement-ID of API-key in:
- Google Tag Manager: Container-ID (GTM-XXXXX)
- Meta Pixel: Pixel-ID
- Klaviyo: API-key
Events beginnen direct te stromen

Ondersteunde chatintegraties

Het analytics-systeem initialiseert ook chat-widgets wanneer geconfigureerd:

Front Chat
Superchat
Tawk.to
Intercom

Problemen oplossen

Events verschijnen niet in Meta/Google

Controleer of je pixel-ID correct is en de integratie is ingeschakeld. Server-side events kunnen tot 24 uur duren voordat ze in sommige dashboards verschijnen vanwege verwerkingsvertragingen op het platform.

Omzetbedragen kloppen niet

Zorg dat je analytics-platform is ingesteld op de juiste valuta. storekit stuurt bedragen in de lokale valuta van de store. Merk op dat prijzen in events in minor units (pence/cents) worden verzonden, tenzij anders vermeld.

Ontbrekende gebruikersidentiteit

Anonieme bezoekers worden gevolgd met een device-gebaseerde ID. De gebruikersidentiteit wordt gekoppeld zodra ze bij het afrekenen hun e-mailadres opgeven.

Store Designer-modus

Analytics zijn uitgeschakeld wanneer de store in Store Designer-modus wordt bekeken, om te voorkomen dat je data met testverkeer vervuild raakt.

Getting Started

Orders

Fulfillment

Pay at Table

Menu

Direct Printing

Payments

Discounts

Marketing

Store Settings

Account

Integrations

Reports

Notifications

Platform, Privacy & Security

Event tracking

Native event-verzameling

Kern-commerce-events

Zoek- en discovery-events

Kortings-events

Promotie-events

Stories-events

Experiment-events

Item-ID-resolutie

Platformintegraties

Meta (Facebook) Pixel

Google Analytics 4 / Google Tag Manager

Klaviyo

1st-party event-verzameling

Configuratie

Integraties inschakelen

Ondersteunde chatintegraties

Problemen oplossen

​Native event-verzameling

​Kern-commerce-events

​Zoek- en discovery-events

​Kortings-events

​Promotie-events

​Stories-events

​Experiment-events

​Item-ID-resolutie

​Platformintegraties

​Meta (Facebook) Pixel

​Google Analytics 4 / Google Tag Manager

​Klaviyo

​1st-party event-verzameling

​Configuratie

​Integraties inschakelen

​Ondersteunde chatintegraties

​Problemen oplossen

Native event-verzameling

Kern-commerce-events

Zoek- en discovery-events

Kortings-events

Promotie-events

Stories-events

Experiment-events

Item-ID-resolutie

Platformintegraties

Meta (Facebook) Pixel

Google Analytics 4 / Google Tag Manager

Klaviyo

1st-party event-verzameling

Configuratie

Integraties inschakelen

Ondersteunde chatintegraties

Problemen oplossen