Panoramica dell'estensione Meta Conversions API

Meta Conversions API ti consente di collegare i dati di marketing lato server alle tecnologie Meta per ottimizzare il targeting degli annunci, ridurre i costi per azione e misurare i risultati. Gli eventi sono collegati a un ID Meta Pixel e vengono elaborati in modo simile agli eventi lato client.

Utilizzando l'estensione Meta Conversions API, puoi sfruttare le funzionalità dell'API nelle regole di inoltro eventi per inviare dati a Meta dall'Edge Network di Adobe Experience Platform. In questo documento viene illustrato come installare l'estensione e utilizzarne le funzionalità in una regola di inoltro eventi.

Demo

Il seguente video ha lo scopo di supportare la comprensione di Meta Conversions API.

Prerequisiti

Si consiglia vivamente di utilizzare Meta Pixel e Conversions API per condividere e inviare gli stessi eventi, rispettivamente, dal lato client e dal lato server, in quanto ciò potrebbe facilitare il ripristino di eventi non raccolti da Meta Pixel. Prima di installare l'estensione Conversions API, consulta la guida sull'Meta Pixel estensione per i passaggi su come integrarla nelle implementazioni tag lato client.

NOTE
La sezione sulla deduplicazione degli eventi più avanti in questo documento descrive i passaggi per garantire che lo stesso evento non venga utilizzato due volte, in quanto potrebbe essere ricevuto sia dal browser che dal server.

Per utilizzare l'estensione Conversions API, è necessario avere accesso all'inoltro degli eventi e disporre di un account Meta valido con accesso a Ad Manager e Event Manager. In particolare, devi copiare l'ID di un Meta Pixel esistente (o creare un nuovo Pixel) in modo che l'estensione possa essere configurata sul tuo account.

INFO
Se prevedi di utilizzare questa estensione con i dati dell'app mobile o se lavori anche con i dati degli eventi offline nelle campagne Meta, dovrai creare il set di dati tramite un'app esistente e selezionare Crea da un ID pixel quando richiesto. Per informazioni dettagliate, consulta l'articolo Decidere quale opzione di creazione del set di dati è adatta alla tua azienda. Consulta il documento API delle conversioni per eventi app per tutti i parametri di tracciamento app obbligatori e facoltativi.

Installare l’estensione

Per installare l'estensione Meta Conversions API, passa all'interfaccia utente di Data Collection o all'interfaccia utente Experience Platform e seleziona Inoltro eventi dal menu di navigazione a sinistra. Da qui, seleziona una proprietà a cui aggiungere l’estensione o creane una nuova.

Dopo aver selezionato o creato la proprietà desiderata, seleziona Estensioni nel menu di navigazione a sinistra, quindi seleziona la scheda Catalogo. Cerca la scheda Meta Conversions API, quindi seleziona Installa.

Opzione Installa selezionata per lestensione Meta Conversions API nellinterfaccia utente di Data Collection.

Nella vista di configurazione visualizzata, devi fornire l'ID Pixel copiato in precedenza per collegare l'estensione al tuo account. Puoi incollare l’ID direttamente nell’input, oppure puoi utilizzare un elemento dati.

È inoltre necessario fornire un token di accesso per utilizzare specificamente Conversions API. Per informazioni su come ottenere questo valore, consulta la documentazione di Conversions API in generazione di un token di accesso.

Al termine, seleziona Salva

LID Pixel fornito come elemento dati nella vista di configurazione dellestensione.

L'estensione è installata e ora puoi utilizzarne le funzionalità nelle regole di inoltro degli eventi.

Integrazione con l’estensione Facebook e Instagram facebook

L’integrazione tramite l’estensione Facebook e Instagram consente di eseguire rapidamente l’autenticazione nell’account Meta Business. In questo modo, l'ID Pixel e l'API Meta Conversions Access Token verranno automaticamente compilati, semplificando l'installazione e la configurazione dell'API Meta Conversions.

Viene visualizzata una finestra di dialogo per l'autenticazione in Facebook e Instagram durante l'installazione dell'estensione Meta Conversions API.

La pagina di installazione dellestensione API Meta Conversions evidenzia Connetti a Meta.

Una finestra di dialogo per l’autenticazione in Facebook e Instagram viene visualizzata anche nell’interfaccia utente del flusso di lavoro con avvio rapido nell’inoltro degli eventi.

Linterfaccia utente del flusso di lavoro con avvio rapido evidenzia Connetti a Meta.

Integrazione con Event Quality Match Score (EMQ) emq

L’integrazione con Event Quality Match Score (EMQ) consente di visualizzare facilmente l’efficacia dell’implementazione mostrando i punteggi EMQ. Questa integrazione riduce al minimo il passaggio a un altro contesto e consente di migliorare il successo delle implementazioni API di metaconversione. Questi punteggi evento vengono visualizzati nella schermata di configurazione dell'estensione Meta Conversions API.

