Como funciona a integração com o Pinterest
Atualizado em 05/10/2026
A integração com o Pinterest envia os eventos da loja (visitas, buscas, categorias, carrinhos, cadastros, contatos e compras) para o Pinterest, que usa esses dados para medir o resultado dos anúncios e otimizar as campanhas no Pinterest Ads.
Você a encontra em Marketing & SEO > Integrações, na pasta Pixels, item Pinterest. A primeira tela é a Visão geral, que lista as duas partes da integração. Cada parte tem um selo com o estado dela e o botão Configurar, que abre a tela da parte. O menu lateral da integração leva às mesmas telas.
Os dados que as telas pedem ficam no Gerenciador de anúncios do Pinterest, na área de Conversões.
Pixel
O Pixel é o rastreamento que roda no navegador do cliente, e o Pinterest o chama de Tag. É ela que registra cada passo da visita e permite ao Pinterest montar públicos, como o de quem viu um produto e não comprou. Na tela Pixel:
- Carregar a Tag na loja — liga a Tag. Desligada, a loja deixa de enviar eventos ao Pinterest pelo navegador.
- ID da Tag — o número da tag, que aparece no Gerenciador de anúncios, em Conversões.
- Enviar os eventos da visita — desligado, a Tag registra só a visita de página. Ligado, envia também a busca, a categoria vista, o carrinho, o cadastro, o contato e a compra (com valor, pedido e itens).
API de Conversão
Aqui está a parte que mais gera dúvida, então vale entender o porquê. O navegador é um mensageiro que às vezes não entrega: bloqueadores de anúncio, proteções de privacidade e a remoção de cookies fazem a Tag falhar em parte das visitas. Quando isso acontece, o Pinterest não sabe que a venda veio dele e para de otimizar bem as campanhas.
A API de Conversão envia os eventos pelo servidor da loja, por um caminho que o navegador não bloqueia. Na seção Conexão da tela API de Conversão:
- Enviar os eventos pelo servidor — liga a API. Desligada, os eventos chegam ao Pinterest só pelo navegador.
- ID da conta de anúncios — o número da conta de anúncios no Gerenciador de anúncios.
- Token de acesso — gerado no Gerenciador de anúncios, em Conversões, na API de Conversão. Por segurança, o campo sempre abre vazio, mesmo com um token gravado: a tela avisa "Chave gravada" e, nas chaves longas, mostra os quatro últimos caracteres. Para trocar, cole o token novo; deixar o campo em branco mantém o atual.
Na seção Eventos enviados, escolha o que sai pelo servidor:
- Enviar os cadastros — o cliente que cria a conta na loja vira o evento signup.
- Enviar os contatos — o formulário de contato e a inscrição na newsletter viram o evento lead.
- Enviar as compras — o pedido feito vira o evento checkout, com valor, pedido e itens.
O cadastro e a compra são enviados por uma fila, então podem não aparecer no Pinterest no mesmo instante em que acontecem na loja.
Atenção: a tela não deixa ligar uma parte sem os dados de que ela depende: o ID da Tag no Pixel, e o Token de acesso e o ID da conta de anúncios na API de Conversão. Ao gravar assim, nada é salvo, e o formulário volta com o campo marcado para você completar.
Atenção: a API ligada sem nenhum evento marcado não envia nada. O selo da parte avisa esse caso em amarelo, com Nenhum evento ligado. O mesmo selo mostra Falta a conta de anúncios quando o token está gravado sem a conta.
Se o Pinterest recusar o token, a loja desliga a API de Conversão sozinha e registra um alerta. Gere um token novo, cole-o na tela e ligue a API de novo.
Usar a Tag e a API de Conversão juntas reduz as perdas de medição quando o navegador bloqueia cookies ou scripts. Para o Pinterest casar os dois envios e não contar a mesma compra em dobro, a integração manda um identificador único do evento, o que se chama deduplicação.