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 da Adobe Experience Platform Edge Network. 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.
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.
Installare l’estensione
Per installare l'estensione Meta Conversions API, passa all'interfaccia utente di Data Collection o all'interfaccia utente di Experience Platform e seleziona Event Forwarding 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, selezionare Extensions nel menu di navigazione a sinistra, quindi selezionare la scheda Catalog. Cerca la scheda Meta Conversions API, quindi seleziona Install.
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, selezionare Save
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 aziendale Meta. In questo modo, Pixel ID e l'API di conversione Meta Access Token vengono automaticamente compilati, semplificando l'installazione e la configurazione dell'API di conversione Meta.
Viene visualizzata una finestra di dialogo per l'autenticazione in Facebook e Instagram durante l'installazione dell'estensione Meta Conversions API.
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.
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 cambio di contesto e consente di migliorare il successo delle implementazioni API per le conversioni di Meta. Questi punteggi di evento vengono visualizzati nella schermata di configurazione Meta Conversions API extension.
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 Alpha per questa funzione.
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.
Inizia a creare una nuova regola di inoltro degli eventi e configurane le condizioni come desiderato. Quando selezioni le azioni per la regola, seleziona Meta Conversions API Extension per l'estensione, quindi seleziona Send Conversions API Event per il tipo di azione.
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.
Se si utilizzano sia Meta Pixel che Conversions API per inviare eventi, assicurarsi di includere sia un Event Name (
event_name) che un Event ID (event_id) con ogni evento, poiché questi valori vengono utilizzati per la deduplicazione eventi.Hai anche la possibilità di Enable Limited Data Use per rispettare le rinunce dei clienti. Per informazioni dettagliate su questa funzione, consulta la documentazione di Conversions API sulle opzioni di elaborazione dati.
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.
Se si invia un evento di acquisto, è necessario utilizzare questa sezione per fornire gli attributi richiesti
currency e value.Al termine, selezionare Keep Changes per aggiungere l'azione alla configurazione della regola.
Quando si è soddisfatti della regola, selezionare Save to Library. 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 per conversioni Meta (Beta) quick-start
- 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 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.
- 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 di Adobe e nell’inoltro degli eventi, riducendo in modo significativo il tempo di configurazione.
Questa funzione installa e configura automaticamente sia l’API di conversione di Meta che le estensioni Pixel di Meta su un tag appena generato automaticamente e una 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 Experience Platform Edge Network.
Il video seguente fornisce un’introduzione alla funzione di avvio rapido.
Installare la funzione di avvio rapido
Per iniziare con la configurazione guidata, segui le istruzioni contenute nella Configurazione guidata inoltro eventi.
Aggiunta di eventi aggiuntivi
Per aggiungere nuovi eventi, selezionare Edit Your Tags Web Property.
Seleziona la regola che corrisponde al meta evento da modificare. MetaConversion_AddToCart.
Per aggiungere un evento, selezionare Add sotto l'intestazione Events.
Seleziona Event Type. In questo esempio, abbiamo selezionato l'evento Click e l'abbiamo configurato per attivarlo quando viene selezionato il .add-to-cart-button. Seleziona Keep Changes.
Il nuovo evento è stato salvato. Selezionare Select a working library e selezionare la libreria in cui si desidera generare la raccolta.
Selezionare quindi il menu a discesa accanto a Save to Library e selezionare Save to Library and Build. La modifica verrà pubblicata nella libreria.
Ripeti questi passaggi per qualsiasi altro evento di metaconversione che desideri configurare.
Configurazione livello dati configuration
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.
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.
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.