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.
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 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.
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
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.
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 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.
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à.
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 Estensione API di conversione metadati per l'estensione, quindi seleziona Invia evento API di conversione 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 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.
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, seleziona Mantieni modifiche per aggiungere l'azione alla configurazione della regola.
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
- 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.
- 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
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.
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.
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.
Attendere alcuni minuti per il completamento del processo di installazione iniziale, quindi selezionare Avanti.
Nella finestra di dialogo Aggiungi codice nel sito copiare il codice fornito utilizzando la funzione di copia
<head> del sito Web di origine. Una volta implementato, seleziona Avvia convalida
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.
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.
Aggiunta di eventi aggiuntivi
Per aggiungere nuovi eventi, selezionare Modifica proprietà Web tag.
Seleziona la regola che corrisponde al meta evento da modificare. MetaConversion_AddToCart.
Per aggiungere un evento, seleziona Aggiungi sotto l'intestazione 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.
Il nuovo evento è stato salvato. Seleziona Seleziona una libreria di lavoro e seleziona la libreria in cui desideri creare.
Quindi, seleziona il menu a discesa accanto a Salva nella libreria e seleziona Salva nella libreria e genera. 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.