Os códigos do evento permitem medir o impacto que os Pinterest Ads têm em determinadas ações no local. Eles também são necessários para lançar campanhas que otimizarão automaticamente eventos específicos, como campanhas de conversão ou anúncios de retargeting dinâmico. Você também precisará de códigos de evento para
Depois de
A tabela abaixo mostra os eventos que você pode rastrear com a tag do Pinterest. Você pode usá-los para
Evento | Finalidade |
---|---|
Checkout | Mensurar quem conclui transações. |
AddToCart | Mensurar quem adiciona itens ao carrinho de compras. |
PageVisit | Mensurar quem visualiza páginas principais, como páginas de produtos e de artigos. |
Signup | Mensurar quem se cadastra para receber o seu produto ou serviço. |
WatchVideo | Mensurar quem assiste a vídeos. |
Lead | Mensurar quem mostra interesse pelo seu produto ou serviço. |
Pesquisar | Mensurar quem faz pesquisas de produtos específicos ou endereços de lojas no seu site. |
ViewCategory | Mensurar quem visualiza páginas de categoria. |
Custom | Mensurar um evento personalizado. Use este nome de evento para mensurar um evento especial que você queira incluir nos relatórios de conversão. |
[User-defined event] | Adicionar quaisquer eventos adicionais que você tenha definido para fins de segmentação do público. Eventos exclusivos não estão disponíveis para relatórios de conversão. Lembre-se de que todos os espaços nos nomes de eventos personalizados passados pela tag serão removidos. |
Existem eventos obrigatórios e recomendados, dependendo da campanha de anúncios que você decidir veicular.
Tipo de campanha | Eventos obrigatórios | Eventos recomendados | Dados de eventos obrigatórios | Dados de eventos recomendados |
---|---|---|---|---|
Reconhecimento da marca | Nenhum |
|
Nenhum | Correspondência avançada |
Vendas de catálogo |
|
|
|
|
Consideração | Nenhum |
|
Nenhum | Correspondência avançada |
Conversões |
Pelo menos um dos seguintes:
|
|
Nenhum |
|
Visualizações do vídeo | Nenhum | Nenhum | Nenhum | Correspondência avançada |
Existem eventos obrigatórios e recomendados dependendo dos recursos que você queira usar.
Recurso | Eventos obrigatórios | Eventos recomendados | Dados de eventos obrigatórios | Dados de eventos recomendados |
---|---|---|---|---|
Conversion Insights |
|
Nenhum | currency | Nenhum |
Programa de Lojas Verificadas (VMP) |
|
Nenhum | currency | Nenhum |
Retargeting dinâmico |
|
Nenhum |
|
Nenhum |
Se você decidiu usar a configuração manual, precisará adicionar códigos do evento a seu site por conta própria. As etapas abaixo são destinadas a pessoas que estão usando a opção de configuração manual.
- Entre em sua conta business do Pinterest no computador.
- Clique em
ícone de hambúrguer no canto superior esquerdo da página - Em Business, clique em Conversões.
- Clique em Começar.
- Selecione Somente a Tag do Pinterest e clique em Continuar.
- Clique em Pular no canto inferior direito da tela.
- Clique em Pular para a configuração manual.
- Copie o código de base e clique em Continuar.
- Escolha se deseja ativar a correspondência avançada automática e clique em Continuar.
- Clique em Copiar código abaixo da caixa cinza ao lado do código do evento que você deseja adicionar.
- Abra o código da página do seu site na qual você queira mensurar um evento.
- Cole o código do evento na página em que o evento deve ocorrer, substituindo todos os valores de exemplo pelo valor apropriado para o seu site. Isso significa que o evento será disparado sempre que a página for carregada.
- Clique em Feito.
Observação: se um evento for disparado somente depois de alguém executar uma ação específica na página, como clicar em um botão ou enviar um formulário, você precisará se certificar de que o código do evento seja executado somente como resultado da ação. Isso requer um entendimento dos manipuladores de eventos existentes no código JavaScript da sua página.
Você pode fornecer informações adicionais sobre um evento anexando um objeto que contenha os dados do evento. Todos os dados de eventos estão disponíveis para a segmentação do público-alvo, mas apenas os dados de eventos de value e order_quantity estão disponíveis para relatórios de conversão paga e orgânica.
Dados do evento | Valor da amostra | Tipo |
---|---|---|
value | 100,00 | Número (inteiro ou ponto flutuante) |
event_id | eventId0001 |
String (uma string de ID que identifica o evento de forma exclusiva) Observação: esse ID pode ser enviado com qualquer um dos seguintes nomes de campo, todos com diferenciação de maiúsculas e minúsculas: |
order_quantity | 1 | Número inteiro |
order_id | 1234OrderID | Cadeia de caracteres (order_id é necessário para relatórios de análise de conversão) |
product_name | Botas Parker | Matriz de line_items, sequência |
product_id | 1414 | Matriz de line_items, sequência |
product_category | Sapatos | Matriz de line_items, sequência |
product_variant_id | 1414-Vermelho | Matriz de line_items, sequência |
product_variant | Vermelho | Matriz de line_items, sequência |
product_price | 99,99 | Número (inteiro ou ponto flutuante), matriz de line_items, sequência |
product_quantity | 1 | Inteiro, matriz de line_items, sequência |
product_brand | Parker | Matriz de line_items, sequência |
promo_code | WINTER10 | Cadeia de caracteres |
property | Athleta | Cadeia de caracteres |
search_query | botas | Cadeia de caracteres |
video_title | Como criar um estilo com suas botas Parker | Cadeia de caracteres |
lead_type | newsletter | Cadeia de caracteres |
currency | USD |
Uma das seguintes: AED, AMD, ARS, AUD, AZN, BAM, BGN, BHD, BMD, BND, BOB, BRL, BSD, CAD, CHF, CLP, CNY, COP, CRC, CZK, DKK, DOP, EGP, EUR, FJD, GBP, GEL, GIP, HKD, HNL, HRK, HUF, IDR, ILS, INR, ISK, JMD, JPY, KGS, KRW, KWD, KZT, MAD, MDL, MOP, MXN, MYR, NOK, NZD, OMR, PAB, PEN, PHP, PKR, PLN, QAR, RON, RSD, RUB, SAR, SEK, SGD, THB, TRY, TWD, UAH, USD, UYU, VND ou ZAR. Observação: quando você informar uma moeda no seu evento de tag, calcularemos a taxa de câmbio com base na moeda da sua conta de anunciante. |
A tag IMG é um fragmento de código dentro da tag do Pinterest que atua como um backup caso as pessoas tenham desativado o JavaScript nos seus navegadores. Recomendamos incluir dados de eventos na tag IMG também, pois isso permite uma melhor segmentação de usuários. Você pode optar por usar apenas a tag IMG e não a tag JavaScript, mas será preciso
Veja abaixo alguns exemplos de cada tipo de evento para que você possa copiar e colar diretamente no seu site. Observe que você precisará substituir os valores de exemplo por uma variável dinâmica apropriada para o seu site.
Checkout
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=checkout&ed[event_id]=YOUR_EVENT_ID&ed[value]=10.00&ed[order_quantity]=2&noscript=1" />
Dados do evento: event_id, value, order_quantity e currency
Certifique-se de inserir o código de moeda correto para o seu site.
AddToCart
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=SEU_ID_TAG&event=AddToCart&ed[value]=10.00&ed[order_quantity]=2&noscript=1" />
Dados do evento: value, order_quantity e currency.
Certifique-se de inserir o código de moeda correto para o seu site.
PageVisit
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=SEU_ID_TAG&event=pagevisit&noscript=1" />
Dados do evento: none
Signup
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=SEU_ID_TAG&event=signup&noscript=1" />
Dados do evento: none
WatchVideo
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=SEU_ID_TAG&event=watchvideo&ed[video_title]=My+Product+Video+01&noscript=1" />
Dados do evento: video_title
Lead
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=SEU_ID_TAG&event=lead&ed[lead_type]=Newsletter&noscript=1" />
Dados do evento: lead_type
Pesquisar
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=SEU_ID_TAG&event=search&ed[search_query]=horse&noscript=1" />
Dados do evento: search_query
ViewCategory
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=SEU_ID_TAG&event=viewcategory&noscript=1" />
Dados do evento: none
Custom
O tipo de evento deve ser chamado custom — caso contrário, as conversões rastreadas pela tag não serão relatadas no Gerenciador de Anúncios.
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=SEU_ID_TAG&event=custom&noscript=1" />
Dados do evento: none
Value e order_quantity são as duas partes de dados do evento disponíveis em relatórios de conversão paga e orgânica. Se quiser adicionar valor e quantidade, você poderá passá-los de volta dinamicamente. Um valor dinâmico pode mudar dependendo da ação executada em seu site. Se optar por passar value e order-quantity de volta dinamicamente, isso será exclusivo para o seu site e como você registra as vendas. O valor e a quantidade dos produtos em cada pedido feito no seu site costuma variar.
<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 relatado: valor dinâmico comprado com a finalização da compra correspondente
Quantidade relatada: quantidade dinâmica comprada com a finalização da compra correspondente
Observação: a configuração da quantidade e valor dinâmicos do pedido é exclusiva do seu site.
Além dos dados do evento, você pode passar uma função de retorno de chamada de JavaScript como um argumento opcional para a função pintrk(). Com isso, você tem informações adicionais se algo deu errado com sua tag, o que pode ser verificado na sua ferramenta de desenvolvedor. Essa função de retorno de chamada é executada toda vez que uma chamada de rastreamento de evento, a função pintrk(), é disparada.
A função de retorno de chamada leva estes dois argumentos:
function(didInit, error) {}
didInit: este primeiro argumento recebe um valor booleano, que é definido para ser verdadeiro se a chamada de rastreamento de evento é construída com sucesso e falso se um erro é detectado ao fazer a chamada de rastreamento de evento.
error: este segundo argumento recebe uma cadeia de caracteres, que descreve o erro quando didInit retorna falso; se didInit é verdadeiro, essa cadeia de caracteres é indefinida.
<script>
pintrk('track', 'checkout', {
value: 10.00,
order_quantity: 2,
currency: 'USD',
event_id: 'eventId0001',
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>
Para rastreamento de conversão e geração de relatórios, você deve especificar um dos nove tipos de evento no código do evento. Você também deve substituir SEU_ID_TAG pelo seu ID de tag de conversão do Pinterest. Lembre-se, você pode incluir qualquer combinação de dados por evento além do que é mostrado nos exemplos abaixo.
Esta seção contém um exemplo de cada tipo de evento em um formato completo e copiável que você pode colocar no seu site diretamente. Cada exemplo tem os dados do evento necessários para começar a mensurar a atividade no seu site. Observe que você precisará substituir os valores de exemplo pelo valor estático ou variável dinâmica apropriados para o seu site. Por exemplo, você provavelmente desejará mensurar o valor do pedido de forma dinâmica, pois o valor de cada pedido feito em seu site variará dependendo do que alguém comprar. No entanto, você poderá atribuir um valor estático ao dado do evento lead_type se ele for referente apenas a uma página específica.
Checkout
<script>
pintrk('track', 'checkout', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Dados do evento: value, order_quantity, currency e event_id.
Certifique-se de inserir o código de moeda correto para o seu site.
AddToCart
<script>
pintrk('track', 'addtocart', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Dados do evento: value, order_quantity e currency.
Certifique-se de inserir o código de moeda correto para o seu site.
PageVisit
<script>
pintrk('track', 'pagevisit', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Signup
<script>
pintrk('track', 'signup', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
WatchVideo
<script>
pintrk('track', 'watchvideo', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Dados do evento: Video_title
Lead
<script>
pintrk('track', 'lead', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Dados do evento: lead_type
Pesquisar
<script>
pintrk('track', 'search', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Dados do evento: search_query
ViewCategory
<script>
pintrk('track', 'viewcategory', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Eventos definidos pelo usuário
<script>
pintrk('track', 'user_defined_event_name', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Custom
O tipo de evento tem que ser chamado custom; caso contrário, as conversões rastreadas pela tag não serão relatadas no Gerenciador de Anúncios.
<script>
pintrk('track', 'custom', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Aqui estão alguns exemplos de códigos de base combinados com códigos do evento. Lembre-se de confirmar se o código do evento foi colocado após o código de base no seu site.
Exemplo de ID de tag de conversão: 123456789 (substitua pelo seu ID de tag de conversão do Pinterest)
Exemplo de código de evento: PageVisit
<head>
<script type="text/javascript">
!function(e){if(!window.pintrk){window.pintrk=function(){window.pintrk.queue.push(
Array.prototype.slice.call(arguments))};var
n=window.pintrk;n.queue=[],n.version="3.0";var
t=document.createElement("script");t.async=!0,t.src=e;var
r=document.getElementsByTagName("script")[0];r.parentNode.insertBefore(t,r)}}
("https://s.pinimg.com/ct/core.js"); pintrk('load', '123456789'); pintrk('page');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&noscript=1" />
</noscript>
<script>
pintrk('track', 'pagevisit');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=pagevisit&noscript=1" />
</noscript>
</head>
Exemplo de ID de tag de conversão: 123456789 (substitua pelo seu ID de tag de conversão do Pinterest)
Exemplos de código de evento: PageVisit e AddToCart
<head>
<script type="text/javascript">
!function(e){if(!window.pintrk){window.pintrk=function(){window.pintrk.queue.push(
Array.prototype.slice.call(arguments))};var
n=window.pintrk;n.queue=[],n.version="3.0";var
t=document.createElement("script");t.async=!0,t.src=e;var
r=document.getElementsByTagName("script")[0];r.parentNode.insertBefore(t,r)}}
("https://s.pinimg.com/ct/core.js"); pintrk('load', '123456789'); pintrk('page');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&noscript=1" />
</noscript>
<script>
pintrk('track', 'pagevisit');
pintrk('track', 'addtocart');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=pagevisit&noscript=1" />
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=addtocart&noscript=1" />
</noscript>
</head>