Rastreamento de conversões em websites

 

Visão Geral

Com o rastreamento de conversão, você pode avaliar seu retorno sobre investimento em publicidade rastreando as ações que as pessoas realizam depois de visualizar seus anúncios no X ou interagir com eles. Seus eventos de conversão permitirão que você gere relatórios sobre o desempenho de suas campanhas, mas também podem ser usados para ajudar ainda mais a otimizar e segmentar seus anúncios.

Novo! Implementamos uma série de melhorias em todos os produtos de Rastreamento de Conversão, feitos para ajudar a expandir nossas soluções existentes, melhorar a configuração e aumentar a flexibilidade de mensuração. Isso inclui:

  • O novo X Pixel

  • API de Conversão 

  • Nova página de configuração de rastreamento de conversão

  • Expansão do recurso Click ID, para a parte inferior do funil de vendas

  • Novos tipos de eventos e parâmetros

  • Melhor definição dos tipos de evento Tráfego para o Website

  • Nova lógica de desduplicação

  • Renovação do Pixel Helper

  • Atualização dos modelos do Gerenciador de Tags

Essas atualizações não devem afetar a mensuração existente nem o desempenho da campanha. No entanto, recomendamos atualizar ou implementar as soluções relevantes. Por exemplo, se anteriormente você tiver implementado uma X Universal Web Tag (UWT) ou uma Single Event Tag (SET), recomendamos fazer atualização para o novo X Pixel.

 

Soluções de rastreamento de conversão

Há duas soluções disponíveis:

  • O novo X Pixel, que é uma website tag implementada no seu website para rastrear ações ou conversões dele.  

  • A API de Conversões, que é uma integração direta, de servidor a servidor, que permite compartilhar dados sem necessidade de implementação de um código de website. 

As duas soluções atingem o mesmo objetivo e têm basicamente a mesma funcionalidade: habilitar o acompanhamento de conversões para suas campanhas na web. É fundamental implementar ou fazer upgrade de pelo menos uma dessas opções para abrir espaço para todas as possibilidades das campanhas online. 

Como escolher a solução certa:

  • Para a maioria dos anunciantes, recomendamos usar o X Pixel. Se você estiver dando seus primeiro passos, o X Pixel pode ser a solução mais simples para configurar. 

  • Se você tiver considerações importantes em relação ao seu site (por exemplo: não conseguir implementar  JavaScript nele), a API de Conversões pode ser a melhor opção. 

Observação: se você já implementou um X Universal Web Tag ou uma Single Event Tag, elas foram migradas para  continuar funcionando junto com o novo X Pixel. Saiba mais abaixo.

Depois de configurar o rastreamento de conversão, você também poderá rastrear conversões em vários dispositivos. Isso significa que, se alguém tiver visto seu Anúncio Promovido em um dispositivo mobile, mas converter no laptop, a conversão será atribuída com precisão à sua campanha.

O novo X Pixel

O novo X Pixel é uma website tag implementada no seu website para rastrear ações ou conversões do website. 

Este novo produto combina nossas já existentes web tags – a Universal Web Tags (UWT) e a Single Event Tags (SET) – em uma solução única e fácil de usar. Junto com esta versão, nós também introduzimos o recurso de funcionalidade de evento baseada em código (vs. eventos definidos por regras de URL).

O novo X Pixel é feito de duas partes:

  • Código-base – semelhante à Universal Web Tag, deve ser implementado em todas as páginas do seu website. Quaisquer Universal Web Tags previamente integradas podem funcionar como código-base do novo X Pixel. O código-base rastreia visitas a um website e inicializa o pixel para que você possa rastrear eventos adicionais via código do evento ou criar audiências usando o Gerenciador de Audiências.

  • Código do evento – exige que o código-base esteja implementado. Semelhante às Single Event Tags, o código do evento deve ser implementado em locais-chave (como um botão “Adicionar ao carrinho”). Quaisquer Single Event Tags previamente integradas sofreram transição para funcionar como código de evento do novo X Pixel. O código do evento permite rastrear ações individuais no seu website, como Compras.

Você tem duas opções para implementar o X Pixel: via integração direta ou via um Gerenciador de Tags externo compatível. Saiba mais abaixo

(i) Já tinha implementado a Universal Web Tag e/ou a Single Event Tag? Com a transição que mencionamos acima, toda mensuração implementada deve continuar a funcionar como antes. No entanto, ainda recomendamos com ênfase atualizar sua implementação para acessar o novo recurso agora e no futuro.

Para atualizar a implementação existente ao implementar diretamente o código, siga as instruções nesta página e cole sobre qualquer código previamente implementado o novo código-base e/ou códigos de evento. Se estiver usando um Gerenciador de Tags, substitua a configuração anterior pelos modelos atualizados do X.

API de Conversão

A API de Conversão (CAPI) é uma solução de mensuração que permite uma conexão direta, de servidor a servidor, para compartilhar dados de conversão com o X para permitir a mensuração das campanhas na plataforma. 

A API de Conversão aumenta as opções de mensuração e proporciona controle sobre quais dados são compartilhados. Trata-se de uma solução complementar de mensuração para o novo X Website Pixel, que pode ser usada com ou sem o Pixel.

Podem ser usados vários sinais de dados com a API de Conversão (CAPI), inclusive X Click ID ou endereços de e-mail para enviar os eventos de conversão ao ponto de extremidade da API.

Observação: O uso da API de Conversão também permite o rastreamento de eventos de conversão offline. Os eventos de conversão muitas vezes podem começar online, mas terminar offline. O uso de uma solução offline da API de Conversão significa que você também pode mensurar essas conversões, além de suas conversões online. 

Implementação: Configurar a API de Conversão exige acesso à API do X Ads e a uma Conta do Desenvolvedor ativa. Mais detalhes e um guia passo a passo podem ser encontrados na página de configuração da documentação da API de Conversão.

 

Configuração do X Pixel

