O que faz a Conversion API
Uma Conversion API (CAPI) envia eventos de conversão do servidor da Storeep diretamente para a plataforma de anúncios, sem passar pelo navegador do comprador. Como funciona de servidor para servidor, não é afetada por bloqueadores de anúncios, configurações de privacidade do navegador ou limites de rastreamento do iOS, e carrega detalhes do cliente com hash para melhorar a correspondência em Smart Bidding e públicos semelhantes. Para os pixels do lado do cliente, veja o artigo complementar Browser pixels.
Você pode usar um pixel de navegador e uma CAPI para a mesma plataforma ao mesmo tempo. A Storeep marca ambos com um ID de evento compartilhado, criado a partir do tipo de evento e número do pedido, para que a plataforma faça a deduplicação em uma única conversão, em vez de contar duas.
Quais plataformas oferecem uma CAPI
- Facebook / Meta Conversion API.
- TikTok Events API.
- Snapchat Conversions API.
X e Google Ads não possuem Conversion API do lado do servidor na Storeep; funcionam apenas do lado do navegador.
O que é enviado
Em cada pedido qualificado, a Storeep envia o valor e moeda do pedido, os itens do pedido e os sinais do comprador: e-mail com hash, telefone com hash, um ID de cliente com hash (external_id), endereço IP, user agent e, para Facebook e Snapchat, o país do mercado com hash. Também encaminha qualquer ID de clique de anúncio encontrado nos cookies do comprador (Facebook _fbc e _fbp, TikTok ttclid, Snapchat ScCid) para que a plataforma possa atribuir a conversão ao clique original.
Tipos de evento de conversão
- Facebook: apenas Lead ou Purchase. A CAPI do Facebook não envia eventos de adicionar ao carrinho ou checkout.
- TikTok: Lead, Purchase, Place an order ou Complete payment.
- Snapchat: Purchase ou Reserve.
Moeda e pedidos de valor zero
Cada evento usa a moeda do próprio pedido quando a plataforma permite; caso contrário, o valor é convertido para USD. A CAPI do Facebook ignora qualquer pedido cujo total seja 0, pois a Meta rejeita conversões sem valor, mantendo a consistência com o pixel do navegador do Facebook.
Controle de pedidos abandonados
Esse é o comportamento principal para entender. Um pedido novo sempre aciona o envio pela CAPI. Um pedido abandonado é diferente: só é enviado quando você ativa a opção Pedidos abandonados para aquela entrada da CAPI, e apenas no momento em que o status do pedido muda de abandonado para qualquer outro status.
- Com Pedidos abandonados desativado, pedidos abandonados recuperados nunca são enviados para a plataforma.
- Com a opção ativada, o evento dispara quando o pedido sai do status de abandonado, seja você mudando o status manualmente ou o app Automator mudando automaticamente.
- Se o Automator não estiver instalado, você deve mover o pedido para outro status manualmente para que o evento seja enviado.
- A opção é por entrada, então você pode ativar o rastreamento de pedidos abandonados para um Pixel ID e deixar desativado para outro.
Instalando uma CAPI e seus campos
- Abra Apps no menu à esquerda.
- Encontre o app Conversion API desejado e clique em Instalar, depois confirme.
- Abra o app novamente e clique em Adicionar novo pixel para criar uma entrada.
Cada entrada possui estes campos:
- Ativar: quando ligado, eventos de conversão são enviados de servidor para servidor. Ativado por padrão.
- Pedidos abandonados: a opção de controle descrita acima. Desativada por padrão.
- Nome da conta de anúncio: um rótulo apenas para sua referência.
- Pixel ID: seu Pixel ID do Meta, TikTok ou Snapchat.
- Mercados: os mercados da loja que essa entrada cobre. Selecione um ou mais.
- Tipo de evento de conversão: as opções de plataforma listadas acima.
- Token de acesso: o token de acesso da Conversions API gerado no gerenciador de eventos da plataforma. Obrigatório.
- Ativar modo de teste: quando ligado, eventos são enviados como eventos de teste.
- Código de teste: o código de evento de teste da plataforma, por exemplo TEST_1234. Obrigatório quando o modo de teste está ativado.
Modo de teste
Com o modo de teste ativado, os eventos aparecem na visualização de eventos de teste da plataforma para que você possa confirmar a integração sem afetar dados reais. Eventos de teste não alimentam lances ou otimização de anúncios, então desative o modo de teste antes de rodar campanhas reais.
Como os mercados segmentam uma CAPI
Uma entrada de CAPI só dispara para pedidos feitos nos mercados selecionados nela. Um pedido em um mercado não selecionado não aciona aquela entrada, assim você pode usar um Pixel ID e token de acesso diferentes por país na mesma loja.
Coisas para conferir
- Use o mesmo Pixel ID no seu pixel de navegador e na sua CAPI para que a plataforma deduplicate as duas entregas em uma conversão.
- Se os eventos pararem de aparecer no gerenciador de eventos da plataforma, seu token de acesso pode ter expirado. Gere um novo e atualize a entrada.
- Cada entrada é independente. Você pode adicionar várias entradas por plataforma, cada uma com seu próprio Pixel ID, token de acesso, mercados, tipo de evento e configuração de pedidos abandonados.
- Lembre-se de desativar o modo de teste antes de ir para produção, ou suas conversões reais não serão contabilizadas.