Stape
Ricerca

Il tag di Conversion API di Twitter per sGTM

Aggiornato
26 ago 2022
Pubblicato
20 ago 2022
Disponibile anche in

Il Conversion API di Twitter ti permette di inviare le informazioni dal tuo server direttamente ai server di Twitter, che può essere usato per misurare il successo delle campagne. 

Con CAPI Twitter, fai il monitoraggio più protetto e preciso. Come FB, Twitter permette il monitoraggio web e del server. Combinando il monitoraggio web e del server, la deduplicazione è obbligatoria. Per abbinare gli utenti negli eventi ai profili Twitter, utilizzano i dati dei clienti: email e tclid.

In questa guida, parlerò di come il Conversion API di Twitter funziona e come configurare il tag CAPI Twitter in sGTM. 

Come funziona il Conversion API di Twitter

Autenticazione

Per fare il tag CAPI di Twitter funzionare, aggiungere solo ID di pixel o API token non è sufficiente. Twitter richiede l’autenticazione aggiuntiva. Questo tipo di autenticazione è impossibile da implementare tramite sGTM. Ecco perché per ora il tag CAPI di Twitter funziona solo con i server stape per sGTM.

 Stape ha un modulo aggiuntivo per gestire l’autenticazione API di Twitter. Questa è la ragione perché il tag CAPI di Twitter funziona solo con stape. Senti libero di usare il modello di tag per modificarlo e implementare l’autenticazione da solo.  

Sembra che il modo in cui funziona Twitter CAPI sia la prima versione e sarà migliorata. In realtà ci vuole 5 volte più tempo per implementare il CAPI di Twitter rispetto al CAPI "standard" per qualcuno che ha già conosciuto FB o TikTok CAPI. Oltre a ciò, ci sono alcune altre complicazioni con Twitter CAPI.

Hai bisogno di avere l’account di sviluppatore, applicare per l’accesso a CAPI di Twitter e generare i token di accesso diverso. Elaborerò tutti questi passi più avanti in un post del blog. 

Deduplicazione degli eventi

Twitter supporta la deduplicazione degli eventi. Invii lo stesso ID dell’evento se vuoi usare entrambi monitoraggio del server e web. Se vuoi inviare i dati dell’evento solo dal server, devi creare un nuovo ID dell’evento in Twitter events manager. 

Se combina il monitoraggio web e del server, devi inviare una chiave di deduplicazione con entrambi eventi web e del server. Usi conversion_id per inviare la chiave di deduplicazione. La deduplicazione avviene solo se gli eventi erano ricevuti entro 48 ore. 

Per creare un evento solo server, devi utilizzare il Twitter events manager per creare un nuovo evento e scegliere la configurazione con Conversion API nel terzo passo.  

twitter conversion API event

I parametri dell’utente di Twitter CAPI

A differenza di altre piattaforme, Twitter accetta solo email dell’utente e twclid. Quando invii un email, deve avere hash con SHA256. 

Twitter CAPI testing

Purtroppo, non c’è il modo di provare il server di Twitter in tempo reale. Se il monitoraggio è configurato correttamente, devi vedere lo stato di “Single event web tag”, dovrebbe mostrare TRACKING sul monitoraggio delle conversioni in Gestione inserzioni entro 12-24 ore.  

I parametri di tag CAPI di Twitter

twitter conversion API tag for sGTM

Stape Container API Key - si trova nel contenitore sGTM nel tuo stape account.

Consumer Key, Consumer Secret, OAuth Token, OAuth Token Secret - puoi trovare nel tuo account di sviluppatore di Twitter dopo aver creato un’app Twitter. Ti mostrerò come generarli tardi.

Pixel ID - ID UWT (Universal Website Tag) del tuo account pubblicitario Twitter. Per trovarlo vai a Twitter events manager. 

Event ID - Quando crei un Conversion API dell’Evento in Twitter events manager, lo troverai.

Use HttpOnly cookies - Impedisce a JavaScript di accedere al cookie se abilitato.

Server Event Data Override - scegli di sottoscrivere uno dei parametri del server standard: tempo della conversione, numero degli elementi, valuta, ID della conversione, discrezione e contenuto.

User Data - aggiungi il data dell’utente: email o twclid.

Logs Settings - scegli se vuoi usare i log di stape.