A configuração do X Pixel exige:

  1. Geração do Pixel em si

  2. Criação dos eventos a serem rastreados

  3. Implementação do código-base em todo o seu website

  4. Implementação do código do evento em locais-chave do seu website (exemplo: botão de "adicionar ao carrinho")

Geração do Pixel e criação de eventos

1. Entre na sua conta de anúncios em ads.X.com

2. Em “Ferramentas”, selecione “Gerenciador de Eventos”.

  • Você não consegue ver a aba Ferramentas na sua conta? Isso provavelmente acontece porque você ainda não adicionou nenhum cartão de crédito à sua conta. Descubra como adicionar um aqui.

3. Se você tiver criado um Pixel antes, poderá ver o X Pixel na lista da coluna à esquerda, e poderá pular para a etapa 6

  • Se você nunca tiver criado um Pixel no X antes, será preciso adicionar uma fonte de evento. No “Gerenciador de Eventos”, clique em “Adicionar origem do evento”. 

4. Esta opção também pode ser acessada pela aba Configurações, caso você já tenha previamente criado um Pixel

  • Você agora está na página “Instalar código do pixel”. Aqui, você terá a opção de desmarcar “Permitir cookies próprios”, caso queira. 

(i) A caixa “Permitir cookies próprios” permite que o recurso Click ID use cookies próprios nos websites. Mais especificamente, permite a mensuração de eventos de conversão além das visitas à página de destino. O cookie próprio armazenará o parâmetro Click ID anexado ao URL da página de destino para mensurar os eventos de conversão que acontecem no seu website.

Essa opção precisa acessar toda a funcionalidade das futuras soluções de Otimização da Conversão e Anúncios de Produtos Dinâmicos, pois os dados seriam usados para otimização da campanha. Leia mais sobre o Click ID aqui e sobre como usamos cookies aqui.

Observe que, por padrão, essa opção fica ativada. Ela pode ser desativada ao desmarcar a opção “Permitir cookies próprios”.

5. Clique no botão “Salvar fonte do evento” para salvar seu novo Pixel. Você será levado à tela principal de “Gerenciador de Eventos”.

  • Observação: Se você tiver previamente configurado eventos usando a Universal Website Tag ou a Single Event Tags, eles serão exibidos como eventos aqui. Ainda recomendamos fazer upgrade do código do pixel e habilitar parâmetros do evento, quando relevante. 

6. A seguir, você precisará criar eventos para rastrear ações no website. Quais ações a serem rastreadas podem variar, dependendo dos objetivos. Por exemplo: uma empresa de comércio eletrônico pode querer implementar eventos “Adicionar ao carrinho” e “Compra”, enquanto uma concessionária de automóveis pode querer implementar “Lead”.

  • Leia mais sobre os eventos de conversão e parâmetros disponíveis aqui.
  • Observação: Se você tiver criado previamente uma Single Event Tag, elas ainda serão exibidas no “Gerenciador de Eventos”. Para reutilizá-las e atualizar o código, pule para a seção “Implementação do código do evento”. Se você quiser criar novos eventos para substituir quaisquer Single Event Tags feitas previamente, continue com as etapas a seguir.

7. Clique no botão “Adicionar eventos”.

Nota: Os anunciantes que estiverem criando eventos do X Pixel para Anúncios de Produtos Dinâmicos precisam adicionar os seguintes eventos de conversão:

  • Visualização da página
  • Visualização do conteúdo
  • Adicionar ao carrinho
  • Comprar

8. Na tela “Detalhes do evento”, insira um nome para o evento. No menu suspenso “Tipo”, selecione o tipo de ação que você deseja rastrear. Clique em “Avançar”

9. Na tela “Método de configuração”, você poderá escolher como deseja definir seu evento. Recomendamos definir seu evento com o código, pois isso lhe dará mais flexibilidade. Por exemplo: ele permite o envio de informações-chave de volta por meio de parâmetros do evento. Selecione “Definir evento com código” e clique em “Avançar”.

10. Na tela “Instalação do evento”, veja três abas no topo, que permitem acessar as instruções da abordagem de instalação preferida. Mais detalhes sobre a instalação do Gerenciador de Tags são fornecidas aqui, e mais detalhes sobre a API de Conversão podem ser encontradas aqui. 

Ao escolher instalar o código do pixel no código do seu website, você poderá usar as caixas de seleção para criar um modelo do pixel do seu código de evento. Selecione os parâmetros de evento que você deseja usar e o código de pixel do modelo mudará dinamicamente abaixo. Clique em “Salvar” para salvar o evento recém-criado.

Observação: As caixas de seleção do parâmetro só servem para criar um modelo do código de evento. Marcar as caixas não fará automaticamente a mensuração dos parâmetros desse evento. O código precisará ser atualizado para passar dinamicamente valores para os parâmetros. São fornecidos mais detalhes de implementação a seguir.

11. Repita as etapas 7 a 10 para criar eventos a todas as ações relevantes que você deseja rastrear.

  • Em quase todos os casos, um tipo de conversão específico (como Compra ou Download) deve ser usado somente uma vez em seu website. Criar vários eventos de conversão do mesmo tipo causa bifurcação do sinal e acarreta uma configuração de otimização ineficiente.
  • Os anunciantes que definirem a implementação do código do evento para as campanhas dos Anúncios de Produtos Dinâmicos precisam selecionar os parâmetros a seguir 
    • Conteúdo (escolha esta opção para todos os eventos)
    • Valor (escolha para o evento de Compra, pois denota o valor de compra)
    • Moeda (escolha para o evento de Compra, pois denota a moeda de compra)
    • E-mail (escolha esta opção para todos os eventos)

Depois de fazer o que foi descrito acima, você precisará implementar o código-base do Pixel recém-criado e o código do evento para começar a rastrear ações. 

Como implementar o X Pixel

