API Conversions

Gateway dell'API Conversions

Il gateway dell'API Conversions è un'opzione di configurazione self-service in Gestione eventi. Consente alle aziende di eseguire l'integrazione secondo le linee guida sulle best practice e di inviare eventi con il pixel di Meta e l'API Conversions in una configurazione ridondante, senza risorse per gli sviluppatori dedicate, così da non aver bisogno di partner o codice di terzi.

Inoltre, il gateway dell'API Conversions offre forme di efficienza incrementale, come:

  1. Velocità: riduce i tempi dell'integrazione dell'API Conversions potenziali da settimane a ore.
  2. Costi: il gateway dell'API Conversions può determinare costi inferiori per i clienti in ragione di minori risorse tecniche o requisiti. L'unico costo del gateway dell'API Conversions è rappresentato dalle tariffe associate delle risorse cloud.
  3. Facilità di configurazione: i performance marketer con esperienza in ambito tecnico possono impostare e configurare autonomamente l'API Conversions con un supporto minimo da parte dei rispettivi team IT o di sviluppatori.
  4. Bassi costi di manutenzione: a differenza delle integrazioni manuali dirette, il gateway dell'API Conversions si aggiornerà automaticamente (con il consenso del cliente) ogni volta che saranno disponibili nuove funzioni, riducendo i costi di manutenzione a lungo termine.

Architettura

Il gateway dell'API Conversions viene configurato mediante l'auto-provisioning di un'istanza server nell'ambiente cloud, utilizzata per inviare eventi web attraverso una connessione server-to-server affidabile con Facebook.

Di seguito è riportato il diagramma di una progettazione dettagliata dei principali componenti coinvolti nel gateway dell'API Conversions:


In questo diagramma:

  • Un pixel di Meta configurato con l'endpoint del gateway invia eventi al gateway attraverso lo script del pixel.
  • Il gateway dell'API Conversions riceve i dati degli eventi dai browser e li invia all'API Conversions.
  • La chiave di deduplicazione event_id viene generata automaticamente e propagata per contribuire alla deduplicazione tra i due canali.

Supporto per pixel e domini multipli per il pixel di Meta

Il gateway dell'API Conversions supporta domini multipli. Ad esempio, puoi avere domini multipli come "dominio.com", "dominio.it", "unaltrodominio.com". Tutti questi domini possono essere configurati con una singola istanza del gateway dell'API Conversions durante l'implementazione. Per maggiori dettagli, consulta la Guida alla configurazione.

Il gateway dell'API Conversions supporta diversi pixel di Meta. Per eseguire la configurazione, il pixel deve essere associato allo stesso account business e disporre di un'implementazione del gateway dell'API Conversions esistente per uno dei pixel. Per maggiori dettagli, consulta la Guida alla configurazione.

Componenti del gateway dell'API Conversions

Il gateway dell'API Conversions richiede l'account di un provider di servizi cloud gestito da terzi diversi da Meta (ad esempio, AWS) per consentire alle aziende di implementare automaticamente l'infrastruttura sottostante senza bisogno dell'intervento di uno sviluppatore, con costi prevedibili.

Componenti software

Pixel di Meta

Il pixel di Meta è una libreria JavaScript standard caricata sul sito web dell'inserzionista che consente alle aziende di condividere i dati sulle azioni dei clienti, indicati come Dati degli strumenti business nelle Condizioni per gli strumenti business. Per le aziende che abilitano il gateway dell'API Conversions, questo tag JavaScript invia eventi sia a Meta che al gateway dell'API Conversions attraverso una connessione sicura (HTTPS) ogni volta che il pixel di Meta viene attivato dal browser.

Gateway dell'API Conversions

Il gateway dell'API Conversions è un prodotto Meta standalone e un'implementazione basata su Kubernetes ospitata su un'istanza cluster EKS del provider. È sottoposto a provisioning in un account del provider cloud di proprietà dell'azienda. Si compone di due moduli principali:

  • Un modulo middleware preposto alla ricezione degli eventi in entrata dai browser, alla trasformazione di tali eventi del browser in eventi dell'API Conversions e all'invio di eventi a Meta attraverso il collegamento con l'API Conversions.
  • Il portale con amministratore unico (interfaccia utente web) in cui le aziende possono amministrare, gestire e monitorare la propria istanza server del gateway dell'API Conversions.

Interfaccia utente per amministratori del gateway dell'API Conversions

Il gateway dell'API Conversions offre un'interfaccia utente con il prodotto. Puoi accedere a questa interfaccia utente all'indirizzo "https://<Conversions API Gateway Endpoint>/hub/capig" (ovvero, l'endpoint del gateway dell'API Conversions configurato nel DNS).

Da questa interfaccia utente, puoi vedere:

  • Pixel collegati: puoi chiudere e aprire collegamenti per diversi pixel di Meta.
  • Attività degli eventi: puoi vedere il volume di eventi ricevuti da Meta da entrambi i canali, pixel e gateway dell'API Conversions.
  • Percentuale di successo dell'API Conversions: puoi vedere la percentuale di eventi ricevuti dal browser pubblicati su Meta.
  • Notifiche: ricevi notifiche relative agli aggiornamenti ai prodotti e aggiorna il software del gateway dell'API Conversions.

Per saperne di più