Pixel marketing (Meta, TikTok, GA4, Klaviyo, Pinterest, Snapchat, Omnisend)

WooshPayment supporta 7 piattaforme di tracking. Tutte funzionano sia client-side (pixel su browser) sia server-side via Conversion API (CAPI) per maggior accuratezza post-iOS 14.5.

Pixel supportati

Piattaforma	Modalità	Use case
Meta (Facebook + Instagram)	Pixel + CAPI	Ads FB/IG retargeting + ottimizzazione
TikTok	Pixel + CAPI	Ads TikTok
Google Analytics 4	gtag + Measurement Protocol	Reporting + remarketing
Klaviyo	Profile + Track API	Email marketing + flow recovery
Pinterest	Pixel + CAPI	Ads Pinterest
Snapchat	Pixel + CAPI	Ads Snapchat
Omnisend	Profile API	Email + SMS marketing

1. Setup pixel Meta (esempio)

1. Vai su business.facebook.com → Eventi → Pixel
2. Crea un pixel se non l'hai (associa al tuo Business Manager)
3. Copia il Pixel ID (15 cifre)
4. Per CAPI server-side: Eventi → Impostazioni → "Crea token di accesso" → copia
5. Dashboard WooshPayment → Integrazioni → Marketing → Meta:
   • Pixel ID
   • Access Token (server-side)
   • Salva

WooshPayment invierà subito questi eventi:

• PageView — atterraggio sul checkout
• InitiateCheckout — dopo che il cliente ha inserito email
• AddPaymentInfo — dopo metodo pagamento
• Purchase — dopo conferma pagamento (server-side, garantito)

Eventi inviati (tutti i pixel)

Evento	Quando	Dove
PageView	Landing checkout	Client
InitiateCheckout	Email inserita	Client + Server
AddShippingInfo	Indirizzo completato	Server
AddPaymentInfo	Metodo pagamento scelto	Server
Purchase	Pagamento confermato	Server (importante: post iOS 14.5 il client può non triggerare)

CAPI: perché è importante

Dopo iOS 14.5 il pixel client (fbq()) viene bloccato dal 30-50% degli utenti. La Conversion API server-side invia gli eventi direttamente dal nostro backend al pixel, bypassando AdBlock + Safari ITP. Risultato:

• +20-40% eventi tracciati
• ROAS più accurato
• Migliore ottimizzazione algoritmo ads

WooshPayment manda sempre l'evento Purchase server-side, con event_id univoco per dedup vs client.

Klaviyo: flow recovery

1. Crea account klaviyo.com
2. Account → Settings → API Keys → Private API Key (server-side)
3. WooshPayment → Integrazioni → Klaviyo → incolla
4. Eventi inviati:
   • Started Checkout — per flow abandoned cart
   • Placed Order — per ricevute / cross-sell
   • Refunded Order — per gestione customer service

In Klaviyo crea un Flow "Started Checkout" che manda email a 1h, 24h, 72h se cart non confermato.

Configurare consent (GDPR / CCPA)

WooshPayment rispetta consent management:

• Se cliente NON ha dato consenso marketing → pixel client disabilitati
• Eventi server-side (CAPI) per Purchase vengono sempre mandati (legittimo interesse — analytics tx)
• Eventi email_marketing mandati solo se cliente flagga "Iscrivimi alla newsletter" al checkout

Testing

Meta

• Apri Test Events nel Pixel dashboard
• Inserisci un Test Event Code nel WooshPayment setup
• Crea checkout di test → vedi eventi arrivare live

GA4

• Apri DebugView in Analytics → vedi eventi in tempo reale (max 60s delay)

Klaviyo

• Apri Activity Feed → "Recent Events" → filtra per email del test customer

Domande frequenti

Devo inserire entrambi pixel client + token server?

• Per Meta/TikTok/Pinterest/Snap: idealmente sì (dedup automatico via event_id)
• Per GA4: server-side (Measurement Protocol) sufficiente
• Per Klaviyo: solo Private API Key

I miei eventi non arrivano

1. Verifica chiave/token corretta
2. Apri WooshPayment → Logs → Marketing per vedere errori (es. "401 Unauthorized" = token revocato)
3. Su Meta: verifica che il Pixel ID sia di un pixel attivo e associato al tuo Business

Posso disattivare un pixel temporaneamente?

Sì, toggle on/off nel pannello senza dover rimuovere la chiave.

Sicurezza

Prossimi step

• Codici sconto
• Upsell post-checkout
• Abandoned cart recovery