Você pode optar por implementar o código do evento e o código-base do X Pixel das seguintes formas:

  • Direta: ao fazer download e integrar o código fornecido no website.

  • Gerenciador de Tags: aproveitando um gerenciador de tags de terceiros já aprovado.  

Esta seção apresenta a implementação direta. Se você planeja integrar seu código-base e/ou código via Gerenciador de Tags, confira a seção Gerenciador de Tags aqui.

Implementação do código-base

1. No “Gerenciador de Eventos”, próximo ao topo da página, clique em “Exibir código-base” do pixel que você deseja implementar.

2. Na página “Instalar código do pixel, verifique se a aba “Instalar com o código do Pixel” está selecionada.

3. A partir daqui, copie ou faça download do código do Pixel no campo “Código do Pixel”. 

  • Para fazer download, clique em “Fazer Download do código do pixel”, abaixo do campo.

4. Cole esse código antes da tag HTML de todas as páginas no seu website. 

  • A implementação em todo o website é fundamental para rastrear corretamente todas as ações nele.
  • Observação: Se você tiver previamente implementado uma Universal Web Tag e quiser fazer upgrade da sua implementação, cole sobre o código previamente implementado em todo o website o novo código que copiou ou baixou.

Depois de implementar o código-base, criaremos automaticamente um evento de “Visita ao website” ou “Visualização da página de destino”, que mensuram uma visita a um website ou uma visualização da página de destino, respectivamente. Eles podem ser encontrados em “Gerenciador de Eventos”. Leia mais sobre esses eventos e atualizações nos eventos de Tráfego para o Website, aqui.

 

Implementação do código do evento

1. No “Gerenciador de Eventos”, encontre o evento que você deseja implementar.

2. Clique nos três (3) pontos ao lado do nome do evento e selecione “Editar evento”.

3. Clique em “Avançar” duas vezes para ir à página “Instalação do evento”. 

4. Clique em “Baixar trecho de código” sob o campo “Código”. 

5. Adicione esse código a elementos específicos do seu website (como à página de agradecimento ou ao botão “Download”).

  • Se você estiver usando parâmetros do evento, atualize os valores padrão ao instalar o código no seu website. 
  • Observação: Se você tiver previamente implementado uma Single Event Tag e quiser fazer upgrade da sua implementação, cole o código implementado anteriormente com os novos códigos de evento que você copiou ou baixou.

6. Repita as etapas 1-5 para cada evento que deseja rastrear.

Como implementar o código do pixel de múltiplas contas na mesma página

Se você estiver usando mais de uma conta de anúncios para marketing no seu website, pode acabar precisando adicionar vários códigos-base e códigos de eventos à mesma página. Por exemplo: você tem duas contas, como pixel_id1 e pixel_id2, respectivamente, e quer rastrear um evento para cada conta em uma página com um ID de evento tw-pixel_id1-event_id1 e tw-pixel_id2-event_id2, respectivamente.

Você pode agrupar o código do pixel da seguinte forma:

      <!-- Twitter conversion tracking base and event code -->
<script>
!function(e,t,n,s,u,a){e.twq||(s=e.twq=function(){s.exe?s.exe.apply(s,arguments):s.queue.push(arguments);
},s.version='1.1',s.queue=[],u=t.createElement(n),u.async=!0,u.src='https://static.ads-twitter.com/uwt.js',
a=t.getElementsByTagName(n)[0],a.parentNode.insertBefore(u,a))}(window,document,'script');

twq('config','pixel_id1');
twq('config','pixel_id2');

twq('event', 'event_id1');  // tw-o6ou1-o9l96
twq('event', 'event_id2');  //  tw-o6ou1-o7uw7

</script>
<!-- End Twitter conversion tracking base and event code →
    

Como usar eventos em campanhas

Depois de o evento de conversão ser criado, você poderá selecioná-lo no formulário da campanha.

Para fazer isso:

a. Selecione “Criar campanha” na sua conta do X Ads

b. Depois de preencher os detalhes da campanha, você precisará preencher os detalhes do grupo de anúncios.

c. Ao preencher os detalhes do grupo de anúncios, selecione “Conversões em website” em “Preferência de otimização”. Isso criará um novo campo, “Métrica principal de conversão”, onde você poderá selecionar o evento de conversão.

Para obter mais ajuda com o formulário da campanha, confira estas instruções detalhadas para criar uma campanha de Tráfego para o Website.

 

Novos tipos de eventos e parâmetros

Os eventos de conversão ajudam a rastrear as ações importantes a você e aos seus negócios. Com cada evento, você pode selecionar o tipo que deseja rastrear e escolher fazer o passback de certos parâmetros para compartilhar mais sobre a ação.

Você pode escolher entre uma série de opções disponíveis ao configurar um evento de conversão. Clique nos menus suspensos a seguir para ver os eventos e parâmetros disponíveis:

Tipos de evento

Parâmetros

Tipos de evento

Visualização de página (antes chamado de Visita ao website), Compra, Download, Personalizado, Lead*, Adição ao ao carrinho, Finalização de compra iniciada, Visualização de conteúdo, Informações de pagamento adicionadas, Busca, Assinatura, Início de período de demonstração, Adição à lista de desejos e Customização do produto.

Parâmetros

Conteúdo, ID de conversão, Endereço de e-mail, Valor, Moeda

*O evento "Inscrever-se" agora passou a se chamar “Lead”. Lead pode ser qualquer envio de dados realizado por um cliente, como inscrições, reservas, preenchimento de formulários etc.

Tipos de Evento

É importante definir o evento correto. Isso ajuda a sinalizar ao X que tipo de ação você está mensurando e pode informar o tipo de otimização que nosso sistema usa ao veicular anúncios. 

Por conta disso, os eventos são a espinha dorsal dos produtos na parte inferior do funil de vendas. Se você estiver interessado em usar produtos futuros voltados para parte inferior do funil de compras, como Otimização da Conversão e/ou Anúncios de Produtos Dinâmicos, é importante configurar eventos, com parâmetros, em locais-chave do seu website.

