Tag API de conversão do Twitter para sGTM

O Twitter Conversion API permite que você envie informações do seu servidor diretamente para os servidores do Twitter, o que pode ser utilizado para medir o sucesso das campanhas.

Com o Twitter CAPI, você torna o rastreamento mais seguro e preciso. Assim como o Facebook, o Twitter permite e recomenda o uso de um método híbrido de rastreamento, web + servidor. Ao combinar rastreamento na web e servidor, a deduplicação é necessária. Para associar eventos de usuários aos perfis do Twitter, são utilizados dados do cliente: email e twclid.

Este guia discutirá como o Twitter Conversion API funciona e como configurar a tag do Twitter CAPI no sGTM.

Para identificar seu Twitter CAPI, você precisa de mais do que um pixel ID do Twitter ou um token de API. O Twitter requer autenticação adicional, que não é possível implementar via sGTM. Por isso, por enquanto, a tag do Twitter CAPI funciona apenas com o Stape. Fique à vontade para modificar o modelo da tag e implementar a autenticação você mesmo, se necessário.

O novo Twitter CAPI ainda não está totalmente otimizado e exigirá cinco vezes mais trabalho do que a implementação “padrão” de CAPI, caso você já esteja familiarizado com as APIs do FB ou TikTok. Além disso, existem outras complicações ao usar essa plataforma que dificultam o processo.

Será necessário ter uma conta de desenvolvedor, solicitar acesso ao Twitter CAPI e gerar vários tokens de acesso. Vamos detalhar todas essas etapas em um post no blog posteriormente.

Para acessar a API de anúncios, entre em contato com um representante do Twitter.

Aplicações Ads API Existentes

Se você já possui uma aplicação Ads API ativa, poderá usá-la e seus tokens de acesso para o Conversion API.

Tokens de Acesso

• Personal Tokens: Gere esses tokens para sua conta do Twitter no portal do desenvolvedor.
• Other Users' Tokens: Use um fluxo de OAuth em três etapas:

- Linha de comando com autorização web (twurl)

- Linha de comando com autorização baseada em PIN

- Fluxo web personalizado

Os tokens para o Conversion API devem ser de usuários com acesso AD_MANAGER ou ACCOUNT_ADMIN, o que você pode verificar via o endpoint authenticated_user_access.

Nota: Você pode compartilhar tokens com usuários sem acesso AD_MANAGER ou ACCOUNT_ADMIN.

A autenticação do Twitter Conversion API é um processo complexo; por enquanto, a autenticação do Twitter CAPI não pode ser totalmente funcional no sGTM. Por isso, lidamos com a autenticação internamente. Isso significa que a tag do Twitter CAPI requer hospedagem do Stape. Se pudermos usar apenas o sGTM para autenticação, atualizaremos essa tag para oferecer suporte a qualquer hospedagem. Você pode encontrar a chave da API do container sGTM nas configurações do container.

Essas duas chaves só podem ser geradas se você tiver uma conta de desenvolvedor do Twitter. Para receber uma conta de desenvolvedor do Twitter, você deve solicitar uma e aguardar de 1 a 3 dias para a aprovação da sua inscrição.

Ao se inscrever, é necessário solicitar o Acesso Essencial. Certifique-se de usar a conta do Twitter correta para se inscrever, pois não é possível mudar de conta depois.

Crie um app usando a seção Project and App ao receber uma conta de desenvolvedor. Uma Consumer Key e um Consumer Secret serão gerados.

Você pode encontrar esses dois tokens em seu anúncio na conta de desenvolvedor do Twitter.

1. Crie e configure um container do Google Tag Manager no servidor.

Importante: A tag do Twitter CAPI funciona apenas se você usar o Stape para hospedar containers sGTM.

2. Envie dados da web para o GTM do servidor. Pode configurar o GA4 do lado do servidor, Webhooks ou Data Tag/Data Client.

3. Baixe a tag do Twitter Conversion API na Template Gallery.

4. Crie uma nova tag e selecione Twitter Tag. Para adicionar a Chave da API do Container Stape, abra as configurações do container sGTM e copie a Chave da API do Container.

5. Adicione a Consumer Key, Consumer Secret, OAuth Token, e OAuth Token Secret. Eu descrevi como gerar esses valores aqui.

6. Adicione o Twitter Pixel ID e o Event ID. Você pode encontrar esses valores no Tweeter Events Manager.

7. Adicione os dados de Server Event Data Override e User Data que você deseja enviar para o Twitter, e configure um gatilho.

Parâmetros da tag do Twitter CAPI:

Stape Container API Key - encontre-a nas configurações do container sGTM na sua conta Stape.

Consumer Key, Consumer Secret, OAuth Token, OAuth Token Secret - você pode encontrá-los na sua conta de desenvolvedor do Twitter após a criação de um app do Twitter.

Pixel ID - este é o Universal Website Tag (UWT) ID da sua conta de anúncios do Twitter. Para encontrá-lo, vá para o Twitter Events Manager.

Event ID - ao criar um evento de API de conversão no Twitter Events Manager, você o encontrará.

Use HttpOnly cookies - proíbe o JavaScript de acessar o cookie, se ativado.

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

User Data - adicione dados do usuário: email ou twclid.

Logs Settings - selecione se deseja usar os logs do Stape.

9. Testando eventos. Quando seu evento tiver recebido eventos de conversão com sucesso dentro de 12 a 24 horas, o status do ‘Single event web tag’ deverá mostrar RASTREAMENTO na página de Rastreamento de Conversões do Ads Manager. Isso não afetará campanhas em andamento que enviem conversões via Conversion API.

O Twitter oferece suporte para deduplicação de eventos. A combinação de rastreamento web e servidor exige o envio de uma chave de deduplicação com os eventos web e do servidor. Use o conversion_id para enviar a chave de deduplicação. A deduplicação ocorre apenas se os eventos forem recebidos dentro de 48 horas.

Para criar um evento apenas no servidor, use o Twitter Events Manager para criar um novo evento e selecione Instalar com API de Conversão na terceira etapa.

Diferente de outras plataformas, o Twitter aceita apenas email de usuário e twclid. Quando você envia um email, ele deve estar criptografado com SHA256. A tag do Twitter criptografa automaticamente o email do usuário.

Infelizmente, não há como testar eventos de servidor do Twitter em tempo real. Se o rastreamento estiver configurado corretamente, você verá o status do ‘Single event web tag’ mostrando rastreamento na página de Rastreamento de Conversão no Ads Manager dentro de 12 a 24 horas.

O Twitter CAPI pode ser uma excelente adição à sua pilha de rastreamento no servidor. Embora o processo de autorização do Twitter CAPI seja incrivelmente complexo por enquanto, a lógica funciona de forma muito semelhante aos APIs de conversão do FB ou TikTok: você pode enviar eventos personalizados ou padrão e usar rastreamento web + servidor ou apenas servidor. O Twitter solicita dados do usuário para associar usuários, mas, por enquanto, eles suportam apenas email de usuário e twclid.

O Twitter CAPI tem duas principais desvantagens: o processo de autenticação e a falta de uma ferramenta de teste em tempo real. Por conta do processo de verificação, a tag do Twitter funciona apenas com servidores Stape para sGTM. Se o Twitter simplificar o processo de autenticação, a equipe do Stape atualizará a tag para funcionar com GCP.

Este guia ajudará você a se familiarizar com o Twitter CAPI e a configurá-lo no sGTM. Para informações mais detalhadas sobre o Twitter CAPI, consulte a documentação oficial.