La pagina di configurazione dellestensione Meta Conversions API evidenzia Visualizza punteggio EMQ.

Integrazione con LiveRamp (Alpha) alpha

LiveRamp clienti che hanno implementato la soluzione di traffico autenticato (ATS) di LiveRamp sui loro siti possono scegliere di condividere i RampID come parametro delle informazioni sul cliente. Collabora con il tuo account team Meta per partecipare al programma di Alpha per questa funzionalità.

La pagina di configurazione dellinoltro degli eventi Meta Rule evidenzia Partner Name (alpha) e Partner ID (alpha).

Configurare una regola di inoltro degli eventi rule

In questa sezione viene illustrato come utilizzare l'estensione Conversions API in una regola di inoltro eventi generica. In pratica, è necessario configurare diverse regole per inviare tutti i eventi standard accettati tramite Meta Pixel e Conversions API. Per i dati delle app mobili, consulta i campi obbligatori, i campi dati delle app, i parametri delle informazioni cliente e i dettagli dei dati personalizzati qui.

NOTE
Gli eventi devono essere inviati in tempo reale o il più vicino possibile al tempo reale per una migliore ottimizzazione della campagna pubblicitaria.

Inizia a creare una nuova regola di inoltro degli eventi e configurane le condizioni come desiderato. Quando selezioni le azioni per la regola, seleziona Estensione API di conversione metadati per l'estensione, quindi seleziona Invia evento API di conversione per il tipo di azione.

Tipo di azione Invia visualizzazione pagina selezionato per una regola nellinterfaccia utente di Data Collection.

Vengono visualizzati i controlli che consentono di configurare i dati evento che verranno inviati a Meta tramite Conversions API. Queste opzioni possono essere immesse direttamente negli input forniti, oppure puoi selezionare elementi dati esistenti per rappresentare i valori. Le opzioni di configurazione sono suddivise in quattro sezioni principali, come descritto di seguito.

Sezione di configurazione
Descrizione
Parametri evento server
Informazioni generali sull'evento, tra cui l'ora in cui si è verificato e l'azione di origine che l'ha attivato. Per ulteriori informazioni sui parametri evento standard accettati da Conversions API, consultare la documentazione per gli sviluppatori di Meta.

Se per l'invio di eventi si utilizzano sia Meta Pixel che Conversions API, assicurarsi di includere sia un Nome evento (event_name) che un ID evento (event_id) in ogni evento, poiché questi valori vengono utilizzati per la deduplicazione evento.

Hai anche la possibilità di abilitare l'uso limitato dei dati per rispettare le rinunce dei clienti. Per informazioni dettagliate su questa funzione, consulta la documentazione di Conversions API sulle opzioni di elaborazione dati.
Parametri informazioni cliente
Dati di identità utente utilizzati per attribuire l’evento a un cliente. Per poter essere inviati all'API, alcuni di questi valori devono avere un hash.

Per garantire una buona connessione API comune e un'elevata qualità di corrispondenza eventi (EMQ), si consiglia di inviare tutti i parametri accettati per le informazioni sul cliente insieme agli eventi del server. Anche questi parametri dovrebbero avere priorità in base alla loro importanza e al loro impatto su EMQ.
Dati Personalizzati
Dati aggiuntivi da utilizzare per l’ottimizzazione della consegna di annunci, forniti sotto forma di oggetto JSON. Per ulteriori informazioni sulle proprietà accettate per questo oggetto, consulta la Conversions API documentazione.

Se si invia un evento di acquisto, è necessario utilizzare questa sezione per fornire gli attributi richiesti currency e value.
Evento di prova
Questa opzione viene utilizzata per verificare se la configurazione sta causando la ricezione di eventi server da parte di Meta come previsto. Per utilizzare questa funzionalità, selezionare la casella di controllo Invia come evento di test e quindi specificare il codice dell'evento di test desiderato nell'input seguente. Una volta distribuita la regola di inoltro degli eventi, se l'estensione e l'azione sono state configurate correttamente, è necessario visualizzare le attività nella visualizzazione Test Events in Meta Events Manager.

Al termine, seleziona Mantieni modifiche per aggiungere l'azione alla configurazione della regola.

Selezione di Mantieni modifiche per la configurazione dellazione.

Una volta soddisfatta la regola, selezionare Salva nella libreria. Infine, pubblica un nuovo evento con inoltro di build per abilitare le modifiche apportate alla libreria.

Deduplicazione degli eventi deduplication

Come indicato nella sezione prerequisiti, è consigliabile utilizzare sia l'estensione tag Meta Pixel che l'estensione inoltro eventi Conversions API per inviare gli stessi eventi dal client e dal server in una configurazione ridondante. Questo può aiutare a recuperare gli eventi che non sono stati rilevati da un’estensione o dall’altra.

