Event-Tracking

storekit erfasst Verhaltens-Events, um Ihnen zu helfen, Kundenreisen zu verstehen, Conversions zu optimieren und Marketing-Integrationen zu ermöglichen. Diese Seite erklärt, was wir tracken, wie Daten fließen und wie Events mit Drittanbieterplattformen integriert werden.

Native Event-Erfassung

storekit erfasst Events automatisch über Web- und native Apps hinweg, ohne dass zusätzlicher Code erforderlich ist.

Kernkommerz-Events

active_on_site

Wird ausgelöst, wenn ein Kunde im Store landet.

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

menu_loaded

viewed_product

Wird ausgelöst, wenn ein Kunde ein Produkt-Modal öffnet.

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

Wird ausgelöst, wenn ein Artikel in den Warenkorb gelegt wird.

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

Wird ausgelöst, wenn ein Artikel aus dem Warenkorb entfernt wird.

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

started_checkout

Wird ausgelöst, wenn der Kunde den Checkout-Bildschirm öffnet.

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

Wird ausgelöst, wenn die Zahlung bestätigt und die Bestellung aufgegeben wurde.

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

Such- und Discovery-Events

products_searched

Wird ausgelöst, wenn ein Kunde eine Suche durchführt (debounced um 1 Sekunde).

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

Wird ausgelöst, wenn das Upsell-/Cross-Sell-Modal angezeigt wird.

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

crossSellType ist entweder "product" oder "category", je nach Konfiguration.

Rabatt-Events

discount_entered

Wird ausgelöst, wenn ein Kunde einen Rabattcode einreicht.

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

discount_applied

Wird ausgelöst, wenn ein Rabattcode erfolgreich angewendet wird.

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

discount_denied

Wird ausgelöst, wenn ein Rabattcode abgelehnt wird.

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

Werbeangebot-Events

viewed_offer

Wird ausgelöst, wenn ein Werbeangebot sichtbar wird.

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

click_offer

Wird ausgelöst, wenn ein Kunde auf ein Werbeangebot klickt.

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

Stories-Events

story_viewer_opened

Wird ausgelöst, wenn ein Kunde den Story-Viewer öffnet.

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

story_viewed

Wird ausgelöst, wenn eine Story-Seite angezeigt wird.

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

story_navigation

Wird ausgelöst, wenn ein Kunde zwischen Story-Seiten navigiert.

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

story_cta_clicked

Wird ausgelöst, wenn ein Kunde in einer Story auf ein CTA klickt.

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

story_completed

Wird ausgelöst, wenn ein Kunde alle Seiten einer Story angesehen hat.

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

story_viewer_closed

Wird ausgelöst, wenn der Story-Viewer geschlossen wird.

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

Experimentierungs-Events

viewed_experiment

Wird ausgelöst, wenn ein Kunde einer A/B-Test-Variante ausgesetzt wird.

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

Item-ID-Auflösung

Beim Senden von Events an Analyseplattformen löst storekit die item_id mit der folgenden Priorität auf:

PLU – Point-of-Sale-Lookup-Code (bevorzugt für POS-verbundene Stores)
SKU – Stock Keeping Unit
POS-ID – Kennung des externen POS-Systems
ID – Interne Produkt-ID von storekit (Fallback)

Dies stellt sicher, dass Ihre Analysedaten dieselben Kennungen wie Ihr POS-System für genaue Berichterstattung und Attribution verwenden.

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

Für die besten Ergebnisse stellen Sie sicher, dass Ihre Produkte PLU-Codes konfiguriert haben, wenn Sie eine POS-Integration verwenden. Dies hält Ihre Analysedaten mit Ihren POS-Berichten konsistent.

Plattformintegrationen

storekit leitet Events in ihrem nativen Format an Drittanbieterplattformen weiter. Events werden automatisch transformiert – kein Mapping erforderlich.

Meta (Facebook) Pixel

Events werden an die Pixel API von Meta gesendet. Ein PageView-Event wird bei der Initialisierung automatisch ausgelöst.

AddToCart

Ausgelöst durch add_to_cart

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

InitiateCheckout

Ausgelöst durch started_checkout

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

Purchase

Ausgelöst durch order_completed

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

Meta Pixel bietet eine bessere Attribution als reine Browser-Pixel, insbesondere bei iOS-Datenschutzänderungen und Werbeblockern.

Google Analytics 4 / Google Tag Manager

