API Conversions

Gateway dell'API Conversions: AWS App Runner

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.

Il gateway dell'API Conversions è un prodotto basato su cloud e, per la configurazione, richiede una soluzione di cloud hosting. Durante la configurazione, ti verrà data la possibilità di usare il tuo account cloud o di far ospitare il tuo account da un servizio partner. Se desideri ospitare il tuo account, una configurazione in cloud utilizzando Amazon Web Services App Runner può avere un costo mensile fisso inferiore e può essere implementata in circa 15 minuti seguendo i passaggi seguenti.

Se il tuo account riceverà più di 2,4 miliardi di eventi al mese, durante il flusso di configurazione prendi in considerazione l'idea di usare un gateway dell'API Conversions basato su Elastic Kubernetes Service.

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.

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 ospitato nell'istanza App Runner di un fornitore cloud. È 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.

Scopri di più