Como funcionam o Pixel e a API de Conversões da Meta na Meloja?
A Meloja possui integração com o Facebook Pixel da Meta e também com a API de Conversões da Meta (Conversions API / CAPI).
Essas duas formas de rastreamento trabalham em conjunto para enviar à Meta informações sobre ações realizadas pelos visitantes da sua loja, como visualizar produtos, adicionar itens ao carrinho, iniciar o checkout e concluir uma compra.
O Pixel funciona diretamente no navegador do visitante. Já a API de Conversões permite que determinados eventos também sejam enviados pelos servidores da Meloja diretamente para a Meta.
Quando a API de Conversões está configurada, a Meloja utiliza automaticamente a forma mais adequada de envio para cada evento.
Como configurar
No painel da Meloja, ative o plugin Facebook Pixel e informe o Número de identificação do Pixel.
Para utilizar também a API de Conversões, informe o Token da API de Conversões fornecido pela Meta.
O token é opcional. Portanto, existem dois modos possíveis de utilização:
- Pixel configurado, sem token da API de Conversões: os eventos compatíveis são enviados pelo Pixel no navegador.
- Pixel + token da API de Conversões configurados: a Meloja passa a utilizar também o envio de eventos pelo servidor.
Quais eventos são enviados
Atualmente, a Meloja envia os seguintes eventos padrão da Meta:
PageView: quando uma página da loja é visualizada. Enviado pelo navegador.ViewContent: quando um produto ou conteúdo compatível é visualizado. Enviado pelo navegador.Search: quando o cliente realiza uma pesquisa na loja. Enviado pelo navegador.Contact: em ações de contato compatíveis com o rastreamento atual. Enviado pelo navegador.AddToCart: quando um produto é adicionado com sucesso ao carrinho. Enviado pelo navegador e pelo servidor quando a CAPI está configurada.InitiateCheckout: quando o cliente inicia um checkout válido. Enviado pelo navegador e pelo servidor quando a CAPI está configurada.AddPaymentInfo: quando a forma de pagamento é informada durante o checkout. Enviado pelo navegador e pelo servidor quando a CAPI está configurada.CompleteRegistration: quando uma nova conta de cliente é efetivamente criada. Enviado pelo servidor quando a CAPI está configurada.Purchase: quando a API de Conversões está configurada, é enviado pelo servidor quando o pagamento de um pedido da loja é aprovado pela primeira vez. Quando o token da API de Conversões não está configurado, é enviado pelo navegador quando o checkout é concluído.
Nem todos os eventos precisam ser enviados pelo servidor. Eventos de navegação, como PageView , ViewContent e Search , continuam sendo enviados pelo Pixel.
Por que alguns eventos aparecem como "Navegador" e "Servidor" na Meta?
Isso é esperado.
Para alguns eventos, como AddToCart , InitiateCheckout e AddPaymentInfo , a Meloja pode enviar a mesma ação tanto pelo Pixel quanto pela API de Conversões.
A Meloja envia um identificador correspondente nas duas versões do evento para que a Meta possa realizar a desduplicação.
Assim, embora o Gerenciador de Eventos possa indicar que recebeu o evento pelo navegador e pelo servidor, eles representam a mesma ação do cliente e não devem ser tratados como duas conversões diferentes.
Esse comportamento é intencional e segue o modelo de integração entre Pixel e API de Conversões.
Como funciona o evento Purchase
O evento Purchase possui um tratamento especial.
Quando a API de Conversões está corretamente configurada para a loja, a Meloja não envia o Purchase pelo Pixel no navegador. Nesse caso, ele é enviado pelo servidor somente quando o pagamento do pedido é efetivamente aprovado pela primeira vez.
Isso também permite registrar compras cujo pagamento seja confirmado depois que o cliente já saiu da loja, como pode acontecer em pagamentos por Pix ou boleto.
Para formas de pagamento que dependem de confirmação manual, o Purchase é enviado quando o pagamento do pedido é marcado como pago.
Pedidos criados manualmente pelo lojista diretamente no painel não são considerados compras originadas pela loja virtual para esse rastreamento.
Se o token da API de Conversões não estiver configurado, a Meloja mantém o funcionamento tradicional do Purchase através do Pixel, enviando o evento pelo navegador quando o checkout é concluído.
O Purchase pode ser enviado novamente se eu alterar o pagamento do pedido?
Não.
Depois que a primeira aprovação do pagamento de um pedido é processada para fins de rastreamento, a Meloja mantém essa informação vinculada ao pedido.
Por isso, remover posteriormente a data de pagamento e marcar o mesmo pedido como pago novamente não deve gerar uma nova conversão Purchase .
Esse controle existe para evitar que alterações administrativas em um pedido já existente sejam interpretadas como uma nova venda pela Meta.
Como funciona o AddPaymentInfo
O AddPaymentInfo representa a etapa em que o cliente informa ou seleciona a forma de pagamento durante o checkout.
A Meloja controla esse evento para que ele seja registrado uma vez por checkout, evitando novos eventos apenas porque o visitante alternou repetidamente entre formas de pagamento durante a mesma compra.
Como funciona o CompleteRegistration
O CompleteRegistration é registrado quando uma nova conta de cliente é realmente criada na loja.
Isso pode ocorrer tanto em um fluxo normal de cadastro quanto durante o processo de checkout, quando houver criação de uma nova conta.
Entrar em uma conta que já existe não gera um novo CompleteRegistration .
Atualmente esse evento é enviado pela API de Conversões, portanto exige que a integração server-side esteja configurada.
Quais informações podem ser enviadas à Meta?
Dependendo do evento e das informações disponíveis no momento da ação, a Meloja pode enviar dados necessários para a mensuração da conversão, como horário do evento, endereço da página, IP e User-Agent do visitante, identificadores do navegador utilizados pela Meta, como _fbp e _fbc , além de informações comerciais relacionadas ao evento, como produto, quantidade, valor e moeda.
Por exemplo, em uma compra podem ser enviados o valor total do pedido, moeda BRL e informações dos itens adquiridos.
A Meloja não disponibiliza o Token da API de Conversões no navegador do cliente. O envio via CAPI é realizado pelos servidores da Meloja.
O que acontece se a Meta estiver temporariamente indisponível?
Os eventos enviados pela API de Conversões utilizam processamento em segundo plano. Se ocorrer uma falha temporária de comunicação com a Meta, a Meloja pode realizar novas tentativas de envio sem interromper o checkout ou impedir que o cliente conclua sua compra.
Como conferir os eventos recebidos pela Meta
Você pode acompanhar os eventos pelo Gerenciador de Eventos da Meta, selecionando o Pixel utilizado na sua loja.
Dependendo do evento, a Meta poderá indicar a origem como Navegador, Servidor ou ambas.
Para eventos enviados das duas formas, como AddToCart , não é necessariamente um problema visualizar as duas origens. A Meta utiliza os identificadores do evento para realizar a desduplicação quando se trata da mesma ação.
O Purchase , quando a API de Conversões estiver configurada, deverá ser recebido pelo servidor após a aprovação do pagamento.
Quando o token da API de Conversões não estiver configurado, o Purchase será enviado pelo navegador quando o checkout for concluído.
Preciso configurar a API de Conversões?
Não é obrigatório.
Você pode continuar utilizando somente o Facebook Pixel informando apenas o ID do Pixel.
No entanto, ao informar também o Token da API de Conversões, a Meloja passa a enviar os eventos server-side compatíveis automaticamente, sem que seja necessário instalar scripts adicionais ou configurar os eventos manualmente.
Preciso configurar eventos manualmente no código da loja?
Não.
Ao utilizar a integração nativa da Meloja, os eventos suportados são gerados automaticamente conforme as ações realizadas na loja.
Evite adicionar manualmente outro código que envie os mesmos eventos do Pixel ou da API de Conversões sem conhecer o funcionamento da integração, pois isso pode provocar eventos duplicados ou prejudicar a mensuração das campanhas.
Em resumo
Com apenas o Número de identificação do Pixel, a Meloja utiliza o rastreamento pelo navegador. Nesse caso, o evento Purchase é enviado quando o checkout é concluído.
Ao adicionar também o Token da API de Conversões, a Meloja passa a utilizar uma integração híbrida: alguns eventos continuam no navegador, alguns são enviados pelo navegador e pelo servidor com desduplicação, e eventos como Purchase passam a utilizar o servidor para representar com maior precisão a aprovação real do pagamento.
Todo esse processo é realizado automaticamente pela Meloja após a configuração da integração.