Meta Pixel e Conversions API

Personalizzazione Plugin
,
1
:information_source: Sommario Aggiunge il tracciamento di Meta Pixel con Conversions API (CAPI) al tuo forum Discourse.
:hammer_and_wrench: Link al repository Plugin Discourse Meta Pixel & Conversions API
:open_book: Guida all’installazione Come installare i plugin in Discourse

Il modo usuale per aggiungere Meta Pixel a Discourse consiste nell’incollare il codice base in un componente del tema. Questo esegue fbq('track', 'PageView') una sola volta al caricamento del documento e, poiché Discourse non ricarica mai il documento, ottieni una sola PageView per visita, indipendentemente da quanti topic qualcuno legge. Questo plugin viene eseguito per ogni navigazione, aggiunge eventi di contenuto e conversione e invia una copia lato server tramite la Conversions API, in modo che gli eventi sopravvivano ai bloccanti di annunci.

Perché non usare semplicemente un componente del tema?

Un componente del tema viene eseguito solo nel browser, il che ha tre conseguenze.

I bloccanti di annunci e l’ITP di Safari rimuovono una quota significativa degli eventi del browser e non è possibile sapere quali siano mancanti. Non può eseguire la Conversions API, perché questa richiede un token di accesso e non c’è alcun posto in un componente del tema dove inserire un segreto che i visitatori non possano leggere. Inoltre, viene eseguito ovunque venga iniettato, inclusi messaggi privati, /admin e pagine di reimpostazione della password.

Se tutto ciò che desideri è una PageView per un pubblico di retargeting, un componente del tema è davvero sufficiente e richiede due minuti. Questo plugin è per la qualità delle conversioni.

Mi serve questo per il mio forum?

Probabilmente no. Pixel e CAPI sono progettati per aiutarti a tracciare le conversioni e creare pubblici pubblicitari. Sebbene possa fornirti alcuni dati analitici, il pannello di amministrazione di Discourse dispone già di dati analitici robusti. Questo è per gli utenti che desiderano principalmente tracciare le conversioni e gestire gli annunci Meta che aiutano ad attirare utenti sul tuo forum e sul tuo sito.

Funzionalità

  • Pixel del browser e Conversions API lato server in un unico plugin, che condivide un unico ID evento in modo che Meta deduplichi invece di contare due volte
  • PageView, ViewContent, Search, TopicEngaged, CompleteRegistration, TopicCreated, ReplyCreated
  • Viene eseguito per ogni navigazione SPA, non per ogni caricamento della pagina
  • Le conversioni lato server arrivano comunque quando il Pixel del browser è bloccato
  • Messaggi privati, categorie limitate e route di amministrazione non generano alcun evento
  • I titoli UGC e il testo di ricerca non vengono mai inviati
  • Il traffico dello staff può essere escluso per gruppo, applicato anche agli eventi lato server
  • Consegna in batch con classificazione dei retry, backoff per limiti di velocità e una tabella di idempotenza durevole
  • Pagina di diagnostica che mostra le consegne recenti e il loro stato

Configurazione

1. Installazione

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/multidimension-al/discourse-meta-pixel-capi.git

Poi ./launcher rebuild app. La ricostruzione esegue una migrazione che crea la tabella di consegna.

image
image840×1011 61.3 KB

2. Pixel. Amministratore → Impostazioni → Meta Pixel & Conversions API. Inserisci il tuo Pixel ID in meta pixel dataset id, poi attiva discourse meta pixel enabled. Questa è una configurazione funzionante solo con Pixel.

(Meta chiama questo Pixel ID in Events Manager e dataset ID nella documentazione della Conversions API. È lo stesso numero.)

3. Conversions API (facoltativa). Genera un token in Events Manager → il tuo dataset → Impostazioni → Conversions API. Inseriscilo in meta pixel capi access token, poi attiva meta pixel capi enabled. L’impostazione rifiuta l’attivazione senza un token e un dataset ID.

