Parece que estás a visualizar este conteúdo numa região em que a Tag do Pinterest ainda não está disponível. Vê onde a Tag do Pinterest está disponível para contas de empresa do Pinterest. Saber mais

Os códigos de evento permitem analisar o impacto dos anúncios do Pinterest em determinadas ações em sites. São necessários para lançar campanhas que otimizam automaticamente determinados eventos, como campanhas de conversão ou anúncios de ressegmentação dinâmica. Também vais precisar de códigos de evento para aceder às informações de conversões e aderir ao Programa de comerciantes verificados.

Depois de adicionares o código-fonte, podes adicionar códigos de evento para acompanhar determinada conversão no teu Website. O código-fonte deve ser colocado em todas as páginas do Website e os códigos de evento só precisam de ser colocados nas páginas em que pretendas acompanhar determinadas conversões. São necessários códigos de evento diferentes para executar campanhas de anúncios diferentes e aceder a determinadas funcionalidades.

Tipos de códigos de evento

A tabela abaixo apresenta os eventos que podes controlar com a Tag do Pinterest. Podes utilizá-los para criar públicos-alvo para segmentação de anúncios e podes consultar os respetivos relatórios de conversões pagas e orgânicas no Gestor de anúncios. Nota: não existem relatórios para eventos definidos pelo utilizador.

Evento Finalidade
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.
Pesquisa Acompanhar utilizadores que executam pesquisas no teu website para procurar determinados produtos 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 eventos adicionais 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 personalizados que passem pela tag.
Eventos obrigatórios e recomendados para campanhas de anúncios

Existem eventos obrigatórios e recomendados, dependendo da campanha de anúncios que decidires executar.

Tipo de campanha Eventos obrigatórios Eventos recomendados Dados de eventos obrigatórios Dados de eventos recomendados
Notoriedade da marca Nenhum
  • PageVisit
  • Checkout
  • AddToCart
  • Lead
  • Signup
Nenhum Correspondência melhorada
Vendas de catálogo
  • PageVisit
  • AddToCart
  • Checkout
  • Signup
  • Lead
  • ID do produto
  • ID da encomenda
  • Value
  • Moeda (necessário para addtocart e checkout)
  • Categoria do produto
  • Correspondência melhorada
Consideração Nenhum
  • PageVisit
  • Checkout
  • AddToCart
  • Lead
  • Signup
Nenhum Correspondência melhorada
Conversões

Pelo menos uma das seguintes opções:

  • Signup
  • Lead
  • AddToCart
  • Checkout
  • ID do produto
  • ID da encomenda
  • Value
  • Correspondência melhorada
Nenhum
  • Categoria do produto
  • currency
  • Correspondência melhorada
Visualizações de vídeos Nenhum Nenhum Nenhum Correspondência melhorada
Eventos obrigatórios e recomendados para funcionalidades

Existem eventos obrigatórios e recomendados, dependendo das funcionalidades que quiseres usar.

Funcionalidade Eventos obrigatórios Eventos recomendados Dados de eventos obrigatórios Dados de eventos recomendados
Informações de conversões
  • PageVisit
  • AddToCart
  • Checkout
Nenhum currency Nenhum
Programa de comerciantes verificados (VMP)
  • PageVisit
  • AddToCart
  • Checkout
Nenhum currency Nenhum
Nova segmentação dinâmica
  • PageVisit
  • AddToCart
  • Checkout
Nenhum
  • ID do produto
  • Value
  • currency
Nenhum
Adicionar códigos de evento ao teu website

Se tiveres optado pela configuração manual, será necessário adicionar códigos de eventos ao teu Website. Os passos abaixo são para pessoas que estão a usar a opção de configuração manual.

  1. Inicia sessão na tua conta de empresa do Pinterest no computador.
  2. Clica em ícone de hambúrguer no canto superior esquerdo da página
  3. Em Empresa, clica em Conversões
  4. Clica em Começar.
  5. Seleciona Apenas Tags do Pinterest e depois clica em Continuar.
  6. Clica em Ignorar no canto inferior direito do ecrã.
  7. Clica em Saltar para a configuração manual.
  8. Copia o código-fonte e clica em Continuar.
  9. Escolhe se pretendes ativar a correspondência melhorada automática e, em seguida, clica em Continuar.
  10. Clica em Copiar código abaixo da caixa cinzento, ao lado do código de evento que queres adicionar.
  11. Abre o código da página do Website em que pretendes acompanhar um evento.
  12. Cola o código de evento na página onde o evento deve ocorrer e certifica-te de que substituis quaisquer valores de exemplo pelo valor adequado para o teu Website. Isto significa que o evento será acionado quando a página for carregada.
  13. Clica em Concluído.

Nota: se um evento for acionado apenas quando alguém realizar uma determinada ação na página, como clicar num botão ou submeter um formulário, certifica-te de que o código de evento é 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.

Adicionar dados de eventos

Podes indicar mais dados sobre um evento ao anexar um objeto que contenha dados de evento. Todos os dados de eventos estão disponíveis para segmentação de públicos-alvo, mas apenas os dados de eventos valor e order_quantity estão disponíveis para relatórios de conversões pagas e orgânicas.

Dados de eventos Valor de amostra Tipo
value 100,00 Número (inteiro ou ponto flutuante)
event_id eventId0001

String (uma cadeia de id que identifica de forma exclusiva o evento)