Events werden dem dataLayer gemäß dem E-Commerce-Schema von GA4 hinzugefügt.

active_on_site

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

view_item

Ausgelöst durch 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

Ausgelöst durch 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

Ausgelöst durch 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 werden an Klaviyo für E-Mail-Marketing-Automatisierung gesendet. Die Kundenidentität wird per E-Mail verknüpft, wenn verfügbar, mit klaviyo.identify().

Active on Site

Ausgelöst durch active_on_site

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

Viewed Product

Ausgelöst durch viewed_product

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

Added to Cart

Ausgelöst durch add_to_cart

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

Started Checkout

Ausgelöst durch started_checkout

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

First-Party-Event-Erfassung

Für Kunden, die vollständigen Datenbesitz wünschen, kann storekit Events direkt an Ihr eigenes Data Warehouse senden. Alle Events enthalten automatisch Basiskontext-Eigenschaften. Basiskontext (in allen Events enthalten):

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

venue_loaded

Ausgelöst durch active_on_site. Identifiziert auch den Benutzer.

{
  "event": "venue_loaded"
}

menu_loaded

Ausgelöst durch 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

Ausgelöst durch 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

Ausgelöst durch 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"
}

Konfiguration

Integrationen aktivieren

Gehen Sie zu Settings > Integrations in Ihrem Dashboard
Wählen Sie die Analyseplattform
Geben Sie Ihre Pixel-/Measurement-ID oder Ihren API-Schlüssel ein:
- Google Tag Manager: Container-ID (GTM-XXXXX)
- Meta Pixel: Pixel-ID
- Klaviyo: API-Schlüssel
Events beginnen sofort zu fließen

Unterstützte Chat-Integrationen

Das Analysesystem initialisiert bei entsprechender Konfiguration auch Chat-Widgets:

Front Chat
Superchat
Tawk.to
Intercom

Fehlerbehebung

Events erscheinen nicht in Meta/Google

Überprüfen Sie, dass Ihre Pixel-ID korrekt ist und die Integration aktiviert ist. Serverseitige Events können aufgrund von Plattformverarbeitungsverzögerungen bis zu 24 Stunden benötigen, um in einigen Dashboards zu erscheinen.

Umsatzwerte stimmen nicht überein

Stellen Sie sicher, dass Ihre Analyseplattform für die richtige Währung konfiguriert ist. storekit sendet Werte in der Landeswährung des Stores. Beachten Sie, dass Preise in Events in kleineren Einheiten (Pence/Cents) angegeben sind, sofern nicht anders angegeben.

Fehlende Benutzeridentität

Anonyme Besucher werden mit einer gerätebasierten ID verfolgt. Die Benutzeridentität wird zugeordnet, sobald sie ihre E-Mail an der Kasse angeben.

Store-Designer-Modus

Analyse ist deaktiviert, wenn der Store im Store-Designer-Modus angezeigt wird, um zu vermeiden, dass Ihre Daten mit Testdaten belastet werden.

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-Erfassung

Kernkommerz-Events

Such- und Discovery-Events

Rabatt-Events

Werbeangebot-Events

Stories-Events

Experimentierungs-Events

Item-ID-Auflösung

Plattformintegrationen

Meta (Facebook) Pixel

Google Analytics 4 / Google Tag Manager

Klaviyo

First-Party-Event-Erfassung

Konfiguration

Integrationen aktivieren

Unterstützte Chat-Integrationen

Fehlerbehebung

​Native Event-Erfassung

​Kernkommerz-Events

​Such- und Discovery-Events

​Rabatt-Events

​Werbeangebot-Events

​Stories-Events

​Experimentierungs-Events

​Item-ID-Auflösung

​Plattformintegrationen

​Meta (Facebook) Pixel

​Google Analytics 4 / Google Tag Manager

​Klaviyo

​First-Party-Event-Erfassung

​Konfiguration

​Integrationen aktivieren

​Unterstützte Chat-Integrationen

​Fehlerbehebung

Native Event-Erfassung

Kernkommerz-Events

Such- und Discovery-Events

Rabatt-Events

Werbeangebot-Events

Stories-Events

Experimentierungs-Events

Item-ID-Auflösung

Plattformintegrationen

Meta (Facebook) Pixel

Google Analytics 4 / Google Tag Manager

Klaviyo

First-Party-Event-Erfassung

Konfiguration

Integrationen aktivieren

Unterstützte Chat-Integrationen

Fehlerbehebung