Visão geral

Com a API do Pinterest para conversões, os anunciantes podem enviar conversões diretamente para o Pinterest usando um método de conexão entre servidores. As conversões capturadas com a API do Pinterest podem ser usadas para ressegmentação em campanhas e ser analisadas nos relatórios de conversão para melhorar a visibilidade das conversões.

Por meio da API do Pinterest para conversões, os anunciantes podem enviar:

  • Conversões na Web
  • Conversões no aplicativo
  • Conversões offline
  • Os eventos podem ser recebidos em tempo real ou dentro de uma hora após o evento ocorrer e ser capturado. Os eventos recebidos fora desse intervalo ou como parte de um evento em lote atrasado serão contados como conversões offline. 

    O uso da API do Pinterest para conversões junto com a tag do Pinterest pode ajudar a maximizar a visibilidade em conversões capturadas. Nossa prática recomendada é usar as duas soluções de captura de conversão para garantir que você esteja recebendo uma visão completa do desempenho da sua campanha de conversão.

    A API do Pinterest

    A API do Pinterest para conversões é um dos vários produtos que ficam no nosso ecossistema de API do Pinterest. Qualquer pessoa com uma conta do Pinterest Business poderá usar a API do Pinterest para conversões, mas ela não concede acesso automático à API do Pinterest mais ampla. 

    A Plataforma para Desenvolvedores do Pinterest tem informações sobre todos os produtos de API do Pinterest. 

    Primeiros passos

    Qualquer pessoa com uma conta do Pinterest Business tem acesso à API do Pinterest para conversões.

    Para começar, primeiro você precisará gerar um token de acesso. Um token de acesso é uma série de caracteres que confirmam que as solicitações estão sendo feitas e enviadas de volta para a conta do usuário correto. 

    Para gerar um token de acesso: 

  • Entrar na sua conta business do Pinterest
  • Clique em Anúncios no menu superior e escolha Conversões
  • Selecione a página do Token de acesso da conversão na navegação do lado esquerdo
  • Clique no botão Gerar novo token
  • Copie o novo token de acesso e retorne ao processo de configuração.
  • Se estiver tentando acessar uma conta que não seja sua, será necessário configurar primeiro o Acesso para Empresas. 

    Implementação

    Eventos de conversão: todos os tipos de evento disponíveis para captura na tag do Pinterest também estão disponíveis por meio da API do Pinterest para conversões. Você pode encontrar uma lista completa dos eventos e mais informações sobre a importância deles na nossa Documentação para Desenvolvedores da API do Pinterest.

    A configuração de uma integração de API de servidor para servidor exige recursos de desenvolvedor e de engenharia do proprietário do site. O esforço técnico para o desenvolvedor varia dependendo destes fatores:

  • A familiaridade do seu desenvolvedor com integrações de API. Se ele nunca tiver feito uma integração de API, o processo será mais trabalhoso. Se você já tiver implementado outras APIs de conversão, seu desenvolvedor só precisará fazer algumas alterações.
  • O número de eventos rastreados e em qual estágio do processo de conversão esses dados serão enviados para nós.
  • Se um anunciante quer ou precisa usar um terceiro para a integração (por exemplo, Shopify, GTM, Tealium).
  • Se você já estiver usando a tag do Pinterest

    É altamente recomendável o uso da API do Pinterest para conversões junto com a tag do Pinterest para garantir a maximização de suas conversões. 

    Se você já tiver configurado a tag do Pinterest anteriormente, precisará garantir que as conversões não sejam contabilizadas duas vezes — uma vez por meio da tag do Pinterest e uma vez por meio da API. 

    Para isso, você precisará confirmar que o parâmetro event_id está sendo informado com conversões capturadas tanto pela tag do Pinterest quanto pela API do Pinterest para conversões. 

    Nosso sistema reconhecerá o event_ids como duplicado e manterá apenas a primeira conversão capturada. Para garantir que essa desduplicação seja bem-sucedida, o event_ids precisará ser:

  • event_ids precisam ser idênticos entre as mesmas conversões – uma pessoa navega até uma página da Web e uma conversão de visita à página é disparada tanto pela tag do Pinterest quanto pela API do Pinterest. As duas conversões precisarão ter event_ids correspondentes enviados de volta para que nosso sistema reconheça que são a mesma conversão. 
  • event_ids precisam ser exclusivos para diferentes conversões – uma pessoa navega até uma página da Web e uma conversão de visita à página é disparada tanto pela tag do Pinterest quanto pela API do Pinterest. A pessoa adiciona uma camiseta ao carrinho, o que aciona o evento AddToCart que é disparado tanto na tag do Pinterest quanto na API do Pinterest. Embora os event_ids disparados para os mesmos eventos precisem ser iguais, os event_ids sendo enviados para o evento de visita à página e o evento AddToCart precisam ser únicos. Assim, nosso sistema os reconhecerá como eventos separados.
  • Com base no identificador do evento e em event_name, o Pinterest removerá quaisquer eventos duplicados do registro, desde que (a) o evento não tenha ocorrido offline (action_source não esteja offline) e (b) o Pinterest receba os eventos duplicados com um intervalo de 48 horas entre um e outro.

    Verificando sua configuração

    Após concluir a configuração da API, você poderá confirmar se os eventos de conversão estão sendo recebidos verificando:

  • Códigos de resposta: o desenvolvedor que configurar sua integração de API pode analisar os códigos de resposta devolvidos com cada solicitação enviada de volta após um disparo de conversão. 
  • Página de desduplicação no Gerenciador de Anúncios: as conversões pós-desduplicadas aparecerão na página de desduplicação no Gerenciador de Anúncios. Para acessar a página de desduplicação:
    • Entrar na sua conta business do Pinterest
    • Clique em Anúncios no menu superior e escolha Conversões
    • Selecione Desduplicação na navegação do lado esquerdo.
  • Qualidade e resiliência

    Resiliência é o status de uma configuração da API para conversões que permite o nível mais alto de correspondência e atribuição de sinal. Esses dados adicionais nos ajudarão a fornecer relatórios mais precisos à medida que as políticas do setor de anúncios mudarem e evoluírem.

    Status de resiliência

    Há duas categorias de status de  resiliência: Boa e Ruim. Seu status de resiliência está visível na seção Integridade da conversão do Gerenciador de Anúncios.

    Boa resiliência

    Opção 1: cobertura de identificador específico

  • Cobertura de identificadores
    • 90% ou mais dos eventos devem ter IP/UA. 
    • 10% ou mais dos eventos de funil mais baixos têm email com hash ou MAID. 
    • 10% ou mais dos eventos têm ID externo.
  • Sobreposição com dados da tag (quando aplicável)
    • 90%* ou mais eventos de tag devem ser recebidos por meio do CAPI 
  • Ou:

    Opção 2: alcançar taxa de correspondência de base

  • Taxa de correspondência de usuário do CAPI de 60% ou mais
  • Sobreposição com dados da tag (quando aplicável)
  • 90%* ou mais eventos de tag devem ser recebidos por meio do CAPI 


  • Resiliência Ruim

    Qualquer configuração que não seja Boa.

    Sinais e IDs de resiliência

    Envie os seguintes sinais para alcançar o status de anunciante resiliente.

    Sinais/IDs de API Pesos/classificação
    client_ip_address + client_user_agent Alto
    em Alto
    external_id Alto
    hashed_maid Alto
    click_id Alto
    fn + ln Baixo
    ph Baixo
    ge, bd, ct, st, zp, country Baixo

    *Pesos/classificação com base na probabilidade de aumentar a taxa de correspondência

    Implementação de terceiros

    O Pinterest tem várias integrações de terceiros para ajudar a dar suporte ao seu processo de adoção da API. 

    Gerenciador de tags do Google — lado do servidor

    Conecte sua conta do Gerenciador de tags do Google à API do Pinterest para conversões para descobrir quanto o Pinterest influencia o tráfego para sua loja e as vendas dos seus produtos.

    Essa integração requer que você implante um contêiner para servidor usando seu provedor de nuvem preferido e tenha conhecimentos sobre marcação no lado do servidor. Para obter mais informações sobre pré-requisitos, acesse o site para desenvolvedores.

    Shopify

    Essa nova integração da API para Conversões complementa a tag do Pinterest para garantir alta cobertura e qualidade de dados. Contanto que o aplicativo da Shopify esteja instalado, nenhuma ação será necessária para aproveitar esse aprimoramento. As alterações serão aplicadas automaticamente à loja do comerciante.

    Tealium

    Os anunciantes interessados no Tealium podem configurar a API para Conversões diretamente com terceiros. O Tealium cria o modelo e ajuda a facilitar a integração com o anunciante. 

    O processo de implementação está descrito na Central de Aprendizagem do Tealium. Qualquer dúvida sobre o suporte à implementação pode ser enviada para support [at] tealium.com (support[at]tealium[dot]com)

    Se você tem interesse nas integrações adicionais de terceiros, entre em contato com o representante de vendas para obter mais informações. 

    Entendendo o processamento de dados limitado

    A partir de 1º de janeiro de 2023, os anunciantes vão poder usar uma sinalização de processamento de dados limitado para cumprir o California Consumer Privacy Act, alterado pelo California Privacy Rights Act (juntos, o CCPA). Quando essa sinalização é usada, o Pinterest limita a forma como usamos determinados dados para ajudar os anunciantes a respeitar as configurações de privacidade do usuário. Por exemplo, um anunciante pode implementar a sinalização de processamento de dados limitado para usuários da Califórnia que optaram por não vender ou compartilhar dados de acordo com o CCPA. Quando a sinalização de processamento de dados limitado é usada, o Pinterest atua como um provedor de serviços, de acordo com o CCPA, no que diz respeito aos dados sinalizados de usuários na Califórnia.

    Os anunciantes são responsáveis por respeitar as opções dos usuários e identificar o estado de residência do usuário ao implementar a sinalização de processamento de dados limitado.

    End of Other articles Links
    Still need help? Contact us
    User feedback
    Este artigo foi útil?

    collection_fields

    Como podemos melhorar este artigo?