Tracciamento eventi

storekit raccoglie eventi comportamentali per aiutarti a comprendere i percorsi dei clienti, ottimizzare le conversioni e alimentare integrazioni di marketing. Questa pagina spiega cosa tracciamo, come fluiscono i dati e come gli eventi si integrano con piattaforme di terze parti.

Raccolta nativa degli eventi

storekit raccoglie automaticamente gli eventi su web e app native senza richiedere codice aggiuntivo.

Eventi commerce principali

active_on_site

Attivato quando un cliente arriva sullo store.

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

menu_loaded

viewed_product

Attivato quando un cliente apre il modale di un prodotto.

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

Attivato quando un articolo viene aggiunto al carrello.

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

Attivato quando un articolo viene rimosso dal carrello.

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

started_checkout

Attivato quando il cliente apre la schermata di checkout.

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

Attivato quando il pagamento è confermato e l’ordine è effettuato.

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

Eventi di ricerca e scoperta

products_searched

Attivato quando un cliente effettua una ricerca (con debounce di 1 secondo).

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

Attivato quando viene mostrato il modale di upsell/cross-sell.

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

crossSellType è "product" o "category" a seconda della configurazione.

Eventi sconto

discount_entered

Attivato quando un cliente invia un codice sconto.

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

discount_applied

Attivato quando un codice sconto viene applicato con successo.

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

discount_denied

Attivato quando un codice sconto viene rifiutato.

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

Eventi offerte promozionali

viewed_offer

Attivato quando un’offerta promozionale diventa visibile.

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

click_offer

Attivato quando un cliente clicca su un’offerta promozionale.

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

Eventi Stories

story_viewer_opened

Attivato quando un cliente apre il visualizzatore di storie.

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

story_viewed

Attivato quando una pagina di una storia viene visualizzata.

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

story_navigation

Attivato quando un cliente naviga tra le pagine di una storia.

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

story_cta_clicked

Attivato quando un cliente clicca una CTA all’interno di una storia.

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

story_completed

Attivato quando un cliente visualizza tutte le pagine di una storia.

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

story_viewer_closed

Attivato quando il visualizzatore di storie viene chiuso.

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

Eventi di sperimentazione

viewed_experiment

Attivato quando un cliente viene esposto a una variante di test A/B.

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

Risoluzione dell’item ID

Quando invia eventi alle piattaforme di analytics, storekit risolve l’item_id usando la seguente priorità:

PLU - Codice di lookup del punto vendita (preferito per store connessi a POS)
SKU - Stock keeping unit
POS ID - Identificatore del sistema POS esterno
ID - ID prodotto interno di storekit (fallback)

Questo assicura che i tuoi dati di analytics usino gli stessi identificatori del tuo sistema POS per reporting e attribuzione accurati.

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

Per i migliori risultati, assicurati che i tuoi prodotti abbiano codici PLU configurati se stai usando un’integrazione POS. Questo mantiene i tuoi dati di analytics coerenti con i report del tuo POS.

Integrazioni con le piattaforme

storekit inoltra gli eventi a piattaforme di terze parti nel loro formato nativo. Gli eventi vengono trasformati automaticamente — non è richiesto alcun mapping.

Meta (Facebook) Pixel

Gli eventi vengono inviati all’API Pixel di Meta. Un evento PageView viene attivato automaticamente all’inizializzazione.

AddToCart

Attivato da add_to_cart

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

InitiateCheckout

Attivato da started_checkout

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

Purchase

Attivato da order_completed

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

Meta Pixel fornisce un’attribuzione migliore rispetto ai pixel solo del browser, soprattutto con i cambiamenti sulla privacy di iOS e gli ad blocker.

Google Analytics 4 / Google Tag Manager

Gli eventi vengono inviati al dataLayer seguendo lo schema e-commerce di GA4.

active_on_site

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

view_item

Attivato da 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

Attivato da 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

Attivato da 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

Gli eventi vengono inviati a Klaviyo per l’automazione di email marketing. L’identità del cliente viene collegata tramite email quando disponibile usando klaviyo.identify().

