Il tag di Conversion API di Twitter per sGTM

L'API di conversione di Twitter vi consente di inviare informazioni dal vostro server direttamente ai server di Twitter, che possono essere utilizzati per misurare il successo della campagna.

Con Twitter CAPI, il tracciamento diventa più sicuro e preciso. Come Facebook, Twitter consente e consiglia di utilizzare un metodo ibrido di tracciamento, web+server. Quando si combina il tracciamento via web e via server, è necessaria la deduplicazione. Per abbinare gli utenti degli eventi ai profili Twitter, si utilizzano i dati dei clienti: e-mail e twclid.

Questa guida spiega come funziona l'API di conversione di Twitter e come impostare il tag Twitter CAPI in sGTM.

Per identificare l'API di conversione di Twitter è necessario qualcosa di più di un semplice ID pixel di Twitter o di un token API. Twitter richiede un'autenticazione aggiuntiva, impossibile da implementare tramite sGTM. Per questo motivo, per ora, il tag Twitter CAPI funziona solo con lo stape. Sentitevi liberi di modificare il modello di tag e di implementare l'autenticazione da soli, se necessario.

Il nuovo CAPI di Twitter non è ancora pronto per la prima serata e richiederà un lavoro 5 volte superiore rispetto all'implementazione del CAPI “standard”, se si ha già familiarità con le API di FB o TikTok. Inoltre, ci sono altre complicazioni nell'utilizzo della loro piattaforma che rendono le cose difficili.

È necessario disporre di un account dev, richiedere l'accesso a Twitter CAPI e generare diversi token di accesso. Approfondiremo tutti questi passaggi in un post successivo.

To access the Ads API, contact a Twitter representative.

Per accedere all'API annunci, contattate un rappresentante di Twitter

Se disponete di un'applicazione Ads API attiva, potete utilizzare tale applicazione e i relativi token di accesso per l'API di conversione.

Access Tokens

• Personal Tokens: Generate questi token per il vostro account Twitter nel portale degli sviluppatori.
• Other Users' Tokens: Utilizzare un flusso OAuth a tre livelli:

- Una riga di comando con autorizzazione web (twurl)

- Una riga di comando con autorizzazione basata su PIN

- Flusso web personalizzato

I token per l'API di conversione devono provenire da utenti con accesso AD_MANAGER o ACCOUNT_ADMIN, che è possibile verificare tramite l'endpoint authenticated_user_access.

Nota: È possibile condividere i token con utenti senza accesso AD_MANAGER o ACCOUNT_ADMIN.

L'autenticazione dell'API di conversione di Twitter è un processo complicato; per il momento, l'autenticazione CAPI di Twitter non può essere completamente funzionale su sGTM. Per questo motivo gestiamo l'autenticazione internamente. Ciò significa che il tag Twitter CAPI richiede l'hosting di Stape. Se potremo usare solo sGTM per l'autenticazione, aggiorneremo questo tag per supportare qualsiasi hosting. La chiave API del contenitore sGTM si trova nelle impostazioni del contenitore.

Queste due chiavi possono essere generate solo se si dispone di un account sviluppatore Twitter. Per ricevere un account sviluppatore Twitter, è necessario fare richiesta e attendere 1-3 giorni per l’approvazione della propria richiesta.

Quando si fa domanda, è necessario richiedere Accesso Essenziale. Assicurarsi di utilizzare l’account Twitter corretto per fare domanda, poiché non è possibile cambiare account in seguito.

Crea un’app utilizzando la sezione Progetto e App una volta ricevuto un account sviluppatore. Una volta fatto ciò, verranno generati una Chiave Consumatore e un Segreto Consumatore.

È possibile trovare questi due elementi nel proprio annuncio sull’account sviluppatore Twitter.

1. Crea e configura un contenitore server di Google Tag Manager.

Importante: il tag Twitter CAPI funziona solo se si utilizza l'hosting Stape per i contenitori sGTM.

