Questo documento è stato aggiornato.
La traduzione in Italiano non è ancora completa.
Aggiornamento inglese: 29 apr

Gateway dell'API Conversions: guida alla configurazione

Procedi come indicato per configurare il gateway dell'API Conversions.

Prima di seguire questa guida alla configurazione, assicurati di aver consultato e completato i prerequisiti per il gateway dell'API Conversions API.

Passaggio 1: primi passi e avvio dell'implementazione

Per iniziare il processo di configurazione, accedi alla tab Impostazioni in Gestione eventi di Meta. In "Configura con il gateway dell'API Conversions", clicca su Inizia.



  • Controlla i prerequisiti per il gateway dell'API Conversions e seleziona Avanti.

Selezione delle preferenze

  • Scegli le impostazioni che desideri abilitare e poi clicca su Continua.

    • Gli eventi di miglioramento possono aiutare a migliorare l'attribuzione delle conversioni e ottimizzare le prestazioni degli eventi che al momento condividi con Meta.
    • Il monitoraggio del livello di integrità del gateway dell'API Conversions consente a Meta di risolvere in modo più efficace potenziali problemi.


  • In seguito, in Seleziona la tua area geografica per l'hosting, seleziona l'area geografica desiderata. Puoi configurare il gateway dell'API Conversions in una sola area geografica.
  • Clicca su Avanti per aprire Amazon Web Services (AWS) oppure su Copia URL per inviarlo all'amministratore dell'account AWS della tua organizzazione.

Passaggio 2: configurazione e installazione di AWS

Accedi ad AWS se non l'hai ancora fatto.

  • Si aprirà un flusso di creazione rapida per lo stack del gateway dell'API Conversions.

  • Tutti i campi saranno pre-popolati. Non cambiare il campo ProvisioningData.
  • Clicca su Crea stack per iniziare l'installazione.
  • La procedura di creazione richiede circa 30-40 minuti, trascorsi i quali tre output saranno scritti nella tab "Output" per la nuova istanza AWS. Saprai che la procedura è stata conclusa quando verrà indicato lo stato CREATE_COMPLETE nella tab delle informazioni sullo stack.
  • Dopo il completamento, accedi alla tab Output.
  • (Consigliato) Crea un dominio personalizzato per facilitare il routing dei dati, consulta il passaggio 4 descritto di seguito.
  • Prendi nota del CapigSetupURL, che ti servirà per eseguire il provisioning dell'interfaccia utente del gateway dell'API Conversions.

Passaggio 3: verifica della raccolta dei dati

Per accedere all'interfaccia utente per amministratori del gateway dell'API Conversions utilizza il CapigSetupURL all'interno della tab Output (consulta il passaggio 2). Il CapigSetupURL può essere trovato anche in Gestione eventi di Meta.

  • Ti verrà chiesto di creare un account amministratore al primo accesso all'interfaccia utente per amministratori.
  • Una volta creato l'account amministratore, seleziona Accedi.
  • Si aprirà il sito dell'interfaccia utente per amministratori del gateway dell'API Conversions.
  • Alla prima visualizzazione del sito, i dati di server e browser potrebbero essere a 0. La compilazione di queste informazioni dovrebbe richiedere da 5 minuti a 2 ore.
  • Per controllare se i dati sono in fase di compilazione, puoi accedere al tuo sito web e aggiornare la pagina.
  • Se gli eventi non vengono compilati entro 2 ore, rivolgiti a Meta.
  • Ora dovresti vedere il gateway dell'API Conversions nelle impostazioni del tuo pixel.

(Consigliato) Passaggio 4: aggiunta di un dominio personalizzato

Configura un dominio personalizzato all'interno dell'interfaccia utente per amministratori del gateway dell'API Conversions. È consigliato un dominio personalizzato perché potrebbe facilitare l'ottimizzazione del routing dei dati e potrebbe ridurre i costi.

Nota: dovrai accedere al tuo provider DNS per aggiungere un dominio personalizzato.

  • Accedi all'interfaccia utente per amministratori del gateway dell'API Conversions.
  • Accedi a Gestione del dominio nella barra laterale di sinistra in Impostazioni.
  • Scegli il provider DNS tra AWS Certificate Manager (ACM) e Cloudflare.

