Glossario

Conversions API Gateway

Il Conversions API Gateway è un software Meta, ospitato nel tuo cloud o da un partner, che inoltra gli eventi del Pixel alla Conversions API. Costi e limiti.

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 GatewayIntegrazione direttaConversions API abilitata da Meta
Chi manda l’eventoil Gateway, inoltrando il Pixelil tuo server, quando l’evento succedeMeta, replicando il Pixel
Codicenessuno per l’inoltro dal Pixeluno sviluppatore; da 2 a 4 settimane per una nuova integrazionenessuno, un clic
Hostingil tuo account AWS o Google Cloud, oppure un partnerla tua infrastrutturaniente da ospitare
Fonti degli eventisito tramite il Pixel; caricamenti o endpoint server per le altreweb, app, offline, CRM, messaggisticasolo web
Un Lead che il Pixel non ha mai inviatonon inoltrato, a meno che non lo mandi il tuo serverinviato dal server che ha ricevuto il formperso

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

Ultimo aggiornamento:

FAQ

Chi ospita il Conversions API Gateway?+

Tu, oppure qualcuno che scegli tu. Meta fornisce il software, che gira in un account cloud di proprietà della tua azienda su AWS o Google Cloud, oppure il tuo account può essere ospitato da un servizio partner. Agenzie e rivenditori possono anche gestire un unico Gateway per più account e farci entrare i propri clienti.

Quanto costa il Conversions API Gateway?+

Il Centro assistenza di Meta dice che le commissioni del cloud sono l'unico costo, a partire da 30 USD al mese e variabili in base a zona, utilizzo e traffico del Pixel. La documentazione per sviluppatori parla del costo delle risorse cloud o delle commissioni del partner.

Che differenza c'è tra il Conversions API Gateway e un'integrazione diretta?+

Il Gateway inoltra gli eventi che il tuo Meta Pixel manda dal browser, senza codice. Un'integrazione diretta è il tuo server che chiama la Conversions API, quindi può segnalare eventi che il browser non ha mai inviato, come un form inviato mentre il Pixel era bloccato, più eventi da app, offline e CRM. Meta stima da 2 a 4 settimane per costruire una nuova integrazione diretta.

Il Conversions API Gateway deduplica gli eventi?+

Sì. Meta dice che il Gateway genera in automatico la chiave di deduplicazione event_id e la propaga sia sulla copia del Pixel sia su quella del server di ogni evento.

Pronto a sapere cosa
converte davvero?

Gratis per iniziare.

Inizia gratis →