Integração da Meta Conversions API para restaurantes: medindo anúncios em relação a visitas reais

Integrar a Meta Conversions API ao WiFi de visitantes permite que restaurantes meçam visitas off-line em relação aos gastos com anúncios de acordo com os padrões da GDPR. Ao enviar registros de login com hash SHA-256 em mais de 80.000 locais, os operadores atribuem visitas presenciais diretamente às campanhas, indo além das reservas on-line para acompanhar o retorno real dos anúncios.

O que a Meta Conversions API faz por um restaurante?

A Meta avalia seus anúncios com base nos eventos que consegue visualizar. Para a maioria dos restaurantes, esses eventos são gerados por pixels em um site: uma reserva, a visualização de um cardápio ou o download de um cupom. Um cliente que viu seu anúncio, ignorou o site e foi almoçar no local nunca aparece. No entanto, essa visita é o resultado pelo qual você pagou.

A Conversions API (CAPI) é a conexão servidor a servidor da Meta. Seus sistemas enviam eventos diretamente para a Meta, em vez de depender de um script em um navegador. A Meta a documenta para eventos de site, aplicativo e eventos off-line. Eventos off-line incluem visitas a um local físico, marcados com a fonte de ação "physical_store".

Por que relatórios baseados apenas em pixel subestimam os resultados de restaurantes

Existem três lacunas entre o que seus anúncios alcançam e o que o Ads Manager relata.

• A visita ocorre off-line. O Meta Pixel é executado apenas em um navegador, nas suas próprias páginas. Uma visita presencial, uma reserva por telefone ou uma reserva por meio de uma plataforma de terceiros não deixa nenhum evento de pixel.
• Navegadores descartam eventos. As próprias orientações da Meta afirmam que a Conversions API reduz a perda de dados decorrente de erros de carregamento do navegador, problemas de conectividade e bloqueadores de anúncios.
• As configurações de privacidade do dispositivo limitam os sinais. Desde o iOS 14.5, a Apple exige que os aplicativos solicitem permissão antes de usar dados de atividade nos aplicativos e sites de outras empresas. Muitas pessoas recusam, o que remove os sinais em que o pixel costumava confiar.

O custo vai além de uma lacuna de relatórios. O sistema de veiculação da Meta otimiza na direção das pessoas que geram os eventos recebidos. Se esses eventos forem apenas reservas on-line, o orçamento migra para pessoas que reservam on-line. Campanhas que lotam mesas com clientes presenciais parecem caras e acabam sendo pausadas.

O que muda quando as visitas chegam à Meta

Você envia um evento de visita para cada visitante com consentimento que faz login no seu WiFi, com um e-mail ou número de telefone em hash e um carimbo de data/hora. A Meta vincula esse evento à conta da Meta da pessoa sempre que possível. Em seguida, ela relata a visita em relação a qualquer anúncio visto ou clicado por essa pessoa dentro da sua configuração de atribuição. Você obtém um custo por visita por campanha, não apenas um custo por reserva.

A parte difícil não é a API. É ter um registro confiável e com consentimento de quem visitou e quando. Plataformas de e-mail como Mailchimp, Klaviyo e HubSpot enviam campanhas para uma lista que você já possui. Elas não registram que um cliente entrou pela sua porta. O WiFi de visitantes faz isso: cada login é um registro de visita de primeira parte com carimbo de data/hora e a opção de consentimento do visitante vinculada. Em mais de 80.000 locais ativos do Purple, os visitantes fizeram login 440 milhões de vezes em 2024 (dados do Purple). Esse é o material bruto para a medição de visitas.

O que você precisa antes de começar com a Conversions API?

Reúna sete itens antes que qualquer pessoa escreva código ou conecte uma integração.

1. Um portfólio empresarial da Meta com acesso de administrador, além do conjunto de dados sobre o qual seus anúncios relatam. A Meta agora usa "conjunto de dados" para o que costumava ser chamado de ID do pixel.
2. Um token de acesso da API de Conversões, gerado no Gerenciador de Eventos da Meta para esse conjunto de dados.
3. Uma maneira de enviar eventos no lado do servidor. Isso significa seu próprio desenvolvedor, uma integração de parceiro da Meta ou um CRM ou plataforma de dados do cliente com um conector da Meta.
4. Dados de visitas com consentimento. Você precisa de registros de login do WiFi de visitantes com e-mail ou telefone, carimbo de data/hora, local e status de consentimento. O Purple Engage mantém esses dados como perfis de visitantes criados a partir de cada login.
5. Uma base legal e um aviso de privacidade atualizado. Sob o Artigo 6 do GDPR, você precisa de uma base legal para compartilhar dados com a Meta. Para mensuração de anúncios, isso geralmente é o consentimento, que deve atender às condições do Artigo 7.
6. Uma definição compartilhada de uma visita. Decida o que conta: um login por visitante por local por dia, excluindo a equipe.
7. Uma linha de base. Exporte quatro semanas de resultados apenas com pixel por campanha para poder comparar o antes e o depois.