Se invii tipi di evento diversi dal client e dal server senza alcuna sovrapposizione tra i due, la deduplicazione non è necessaria. Tuttavia, se un singolo evento è condiviso sia da Meta Pixel che da Conversions API, è necessario assicurarsi che questi eventi ridondanti siano deduplicati in modo che il reporting non venga influenzato negativamente.

Quando invii eventi condivisi, accertati di includere un ID evento e un nome con ogni evento inviato sia dal client che dal server. Quando vengono ricevuti più eventi con lo stesso ID e nome, Meta utilizza automaticamente diverse strategie per deduplicarli e mantenere i dati più rilevanti. Per informazioni dettagliate su questo processo, consulta la documentazione Meta sulla deduplicazione per Meta Pixel e Conversions API eventi.

Flusso di lavoro di avvio rapido: estensione API Meta Conversions (Beta) quick-start

IMPORTANT
  • La funzione di avvio rapido è disponibile per i clienti che hanno acquistato il pacchetto Real-Time CDP Prime e Ultimate. Per ulteriori informazioni, contatta il rappresentante del tuo Adobe.
  • Questa funzione è destinata alle nuove implementazioni nette e al momento non supporta l’installazione automatica di estensioni e configurazioni su tag e proprietà di inoltro degli eventi esistenti.
NOTE
Qualsiasi client esistente può utilizzare i flussi di lavoro di avvio rapido per creare un’implementazione di riferimento che può essere utilizzata per i seguenti elementi:
  • Utilizzala come inizio di un’implementazione completamente nuova.
  • Sfruttala come implementazione di riferimento da esaminare per vedere come è stata configurata e replicarla nelle implementazioni di produzione correnti.

La funzione di avvio rapido consente di effettuare la configurazione con facilità ed efficienza con l’API Meta Conversions e le estensioni Meta Pixel. Questo strumento automatizza più passaggi eseguiti nei tag Adobe e nell’inoltro degli eventi, riducendo in modo significativo il tempo di configurazione.

Questa funzione installa e configura automaticamente sia l’API Meta Conversions che le estensioni Meta Pixel su un tag appena generato automaticamente e la proprietà di inoltro degli eventi con le regole e gli elementi dati necessari. Inoltre, installa e configura automaticamente Experience Platform Web SDK e Datastream. Infine, la funzione di avvio rapido pubblica automaticamente la libreria nell’URL designato in un ambiente di sviluppo, consentendo la raccolta dei dati lato client e l’inoltro degli eventi lato server in tempo reale tramite l’inoltro degli eventi e un Edge Network di Experience Platform.

Il video seguente fornisce un’introduzione alla funzione di avvio rapido.

Installare la funzione di avvio rapido

NOTE
Questa funzione è progettata per aiutarti a iniziare con un’implementazione di inoltro degli eventi. Non fornirà un’implementazione end-to-end pienamente funzionale che tenga conto di tutti i casi d’uso.

Questa configurazione installa automaticamente sia l’API Meta Conversions che le estensioni Meta Pixel. Questa implementazione ibrida è consigliata da Meta per raccogliere e inoltrare le conversioni di eventi lato server.
La funzione di configurazione rapida è progettata per aiutare i clienti a iniziare con un’implementazione di inoltro degli eventi e non è concepita per fornire un’implementazione completa e funzionale che tenga conto di tutti i casi d’uso.

Per installare la funzionalità, selezionare Inizia per Send Conversions Data to Meta nella pagina Home della raccolta dati di Adobe Experience Platform.

Home page della raccolta dati che mostra i dati delle conversioni in meta

Immetti il dominio, quindi seleziona Successivo. Questo dominio verrà utilizzato come convenzione di denominazione per le proprietà, le regole, gli elementi dati, i flussi di dati e così via dei tag generati automaticamente e dell’inoltro degli eventi.

schermata di benvenuto con richiesta del nome di dominio

Nella finestra di dialogo Configurazione iniziale, immetti il ID metadati, il Token di accesso API di conversione metadati e il Percorso livello dati, quindi seleziona Avanti.

Finestra di dialogo per linstallazione iniziale

Attendere alcuni minuti per il completamento del processo di installazione iniziale, quindi selezionare Avanti.

Schermata di conferma del completamento dellinstallazione iniziale

Nella finestra di dialogo Aggiungi codice nel sito copiare il codice fornito utilizzando la funzione di copia Copia e incollarlo in <head> del sito Web di origine. Una volta implementato, seleziona Avvia convalida

Aggiungi il codice nella finestra di dialogo del sito

La finestra di dialogo Risultati convalida visualizza i risultati dell'implementazione dell'estensione Meta. Seleziona Avanti. Puoi visualizzare ulteriori risultati di convalida selezionando il collegamento Assurance.