Active on Site

Attivato da active_on_site

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

Viewed Product

Attivato da viewed_product

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

Added to Cart

Attivato da add_to_cart

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

Started Checkout

Attivato da started_checkout

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

Raccolta eventi first-party

Per i clienti che vogliono la piena proprietà dei dati, storekit può inviare gli eventi direttamente al tuo data warehouse. Tutti gli eventi includono automaticamente le proprietà del contesto base. Contesto base (incluso in tutti gli eventi):

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

venue_loaded

Attivato da active_on_site. Identifica anche l’utente.

{
  "event": "venue_loaded"
}

menu_loaded

Attivato da 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

Attivato da 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

Attivato da 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"
}

Configurazione

Abilitare le integrazioni

Vai su Settings > Integrations nella tua dashboard
Seleziona la piattaforma di analytics
Inserisci l’ID pixel/measurement o la chiave API:
- Google Tag Manager: ID del container (GTM-XXXXX)
- Meta Pixel: ID pixel
- Klaviyo: chiave API
Gli eventi iniziano a fluire immediatamente

Integrazioni chat supportate

Il sistema di analytics inizializza anche i widget chat quando configurati:

Front Chat
Superchat
Tawk.to
Intercom

Risoluzione dei problemi

Gli eventi non compaiono in Meta/Google

Verifica che il tuo ID pixel sia corretto e che l’integrazione sia abilitata. Gli eventi lato server possono impiegare fino a 24 ore per comparire in alcune dashboard a causa dei ritardi di elaborazione della piattaforma.

I valori di ricavo non corrispondono

Assicurati che la tua piattaforma di analytics sia configurata per la valuta corretta. storekit invia i valori nella valuta locale dello store. Nota che i prezzi negli eventi sono in unità minori (pence/centesimi) se non diversamente specificato.

Identità utente mancante

I visitatori anonimi vengono tracciati con un ID basato sul dispositivo. L’identità dell’utente viene associata una volta che fornisce la sua email al checkout.

Modalità Store Designer

L’analytics è disabilitato quando si visualizza lo store in modalità Store Designer per evitare di contaminare i tuoi dati con traffico di test.

Getting Started

Orders

Fulfillment

Pay at Table

Menu

Direct Printing

Payments

Discounts

Marketing

Store Settings

Account

Integrations

Reports

Notifications

Platform, Privacy & Security

Tracciamento eventi

Raccolta nativa degli eventi

Eventi commerce principali

Eventi di ricerca e scoperta

Eventi sconto

Eventi offerte promozionali

Eventi Stories

Eventi di sperimentazione

Risoluzione dell’item ID

Integrazioni con le piattaforme

Meta (Facebook) Pixel

Google Analytics 4 / Google Tag Manager

Klaviyo

Raccolta eventi first-party

Configurazione

Abilitare le integrazioni

Integrazioni chat supportate

Risoluzione dei problemi

​Raccolta nativa degli eventi

​Eventi commerce principali

​Eventi di ricerca e scoperta

​Eventi sconto

​Eventi offerte promozionali

​Eventi Stories

​Eventi di sperimentazione

​Risoluzione dell’item ID

​Integrazioni con le piattaforme

​Meta (Facebook) Pixel

​Google Analytics 4 / Google Tag Manager

​Klaviyo

​Raccolta eventi first-party

​Configurazione

​Abilitare le integrazioni

​Integrazioni chat supportate

​Risoluzione dei problemi

Raccolta nativa degli eventi

Eventi commerce principali

Eventi di ricerca e scoperta

Eventi sconto

Eventi offerte promozionali

Eventi Stories

Eventi di sperimentazione

Risoluzione dell’item ID

Integrazioni con le piattaforme

Meta (Facebook) Pixel

Google Analytics 4 / Google Tag Manager

Klaviyo

Raccolta eventi first-party

Configurazione

Abilitare le integrazioni

Integrazioni chat supportate

Risoluzione dei problemi