Código de evento

Depois de adicionares o código-fonte, podes adicionar um código de evento para controlar um evento de conversão específico no teu site.

A seguinte tabela indica os eventos que podes controlar com a Tag do Pinterest e se incluem criação de públicos-alvo e relatórios de conversão. 

Evento

Finalidade

Criação de públicos-alvo

Relatórios de conversão

Checkout

Acompanhar utilizadores que completam transações

AddToCart

Acompanhar utilizadores que adicionam artigos aos carrinhos de compras

PageVisit

Acompanhar utilizadores que visualizam páginas principais, como páginas de produtos ou artigos

Signup

Acompanhar pessoas que se inscrevem no teu produto ou serviço

WatchVideo

Acompanhar utilizadores que veem vídeos

Lead

Acompanhar utilizadores que demonstram interesse no teu produto ou serviço

Search

Acompanhar utilizadores que executam pesquisas no teu site para procurar produtos específicos ou localizações de lojas

ViewCategory

Acompanhar utilizadores que veem páginas de categorias

Custom

Acompanhar um evento personalizado. Usa este nome de evento para acompanhar um evento especial que queiras incluir no teu relatório de conversões

[User-defined event]

Acrescentar qualquer informação adicional que tenhas definido para a finalidade da segmentação do público-alvo. Os eventos únicos não têm relatórios de conversões. Não te esqueças de que os espaços em brancos serão retirados dos nomes de eventos que passem pela tag

 

Colocação

Tanto o código-fonte como o código de evento têm de ser adicionados a todas as páginas em que pretendas acompanhar conversões. O código-fonte deve ser colocado em todas as páginas do teu website, enquanto que o código de evento só precisa de ser colocado nas páginas em que pretendas acompanhar conversões. O código-fonte tem de ser executado antes do código de evento. Não te esqueças de colocá-lo em primeiro lugar.

Por exemplo, se quiseres acompanhar pagamentos concluídos, tens de colocar o código-fonte seguido do código de evento dos pagamentos entre as tags <head> e </head> na página de confirmação de pagamentos. Este posicionamento garante que os códigos são executados quando a página é carregada.

Por outro lado, se um evento for acionado quando um utilizador toma uma ação em específico na página (como clicar num botão ou submeter um formulário), o código do evento tem de ser executado apenas como resultado da ação. Isto exige uma compreensão dos controladores existentes do evento no código JavaScript da tua página.

Dados de eventos

Podes indicar mais dados sobre um evento ao anexar um objeto que contenha dados de evento.

Não te esqueças que, de momento, apenas estão disponíveis relatórios de "value" e "order_quantity". Todos os dados de evento adicionais estão disponíveis para segmentação de públicos-alvo, mas não estão disponíveis para relatórios de conversão.

O valor deve ser enviado com o código de moeda adequado. O Pinterest irá converter o valor de conversão no relatório do gestor de anúncios para a moeda da tua conta através da taxa de câmbio entre o código da moeda enviado na tua tag de conversão e a moeda da tua conta.

Dados de eventos

Valor de amostra

Tipo

Criação de públicos-alvo

Relatórios de conversão

value

100,00

Número (inteiro ou ponto flutuante)

order_quantity

1

Inteiro

currency

EUR

Uma das seguintes: USD, GBP, CAD, EUR, AUD ou NZD

 

product_name

Botas Parker

line_items array

 

product_id

1414

line_items array

 

product_category

Sapatos

line_items array

 

product_variant_id

1414-Vermelho

line_items array

 

product_variant

Vermelho

line_items array

 

product_price

99,99

Número (inteiro ou ponto flutuante), matriz line_items

 

product_quantity

1

Inteiro, matriz line_items

 

product_brand

Parker

line_items array

 

promo_code

INVERNO10

Segmento

 

property

Athleta

Segmento

 

search_query

botas

Segmento

 

video_title

Como personalizar botas Parker

Segmento

 

lead_type

Boletim

Segmento

 

 

