O que é a Conversions API do Pinterest?
A Conversions API do Pinterest, que o Pinterest chama em português de API de Conversões, permite enviar conversões direto para o Pinterest por uma conexão de servidor a servidor, ao lado dos eventos que a tag do Pinterest envia do navegador do comprador.
Com o WeProfit, uma compra da Shopify chega ao Pinterest como checkout, o evento do Pinterest para uma transação concluída, enviada dos servidores do WeProfit para a conta de anúncios que você conectar. O início do checkout tem um evento próprio no Pinterest, o initiate_checkout, então não confunda os dois ao ler os seus relatórios.
O Pinterest está incluído em todos os planos do WeProfit, junto com Meta, Google, TikTok, Snapchat, X Ads, Microsoft (piloto), Reddit, LinkedIn e Taboola.
Conecte o Pinterest no WeProfit
Primeiro, conecte sua loja Shopify. O envio para o Pinterest precisa de dois valores: o ID da sua conta de anúncios do Pinterest e um token de acesso de conversão. O WeProfit não pede o ID da tag do Pinterest, e o formulário do Pinterest não tem campo de código de evento de teste.
- No Pinterest Ads Manager, abra Conversions e depois Conversions API e selecione Set up API. Escolha o token de acesso de conversão (Conversion access token), selecione Generate new token e copie o token.
- Copie o ID da sua conta de anúncios: o número que aparece na URL do Pinterest Ads Manager. O Pinterest também o mostra ao lado de um token recém-gerado.
- No WeProfit, abra Redes de anúncios > Pinterest e selecione Adicionar destino. Informe o ID da conta de anúncios e o token de acesso de conversão. O rótulo é opcional e ajuda quando você conecta mais de uma conta de anúncios.
- Deixe as Condições em branco para enviar todos os eventos elegíveis ou adicione condições, como país, evento, valor do pedido ou campanha, para limitar o que essa conta de anúncios recebe. Depois, selecione Conectar Pinterest.
- Selecione Enviar teste. O WeProfit envia um evento de teste com a flag de teste do Pinterest e mostra se o Pinterest o aceitou. O Pinterest coloca os eventos de teste em um ambiente isolado (sandbox) e não os processa para relatórios nem para otimização; os eventos reais nunca levam essa flag.
Compras e eventos de checkout enviados ao Pinterest
De uma loja Shopify, o WeProfit envia ao Pinterest as suas compras e duas etapas do checkout que o pixel da web dele registra: o início do checkout e a inclusão das informações de pagamento. As compras vêm do webhook de pedidos da Shopify, e a compra de cada pedido vai no máximo uma vez para cada conta de anúncios conectada.
O WeProfit só envia um evento ao Pinterest quando ele traz um e-mail com hash ou, juntos, um endereço IP e um user agent, o mínimo que a API do Pinterest pede em um evento da web. Ele ignora os eventos sem esses dados, e um evento ignorado não ganha linha no log de envios. Os reembolsos não são enviados ao Pinterest, e nada retira uma compra que o Pinterest já recebeu.
Cada compra leva o total do pedido informado pela Shopify, na moeda do pedido, os produtos com IDs, preços e quantidades, o número de itens e o ID do pedido na Shopify. Confira no Pinterest Ads Manager quais eventos a sua conta de anúncios recebe.
| Evento da loja | Evento do Pinterest |
|---|---|
| Checkout started | initiate_checkout |
| Payment information added | add_payment_info |
| Purchase | checkout |
Dados do cliente enviados com cada compra
Para ajudar o Pinterest a associar uma compra a um usuário do Pinterest, o WeProfit envia dados do pedido da Shopify com hash SHA-256: o e-mail e o telefone do comprador e, do endereço de entrega ou, se não houver, do endereço de cobrança, o nome e o sobrenome, a cidade, o estado, o CEP e o país. O endereço IP e o user agent vão sem hash. Quando o WeProfit tem esses dados, ele também envia o ID de clique do Pinterest, o epik, e um ID externo, que é um hash SHA-256 do ID de visitante do WeProfit.
O Pinterest adiciona o epik à URL de uma visita que vem do seu anúncio, e a tag do Pinterest o guarda no cookie _epik. O WeProfit lê os dois, mas não carrega a tag do Pinterest, então o cookie só existe quando a sua loja executa essa tag.
Tag do Pinterest e Conversions API: evite a contagem dupla
O Pinterest remove uma duplicata quando o eventID do evento do navegador, enviado pela tag do Pinterest, é igual ao event_id do evento do servidor. Ele mantém o primeiro evento que recebe e remove as duplicatas dentro de 48 horas.
O WeProfit não carrega a tag do Pinterest. Ele envia os eventos do Pinterest só pelo servidor, cada um com o próprio ID do evento. Uma compra sai como pur_ seguido de um código da loja e do ID do pedido na Shopify, como pur_a1b2c3d4-6012345678901, uma vez por pedido e conta de anúncios, e uma nova tentativa reutiliza esse ID.
Se a tag do Pinterest também informar compras para a mesma conta de anúncios, seja porque um app a adicionou ou porque ela está no código do seu tema, ela usa os próprios IDs de evento. Eles não serão iguais aos do WeProfit, então o Pinterest não consegue parear as duas cópias e pode contar o pedido duas vezes. Mantenha uma só ferramenta de envio de compras por conta de anúncios e depois compare uma compra de teste no Pinterest Ads Manager com o log de envios do WeProfit.
Confira os envios no log de envios da CAPI
Abra Redes de anúncios > Pinterest no WeProfit e role até o Log de envios da CAPI. Ele lista todos os eventos server-side enviados ao Pinterest, com as colunas Criado em, Evento, Destino, ID do evento, Status, Tentativas e Erro, e você pode filtrar por destino, evento e status. O filtro Purchase também encontra os eventos checkout do Pinterest.
O log mostra o ID do evento do próprio WeProfit, como pur_6012345678901; o Pinterest o recebe com o código da loja, como pur_a1b2c3d4-6012345678901. O log não tem coluna de valor, então confira o valor de uma compra na página Eventos do WeProfit. A página Pedidos mostra o envio de cada pedido para cada rede conectada na coluna Redes.
O status enviado significa que o Pinterest aceitou o evento, não que creditou o pedido a um anúncio. Se o Pinterest recusar o token de acesso, o WeProfit pausa a conexão e mostra um banner; um novo token ou um Enviar teste bem-sucedido reativa a conexão.
| Status | O que significa |
|---|---|
| pendente | Na fila e ainda não enviado. |
| enviado | O Pinterest aceitou o evento. |
| com falha | Um problema temporário. O WeProfit faz novas tentativas automaticamente por algumas horas, com o mesmo ID do evento. |
| falha definitiva | O WeProfit desistiu: o Pinterest recusou o evento, com a mensagem dele na coluna Erro, ou as tentativas acabaram. |
| ignorado (desativado) | O destino estava desativado ou pausado quando chegou a vez do evento. Os eventos ignorados enquanto ele está desativado não são enviados depois. |
| ignorado (antes da instalação) | A compra de um pedido feito antes da instalação do WeProfit. Ela nunca é enviada. |
Detalhes de campanha dos seus anúncios no Pinterest
O WeProfit classifica uma visita como Pinterest Ads quando ela traz o ID de clique epik do Pinterest, ou utm_source=pinterest com uma mídia paga. Com os parâmetros de URL automáticos do Pinterest, ele também lê os IDs da campanha e do grupo de anúncios.
Para ter o ID do anúncio e os nomes legíveis, adicione o modelo de URL do WeProfit para o Pinterest uma única vez para toda a conta de anúncios: no Business Manager, abra Ad accounts, selecione a sua conta, abra a aba Settings, edite as Parameter settings para que contenham os parâmetros do modelo do WeProfit e selecione Save and apply. Enquanto a opção de aplicar parâmetros de URL automaticamente a todas as campanhas atuais e futuras estiver marcada, o Pinterest os adiciona às URLs de destino dos seus anúncios; ele não substitui as tags UTM que uma URL já tem. Os modelos valem só para novos cliques.
Na atribuição do próprio WeProfit, um clique no anúncio conta por 30 dias e o clique mais recente vence, o que funciona como o último clique com uma janela de 30 dias para cliques em anúncios. O Pinterest credita as conversões pelas próprias configurações de atribuição, então os números dele e os do WeProfit podem ser diferentes para os mesmos pedidos.
utm_source=pinterest&utm_medium=paid&utm_campaign={campaignname}&utm_term={adgroupname}&utm_content={adid}&wpcid={campaignid}&wpasid={adgroupid}&wpadid={adid}