Sobre o item cinco, leia as Diretrizes 8/2020 do Conselho Europeu de Proteção de Dados sobre o direcionamento de usuários de mídias sociais. Elas descrevem como um anunciante e uma plataforma podem ser controladores conjuntos para determinado processamento. Os Termos de Ferramentas de Negócios da Meta também estabelecem suas obrigações ao enviar dados. Seu responsável pela proteção de dados deve aprovar ambos antes que o primeiro evento saia do seu servidor.

Como conectar dados de visitas do WiFi de visitantes à API de Conversões?

A configuração é executada em seis etapas. A documentação para desenvolvedores da Meta cobre os detalhes técnicos; esta seção cobre as decisões que cabem a você.

1. Capture o consentimento no login do WiFi

Sua página de login do WiFi é onde o consentimento começa. Peça o consentimento para mensuração de anúncios separadamente do consentimento para marketing por e-mail. O Recital 32 do GDPR é explícito ao afirmar que o silêncio e caixas pré-marcadas não contam como consentimento. O Purple usa opções de adesão por escolha consciente por esse motivo: o visitante escolhe ativamente e a escolha é armazenada com o perfil.

Escreva o texto em uma linguagem clara. Por exemplo: "Permita-nos compartilhar uma versão codificada do seu e-mail com a Meta para que possamos ver se nossos anúncios trouxeram você até aqui." Uma frase clara gera mais adesões do que um link para uma política.

2. Defina o evento de visita

Os eventos padrão da Meta não incluem uma visita a um restaurante, então a maioria dos locais cria um evento personalizado. Dê a ele um nome óbvio, como "VenueVisit". Envie um evento por visitante, por local, por dia, mesmo que ele faça login três vezes. Exclua dispositivos de funcionários e qualquer visitante que faça login mais de quatro dias por semana, o que geralmente sinaliza um funcionário.

3. Prepare e aplique o hash nos dados de correspondência

A Meta exige que identificadores pessoais, como e-mail e telefone, sejam normalizados e passem por um hash com SHA-256 antes do envio. Normalizar significa remover espaços, converter e-mails para letras minúsculas e adicionar o código do país aos números de telefone. A normalização inadequada é o motivo mais comum para falhas de correspondência.

Cada evento também precisa de um horário de evento, a fonte de ação "physical_store" e um ID de evento exclusivo. Envie apenas os parâmetros listados pela Meta. Identificadores de rede, como endereços MAC, não estão entre eles e nunca devem sair dos seus sistemas.

4. Envie eventos em um lote diário

A Meta rejeita eventos mais antigos do que a janela documentada por ela, portanto, não os deixe em fila por uma semana. Agende um lote diário no mínimo e verifique o limite de tempo atual na documentação da Meta ao desenvolvê-lo. O envio diário também mantém o Gerenciador de Anúncios próximo o suficiente do tempo real para análises semanais de campanhas.

5. Teste antes de colocar no ar

A ferramenta de Teste de Eventos da Meta, dentro do Gerenciador de Eventos, mostra os eventos à medida que eles chegam quando você os envia com um código de teste. Envie primeiro um pequeno grupo de visitas conhecidas. Confirme se o nome do evento, o horário e a fonte de ação estão corretos antes de mudar para envios ao vivo.

6. Crie uma conversão personalizada e adicione-a aos relatórios

Crie uma conversão personalizada a partir do seu evento de visita e, em seguida, adicione-a como uma coluna no Gerenciador de Anúncios. Agora você pode visualizar o custo por visita ao lado do custo por reserva, campanha por campanha.

O que você deve enviar para a Meta e quando?

Comece de forma focada. Um evento de visita limpo ensina mais do que cinco eventos ruidosos. Adicione eventos apenas quando o primeiro estiver com uma boa correspondência e sua equipe confiar nos números.

Evento	De onde vêm os dados	Dados de correspondência enviados	Quando enviar	O que isso informa
VenueVisit (personalizado)	Login do visitante no WiFi, apenas convidados com consentimento	E-mail em hash, telefone em hash, horário do evento, local	Lote diário	Custo por visita por campanha
ReturnVisit (personalizado)	Segundo login no WiFi em até 30 dias	E-mail em hash, telefone em hash, horário do evento, local	Lote diário	Se os anúncios trazem as pessoas de volta, e não apenas uma vez
Purchase (padrão)	Registro do caixa ou EPOS vinculado ao cliente	E-mail em hash, valor, moeda, horário do evento	Lote diário	Receita atribuída aos anúncios
Schedule (padrão)	Sistema de reservas online	E-mail em hash, horário do evento, ID do evento compartilhado com o pixel	Dentro de uma hora	Reservas recuperadas da perda de dados do navegador

Duas regras se aplicam a todas as linhas. Primeiro, envie apenas clientes que deram consentimento para mensuração de anúncios e pare no momento em que eles o retirarem. Segundo, quando o pixel e o servidor reportarem o mesmo evento da web, use o mesmo nome e ID de evento. A Meta usa esse par para eliminar duplicatas, garantindo que uma reserva não seja contada duas vezes.

O evento de visita de retorno é o que mais importa para um diretor de CRM. Uma primeira visita originada de um anúncio é útil. Uma segunda visita em até 30 dias mostra que o anúncio iniciou um relacionamento que seu programa de e-mail e mensagens pode desenvolver. Para o canal de acompanhamento, compare os custos em WhatsApp vs SMS no marketing para restaurantes: custo e alcance comparados.

Qual método de mensuração se adapta ao seu restaurante?

Os eventos de visita no lado do servidor não são a única maneira de mensurar redes sociais pagas. A escolha certa depende de onde seus clientes convertem e de quais dados você possui.

Método	O que ele visualiza	Contabiliza visitas presenciais	Dados necessários	Esforço de configuração	A quem se destina
Apenas Meta Pixel	Eventos do site no navegador	Não	Pixel em suas páginas de reserva e cardápio	Baixo: uma tag no site	Estabelecimentos onde a maioria dos clientes reserva online
Pixel mais CAPI para eventos da web	Eventos do site, com recuperação de perdas do navegador	Não	Pixel, acesso ao servidor, IDs de eventos compartilhados	Médio: integração de parceiro ou desenvolvedor	Grupos com alto volume de reservas online
CAPI com eventos de visita via WiFi para convidados	Eventos da web e visitas presenciais consentidas	Sim, para convidados do WiFi que consentiram	Registros de login consentidos com e-mail ou telefone	Médio a alto: análise de consentimento, hashing, envio diário	Restaurantes, bares e hotéis com forte movimento de clientes sem reserva
Estudo de Meta Conversion Lift	Visitas incrementais geradas por anúncios, via grupos de teste e controle	Sim, usando os eventos de visita que você envia	Eventos de visita mais orçamento e volume suficientes para um teste	Alto: teste planejado ao longo de várias semanas	Grupos que estão testando se as redes sociais pagas realmente trazem retorno

Use a tabela como um caminho de decisão. Se menos da metade dos seus clientes reserva online, os relatórios de pixel perdem a maioria dos seus resultados, portanto os eventos de visita vêm em primeiro lugar. Se você já envia eventos de visita e sua equipe financeira ainda duvida das redes sociais pagas, execute um estudo de lift. A atribuição mostra quem visitou após ver um anúncio. O lift mostra quem visitou por causa dele.

Cenários práticos

Os números abaixo são cálculos ilustrativos para demonstrar o método. Eles não representam resultados reais relatados por um local específico.

Cenário 1: um grupo de restaurantes casuais com 12 unidades promovendo uma oferta de almoço

Situação. O grupo gastou £ 6.000 ao longo de quatro semanas promovendo um menu de almoço para dias úteis no Instagram e no Facebook. O Gerenciador de Anúncios relatou 40 reservas online, a um custo de £ 150 por reserva. O diretor financeiro solicitou a interrupção da campanha.

O que foi feito. A equipe de marketing adicionou um consentimento separado para medição de anúncios na página de login do WiFi. Em seguida, enviou um evento VenueVisit diário para convidados consentidos e reestruturou os relatórios com base em uma conversão personalizada. A veiculação seguinte de quatro semanas rodou com o mesmo orçamento e peças criativas.