O exemplo do código de evento abaixo indicado acompanha um evento de pagamentos com dados do evento, descrevendo a compra de dois produtos. Não te esqueças que este exemplo é a porção JavaScript do código de evento. Neste exemplo, "order_quantity" e "value" são estáticos, mas podes preferir passar estes valores de forma dinâmica.

Consulta a secção de dados de valores e quantidades de eventos para mais exemplos sobre valores dinâmicos e quantidades.
 

<script>
 pintrk('track', 'checkout', {
   value: 10.00,
   order_quantity: 2,
   currency: 'USD',
   line_items: [
     {
       product_name: 'Parker Boots',
       product_id: '1414',
       product_price: 5.00,
       product_quantity: 1
     },
     {
       product_name: 'Parker Sandals',
       product_id: 'ABC',
       product_price: 5.00,
       product_quantity: 1
     }
   ]
 });
</script>

Dados de valores e quantidades de eventos

Os valores e as quantidades de encomendas são dois segmentos de dados de eventos atualmente disponíveis nos relatórios de conversões. Se quiseres adicionar segmentos de valor e quantidade, podes inserir valores estáticos ou passá-los de forma dinâmica. Se preferires passar os segmentos de valor e quantidade de forma dinâmica, tal como recomendamos, serão únicos para o teu site e para a forma como as vendas são registadas. Normalmente, os valores e a quantidade de encomendas processadas no teu site são variáveis. Para acompanhar o valor total das tuas vendas de forma precisa, recomendamos que utilizes uma variável dinâmica para acompanhar as quantidades e valores das tuas tags de conversão.

Exemplo de segmentos de valor e quantidade não alteráveis:

<script>
 pintrk('track', 'checkout', {
   value: 10.00, // Read this value (must be a number)
   order_quantity: 5 // Read this quantity (must be an integer)
 });
</script>
<noscript>
 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=checkout&ed[value]=10.00&ed[order_quantity]=5&noscript=1"/>
</noscript>

Valor indicado: 10,00

Quantidade indicada: 5

Exemplo de valores e quantidades dinâmicas:

<script>
 pintrk('track', 'checkout', {
   value: {{Enhanced Transaction Revenue}},
   order_quantity: {{item.quantity}}
 });
</script>
<noscript>
 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=checkout&ed[value]={{Enhanced Transaction Revenue}}&ed[order_quantity]={{item.quantity}}&noscript=1" />
</noscript>

Valor indicado: Valor dinâmico adquirido no pagamento correspondente

Quantidade indicada: Quantidade dinâmica adquirida no pagamento correspondente

Tem em atenção que a configuração da quantidade e valor dinâmicos da encomenda é única para o teu site.

Callback

Para além dos dados de eventos, também podes passar uma função de callback como argumento opcional da função dpintrk(). Esta função de callback é executada sempre que um acompanhamento de evento - a função pintrk() - é ativado.

A função de callback tem os seguintes argumentos:

function(didInit, error) {}
  • didInit: Este primeiro argumento recebe um valor booleano, definido como verdadeiro se o acompanhamento do evento for bem construído, ou definido como falso se for detetado um erro ao fazer o acompanhamento do evento.

  • error: Este segundo argumento recebe um segmento que descreve o erro se o valor didInit for falso. Se o valor didInit for verdadeiro, este segmento fica indefinido.

Exemplo

<script>
 pintrk('track', 'checkout', {
   value: 10.00,
   order_quantity: 2,
   currency: 'USD',
   line_items: [
     {
       product_name: 'Parker Boots',
       product_id: '1414',
       product_price: 5.00,
       product_quantity: 1
     },
     {
       product_name: 'Parker Sandals'
       product_id: 'ABC',
       product_price: 5.00,
       product_quantity: 1
     }
   ]
 }, function(didInit, error) { if (!didInit) { console.log(error); }
 });
</script>

Próximas etapas

Podes consultar mais exemplos aqui. Depois de acrescentares os teus códigos-fonte e de evento, podes utilizar o assistente da tag do Pinterest para confirmar que implementaste as tags de forma correta.

Ainda precisas de ajuda?
Contacta-nos