Nota: este id pode ser enviado com qualquer um dos seguintes nomes de campos, sensíveis a maiúsculas e minúsculas:

  • eventID
  • event_id
  • eid
  • order_quantity 1 Inteiro
    order_id 1234OrderID Segmento (order_id é necessário para relatórios de análises de conversão) 
    product_name Botas Parker matriz line_items, segmento
    product_id 1414 matriz line_items, segmento
    product_category Sapatos matriz line_items, segmento
    product_variant_id 1414-Vermelho matriz line_items, segmento
    product_variant Vermelho matriz line_items, segmento
    product_price 99,99 Número (inteiro ou ponto flutuante), matriz line_items, segmento
    product_quantity 1 Inteiro, matriz line_items, segmento
    product_brand Parker matriz line_items, segmento
    promo_code INVERNO10 Segmento
    property Athleta Segmento
    search_query botas Segmento
    video_title Como personalizar botas Parker Segmento
    lead_type Boletim Segmento
    currency EUR

    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.

    Nota: se indicares uma moeda no teu evento da Tag, calcularemos a taxa de câmbio correspondente à moeda indicada na tua conta de anunciante.

    Incluir dados do evento na tag IMG

    A tag IMG é um pedaço de código na Tag do Pinterest que funciona como segurança, caso o utilizador tenha o JavaScript desativado nos respetivos browsers. Recomendamos que incluas também os dados do evento na tag IMG, porque isto permite uma melhor segmentação dos utilizadores. Podes optar por usar apenas a tag IMG sem a tag JavaScript, mas terás de remover as tags <noscript> do código.

    Abaixo apresentamos exemplos de cada tipo de evento, para que possas copiá-los e colá-los diretamente no Website. Nota: terás de substituir os valores de exemplo por um valor dinâmico para o Website.

    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 de eventos: event_id, value, order_quantity e currency

    Não te esqueças de indicar o código de moeda correto para o teu website.

    AddToCart

     <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=AddToCart&ed[value]=10.00&ed[order_quantity]=2&noscript=1" />

    Dados de evento: value, order_quantity e currency.

    Não te esqueças de indicar o código de moeda correto para o teu Website.

    PageVisit

     <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=pagevisit&noscript=1" />

    Dados de evento: none

    Signup

     <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=signup&noscript=1" />
    

    Dados de evento: none

    WatchVideo

     <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=watchvideo&ed[video_title]=My+Product+Video+01&noscript=1" />

    Dados de evento: video_title

    Lead

     <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=lead&ed[lead_type]=Newsletter&noscript=1" />

    Dados de evento: lead_type

    Pesquisa

     <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=search&ed[search_query]=horse&noscript=1" />

    Dados de evento: search_query

    ViewCategory

     <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=viewcategory&noscript=1" />

    Dados de evento: none

    Custom

    O tipo de evento deve ser personalizado. Caso contrário, as conversões controladas pela Tag não serão registadas no gestor de anúncios.

     <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=custom&noscript=1" />

    Dados de evento: none

    Passar os dados de eventos "value" e order_quantity de forma dinâmica

    "Value" e order_quantity são dois segmentos de dados de eventos disponíveis nos relatórios de conversões pagas e orgânicas. Se quiseres adicionar valor e quantidade, podes passá-los de forma dinâmica. Um valor dinâmico pode mudar, dependendo da ação realizada no site. Se optares por passar "value" e order_quantity, estes serão únicos para o teu website e para a forma como as vendas são registadas. O valor e a quantidade de produtos de cada encomenda processada no website são variáveis.

    <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

    Nota: a configuração da quantidade e valor dinâmicos da encomenda é única para o teu website.

    Passar uma função de callback JavaScript

    Além dos dados de eventos, também podes passar uma função de callback como argumento opcional da função pintrk(). Esta fornece informações adicionais se algo correr mal com a tag, que podes verificar nas ferramentas do programador. Esta função de callback é executada sempre que um acompanhamento de evento, a função pintrk(), é acionado.

    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.

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

    Para controlos de conversões ou relatórios, tens de especificar um dos nove tipos de eventos no código de evento. Também deves substituir YOUR_TAG_ID pela ID da tag de conversão do Pinterest. Não te esqueças de que podes incluir qualquer combinação de dados de eventos por evento, além dos exemplos abaixo indicados.

    Esta secção contém um exemplo de cada tipo de evento num formato completo e que pode ser copiado e colocado diretamente no teu site. Cada exemplo inclui os dados do evento para dar início ao acompanhamento de uma atividade no Website. Tem em atenção que tens de substituir os valores de exemplo pelos valores estáticos ou dinâmicos adequados para o Website. Por exemplo, provavelmente queres acompanhar valores de encomendas de forma dinâmica, já que o valor de cada pedido encomendado no Website depende do artigo. No entanto, podes atribuir um valor estático a dados de eventos lead_type se forem colocados apenas numa determinada página.

    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, and event_id.

    Não te esqueças de indicar o código de moeda correto para o teu website.

    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 de evento: value, order_quantity e currency.

    Não te esqueças de indicar o código de moeda correto para o teu website.

    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 de eventos: 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 de evento: lead_type

    Pesquisa

    <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 de 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 utilizador

    <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 deve ser designado personalizado, caso contrário as conversões seguidas pela tag não serão registadas no Gestor 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 combinações de códigos-fonte e códigos de evento

    Aqui estão alguns exemplos de códigos-fonte combinados com códigos de evento. Não te esqueças de confirmar que o código de evento é colocado depois do código-fonte no teu website.

    Exemplo de ID da tag de conversão: 123456789 (substitui pela tua ID da 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 da tag de conversão: 123456789 (substitui pela tua ID da tag de conversão do Pinterest)
    Exemplo de códigos 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 a seguir?

    Verifica a Tag do Pinterest para confirmar se tudo funciona devidamente.

    End of Other articles Links
    Ainda precisas de ajuda? Contacta-nos
    User feedback
    Este artigo foi útil?

    collection_fields

    Como podemos tornar este artigo melhor?