Parece que você está visualizando isso de uma região onde a tag do Pinterest ainda não está disponível. Veja onde a tag do Pinterest está disponível para contas do Pinterest Business. Saiba mais

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 acessar Conversion Insights e participar do Programa de Lojas Verificadas.

Depois de adicionar o código de base, você poderá adicionar códigos de evento para mensurar uma conversão específica no seu site. O código de base deve ser colocado em todas as páginas do seu site e os códigos de evento devem ser colocados apenas nas páginas em que você deseja mensurar conversões específicas. Diferentes códigos de evento são necessários para veicular diferentes campanhas de anúncios e acessar determinados recursos.

Tipos de código de evento

A tabela abaixo mostra os eventos que você pode rastrear com a tag do Pinterest. Você pode usá-los para criar públicos-alvo para a segmentação de anúncios e ver relatórios de conversão pagos e orgânicos relacionados no Gerenciador de Anúncios. Observação: o relatório não está disponível para eventos definidos pelo usuário.

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.
Eventos obrigatórios e recomendados para campanhas de anúncios

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
  • PageVisit
  • Checkout
  • AddToCart
  • Lead
  • Signup
Nenhum Correspondência avançada
Vendas de catálogo
  • PageVisit
  • AddToCart
  • Checkout
  • Signup
  • Lead
  • ID do produto
  • ID do pedido
  • Value
  • Moeda (necessário para addtocart e checkout)
  • Categoria do produto
  • Correspondência avançada
Consideração Nenhum
  • PageVisit
  • Checkout
  • AddToCart
  • Lead
  • Signup
Nenhum Correspondência avançada
Conversões

Pelo menos um dos seguintes:

  • Signup
  • Lead
  • AddToCart
  • Checkout
  • ID do produto
  • ID do pedido
  • Value
  • Correspondência avançada
Nenhum
  • Categoria do produto
  • currency
  • Correspondência avançada
Visualizações do vídeo Nenhum Nenhum Nenhum Correspondência avançada
Eventos obrigatórios e recomendados para recursos

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
  • PageVisit
  • AddToCart
  • Checkout
Nenhum currency Nenhum
Programa de Lojas Verificadas (VMP)
  • PageVisit
  • AddToCart
  • Checkout
Nenhum currency Nenhum
Retargeting dinâmico
  • PageVisit
  • AddToCart
  • Checkout
Nenhum
  • ID do produto
  • Value
  • currency
Nenhum
Adicionar códigos de evento ao seu site

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.

  1. Entre em sua conta business do Pinterest no computador.
  2. Clique em ícone de hambúrguer no canto superior esquerdo da página
  3. Em Business, clique em Conversões
  4. Clique em Começar.
  5. Selecione Somente a Tag do Pinterest e clique em Continuar.
  6. Clique em Pular no canto inferior direito da tela.
  7. Clique em Pular para a configuração manual.
  8. Copie o código de base e clique em Continuar.
  9. Escolha se deseja ativar a correspondência avançada automática e clique em Continuar.
  10. Clique em Copiar código abaixo da caixa cinza ao lado do código do evento que você deseja adicionar.
  11. Abra o código da página do seu site na qual você queira mensurar um evento.
  12. 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.
  13. 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.

Adicionar dados do evento

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:

  • eventID
  • event_id
  • eid
  • 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.

    Incluir dados de eventos na tag IMG

    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 remover as tags <noscript> do código.

    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

    Passar dados de eventos value e order_quantity dinamicamente

    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.

    Passar uma função de retorno de chamada de JavaScript

    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>
    Exemplos de código do evento

    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>
    Exemplos de códigos de base e códigos de evento combinados

    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>
    E agora?

    Verifique a tag do Pinterest para garantir que tudo esteja funcionando corretamente.

    End of Other articles Links
    Ainda precisa de ajuda? Fale conosco
    User feedback
    Este artigo foi útil?

    collection_fields

    Como podemos melhorar este artigo?