Em quase todos os casos, um tipo de conversão específico (como Compra ou Download) deve ser usado somente uma vez em seu website.

 

Atualizações de eventos de Tráfego para o Website

Novo! A partir de agosto de 2022, todos os tipos de evento “Visita ao website” passarão a ser chamados de “Visualização de página”.

Assim como antes, você pode personalizar os tipos de evento de “Visualização de página” conforme as regras definidas. Além disso, quando o código-base do X Pixel estiver instalado, criaremos automaticamente os novos eventos “Visita ao website” e “Visualização da página de destino”, definidos pelo X, que mensuram a visita a um website ou uma visualização da página de destino do anúncio, respectivamente. 

Confira as perguntas frequentes para obter mais orientações sobre que tipo de evento usar em uma campanha. 

Antigo

Novo

Definição

Antigo

Tipo de evento de visita ao website

Novo

Tipo de evento de visualização da página

Definição

Tipo de evento de visualização da página definido pelo anunciante. A definição desse evento varia conforme as regras definidas pelo anunciante. Exemplo: contar uma visualização da página quando o usuário acessar a página que contém “adotar-um-pet/saiba-mais”


Todos os eventos existentes do tipo “visita ao website” serão renomeados para o tipo “visualização da página”. Nenhuma outra alteração aos eventos em si. 

Antigo

Novo

Visita ao website

Definição

Evento criado automaticamente e definido pelo X que mensura uma visita ao website do anunciante (independentemente da página de destino do anúncio) após visualização ou clique no anúncio. 

Antigo

Novo

Visualização da página de destino

Definição

Evento criado automaticamente e definido pelo X que mensura uma visualização da página de destino do anúncio após criar em um anúncio. 

(i) Como isso afeta a Otimização das Visitas ao Website? O modelo de otimização continuará o mesmo, mas há algumas considerações de relatos a manter em mente. 

  • Otimização: não há impacto algum sobre a otimização da campanha atual como consequência das atualizações dos eventos acima. 

  • Renomeação de “Visita ao website” para “Visualização de página”: as campanhas atuais ainda estarão otimizando pelos mesmos eventos que antes desta mudança, mas os eventos vinculados a elas serão exibidos como “Visualização de página”.

  • Relatórios: você pode perceber uma diferença no volume relacionada a recentes atualizações na lógica de desduplicação. É possível também que haja a necessidade de usar a nova métrica “Visualizações de página” ao analisar o relatório.

  • Novos eventos para otimização: agora você pode usar os novos eventos “Visitas ao website” e “Visualização da página de destino”, criados automaticamente, além dos eventos de “Visualização de página”, ao usar “Otimização da visita ao website”.

Regras de desduplicação

Em agosto de 2022, nós também atualizamos as regras de desduplicação. Fizemos essas alterações para alinhar melhor nossa lógica com o padrão que existe e ajudar a dar mais insights sobre o impacto total das campanhas da web.

Tipo de evento

Lógica de desduplicação antiga

Lógica de desduplicação nova*

Tipo de evento

Visualização de página

(incluindo visita ao website e visualização da página de destino, definidos pelo X)

Lógica de desduplicação antiga

1 hora

Lógica de desduplicação nova*

30 minutos

Tipo de evento

Outros tipos de evento

(Compra, Lead etc.)

Lógica de desduplicação antiga

1 hora

Lógica de desduplicação nova*

Não há mais desduplicação. Leia mais sobre esta alteração nas perguntas frequentes

Nós também lançamos um parâmetro de chave de desduplicação junto com essas atualizações. 

Isso pode ser usado para gerenciar a desduplicação de eventos, conforme desejado. Para isso, use o parâmetro de evento “conversion_id”. Esse parâmetro pode ser incluído nas solicitações do Pixel ou da API de Conversão. Por exemplo, para um evento de Compra, o código de evento pode ser assim:

Chave de desduplicação

      twq('event', 'tw-pixel_id1-event_id1', {
    value: 200.00,
    currency: 'USD',
    conversion_id: ‘1234abcd’,
    contents: 
    [
       {content_id: 'OT001', content_name: ‘bird seed’, content_price: 50, num_items: 1},
       {content_id: 'OT002', content_name: ‘bird cage, content_price: 150, num_items: 1}
    ]
  });

</script>
    

Parâmetros do evento

