O que é a Conversions API do Snapchat?
A Conversions API do Snap permite que um servidor passe eventos de conversão da web direto para o Snapchat por uma integração de servidor a servidor, ao lado dos eventos que o Snap Pixel envia do navegador do comprador. O Snap recomenda que os anunciantes na web a usem junto com o pixel.
Com o WeProfit, uma compra da Shopify chega ao Snapchat como PURCHASE, enviada dos servidores do WeProfit para o Snap Pixel que você conectar. O Snapchat está incluído em todos os planos do WeProfit, junto com Meta, Google, TikTok, Pinterest, X Ads, Microsoft (piloto), Reddit, LinkedIn e Taboola.
Conecte o Snapchat no WeProfit
Primeiro, conecte sua loja Shopify. O envio para o Snapchat precisa de dois valores: o ID do seu Snap Pixel e um token da Conversions API. Só um administrador da organização (Organization Admin) da sua empresa no Snapchat pode criar esse token.
- No Snap Ads Manager, abra o menu no canto superior esquerdo, selecione Events Manager e clique no seu pixel. Copie o ID do pixel que aparece no topo: um código longo com hifens.
- Para criar o token, abra o menu no Ads Manager e selecione Business Details. Vá até Conversions API Tokens, selecione Generate Token e copie o token.
- Use esse token da Conversions API. O token de acesso que aparece no Event Source Setup do Events Manager é de outro tipo e não funciona nesta conexão.
- No WeProfit, abra Redes de anúncios > Snapchat e selecione Adicionar destino. Informe o ID do Snap Pixel e o token da Conversions API. O rótulo é opcional e ajuda quando você conecta mais de um pixel.
- 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 esse pixel recebe. Depois, selecione Conectar Snapchat.
- Selecione Enviar teste. O WeProfit envia um evento de teste para o endpoint de validação do Snap, que verifica se um evento está montado corretamente, e mostra se o Snap o aceitou. O destino do Snapchat no WeProfit não tem código de evento de teste, então não há modo de teste para os eventos reais.
Compras e eventos de checkout enviados ao Snapchat
De uma loja Shopify, o WeProfit envia ao Snapchat 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 pixel conectado.
O WeProfit só envia um evento ao Snapchat quando ele traz pelo menos uma das chaves de correspondência que o Snap pede: um e-mail com hash, um telefone com hash ou, juntos, um endereço IP e um user agent. Ele só envia um PURCHASE com valor e moeda. Ele ignora os eventos que não têm esses dados, e um evento ignorado não ganha linha no log de envios.
A lista de eventos padrão do Snap não tem evento de lead, então o WeProfit ignora os leads no Snapchat em vez de enviá-los com outro nome. Eventos personalizados e reembolsos não são enviados ao Snapchat, e nada retira uma compra que o Snapchat já recebeu.
Cada compra leva o total do pedido informado pela Shopify, na moeda do pedido, os produtos com IDs, quantidades e preços, o número de itens e o ID do pedido na Shopify como order_id.
| Evento da loja | Evento do Snapchat |
|---|---|
| Checkout started | START_CHECKOUT |
| Payment information added | ADD_BILLING |
| Purchase | PURCHASE |
Dados do cliente enviados com cada compra
Para ajudar o Snapchat a associar uma compra a um usuário do Snapchat, 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 esse dado, ele também envia um ID externo, que é um hash SHA-256 do ID de visitante do WeProfit.
Quando o WeProfit tem esses dados, a compra também leva o ID de clique e o cookie do Snapchat: o valor ScCid que o Snapchat adiciona à URL da sua página de destino quando alguém clica no seu anúncio, enviado como sc_click_id, e o cookie _scid do Snap Pixel, enviado como sc_cookie1. O WeProfit não carrega o Snap Pixel, então o cookie _scid só existe quando a sua loja executa esse pixel.
Snap Pixel e Conversions API: evite a contagem dupla
O Snap pareia um evento do Snap Pixel com um evento da Conversions API do mesmo ID do pixel quando o client_dedup_id do pixel é igual ao event_id do servidor e os nomes dos eventos coincidem, dentro de 48 horas. Nos eventos PURCHASE, o Snap também pode parear o transaction_id do pixel com o order_id do evento do servidor, por até 30 dias.
O WeProfit não carrega o Snap Pixel. Ele envia os eventos do Snapchat 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 pixel, e uma nova tentativa reutiliza esse ID. O order_id dela é o ID numérico do pedido na Shopify, como 6012345678901, e não o número do pedido que os seus clientes veem.
Se um Snap Pixel também informar compras para o mesmo ID do pixel, por exemplo por um app ou pelo código do seu tema, os IDs de evento dele não serão iguais aos do WeProfit. O Snap então recorre ao ID do pedido: ele só consegue parear as duas cópias se o pixel informar o mesmo ID do pedido na Shopify como transaction_id. Verifique como o seu pixel informa as compras, mantenha uma só ferramenta de envio de compras por Snap Pixel, a menos que você tenha confirmado que os IDs coincidem, e compare uma compra de teste no Snapchat Ads Manager com o log de envios do WeProfit.
Confira os envios no log de envios da CAPI
Abra Redes de anúncios > Snapchat no WeProfit e role até o Log de envios da CAPI. Ele lista todos os eventos server-side enviados ao Snapchat, 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 PURCHASE.
O log mostra o ID do evento do próprio WeProfit, como pur_6012345678901; o Snapchat 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 Snapchat aceitou o evento, não que creditou o pedido a um anúncio. Se o Snapchat recusar o token, 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 Snapchat 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 Snapchat 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. |
Gastos com anúncios do Snapchat: lançados manualmente, não sincronizados
O WeProfit não tem conexão com contas de anúncios do Snapchat, então os gastos do Snapchat não são sincronizados automaticamente. Adicione-os de uma destas três formas: como lançamentos manuais em Lucro > Gasto com anúncios > Lançamentos manuais, com a data, o valor, a rede, um ID de campanha opcional e uma observação opcional; como uma programação diária, que lança o mesmo valor todos os dias até você mudá-la; ou pela API para desenvolvedores.
Adicione o ID da campanha a um lançamento quando quiser ver o lucro por campanha do Snapchat: a Atribuição associa os gastos aos pedidos atribuídos pelo ID ou pelo nome da campanha, e os gastos sem campanha contam no nível do canal. As campanhas do Snapchat costumam aparecer com os IDs em Atribuição, porque não há conexão com contas de anúncios do Snapchat para buscar os nomes. Um lançamento manual para um dia tem prioridade sobre uma programação diária.
Detalhes de campanha dos seus anúncios no Snapchat
O WeProfit classifica uma visita como Snapchat Ads quando ela traz o ID de clique ScCid do Snapchat, ou utm_source=snapchat com uma mídia paga. Com os Auto-UTMs do Snap, ele também lê o ID da campanha e, quando houver, o ID do anúncio. Para ter o conjunto de anúncios, adicione o modelo de URL do WeProfit para o Snapchat a cada anúncio, depois do ponto de interrogação na URL do site do criativo.
As macros diferenciam maiúsculas de minúsculas: escreva {{adSet.id}}, não {{adset.id}}. 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 Snapchat 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=snapchat&utm_medium=paid_social&utm_campaign={{campaign.name}}&utm_term={{adSet.name}}&utm_content={{creative.name}}&wpcid={{campaign.id}}&wpasid={{adSet.id}}&wpadid={{ad.id}}