1. AWS Certificate Manager

Per completare la configurazione, segui le istruzioni per la configurazione di ACM.

2. Cloudflare

Per completare la configurazione, segui le istruzioni per la configurazione di Cloudflare.

Risoluzione dei problemi di configurazione

Procedi come indicato per risolvere i problemi legati alla configurazione del gateway dell'API Conversions. Per la risoluzione dei problemi, consulta Gateway dell'API Conversions - Risoluzione di errori e avvisi.

L'autoinserimento del browser interferisce con la configurazione

Se non riesci a installare il gateway dell'API Conversions a causa di dati di provisioning scaduti, anche lanciando l'installazione da Gestione eventi, ciò potrebbe essere causato dalla funzione di autoinserimento del browser che inserisce automaticamente informazioni usate in precedenza.

Diagnostica

  1. Lancia l'installazione da Gestione eventi e salva i dati di provisioning per esaminarli in un secondo momento.
  2. Clicca su Copia URL e salva l'URL copiato in un editor di testo come Notepad.
  3. Clicca su Avvia implementazione per avviare la pagina di creazione AWS.
  4. Nella pagina di creazione AWS, individua ProvisioningData e verifica che l'inserimento corrisponda all'URL copiato in precedenza. In caso contrario, significa che l'autoinserimento è attivato e devi disattivarlo.

Risoluzione

Procedi come indicato per i browser Firefox:

  1. Clicca sull'icona menu Firefox (tre barre in alto a destra nello schermo).
  2. Clicca su Impostazioni.
  3. Seleziona le impostazioni di Privacy e sicurezza.
  4. Scorri fino a Cronologia e, per la voce Impostazioni cronologia, scegli Utilizza impostazioni personalizzate.
  5. Deseleziona Conserva la cronologia delle ricerche e dei moduli.
  6. Le modifiche vengono salvate automaticamente.

Procedi come indicato per i browser Chrome:

  1. Clicca sull'icona menu Chrome (tre puntini in alto a destra nello schermo).
  2. Clicca su Impostazioni.
  3. Seleziona le impostazioni di Inserimento automatico.
  4. Espandi l'area appropriata.
  5. Disattiva l'impostazione di inserimento automatico.
  6. Le modifiche vengono salvate automaticamente.

Configurazioni aggiuntive

Gestione eventi di Meta consente di aggiungere nuovi collegamenti, configurare domini aggiuntivi e aggiungere nuovi pixel al collegamento del gateway dell'API Conversions esistente. Per farlo, segui i passaggi riportati di seguito:

Clicca su Integrazioni partner, visualizzato a sinistra della pagina:



Seleziona Gateway dell'API Conversions per aprire il gateway dell'API Conversions.



In questa schermata vedrai:

  • Eventi del sito web
    1. Gli eventi sono azioni sul sito web configurate sul sito del gateway dell'API Conversions che vengono inviate separatamente a Meta usando il pixel di Meta.
  • Domini del sito web
    1. I siti web configurati per il collegamento del gateway dell'API Conversions con il pixel.


Clicca su Impostazioni e seleziona l'azione da eseguire.

Aggiunta di un altro collegamento del gateway dell'API Conversions

Questa opzione consente di configurare una nuova istanza del gateway dell'API Conversions con un altro pixel di Meta. Nella finestra di dialogo riportata di seguito viene mostrato il primo passaggio, simile a uno della pagina Impostazioni del pixel di Meta. In seguito, verrà richiesto di selezionare un pixel di Meta per l'installazione della tua nuova connessione del gateway dell'API Conversions.

Aggiunta di un altro pixel di Meta a una connessione del gateway dell'API Conversions esistente

Questa opzione consente di incorporare un altro pixel di Meta su un'installazione del gateway dell'API Conversions esistente.

Per iniziare il processo di configurazione, accedi alla tab Impostazioni in Gestione eventi di Meta. Alla sezione "Gateway dell'API Conversions esistenti", clicca sul pulsante Connetti: