Conversões da Meta

O seu site só fala com a Vibiz. Quando o encaminhamento para a Meta está ligado, a Vibiz envia as suas conversões para o seu pixel da Meta a partir dos próprios servidores, através da conta da Meta que você conectou à Vibiz. Não há nenhum token da API de Conversões para gerar no Gerenciador de Eventos, e nada no seu servidor fala com a Meta.

O que é enviado

Apenas conversões, cada uma como evento padrão da Meta:

• purchase como Purchase
• subscribe como Subscribe
• start_trial como StartTrial
• donate como Donate
• refund como evento personalizado

O resto fica na Vibiz. page_view, lead, sign_up, begin_checkout, add_to_cart e todos os outros eventos são armazenados e aparecem nos relatórios, mas nunca são enviados para a Meta. Uma campanha que otimiza para leads ou cadastros ainda precisa do pixel da Meta na página para esses eventos.

Não importa qual lado envia uma conversão. Um evento da tag do navegador e um de @vibiz/analytics/node são encaminhados da mesma forma, poucos segundos depois de chegarem.

Qual pixel

As conversões vão para o pixel selecionado na conta de anúncios da Meta de onde você lança anúncios, o mesmo que os seus anúncios usam, para que os anúncios e as conversões que eles geraram fiquem num único conjunto de dados. Você o escolhe em Intelligence, ou um agente o define com vibiz_analytics_setup_update. Enquanto nenhum pixel estiver selecionado, nada é enviado.

Ative

O encaminhamento fica desligado até você ativá-lo, porque uma página que ainda dispara o próprio pixel da Meta informaria cada compra duas vezes. Quando a tag viu esse pixel na página, a Vibiz se recusa a ativar o encaminhamento até você removê-lo, compartilhar ids de evento como descrito abaixo, ou confirmar.

Para testar primeiro, insira um código de evento de teste em Gerenciador de Eventos > Eventos de teste. Enquanto ele estiver definido, as conversões vão para essa visualização e não para o seu conjunto de dados. Um evento gasto num teste nunca é enviado de novo de verdade.

Se você também usa o pixel da Meta

A Meta mantém uma única cópia de um evento quando as duas cópias têm o mesmo id de evento. Para cada conversão, a Vibiz envia:

• o id que você passou, se passou um
• caso contrário, um id derivado de order_id, que as cópias do navegador e do servidor de um mesmo pedido compartilham, então nunca se contam em dobro
• caso contrário, um id aleatório

O id derivado de order_id não pode ser calculado do seu lado. Então, quando a página também dispara fbq para uma compra, escolha um id e passe-o para os dois:

const eventId = `purchase-${order.id}`;
track('purchase', { value: 49.9, currency: 'EUR', order_id: order.id }, { eventId });
fbq('track', 'Purchase', { value: 49.9, currency: 'EUR' }, { eventID: eventId });

O terceiro argumento de track precisa de @vibiz/analytics 0.6.0 ou da tag script. No servidor, passe o mesmo valor como eventId.

PageView não precisa de nada: a Vibiz nunca o envia, então as visualizações de página do pixel são as únicas que a Meta recebe.

Com um agente

No MCP da Vibiz, vibiz_analytics_setup retorna o org id, os snippets de instalação, as origens permitidas, os últimos eventos por origem e para onde vão as conversões da Meta. vibiz_analytics_setup_update permite origens, seleciona o pixel e ativa o encaminhamento, então toda a configuração é feita sem abrir o Gerenciador de Eventos.