Riferimento eventi

Converlay traccia automaticamente 10 eventi della storefront tramite la Web Pixels API di Shopify. Nessuna configurazione manuale degli eventi è necessaria — tutti gli eventi vengono generati automaticamente quando un visitatore interagisce con il tuo negozio.

Eventi tracciati automaticamente

Evento	Trigger	Dati principali
`page_view`	Ogni caricamento di pagina	URL, referrer, UTM
`view_item`	Pagina prodotto visualizzata	ID prodotto, nome, prezzo, variante
`view_item_list`	Collezione / risultati di ricerca visualizzati	ID elenco articoli, articoli
`add_to_cart`	Articolo aggiunto al carrello	ID prodotto, quantità, prezzo
`remove_from_cart`	Articolo rimosso dal carrello	ID prodotto, quantità
`search`	Ricerca effettuata	Termine di ricerca
`begin_checkout`	Checkout avviato	Valore del carrello, articoli
`add_payment_info`	Informazioni di pagamento inserite	Metodo di pagamento
`add_shipping_info`	Informazioni di spedizione inserite	Metodo di spedizione
`purchase`	Ordine completato	ID transazione, valore, articoli, dati utente

Struttura del payload dell'evento

Ogni evento inviato all'endpoint di raccolta di Converlay segue questa struttura. Ecco un esempio di evento purchase:

purchase event payload

{
  "event_id": "evt_abc123",
  "event_name": "purchase",
  "shop_domain": "my-store.myshopify.com",
  "page_url": "https://my-store.com/thank-you",
  "client_id": "clid_...",
  "session_id": "sid_...",
  "fbp": "fb.1.1700000000000.1234567890",
  "gclid": "CjwKCAiA...",
  "consent_data": {
    "analytics": true,
    "marketing": true,
    "ad_user_data": true,
    "ad_personalization": true
  },
  "ecommerce": {
    "transaction_id": "5678",
    "value": 129.99,
    "currency": "USD",
    "items": [
      {
        "item_id": "gid://shopify/ProductVariant/123",
        "item_name": "Classic Tee",
        "price": 29.99,
        "quantity": 2
      }
    ]
  },
  "user_data": {
    "email": "sha256:abc...",
    "phone": "sha256:def..."
  }
}

Gestione dei PII

I dati utente (email, telefono, indirizzo) vengono sottoposti a hashing con SHA-256 sul server prima dell'inoltro alle piattaforme pubblicitarie. I PII in chiaro non vengono mai memorizzati né condivisi. Prima dell'hashing viene applicata una normalizzazione specifica per paese.

Arricchimento degli eventi

Prima dell'inoltro, ogni evento viene arricchito con:

Click ID stitching — gclid, fbclid, ttclid vengono mantenuti tra le sessioni
Parametri Facebook — _fbp e _fbc vengono generati per il matching di Meta CAPI
Contesto della sessione — sessione mobile di 30 minuti con client ID persistente
Segnali di consenso — segnali Google Consent Mode v2 mappati dalla Customer Privacy API di Shopify
Deduplicazione eventi — un event_id univoco impedisce il doppio conteggio tra pixel e webhook

Precedente← Collegare le destinazioni SuccessivoConsenso e privacy →