4. Verifica. Inserisci un codice da Events Manager → Test Events in meta pixel test event code e naviga nel forum. Ogni evento dovrebbe arrivare una volta, non due. Questa è la deduplicazione in funzione. Svuota il campo successivamente, poiché gli eventi inviati con un codice di test non contano come conversioni.

5. Controllo. Amministratore → Plugin → Meta Pixel → Diagnostica mostra la configurazione, lo stato del browser, i conteggi di consegna e le ultime 25 consegne con eventuali errori.

image
image850×972 43.8 KB

Impostazioni

Nome Descrizione
discourse meta pixel enabled Abilita il plugin. Disabilitato di default.
meta pixel pixel enabled Carica il Meta Pixel nel browser.
meta pixel dataset id Il tuo Meta Pixel ID (chiamato dataset ID nella documentazione CAPI).
meta pixel capi enabled Invia una copia lato server tramite la Conversions API. Richiede un token. Disabilitato di default.
meta pixel capi access token Token della Conversions API da Events Manager. Segreto lato server, mai inviato al browser.
meta pixel graph api version Versione della Graph API per le richieste CAPI. Default v26.0.
meta pixel test event code Codice di Test Events. Da impostare solo durante la verifica, poiché questi non contano come conversioni.
meta pixel track page view Invia PageView per le pagine ammissibili.
meta pixel track view content Invia ViewContent quando viene aperto un topic visibile pubblicamente.
meta pixel track search Invia Search quando viene eseguita una ricerca a pagina intera. Il testo di ricerca non viene mai inoltrato. Disabilitato di default.
meta pixel track topic engaged Invia TopicEngaged dopo una lettura significativa.
meta pixel topic engaged seconds Secondi di lettura attiva prima che venga eseguito TopicEngaged. Default 30.
meta pixel track complete registration Invia CompleteRegistration quando viene creato un account.
meta pixel track topic created Invia TopicCreated per un nuovo topic pubblico.
meta pixel track reply created Invia ReplyCreated per una risposta a un topic pubblico.
meta pixel enhanced email matching Include un hash SHA-256 dell’email del membro per migliorare la qualità dell’abbinamento. Disabilitato di default.
meta pixel external id matching Include un HMAC opaco dell’ID utente. Mai un nome utente o un’email.
meta pixel excluded groups I membri di questi gruppi non generano alcun evento Meta. Default: amministratori, moderatori.
meta pixel respect do not track Non invia nulla per i visitatori il cui browser riporta Do Not Track.
meta pixel public content only Invia eventi di contenuto solo per topic che un visitatore anonimo potrebbe leggere.
meta pixel batch size Conversioni per richiesta. Meta accetta fino a 1000. Default 100.
meta pixel batch max wait seconds Quanto tempo attende un batch parzialmente riempito. Default 300.
meta pixel delivery retention days Giorni per conservare i record di consegna. Minimo 7, default 30.
meta pixel debug mode Registra gli eventi inviati nella console del browser.

Note

  • Le copie browser e server di un evento condividono un unico ID. Meta deduplica in base al nome dell’evento più l’ID entro 48 ore, motivo per cui la finestra di attesa del batch è di minuti e non di ore.
  • La creazione di topic e risposte è solo lato server. Una copia browser non aggiungerebbe alcun segnale di identità, e un client che potesse affermare “un topic è stato creato” potrebbe affermarlo falsamente.
  • La registrazione viene inviata dal server ma abbinata a un evento browser, perché al momento della creazione dell’account non c’è una richiesta in corso da cui prendere un IP, un user agent o un _fbp.
  • I gruppi esclusi sono applicati su ogni percorso di invio lato server, non solo nel browser. TopicCreated, ReplyCreated e CompleteRegistration non coinvolgono mai un browser.
  • L’endpoint a cui il browser invia non è un proxy CAPI. Accetta quattro nomi di evento, un ID evento e facoltativamente un ID topic e un percorso. Non un URL, non user_data arbitrario.

C’è un plugin compagno Google Analytics 4 costruito allo stesso modo.

2

Non dimenticate di compilare questo campo! Io lo ho fatto.

1 Mi Piace