Os parâmetros do evento dão detalhes sobre a ação de conversão (p. ex., o que era o produto. Certos parâmetros também podem ser usados para melhorar a mensuração. 

Parâmetros, junto com os eventos certos, podem até ser usados para entender o retorno sobre investimento das campanhas de Website, incluindo a receita total (ou o valor total das conversões) gerada pela sua campanha e o número total de itens adquiridos.

Para registrar o quanto uma pessoa está gastando ou o valor que está comprando, é preciso instalar o evento em si (como Compra) e passar os valores aos parâmetros de evento do seu código de evento.

Esta tabela apresenta uma visão geral de todos os parâmetros disponíveis que você pode usar para seus eventos. Observação: Os parâmetros deste evento só podem ser usados para eventos definidos com código, não para eventos usando regras de URL. 

Parâmetro do evento

Descrição

Tipo de dados

Parâmetro do evento

valor

Descrição

Valor total do evento de conversão (ex: valor monetário da transação em caso de compra, valor LTV de um lead, etc.)

Tipo de dados

Íntegro ou flutuante

Parâmetro do evento

moeda

Descrição

Código ISO 4217 (p. ex., USD, JPY, EUR)

Tipo de dados

String

Parâmetro do evento

id_conversão

Descrição

Identificador exclusivo para o evento, que pode ser usado para fins de desduplicação

Tipo de dados

String

Parâmetro do evento

busca_de_string

Descrição

O texto que foi pesquisado no seu website

Tipo de dados

String

Parâmetro do evento

descrição

Descrição

Uma descrição de string para informações adicionais

Tipo de dados

String

Parâmetro do evento

twclid

Descrição

X Click ID que pode ser incluído em qualquer solicitação.

O X Pixel já passa automaticamente em twclid do URL ou do cookie próprio. Esse parâmetro pode ser usado também para forçar a atribuição a um certo clique no anúncio.

Tipo de dados

String

Parâmetro do evento

Status

Descrição

O status da inscrição ou assinatura, que pode ser “iniciado” ou “concluído”

Tipo de dados

String

Parâmetro do evento

conteúdos

Descrição

Disposição de objetos JSON representando vários produtos/conteúdos

Veja a seguir os subparâmetros que podem ser incluídos nessa disposição.

Tipo de dados

Disposição de objetos

Subparâmetros

Parâmetro do evento

Descrição

Tipo de dados

Parâmetro do evento

tipo_de_conteúdo

Descrição

Categoria do produto comprado (Taxonomia de produtos do Google)

Tipo de dados

String

Parâmetro do evento

ID_do_conteúdo

Descrição

Para usuários do catálogo de produtos: passe o SKU


Para todos os outros usuários: Passe o Global Trade Item Number (GTIN), se disponível; caso contrário, passe SKU

Tipo de dados

String

Parâmetro do evento

nome_do_conteúdo

Descrição

Nome de um produto ou serviço

Tipo de dados

String

Parâmetro do evento

preço_do_conteúdo

Descrição

Preço de um produto ou serviço

Tipo de dados

Íntegro ou flutuante

Parâmetro do evento

Número_de_ítens

Descrição

Número de produtos comprados

Tipo de dados

Número inteiro

Parâmetro do evento

ID_do_grupo_de_conteúdo

Descrição

ID associado a um grupo de variantes de produto

Tipo de dados

String

Um exemplo de trecho de código para um evento de Compra pode ser assim:

      <!-- Twitter conversion tracking base and event code -->
<script>
!function(e,t,n,s,u,a){e.twq||(s=e.twq=function(){s.exe?s.exe.apply(s,arguments):s.queue.push(arguments);
},s.version='1.1',s.queue=[],u=t.createElement(n),u.async=!0,u.src='https://static.ads-twitter.com/uwt.js',
a=t.getElementsByTagName(n)[0],a.parentNode.insertBefore(u,a))}(window,document,'script');

twq('config',pixel_id1');

twq('event', 'tw-pixel_id1-event_id1', {
    value: 200.00,
    currency: 'USD',
    contents: 
    [
       {content_id: 'OT001', content_name: ‘bird seed’, content_price: ‘50’, num_items: ‘1’},
       {content_id: 'OT002', content_name: ‘bird cage, content_price: ‘150’, num_items: ‘1’}
    ]
  });

</script>
<!-- End Twitter conversion tracking base and event code →
    

Parâmetros do usuário

Nós também damos suporte a parâmetros de usuário, que permitem passar dados com hash adicionais para melhorar a cobertura da mensuração. Atualmente, oferecemos a possibilidade de fazer o passback de endereços de e-mail e números de telefone via Pixel do X ou API de Conversões.

  • Observação: O Pixel do X aplica automaticamente hash nesses parâmetros usando o hash SHA256 padrão. Nenhum dado sem hash é compartilhado com o X.
  • Observação: inclua o número de telefone no seguinte formato: código do país (exemplo: +1, +32, etc.) seguido do número de telefone. Por exemplo, para um telefone dos EUA: +11234567890

Um exemplo de trecho de código para um evento de Compra com dados do usuário pode ser assim:

      <!-- Twitter conversion tracking base and event code -->
<script>
!function(e,t,n,s,u,a){e.twq||(s=e.twq=function(){s.exe?s.exe.apply(s,arguments):s.queue.push(arguments);
},s.version='1.1',s.queue=[],u=t.createElement(n),u.async=!0,u.src='https://static.ads-twitter.com/uwt.js',
a=t.getElementsByTagName(n)[0],a.parentNode.insertBefore(u,a))}(window,document,'script');

twq('config',pixel_id1');

twq('event', 'tw-pixel_id1-event_id1', {
    email_address: 'test_email@twitter.com',
    phone_number: '+11234567890',

    value: 200.00,
    currency: 'USD',
    contents: 
    [
       {content_id: 'OT001', content_name: ‘bird seed’, content_price: ‘50’, num_items: ‘1’},
       {content_id: 'OT002', content_name: ‘bird cage, content_price: ‘150’, num_items: ‘1’}
    ]
  });

</script>
<!-- End Twitter conversion tracking base and event code →
    
 

Estatísticas

Depois que você configurar o X Pixel, os relatórios de acompanhamento de conversões do site estarão disponíveis na guia "Campanhas".

Você verá o número de conversões geradas no nível da campanha ou do post, além de métricas relacionadas, como impressões, engajamentos, gastos e CPA.

Você pode ver os resultados de seus eventos de conversão selecionando "Personalizar Métricas". 

Depois, vá até a seção Conversões das métricas personalizáveis e selecione os tipos de evento de conversão que você deseja visualizar. 

Essas estatísticas também estão disponíveis por meio de um arquivo .csv para download em Exportar dados, no Gerenciador de Anúncios. 

O painel de campanhas mostra as conversões por tipo. Por exemplo, se você tem interesse em rastrear dois tipos diferentes de compras, convém configurar um com a tag “compra” e o outro com a tag “personalizado” para obter relatórios separados sobre os dois.

Caso contrário, o arquivo .csv para download é uma opção para detalhar as conversões por nome do evento de conversão. As conversões pós-visualização e pós-engajamento também são detalhadas separadamente. Para fazer isso, selecione Conversões do website por tag ao exportar suas métricas.

Janelas de atribuição

Janelas de atribuição pós-engajamento: Selecione o período para atribuir ao X as conversões ocorridas depois que uma pessoa interagir com seus anúncios. Alguns exemplos de engajamento são curtidas, reposts, seguidores, respostas ou cliques no URL. 

As opções para janelas de atribuição pós-engajamento são de 1, 2, 3, 5, 7, 14 e 30 dias. Se você não souber ao certo qual janela selecionar, recomendamos a configuração padrão de 30 dias. Se você alterar essa configuração, os dados de conversão serão atualizados retroativamente; portanto, você poderá voltar depois e experimentar outras janelas de atribuição.

Janela de atribuição pós-visualização: “Pós-visualização” refere-se a quando uma pessoa no X vê seu Anúncio Promovido e não interage com ele, mas posteriormente visita seu website e realiza uma conversão. As pessoas no X costumam ver, ler e visualizar mídia nos seus Anúncios Promovidos sem clicar neles. Por isso, incluir a atribuição pós-visualização permite ter uma ideia das conversões que você recebeu, para as quais não houve, no entanto, uma cobrança pelo engajamento.

As opções para janelas de atribuição pós-visualização são Desativado, 1, 2, 3, 5, 7, 14 e 30 dias. Se você não souber ao certo qual configuração escolher, recomendamos o padrão de “1 dia” após a visualização.

 

Audiências Customizadas

Na website tag, as Audiências do X Pixel permitem que você alcance os usuários do X que recentemente expressaram interesse em seus produtos visitando seu website. As Audiências de atividade do website usam o mesmo Pixel do X para rastreamento de conversões desta página. Saiba mais sobre Audiências de Atividade do website.

 

Solução de problemas

 

Parâmetro de Uso de Dados Restritos

O parâmetro Uso de Dados Restritos (RDU) permite que um anunciante limite o uso pelo X de certos dados a somente fins específicos em nome desse anunciante.

Os anunciantes devem decidir por si próprios quando e como usar o RDU – por exemplo, um anunciante pode querer aplicar o parâmetro RDU por usuário, com base no sinal de opt-out ou mais amplamente com base no local do usuário em regiões onde certas leis se aplicam.

Para aprender mais sobre como configurar o RDU, acesse o  portal de Ajuda do X Ads e abra um chamado em "Mobile App, Rastreador de Conversões, gestor de audiências Como configurar o Uso Restrito de Dados".

Gerenciador de Eventos

Depois de colocar o pixel do X, retorne à guia "Gerenciador de eventos" no X Ads para verificar seu status. Para eventos definidos com código, você verá o status no painel principal do gerenciador de eventos. Para o código base, você pode verificar o status de rastreamento dos eventos "criados automaticamente" - Visita ao site ou Visualização da página inicial.

Existem 3 tipos de status diferentes para eventos de conversão do site:

  • Ativo: A atividade foi detectada nas últimas 24 horas

  • Inativo: A atividade não foi detectada

  • Nenhuma atividade recente: A atividade não foi detectada nas últimas 24 horas

Registro de atividades recentes

Depois que seu Pixel for implementado e começar a enviar eventos para o X, você pode usar o Registro de atividades recentes para ver os dados que foram recebidos recentemente e verificar se os eventos e parâmetros estão sendo enviados corretamente. Como fazer isso:

  1. No Gerenciador de eventos, passe o mouse sobre os três pontos ao lado do evento que deseja verificar e selecione "Exibir atividade" no menu suspenso;
  2. O Registro de atividades recentes será aberto, mostrando uma amostra dos dados que recebemos desse evento nas últimas horas;
  3. Passe o mouse sobre cada um dos itens de linha para verificar a hora em que o evento foi recebido, quais parâmetros ele está enviando (se houver algum definido) e o nome do host do site que está enviando esses eventos.

Você pode usar esta ferramenta para verificar rapidamente se os eventos e parâmetros que você implementou em seu Pixel estão enviando dados precisos e válidos.

Seu Pixel começa a enviar dados para a IU do X Ads na primeira vez que alguém visita sua página da Web tagueada. Se você estiver enfrentando problemas com seu Pixel ou apenas quiser ser detalhista, conclua as etapas a seguir para explorar o código do seu site e verificar se a tag do site está posicionada e funcionando corretamente.

Pixel Helper

Se você perceber algum problema com um Pixel implementado, nós também recomendamos usar o X Pixel Helper, uma extensão do Google Chrome. O Pixel Helper compartilha o status de rastreamento do X Pixel e os eventos relevantes e inclui códigos de erro, dependendo do que o problema for.

Saiba mais sobre o X Pixel Helper aqui e baixe a extensão aqui

Política de segurança de conteúdo

Adicionamos uma regra 302 de redirecionamento para nossa tag de rastreamento de conversões online (oct.js) e nossa tag universal de rastreamento de conversões (uwt.js). O redirecionamento funciona da seguinte maneira:

https://platform.twitter.com/oct.js ==> https://static.ads-twitter.com/oct.js

https://platform.twitter.com/uwt.js ==> https://static.ads-twitter.com/uwt.js

Se você tem um website com uma política de segurança de conteúdo (CSP) rigorosa, adicione “ads-twitter.com” a ela.

Além disso, com a recente atualização do Click ID, verifique se você também está colocando na lista de permissões as diretivas “analytics.twitter.com” em “img-src” e “connect-src” para continuar a ver resultados com o Pixel do X.

 

Gerenciador de tags

Observação: As interfaces de terceiros podem não refletir os recursos do nosso rastreamento de website no Gerenciador de Anúncios do X; isso pode estar relacionado somente às informações coletadas por tal terceiro.

Gerenciador de Tags do Google

Observação: O modelo “Website Tag Universal do X” será descontinuado. Em vez disso, busque pelo modelo do X Base Pixel e pelo modelo do X Event Pixel na Galeria de Modelos da Comunidade.

Criar pixel de base:

Observação: Só crie um pixel de base uma vez

  1. Selecione “Tags” no menu de navegação à esquerda e clique em “Novo” e em “Configuração da tag”

  2. Quando solicitado, selecione “Descobrir mais tipos de tag na Galeria de Modelos da Comunidade” e busque pelo Base Pixel do X Pixel

  3. Atribua um título à tag. Caso contrário, o padrão será "Tag sem título".

  4. Dentro da UI do X Ads (ads.X.com), acesse sua conta de anúncios e clique em > Ferramentas > Gerenciador de Eventos e selecione “Adicionar origem do evento” > Instalar com Gerenciador de Tags

  5. Copie e cole o ID do pixel no modelo de tag do Base Pixel do X

  6. Adicione os parâmetros necessários e a localização de página do usuário no modelo de tag do X Pixel

  7. Selecione o gatilho de nome “Todas as páginas – sem bloqueio (assíncrono” com o tipo Visualização de página

Crie o pixel do evento:

Observação: Certifique-se de criar um pixel de base antes de criar pixels de evento

  1. Selecione “Tags” no menu de navegação à esquerda e clique em “Novo” e em “Configuração da tag”
  2. Quando solicitado, selecione “Descobrir mais tipos de tag na Galeria de Modelos da Comunidade” e busque pelo Pixel de Evento do X
  3. Atribua um título à tag. Caso contrário, o padrão será "Tag sem título".
  4. Dentro da UI do X Ads (ads.X.com), acesse sua conta de anúncios e clique em Ferramentas > Gerenciador de Eventos e selecione “Adicionar evento” e preencha o formulário apresentado. Em seguida, selecione “Instalar com o gerenciador de tags”.
  5. Copie e cole o ID do evento no modelo de tag do Evento de Pixel do X
  6. Adicione os parâmetros necessários do usuário, os parâmetros de eventos e o local da página
  7. Adicione os gatilhos necessários para carregar o evento de tag em um conjunto específico de ações.
  8. Conclua as etapas semelhantes para todas as etapas do site - ou seja, não acione o evento da tag 'Visualização da Página' quando o evento da tag 'Compra' for acionado.
  9. Expanda a seção Configurações de tempo (opcional) e, no campo ESCOLHA QUAIS TAGS DEVEM DISPARAR PRIMEIRO, encontre e selecione o Base Pixel do X que acabou de ser criado.

Ensighten

Observação: O aplicativo de rastreamento de conversões do X (UWT) será descontinuado. Use o modelo do Pixel do X.

Crie um pixel de base:

Observação: Só crie um pixel de base uma vez

  1. No  painel do Ensighten, procure “Aplicativos” e “X Pixel” dentro da biblioteca do Ensighten

  2. Atribua um título à tag

  3. Selecione “Base Pixel”

  4. Dentro da UI do X Ads (ads.X.com), acesse sua conta de anúncios e clique em > Ferramentas > Gerenciador de Eventos e selecione “Adicionar origem do evento” > Instalar com Gerenciador de Tags

  5. Copie e cole o ID do pixel no campo ID do Pixel

  6. Adicione os parâmetros necessários do usuário e a localização da página

  7. Escolha “Todas as páginas” como condição/evento para esta tag

  8. Salvar tag

Crie um pixel do evento:

Observação: Certifique-se de criar um pixel de base antes de criar pixels de evento

  1. No  painel do Ensighten, procure “Aplicativos” e “X Pixel” dentro da biblioteca do Ensighten

  2. Atribua um título à tag

  3. Selecione “Pixel do evento”

  4. Dentro da UI do X Ads (ads.X.com), acesse sua conta de anúncios e clique em Ferramentas > Gerenciador de Eventos e selecione “Adicionar evento” e preencha o formulário apresentado. Em seguida, selecione “Instalar com o gerenciador de tags”.

  5. Copie e cole o ID do evento no modelo de tag do Evento do X Pixel

  6. Adicione os parâmetros necessários do usuário, os parâmetros de eventos e o local da página

  7. Adicione as condições e os eventos necessários para carregar o evento de tag em um conjunto específico de ações.

  8. Conclua as etapas semelhantes para todas as etapas do site - ou seja, não acione o evento da tag 'Visualização da Página' quando o evento da tag 'Compra' for acionado.

  9. Salvar tag

Tealium iQ

Observação: A lógica para o modelo de Base Pixel do X e a lógica do modelo de pixel de evento foram combinadas nos acionadores de eventos e mapeamentos de dados do Tealium iQ para facilitar o uso da marcação.

  1. Navegue até as Tags no menu de navegação à esquerda e clique no botão Adicionar Tag.

  2. Quando o Marketplace aparecer, use a barra de pesquisa para localizar o X Pixel.

  3. Selecione o botão verde +Adicionar.

  4. Se necessário, renomeie seu pixel. Caso contrário, prossiga para a próxima etapa para configuração.

  5. Dentro da UI do X Ads (ads.X.com), acesse sua conta de anúncios e clique em Ferramentas > Gerenciador de Eventos e selecione “Adicionar origem do evento” > Instalar com Gerenciador de Tags. Copie o ID do Pixel básico.

  6. Cole seu ID de pixel no campo de configuração de tag de ID de pixel no Tealium.

  7. Selecione quaisquer condições de regra de carregamento para as páginas nas quais você deseja disparar o pixel do X. Use a regra padrão Carregar em todas as páginas para acionar o Base Pixel em cada página.

Crie um acionador de pixel de evento:

  1. Selecione Mapeamentos de Dados na parte superior da janela Configuração.

  2. Selecione uma variável na lista suspensa cujo valor acionará o Pixel de evento específico. Neste exemplo, page_name será usado para invocar um evento de conversão.

  3. Clique no botão + Selecionar destino.

  4. No mapeamento de categorias no lado esquerdo da janela, selecione Eventos.

  5. No campo em que a variável mapeada for igual, insira o valor da variável. No exemplo do Tealium, a confirmação será usada.

  6. Dentro da UI do X Ads (ads.X.com), acesse sua conta de anúncios e clique em Ferramentas > Gerenciador de Eventos e selecione “Adicionar ou Editar um evento”. Em seguida, escolha Instalar com um gerenciador de tags para copiar o ID do evento.

  7. Copie o ID do evento de sua conta do X e cole-o no campo ID do código do evento em sua configuração do Tealium. Isso habilitará o gatilho inicial para esse evento.

  8. Variáveis adicionais podem ser mapeadas para alinhar com a ID do evento. Um exemplo comum é o envio de IDs de pedidos com um evento de conversão. Esse mapeamento ocorrerá na seção Parâmetros específicos do evento da janela Mapeamento de dados .

  9. Usando o ID do pedido como exemplo, siga as etapas 2 e 3 acima para selecionar a variável da camada dos dados do order_id. Em seguida, na aba Parâmetros específicos do evento, mapeie-o para o Parâmetro do ID do Pedido do X e insira o ID do código do evento de conversão.

*O relacionamento agora é criado para que, quando a page_name for igual a confirmação, o Pixel de Evento será invocado e mapeará o parâmetro order_id quando esse evento ocorrer. A conexão é feita com o ID do evento sendo inserido nos campos ID do código do evento nas seções Eventos e Parâmetros específicos do evento.

10. Selecione o botão verde +Adicionar para adicionar o mapeamento de ID do Código de Evento.

11. Assim que seus acionadores de Pixel Base e Evento forem concluídos. Clique no botão Aplicar para concluir sua configuração inicial. O perfil precisará de um salvamento/publicação concluído antes de testar sua tag. Siga seu fluxo de trabalho de teste e publicação de tags padrão.

 

Integrações da API de Conversão

Além do nosso guia da API de Conversão, que você pode usar para começar por conta própria, você pode usar um parceiro terceirizado para ajudá-lo a se integrar ao nosso produto da API de conversão. Atualmente temos parceria com AdobeTealium, Metaroutere Datahash. Se você já trabalha com um desses parceiros, pode seguir os links acima para a documentação deles para saber como integrar com a solução do X. Se você estiver interessado em trabalhar com um desses parceiros na configuração de uma integração da API de Conversão, entre em contato com eles para confirmar a disponibilidade.

 

Perguntas frequentes

Se o pixel não tiver carregado, as seguintes soluções poderão corrigir o problema:

Em uma página que rastreie tanto os destinos da página quando os cliques no botão, procure implementar o pixel nos botões separados da tag que rastreiam pela chegada na página de destino.

Para botões, abra uma nova página. Se a implementação estiver correta, a página da web poderá descarregar antes de a tag terminar a carregar. Deixe que a tag continue a carregar enquanto a nova página está sendo carregada, ou abra uma nova aba para que a tag possa continuar a carregar na aba existente.

Click ID é um identificador exclusivo anexado automaticamente ao URL, com o intuito de melhorar nossa capacidade de atribuir ações ao website. Leia mais sobre o Click ID aqui.


Observação: Em relação ao Click ID, se você estiver usando o cabeçalho “Política de segurança de conteúdo” (CSP) no seu website, certifique-se que você tenha colocado na lista de permissões das diretivas “analytics.twitter.com” em “img-src” e “connect-src” para continuar a ver os resultados com o X Pixel.

Geralmente, recomendamos usar a regra URL contém em vez de URL exato, já que esta busca a correspondência exata do URL fornecido, incluindo os parâmetros de URL query string e o protocolo da página (”http” e “htpps”, por exemplo). Os parâmetros da consulta da string do URL podem variar entre usuários e caminhos de navegação de websites; portanto, recomendamos que você selecione “URL exato” para casos de uso muito raros e específicos.

Os anunciantes que estiverem criando eventos de X Pixel para campanhas de Anúncios de Produtos Dinâmicos precisam adicionar os seguintes eventos de conversão:

  • Visualização da página (antigo Visita ao Website): usado para rastrear quando um usuário visita uma página com vários produtos (p. ex., uma experiência de navegação no seu website como a página Promoção/Liquidação)
  • Visualização de conteúdo: usada para rastrear quando o usuário em um produto ou em uma página de detalhes do produto, ou então visualiza a página/os detalhes de tal produto. Esse evento deve capturar um usuário visualizando intencionalmente, com um id de produto específico
  • Adicionar ao carrinho – usado para rastrear quando o usuário adiciona um produto ao carrinho de compras
  • Comprar – usado para rastrear os produtos que estão sendo comprados 

Para todos os outros casos de uso, recomendamos o seguinte:

  • Visitas ao Website criadas automaticamente: Considere selecionar esta opção quando você quiser maximizar o tráfego para seu website (todas as páginas). Nós geralmente recomendamos aproveitar esse evento ao usar a Otimização de Visitas ao Website.
  • Visualização da Página de Destino criada automaticamente: isso deve ser usado quando você deseja direcionar o tráfego para o destino de clique (ou seja, página de destino) de seus anúncios, em vez de direcionar o tráfego para todo o site. Isso pode ser particularmente útil para anúncios na metade do funil com um produto específico e levando a uma página de detalhes do produto. 
  • Visualização da página: deve ser selecionado quando você estiver interessado em gerar tráfego a um subgrupo do seu website, conforme definido pelas regras de correspondência de URL para um evento de Visualização de Página (antes chamados de Visitas ao Website). 

Os relatórios do X são finalizados de 24 a 48 horas após a veiculação das impressões. Antes disso, estimamos dados para fornecer feedback em tempo real, mas eles podem sofrer alterações. A interface do usuário de relatórios de conversão do X possui dois pipelines de processo para exibir dados.

Primeiro, uma tarefa de transmissão coleta visitas à página e eventos de compra diretamente de dados de registros em tempo real e envia métricas aos relatórios. Em seguida, um processo de lote contínuo remove disparos de tags duplicados, ajusta atribuições de conversão e mescla identidades de conversões em vários dispositivos.

Pronto para começar?