Resultado. O grupo enviou 1.900 eventos de visita no horário de almoço com consentimento. A Meta atribuiu 310 deles à campanha dentro de uma janela de clique de sete dias e visualização de um dia. O custo por visita atribuída ficou em £ 19,35, em comparação com £ 150 por reserva com base apenas nos dados do pixel. A campanha continuou no ar. A equipe de CRM usou o evento ReturnVisit para verificar que 70 desses convidados retornaram dentro de 30 dias.

Cenário 2: um hotel de 150 quartos com restaurante e bar abertos ao público

Situação. O hotel veiculou anúncios na Meta para seu restaurante e bar voltados a clientes locais, não a hóspedes. Ele já utilizava o pixel e eventos de servidor para reservas, mas os resultados relatados dobraram da noite para o dia.

O que foi feito. A equipe descobriu que seu mecanismo de reservas e sua integração de servidor enviavam eventos do tipo Schedule com IDs de evento diferentes. A Meta não conseguia reduzi-los por duplicidade. A equipe alinhou os IDs de evento e excluiu os hóspedes do hotel do evento VenueVisit, filtrando os logins em relação aos perfis vinculados aos quartos.

Resultado. As reservas informadas caíram de 220 para 112 no mês seguinte, alinhando-se com a contagem do próprio sistema de reservas com uma margem de 3%. Os eventos de visita passaram a contar apenas clientes do restaurante não residentes, totalizando 640 no mês. A equipe pôde finalmente comparar os gastos do restaurante com o comércio local, em vez de uma mistura de residentes e duplicatas.

Como saber se a Conversions API está funcionando?

Verifique cinco sinais no primeiro mês, nesta ordem.

Os eventos recebidos correspondem aos eventos enviados

Sua contagem diária de visitas consentidas deve corresponder aos eventos que a Meta informa ter recebido no Events Manager. Uma diferença superior a 5% indica falhas no envio, eventos rejeitados ou problemas de tempo de execução.

A Event Match Quality está melhorando

A Meta dá a cada evento de servidor uma pontuação de 0 a 10 com base em quão bem seus dados de correspondência identificam as pessoas. Adicionar um número de telefone com hash ao lado do e-mail geralmente melhora essa pontuação. Acompanhe a tendência semana a semana, e não o número do primeiro dia.

A desduplicação está limpa

Se os resultados do pixel e do servidor subiram acentuadamente no dia em que você entrou no ar, os eventos provavelmente estão sendo contados duas vezes. Verifique se os eventos compartilhados possuem o mesmo nome e ID de evento em ambas as fontes.

O custo por visita está estável

Após duas ou três semanas, o custo por visita atribuída deve se estabilizar dentro de uma faixa consistente para cada campanha. Oscilações bruscas sugerem que os lotes estão chegando atrasados ou de forma irregular.

Os resultados se sustentam contra um grupo de controle

A atribuição dá crédito de anúncio a qualquer pessoa que o tenha visto e depois feito uma visita, incluindo frequentadores assíduos que viriam de qualquer maneira. Faça um teste simples: pause os anúncios para um local comparável por duas semanas e compare as contagens de visitas via WiFi. Para uma resposta rigorosa, use o estudo de Conversion Lift da Meta.

O que dá errado e como evitar?

A maioria das falhas são falhas de processo, não de código. Aqui estão as seis que custam mais tempo aos grupos de restaurantes.

• Enviar dados sem consentimento válido. Uma única caixa de consentimento agrupada para "marketing" não se sustentará nos termos do Artigo 7 do GDPR para mensuração de anúncios. Separe os opt-ins e armazene cada escolha com seu carimbo de data/hora.
• Contar o mesmo evento duas vezes. Eventos de pixel e de servidor sem IDs de evento correspondentes inflam todos os números relatados. Corrija a desduplicação antes de apresentar os resultados para a equipe financeira.
• Deixar que os lotes fiquem desatualizados. Eventos que ficam na fila além do limite de tempo da Meta são rejeitados sem aparecer nos relatórios. Automatize o envio diário e alerte alguém quando ele falhar.
• Contar funcionários e residentes como clientes. Os funcionários fazem login a cada turno e os hóspedes do hotel fazem login diariamente. Filtre ambos, ou o seu custo por visita parecerá melhor do que realmente é.
• Tratar cada login como uma visita. Um convidado que se reconecta após o almoço ainda é apenas uma visita. Envie um evento por convidado, por local, por dia.
• Confundir atribuição com causa. Um cliente frequente e fiel que viu seu anúncio será contado como uma visita impulsionada pelo anúncio. Use grupos de controle (holdouts) ou estudos de elevação (lift studies) antes de transferir grandes orçamentos.

