Cosa configurerai
- Inoltro lato server delle conversioni a Meta tramite la Conversions API — migliora la qualità del segnale per gli utenti iOS 14.5+ e quelli che usano ad-blocker.
- Il tuo Pixel ID e un access token per la Conversions API generato da Meta Events Manager.
- Un evento di test per verificare l'integrazione prima che vada live, usando la scheda Test Events di Meta.
Elido invia eventi di conversione alla Conversions API (CAPI) di Meta lato server. Questo complementa il tuo pixel lato browser e migliora la qualità del segnale, specialmente per gli utenti che bloccano JavaScript o usano le restrizioni privacy di iOS 14.5+.
Cosa ti serve#
- Un account Meta Business con un pixel.
- Accesso a Meta Events Manager.
- Il token di accesso alla Conversions API del pixel.
Step 1 — Trova il tuo Pixel ID#
- Vai su Meta Events Manager.
- Nel pannello di sinistra, fai clic su Data Sources.
- Seleziona il tuo pixel. Il Pixel ID è il numero mostrato in alto (es.
123456789012345). Copialo.
Step 2 — Genera un access token per la Conversions API#
Nella stessa pagina di dettaglio del pixel:
- Fai clic sulla scheda Settings.
- Scorri fino a Conversions API.
- Fai clic su Generate access token sotto "Set up manually".
- Copia il token. È una lunga stringa che inizia con
EAAB....
Step 3 — Configura in Elido#
- Vai su Dashboard → Conversioni → Meta CAPI → Configura inoltro.
- Incolla il Pixel ID e l'access token.
- Fai clic su Salva.
Step 4 — Invia un evento di test#
- In Elido, fai clic su Invia evento di test. Elido invia un evento di test
Purchasecontest_event_code: TEST1234(o qualunque codice Elido generi). - In Meta Events Manager, vai al tuo pixel → scheda Test Events.
- Aspetta fino a 30 secondi. Dovresti vedere l'evento
Purchaseapparire.
Se vedi "Received" nella scheda Test Events, l'integrazione funziona.
Come Elido mappa i parametri degli eventi#
| Campo Elido | Parametro Meta CAPI |
|---|---|
click_id | event_id (per la deduplicazione) |
conversion.value | value |
conversion.currency | currency |
utm_source | Custom data: source |
utm_campaign | Custom data: campaign |
| IP utente (dal clic) | client_ip_address (hashato prima dell'invio) |
| User agent (dal clic) | client_user_agent |
Meta usa event_id per deduplicare gli eventi tra il tuo pixel browser e l'evento lato server di Elido. Se entrambi si attivano per la stessa conversione, Meta la conta una volta sola.
Nomi degli eventi#
Elido invia Purchase per gli eventi di conversione. Se vuoi che siano inoltrati anche AddToCart o Lead, usa l'opzione webhook + payload personalizzato per costruire un mapping personalizzato.
Privacy e gestione dei dati#
Elido hash email e telefono prima di inviarli a Meta (SHA-256, lowercase, trimmed). Gli indirizzi IP vengono inviati in testo normale — Meta lo richiede per il matching ma non li conserva oltre la finestra di matching. Consulta la policy sui dati di Meta per la tua valutazione di conformità GDPR.
Risoluzione dei problemi#
L'evento di test non appare in Events Manager — Controlla il Pixel ID per refusi. Verifica anche che l'access token sia per il pixel corretto — i token sono specifici per pixel.
Errore "Invalid token" nel log di consegna Elido — Il token è stato revocato o appartiene a un pixel diverso. Rigeneralo da Events Manager → Settings → Conversions API.
Gli eventi appaiono ma nessuna attribuzione in Ads Manager — L'attribuzione richiede 24–72 ore per essere elaborata. Verifica anche che client_ip_address venga passato correttamente — senza un segnale di matching, Meta non può attribuire a una campagna.
Doppio conteggio con il pixel browser — Assicurati che event_id del tuo pixel browser corrisponda al click_id Elido. Se sono stringhe diverse, Meta li tratta come due eventi distinti. Consulta la guida alla deduplicazione di Meta per le regole di matching esatte.