Tag API de conversão do Twitter para sGTM

A API de Conversão do Twitter permite-lhe enviar informações do seu servidor diretamente para os servidores do Twitter, que podem ser utilizadas para medir o sucesso da campanha.

Com o Twitter CAPI, torna o rastreamento mais seguro e preciso. Tal como o FB, o Twitter permite o rastreamento da web e do servidor. Ao combinar o rastreamento da web e do servidor, é necessária a desduplicação. Para igualar os usuários em eventos aos perfis do Twitter, eles utilizam os dados dos clientes: e-mail e twclid.

Neste guia, vou falar sobre como funciona a API de conversão do Twitter e como configurar a tag CAPI do Twitter no sGTM.  

Como funciona a API de conversão do TwitterCopiar link para esta secção

AutenticaçãoCopiar link para esta secção

Para que a tag CAPI do Twitter funcione, não basta adicionar apenas ID de pixel ou API token. O Twitter requer autenticação adicional. Este tipo de autenticação é impossível de implementar via sGTM. É por isso que, por agora, a tag CAPI do Twitter só funciona com os servidores stape para sGTM. 

O Stape tem um módulo adicional para lidar com a autenticação da API do Twitter. Esta é a razão pela qual a tag CAPI do Twitter funciona apenas com o stape. Sinta-se à vontade para usar o template da tag para modificá-la e implementar a autenticação por si próprio. 

Parece que a forma como a tag Twitter CAPI funciona é a primeira versão e será melhorada. Realisticamente, levará 5x mais tempo a implementar o Twitter CAPI do que o "standard" CAPI para alguém já familiarizado com FB ou TikTok CAPI. Além disso, existem algumas outras complicações com o Twitter CAPI. Vai precisar de uma conta dev, solicitar o acesso ao Twitter CAPI, e gerar vários tokens de acesso. Elaborarei todos estes passos mais tarde num post de blog. 

Deduplicação de eventosCopiar link para esta secção

O Twitter apoia a desduplicação de eventos. Se desejar utilizar o mesmo ID de evento, envie o mesmo ID de evento, tanto para o servidor como para o rastreio web. Se quiser enviar dados de eventos apenas a partir do servidor, deve criar uma nova ID de evento no gestor de eventos do Twitter. 

Se combinar o seguimento da web e do servidor, deve enviar uma chave de desduplicação com os eventos da web e do servidor. Utilize o conversion_id para enviar a chave de deduplicação. A desduplicação só acontece se os eventos forem recebidos dentro de 48 horas.  Para criar um evento apenas do servidor, deve usar o gestor de eventos do Twitter para criar um novo evento e seleccionar instalar com a API de Conversão no 3º passo. 

Parâmetros de usuário do Twitter CAPICopiar link para esta secção

Ao contrário de outras plataformas, o Twitter aceita apenas e-mail e twclid de usuários. Quando se envia um e-mail, este deve ser hashed com SHA256.

Twitter CAPI testingCopiar link para esta secção

Infelizmente, não há forma de testar os eventos do servidor Twitter em tempo real. Se o rastreio for configurado correctamente, deverá ver o estado da 'Tag web de evento único' deve mostrar TRACKING no Gestor de Anúncios no prazo de 12 a 24 horas. 

Parâmetros da tag CAPI do TwitterCopiar link para esta secção

Stape Container API Key - encontre-a na configuração de container sGTM na sua conta stape. 

Consumer Key, Consumer Secret, OAuth Token, OAuth Token Secret - pode encontrá-la na sua conta de dev no Twitter depois de ter criado uma aplicação no Twitter. Mais tarde mostrarei como gerar estes.

Pixel ID - o ID da sua conta de anúncio no Twitter da Universal Website Tag (UWT). Para a encontrar, vá ao gestor de eventos do Twitter. 

Event ID - Ao criar um evento API de conversão no gestor de eventos do Twitter, irá encontrá-lo.

Use HttpOnly cookies - Proíbe o JavaScript de aceder ao cookie se este estiver activado.

Server Event Data Override - seleccione para substituir um dos parâmetros padrão do servidor: tempo de conversão, número de itens, moeda, valor, ID de conversão, descrição, e conteúdo. 

User Data - adicionar dados do usuário: e-mail ou twclid