Mais uma falha ocorre completamente fora do Meta: uma lista reduzida de contatos com consentimento. A medição de visitas só funciona para visitantes que optaram por participar. Trate a taxa de opt-in no login do WiFi como uma métrica de mídia paga, pois ela estabelece o limite máximo do que você pode medir.

Perguntas frequentes

A API de Conversões do Meta substitui o Pixel do Meta?

Não, o Meta recomenda executar a API de Conversões junto com o pixel, e não em vez dele. O pixel captura eventos do navegador em tempo real, enquanto a conexão do servidor recupera eventos que o navegador perde e adiciona visitas offline. Quando ambos relatarem o mesmo evento da web, envie o mesmo nome de evento e ID de evento. O Meta o contatará apenas uma vez. Para visitas presenciais, apenas a conexão do servidor se aplica, pois não há evento de navegador para duplicar.

O compartilhamento de dados do WiFi de visitantes com o Meta está em conformidade com o GDPR?

Sim, desde que você tenha uma base legal, que para medição de anúncios é geralmente o consentimento explícito. O Artigo 7 do GDPR estabelece as condições, e o Recital 32 exclui caixas pré-marcadas. Informe aos visitantes em palavras simples que uma versão codificada de seu e-mail vai para o Meta para medir anúncios. Aplique o hash nos identificadores com SHA-256 conforme exigido pelo Meta. Pare de enviar no momento em que um visitante retirar o consentimento. Peça ao seu responsável pela proteção de dados para revisar as Diretrizes 8/2020 do Conselho Europeu de Proteção de Dados.

Isso funcionará com o hardware de WiFi que já temos?

Sim, o Purple é agnóstico em relação ao hardware e roda como uma sobreposição em nuvem nos seus pontos de acesso existentes. Ele funciona com Cisco Meraki, HPE Aruba, Ruckus, Juniper Mist, Ubiquiti, UniFi, Cambium, Extreme Networks e Fortinet. Você não precisa substituir o hardware para capturar registros de login com consentimento. Os dados de visita então fluem para o Purple Engage como perfis de visitantes, prontos para serem preparados para a API de Conversões.

Como isso se difere do uso do Mailchimp, Klaviyo ou HubSpot?

A diferença está na origem dos dados de visita. Mailchimp, Klaviyo e HubSpot enviam campanhas para uma lista que você já possui. Eles não registram que um cliente entrou fisicamente no seu restaurante. O Purple Engage constrói a lista a partir de logins no WiFi de visitantes, cada um sendo um registro de visita first-party, com carimbo de data/hora e consentimento. Esse registro é o que transforma uma conexão da API de Conversões de uma medição web para uma medição de visitas.

Precisamos de um desenvolvedor para configurar a API de Conversões?

Geralmente sim, para eventos de visita, embora o trabalho seja modesto. Eventos de site geralmente podem se conectar por meio de uma integração de parceiro do Meta com pouco código. Eventos de visita precisam de uma tarefa agendada que leia registros de login com consentimento, padronize e aplique hash nos identificadores e envie um lote diário. Um desenvolvedor, uma agência ou um CRM com um conector do Meta pode construí-lo. Reserve um tempo para a redação do texto de consentimento e a revisão da proteção de dados juntamente com o desenvolvimento.

Qual taxa de correspondência (match rate) devemos esperar entre as visitas e as contas do Meta?

Espere que a Meta corresponda a menos visitas do que você envia. A Meta só pode corresponder pessoas que possuem uma conta da Meta sob o mesmo e-mail ou número de telefone. Envie um e-mail com hash e um número de telefone com hash quando os tiver, e normalize cada um cuidadosamente. Em seguida, acompanhe a pontuação de Event Match Quality no Events Manager. Uma pontuação em elevação durante o primeiro mês mostra que seus dados de correspondência estão melhorando.

Em quanto tempo os resultados de visitas aparecerão no Ads Manager?

Os eventos de visita aparecem no Events Manager assim que a Meta os recebe, e o Test Events os mostra à medida que chegam. Os resultados atribuídos se acumulam no Ads Manager à medida que a janela de atribuição de cada campanha é executada. Com uma janela de clique de sete dias, dê à campanha pelo menos uma semana inteira antes de avaliar o custo por visita. Duas a quatro semanas de envios diários oferecem uma visão confiável para decisões de orçamento.