Cosa ti serve per configurare Twitter CAPI

Stape container API key

L’autenticazione di Conversion API di Twitter è un processo complicato, per ora, l’autenticazione di Twitter CAPI non può essere completamente funzionante su sGTM. Ecco perché gestiamo l'autenticazione internamente. Significa che il tag CAPI Twitter richiede Stape hosting. Se è possibile nel futuro usare solo sGTM per l’autenticazione, aggiorneremo questo tag per supportare qualsiasi hosting. Puoi trovare la chiave API del contenitore sGTM all’interno delle configurazioni del contenitore. 

stape container API key

Consumer Key e Consumer Secret.

Queste due chiavi possono essere generate solo se hai un account di sviluppatore di Twitter. Per ricevere un account di sviluppatore di Twitter, devi fare l’applicazione ed aspettare per 1-3 giorni prima che la tua domanda venga approvata.

Al momento della domanda, è necessario richiedere L’accesso Essenziale (Essential Access). Verifica di usare l’account di Twitter corretto per applicare gli account degli sviluppatori poiché è impossibile cambiare account in seguito.

Crea un’app utilizzando la sezione Progetto e App quando ricevi un account di sviluppo. Al termine, verranno generati Consumer Key e Consumer Secret.

twitter capi api keys 

Twitter ads CAPI access.

Per configurare CAPI, è necessario ottenere accesso API degli annunci. Includi l’ID app corretto nell’applicazione API Ads. Scegli il Conversion API nell’applicazione API degli annunci in "Come utilizzerai l’API degli annunci?"

OAuth Token e OAuth Token Secret.

Puoi trovare questi due nel tuo annuncio all’interno dell’account di sviluppatore di Twitter.

Come configurare il tag del Conversion API di Twitter in sGTM

!

I tag CAPI di Twitter funzionano solo se usi i server di stape per i contenitore sGTM.

2. Invii i dati a sGTM. Puoi usare GA4, Webhooks o Data Tag/Data Client.

3. Scarichi il tag di Conversion API di Twitter da GitHub. Apri la sezione dei modelli sGTM -> clicchi su tre punti nell'angolo in alto a destra -> clicchi su import -> carichi il tag che hai scaricato recentemente da GitHub e clicchi su Salva.

import twitter CAPI tag

4. Crei un nuovo tag e scegli Twitter Tag. Aggiungi la Chiave API di Contenitore Stape. Per farlo, apri le configurazioni del contenitore sGTM e copi la Chiave API del Contenitore.

contaniner API key stape

5. Aggiungi Consumer Key, Consumer Secret, OAuth Token, OAuth Token Secret. Ho descritto come generali qui.

6. Aggiungi ID pixel di Twitter e ID dell’evento. Puoi trovare questi valori in Twitter Events Manager.

7. Aggiungi Server Event Data Override e i dati dell’utente se vuoi inviare a Twitter. E configuri un trigger. 

twitter CAPI tag

8. Purtroppo, non c'è modo di provare Twitter CAPI in tempo reale. Dopo la configurazione, utilizza Twitter events manager per vedere se sono stati inviati eventi CAPI di Twitter.

La conclusione:

Twitter CAPI può essere un’ottima aggiunta al tuo stack di monitoraggio lato server. Sebbene il processo di autorizzazione per Twitter CAPI per ora sia incredibilmente complicato, altre logiche funzionano in modo molto simile ad altri Conversion API: puoi inviare eventi personalizzati o standard e utilizzare solo il monitoraggio web+server o server. Per abbinare gli utenti, Twitter chiede di inviare i dati degli utenti, ma per ora supportano solo email degli utenti e twclid.

Ci sono due principali svantaggi di Twitter CAPI: processo di autenticazione e nessuno strumento di prova in tempo reale. A causa del processo di verifica, il tag di Twitter funziona solo con i server stape per sGTM. Se Twitter semplifica il processo di autenticazione, il team di stape aggiornerà il tag per funzionare con GCP.

Spero che questa guida ti aiuti a conoscere Twitter CAPI e come configurare Twitter CAPI in sGTM. Per informazioni più dettagliate su Twitter CAPI, vedi la documentazione ufficiale. Se hai bisogno di aiuto per configurare Twitter CAPI, contattaci!

Taggato con:sGTM tag

Ospita il tuo server GTM su Stape