WWooshPayment docs
Marketing

Pixel marketing (GA4, GTM, Meta, TikTok)

Configura i pixel marketing supportati per tracciare conversioni. Eventi client + server (CAPI) per accuratezza post-iOS 14.5.

3 min di lettura

WooshPayment supporta 4 integrazioni marketing dalla pagina Dashboard → Integrazioni. Ognuna invia eventi a destinazione: alcuni client (script), altri server (CAPI/Measurement Protocol) per bypassare AdBlock + Safari ITP.

Pixel supportati

PiattaformaCampiEventi inviati
Google Analytics 4measurement_id, api_secret (opz.)page_view, begin_checkout, purchase (client + server via MP)
Google Tag Managercontainer_iddataLayer.push su ogni evento
Facebook / Meta Pixelpixel_id, access_token CAPI (opz.)InitiateCheckout, Purchase (client + server via CAPI)
TikTok Pixelpixel_id, access_token Events API (opz.)InitiateCheckout, PlaceAnOrder (client + server via Events API)

Niente Klaviyo, Pinterest, Snapchat, Omnisend per ora. Niente "script custom" (rimosso perché era un vettore di stored XSS).

1. Google Analytics 4

  1. Google Analytics → Admin → Data Streams → Web → tuo stream
  2. Copia Measurement ID (G-XXXXXXXXXX)
  3. (Opzionale ma consigliato) Sezione "Measurement Protocol API secrets" → crea API Secret
  4. WooshPayment Dashboard → Integrazioni → Google Analytics 4 → incolla entrambi → Salva

Senza API Secret, gli eventi partono solo client. Con API Secret, purchase parte anche server-side (più accurato).

2. Google Tag Manager

  1. GTM → seleziona container → copia Container ID (GTM-XXXXXXX)
  2. WooshPayment → Integrazioni → Google Tag Manager → incolla → Salva
  3. In GTM crea trigger basati su dataLayer events (es. event: purchase)

Noi pushiamo dataLayer su ogni evento. GTM si occupa di smistare a destinazione.

3. Meta (Facebook + Instagram) Pixel

  1. business.facebook.com → Events Manager → Pixel
  2. Crea pixel se non l'hai (associa al tuo Business Manager)
  3. Copia Pixel ID (15 cifre)
  4. Per CAPI server-side: Events Manager → Impostazioni → "Crea token di accesso" → copia
  5. WooshPayment → Integrazioni → Facebook / Meta Pixel → incolla → Salva

Eventi inviati:

  • InitiateCheckout quando il cliente arriva al checkout
  • Purchase quando il pagamento è confermato

Con CAPI Access Token, Purchase parte anche server-side con event_id univoco per deduplicazione vs client.

4. TikTok Pixel

  1. TikTok Events Manager → Tools → Pixel → crea pixel
  2. Copia Pixel ID (CXXXXXXXXXXXXXXXXXX)
  3. Stessa pagina → tab "Events API" → genera Access Token
  4. WooshPayment → Integrazioni → TikTok Pixel → incolla → Salva

Eventi: InitiateCheckout, PlaceAnOrder (client + server).

CAPI: perché conta

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

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

WooshPayment manda sempre l'evento di conversione server-side, con event_id univoco per dedup contro il client (così non conti due volte).

Consent management (GDPR / CCPA)

  • Se il cliente non ha dato consenso marketing → pixel client disabilitati
  • Eventi server-side per Purchase partono sempre (base giuridica: legittimo interesse — analytics di una transazione richiesta dall'utente)
  • Cookie banner di consenso è responsabilità del tuo store (Shopify ha il cookie banner built-in; Woo con plugin)

Testing

Meta

  • Apri Test Events nel Pixel dashboard
  • Inserisci un Test Event Code (opzionale) — utile per non sporcare i dati di produzione
  • Apri il tuo checkout, simula un acquisto → vedi gli eventi arrivare in real-time

TikTok

  • Events Manager → tab "Test Events" → vedi eventi live

GA4

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

Sicurezza

Le chiavi server-side (Meta Access Token, TikTok Access Token, GA4 API Secret) non vengono mai esposte client-side. Sono cifrate at rest (AES-256-GCM) e usate solo dal nostro backend per chiamare le rispettive Conversion API.

Domande frequenti

Devo configurare sia pixel client sia token server?

Per Meta/TikTok: idealmente sì (dedup automatico via event_id, accuratezza +30%). Per GA4: il Measurement Protocol server-side è sufficiente ma anche il client gtag aiuta sui report di engagement.

I miei eventi non arrivano

  1. Verifica che chiave/token siano corretti
  2. Vai su Test Events della piattaforma destinazione e fai un acquisto di test
  3. Per Meta: verifica che il Pixel ID sia di un pixel attivo e associato al tuo Business
  4. Per TikTok: verifica che il Pixel ID corrisponda all'account che paga le ads

Posso disattivare un pixel temporaneamente?

Sì, dalla card Integrazione clicca disattiva — la chiave resta salvata.

Voglio Klaviyo / Pinterest / Snapchat

Per ora non sono nel core. Scrivici se ti servono.

Prossimi step