Logs Settings - seleccione se pretende utilizar os registos de stape. 

O que precisa para configurar o CAPI do TwitterCopiar link para esta secção

Stape container API keyCopiar link para esta secção

A autenticação API de conversão do Twitter é um processo complicado; por enquanto, a autenticação CAPI do Twitter não pode ser totalmente funcional no sGTM. É por isso que lidamos com a autenticação internamente. Isto significa que a tag CAPI do Twitter requer alojamento de Stape. Se no futuro for possível utilizar apenas sGTM para autenticação, atualizaremos esta tag para suportar qualquer tipo de alojamento. Pode encontrar a chave API do contêiner sGTM dentro das configurações do contêiner. 

Consumer Key and Consumer Secret.Copiar link para esta secção

Estas duas chaves só podem ser geradas se tiver uma conta de desenvolvedor no Twitter. Para receber uma conta de desenvolvedor no Twitter, é necessário solicitá-la e aguardar cerca de 1-3 dias até que a sua solicitação seja aprovada. 

Ao candidatar-se, precisa de solicitar Acesso Essencial. Certifique-se de que utiliza a conta correta no Twitter para solicitar contas dev, uma vez que é impossível alterar as contas mais tarde. 

Crie uma aplicação utilizando a secção Projecto e Aplicação quando receber uma conta dev. Uma vez terminada, a Chave do Consumidor e o Segredo do Consumidor serão gerados. 

Twitter ads CAPI access.Copiar link para esta secção

Para configurar o CAPI, é necessário obter o acesso API de anúncios. Incluir o ID correto da aplicação na aplicação Ads API. Seleccione Conversion API na aplicação Ads API em "Como irá utilizar a API de anúncios?”

OAuth Token and OAuth Token Secret.Copiar link para esta secção

Pode encontrar estes dois no seu anúncio dentro da conta dev do Twitter.

Como configurar a tag API de conversão do Twitter em sGTMCopiar link para esta secção

1. Criar e configurar um servidor Google Tag Manager container. 

2. Enviar dados para sGTM. Pode usar GA4, Webhooks, ou Data Tag/Data Client.

3. Fazer o download da Twitter Conversion API tag a partir do GitHub. Abra a secção de template sGTM -> clique nos três pontos no canto superior direito -> clique em importar -> carregue a tag que baixou recentemente de GitHub, e clique em Guardar.

4. Crie uma nova tag e seleccione Twitter Tag. Adicione a chave API do Stape Container. Para o fazer, abra as configurações do container sGTM e copie a Container API Key.

5. Adicionar a Consumer Key, Consumer Secret, OAuth Token, OAuth Token Secret. Descrevi aqui como gerar estes valores. 

6. Adicionar ID de pixel do Twitter e ID de evento. Pode encontrar estes valores no Twitter Events Manager.

7. Adicionar Server Event Override e Dados de Usuário que deseja enviar para o Twitter. E configurar um ativador. 

8. Infelizmente, não há forma de testar o CAPI do Twitter em tempo real. Após a configuração, utilize o gestor de eventos do Twitter para ver se foram enviados eventos CAPI do Twitter.

Conclusão:Copiar link para esta secção

O Twitter CAPI pode ser um grande aditamento à sua lista de rastreamento do lado do servidor. Embora o processo de autorização para o Twitter CAPI seja incrivelmente complicado por agora, outras lógicas funcionam de forma muito semelhante a outras APIs de conversão: pode enviar eventos personalizados ou standard e utilizar apenas o rastreio do servidor ou servidor web+servidor. Para combinar os usuários, o Twitter pede para enviar dados do usuário, mas por enquanto, eles suportam apenas e-mail do usuário e twclid. 

Há duas desvantagens principais do CAPI do Twitter: processo de autenticação e nenhuma ferramenta de teste em tempo real. Devido ao processo de verificação, a tag Twitter só funciona com servidores stape para sGTM. Se o Twitter simplificar o processo de autenticação, a equipa de stape irá atualizar a tag para trabalhar com o GCP. 

Espero que este guia o ajude a familiarizar-se mais com o Twitter CAPI e como configurar o Twitter CAPI no sGTM. Para informações mais detalhadas sobre o Twitter CAPI, consulte a documentação oficial. Se precisar de ajuda para configurar o Twitter CAPI, contacte-nos!