Finestra di dialogo dei risultati del test con i risultati dellimplementazione

La visualizzazione della schermata Passaggi successivi conferma il completamento dell'installazione. Da qui puoi ottimizzare l’implementazione aggiungendo nuovi eventi, descritti nella sezione successiva.

Se non si desidera aggiungere altri eventi, selezionare Chiudi.

Finestra di dialogo Passaggi successivi

Aggiunta di eventi aggiuntivi

Per aggiungere nuovi eventi, selezionare Modifica proprietà Web tag.

Finestra di dialogo Passaggi successivi in cui viene visualizzata la finestra di dialogo per la modifica della proprietà Web dei tag

Seleziona la regola che corrisponde al meta evento da modificare. MetaConversion_AddToCart.

NOTE
Se non vi è alcun evento, questa regola non verrà eseguita. Questo è vero per tutte le regole, con la regola MetaConversion_PageView che è l'eccezione.

Per aggiungere un evento, seleziona Aggiungi sotto l'intestazione Eventi.

La pagina delle proprietà dei tag non mostra eventi

Seleziona il Tipo evento. In questo esempio, abbiamo selezionato l'evento Click e l'abbiamo configurato per attivarlo quando viene selezionato .add-to-cart-button. Seleziona Mantieni modifiche.

Schermata di configurazione evento con evento clic

Il nuovo evento è stato salvato. Seleziona Seleziona una libreria di lavoro e seleziona la libreria in cui desideri creare.

Selezionare un elenco a discesa della libreria di lavoro

Quindi, seleziona il menu a discesa accanto a Salva nella libreria e seleziona Salva nella libreria e genera. La modifica verrà pubblicata nella libreria.

Seleziona Salva nella libreria e genera

Ripeti questi passaggi per qualsiasi altro evento di metaconversione che desideri configurare.

Configurazione livello dati configuration

IMPORTANT
Il modo in cui aggiorni questo livello di dati globale dipende dall’architettura del tuo sito web. Un'applicazione a pagina singola sarà diversa da un'app di rendering lato server. C’è anche la possibilità che tu sia completamente responsabile della creazione e dell’aggiornamento di questi dati all’interno del prodotto Tag. In tutte le istanze, il livello dati dovrà essere aggiornato tra l'esecuzione di ciascuno dei MetaConversion_* rules. Se non aggiorni i dati tra regole, potresti anche imbatterti in un caso in cui stai inviando dati non aggiornati dagli ultimi MetaConversion_* rule nell'attuale MetaConversion_* rule.

Durante la configurazione, ti è stato chiesto dove si trova il livello dati. Per impostazione predefinita, è window.dataLayer.meta e all'interno dell'oggetto meta, i dati sono previsti come mostrato di seguito.

Metadati livello dati

Questo è importante da comprendere in quanto ogni regola MetaConversion_* utilizza questa struttura di dati per passare le parti di dati rilevanti all'estensione Meta Pixel e a Meta Conversions API. Per ulteriori informazioni sui dati necessari per i diversi metadati, consulta la documentazione su eventi standard.

Se ad esempio si desidera utilizzare la regola MetaConversion_Subscribe, è necessario aggiornare window.dataLayer.meta.currency, window.dataLayer.meta.predicted_ltv e window.dataLayer.meta.value in base alle proprietà dell'oggetto descritte nella documentazione su eventi standard.

Di seguito è riportato un esempio di ciò che dovrebbe essere eseguito su un sito web per aggiornare il livello dati prima che la regola venga eseguita.

Aggiorna metadati livello dati

Per impostazione predefinita, <datalayerpath>.conversionData.eventId verrà generato in modo casuale dall'azione "Genera nuovo ID evento" in uno dei MetaConversion_* rules.

Per un riferimento locale su come dovrebbe apparire il livello dati, puoi aprire l'editor di codice personalizzato sull'elemento dati MetaConversion_DataLayer nella tua proprietà.

Passaggi successivi

Questa guida illustra come inviare dati evento lato server a Meta utilizzando l'estensione Meta Conversions API. Da qui, si consiglia di espandere l'integrazione connettendo più Pixels e condividendo altri eventi, se applicabile. Effettuando una delle seguenti operazioni puoi migliorare ulteriormente le prestazioni dell’annuncio:

  • Connettere altri Pixels non ancora connessi a un'integrazione Conversions API.
  • Se alcuni eventi vengono inviati esclusivamente tramite Meta Pixel sul lato client, inviare gli stessi eventi a Conversions API anche dal lato server.

Consulta la documentazione di Meta sulle best practice per Conversions API per maggiori informazioni su come implementare in modo efficace l'integrazione. Per informazioni più generali sui tag e sull'inoltro di eventi in Adobe Experience Cloud, consulta la panoramica sui tag.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743