2. Invia i dati dal web al server GTM. È possibile impostare GA4 lato server, Webhooks o Data Tag/Data Client.

3. Scarica il tag Twitter Conversion API dalla Galleria Template.

4. Crea un nuovo tag e seleziona Twitter Tag. Per aggiungere la Stape Container API Key, apri le impostazioni del contenitore sGTM e copia la Container API Key.

5. Aggiungi Consumer Key, Consumer Secret, OAuth Token, OAuth Token Secret. Ho descritto come generare questi valori qui.

6. Aggiungi ID del pixel Twitter e ID evento. È possibile trovare questi valori nel Tweeter Events Manager.

7. Aggiungi l'Override dei Dati Evento Server e i dati dell'utente che si desidera inviare a Twitter e configura un trigger.

Parametri del tag Twitter CAPI:

Stape Container API Key - trova questa chiave nelle impostazioni del contenitore sGTM nel tuo account Stape.

Consumer Key, Consumer Secret, OAuth Token, OAuth Token Secret - puoi trovarli nel tuo account sviluppatore Twitter dopo aver creato un’app Twitter. Mostreremo come generarli più avanti.

Pixel ID - Questo è l'ID UWT (Universal Website Tag) del tuo account pubblicitario Twitter. Per trovarlo, vai nel Twitter events manager.

Event ID - Quando crei un evento API di conversione nel Twitter events manager, lo troverai.

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

Server Event Data Override - seleziona per sovrascrivere uno dei parametri server standard: orario di conversione, numero di articoli, valuta, valore, ID conversione, descrizione e contenuti.

User Data - aggiungi i dati utente: email o twclid.

Logs Settings - seleziona se desideri utilizzare i log Stape.

9. Test degli eventi. Quando il tuo evento ha ricevuto con successo eventi di conversione entro 12-24 ore, lo stato del Single event web tag dovrebbe mostrare TRACKING nella pagina di Conversion Tracking dell’Ads Manager. Non influirà sulle campagne in corso che inviano conversioni tramite l’API di Conversione.

Twitter supporta la deduplicazione degli eventi. La combinazione di tracciamento web e server richiede l’invio di una chiave di deduplicazione con entrambi gli eventi web e server. Utilizza conversion_id per inviare la chiave di deduplicazione. La deduplicazione avviene solo se gli eventi sono stati ricevuti entro 48 ore.

Per creare un evento solo server, utilizza il Twitter events manager per creare un nuovo evento e seleziona Installa con Conversion API al terzo passaggio.

A differenza di altre piattaforme, Twitter accetta solo l’email utente e twclid. Quando invii un'email, dovrebbe essere crittografata con SHA256. Il tag Twitter crittografa automaticamente l’email utente.

Purtroppo, non è possibile testare gli eventi server di Twitter in tempo reale. Se il tracciamento è configurato correttamente, dovresti vedere lo stato del Single event web tag mostrare tracking nella Conversion Tracking in Ads Manager entro 12-24 ore.

Twitter CAPI può essere una grande aggiunta alla tua configurazione di tracciamento lato server. Sebbene il processo di autorizzazione per Twitter CAPI sia al momento estremamente complesso, la logica funziona in modo molto simile alle API di conversione di FB o TikTok: puoi inviare eventi personalizzati o standard e utilizzare solo tracciamento web+server o server. Twitter richiede dati utente per abbinare gli utenti, ma attualmente supporta solo email utente e twclid.

Twitter CAPI ha due principali svantaggi: il processo di autenticazione e la mancanza di uno strumento di test in tempo reale. A causa del processo di verifica, il tag Twitter funziona solo con server Stape per sGTM. Se Twitter semplifica il processo di autenticazione, il team Stape aggiornerà il tag per funzionare con GCP.

Questa guida ti aiuterà a familiarizzare con Twitter CAPI e a configurarlo in sGTM. Per maggiori informazioni dettagliate su Twitter CAPI, consulta la documentazione ufficiale.