Il Conversions API Gateway (nel Centro assistenza in italiano: gateway dell’API Conversions) è un prodotto Meta senza codice che inoltra gli eventi del sito del tuo Meta Pixel alla Conversions API da un’istanza server nel tuo account cloud, o in uno che un partner ospita per te (Meta for Developers). Il Pixel manda ogni evento sia a Meta sia al Gateway, che lo inoltra da server a server con un event_id generato in automatico, così le due copie si deduplicano.
Come funziona il Conversions API Gateway
Meta descrive due moduli: un middleware che riceve gli eventi dai browser, li trasforma in eventi della Conversions API e li manda a Meta, e un’interfaccia di amministrazione su /hub/capig che mostra i Pixel collegati, l’attività degli eventi e il tasso di successo della Conversions API. Una sola istanza può servire più Pixel e più domini.
Il setup parte da Events Manager: tab Impostazioni, Set up with Conversions API Gateway, Get started. Scegli una configurazione cloud e una sola regione di hosting, poi lanci uno stack AWS precompilato che, secondo Meta, richiede da 30 a 40 minuti per essere creato. I dati compaiono in un tempo che va da 5 minuti a 2 ore, e Meta consiglia di aggiungere un dominio personalizzato (guida al setup).
L’inoltro dal Pixel è il cuore del prodotto. Il Gateway accetta anche file di eventi caricati, e dalla versione 1.6.0 ha un endpoint a cui il tuo server può mandare eventi non web (offline, app, CRM) (inviare eventi da un server). Ma nel momento in cui il tuo server ci scrive, stai scrivendo il codice di integrazione che il Gateway doveva risparmiarti.
Chi ospita il Conversions API Gateway
- Il tuo account cloud. L’istanza gira su AWS (EKS o ECS Express) o su Google Cloud, in un account di proprietà dell’azienda. Meta dice che la modalità ECS Express può offrire un costo mensile fisso più basso e si configura in circa 25 minuti (ECS Express).
- Un servizio partner. Durante il setup puoi far ospitare il tuo account da un partner (stesso articolo).
- Un host per più account. Agenzie, partner e rivenditori possono configurare una volta il Gateway per più account e farci entrare le aziende clienti, che poi collegano i loro Pixel senza gestire un’infrastruttura propria.
Sui costi, l’articolo del Centro assistenza di Meta dice che le commissioni del cloud sono l’unico costo e partono da 30 USD al mese, variabili in base a zona, utilizzo e traffico del Pixel. Lo propone alle aziende che usano già il Pixel, non mandano ancora eventi web tramite la Conversions API, spendono più di 300 USD al mese in campagne ottimizzate per eventi web e non lavorano con un partner di e-commerce come Shopify.
Gateway vs integrazione diretta
| Conversions API Gateway | Integrazione diretta | Conversions API abilitata da Meta | |
|---|---|---|---|
| Chi manda l’evento | il Gateway, inoltrando il Pixel | il tuo server, quando l’evento succede | Meta, replicando il Pixel |
| Codice | nessuno per l’inoltro dal Pixel | uno sviluppatore; da 2 a 4 settimane per una nuova integrazione | nessuno, un clic |
| Hosting | il tuo account AWS o Google Cloud, oppure un partner | la tua infrastruttura | niente da ospitare |
| Fonti degli eventi | sito tramite il Pixel; caricamenti o endpoint server per le altre | web, app, offline, CRM, messaggistica | solo web |
| Un Lead che il Pixel non ha mai inviato | non inoltrato, a meno che non lo mandi il tuo server | inviato dal server che ha ricevuto il form | perso |
Le colonne integrazione diretta e Conversions API abilitata da Meta vengono dal confronto di Meta tra le opzioni di configurazione, che oggi elenca queste due più le integrazioni dei partner e lascia fuori il Gateway.
Un Lead che nasce nel browser si può perdere nel browser. DropCPL manda l’evento Lead tramite la Conversions API dal server che riceve il form, con event_id per la deduplicazione e fbc/fbp, e senza niente da ospitare per te. Inizia gratis →
I limiti per la lead generation
Il punto di partenza del Gateway è il browser. Su una landing page di lead gen, l’invio del form arriva a un server qualunque cosa faccia il browser, mentre la copia del Pixel esiste solo se lo script si è caricato ed è partito. Quando il Pixel è bloccato, il setup standard del Gateway non ha niente da inoltrare. Un’integrazione diretta segnala il lead dal server che lo ha salvato, che è lo schema del server-side tracking nella sua forma più semplice.
Quindi la mia regola: se il tuo form invia i dati a un backend che controlli, salta il Gateway e manda il Lead da quel backend. Il Gateway ha senso per team con molti Pixel e domini, senza sviluppatori e con un account cloud che sono disposti a gestire. In ogni caso controlla cosa arriva nel tuo dataset di Meta. La guida al setup della Conversions API ha i passaggi per entrambe le strade, e la deduplicazione tra Pixel e CAPI spiega il match sull’event_id.
Termini correlati
- Meta CAPI: l’API a cui il Gateway inoltra gli eventi
- Dataset di Meta: dove arrivano gli eventi inoltrati
- Server-side tracking: lo schema che segue un’integrazione diretta