O que é a Yelp Conversions API?
A Yelp Conversions API é a interface server-side para enviar dados de conversão diretamente para a plataforma Yelp Ads, sem depender de pixels ou scripts no navegador do usuário.
Para negócios locais e restaurantes que anunciam no Yelp, rastrear conversões com precisão é essencial para calcular o ROI das campanhas e otimizar os investimentos em publicidade.
Benefícios do rastreamento server-side para Yelp Ads
- Maior precisão: conversões não são perdidas por bloqueadores de anúncios ou restrições de cookies
- Atribuição mais confiável: dados de conversão chegam ao Yelp de forma consistente, melhorando a otimização de campanhas
- Menos dependência de JavaScript: o rastreamento funciona mesmo quando scripts client-side são bloqueados ou lentos
- Conformidade com privacidade: controle total sobre quais dados são compartilhados com o Yelp
Pré-requisitos
- Container sGTM configurado e em execução
- Stream de dados ativo do container web para o servidor
- Conta Yelp Ads com acesso ao painel de conversões e API credentials disponíveis
Configuração passo a passo
- Adicione o template ao workspace: no container sGTM, vá em Templates > Search Gallery > busque 'Yelp' > selecione 'Yelp Conversions API by Stape' > adicione ao workspace
- Crie uma nova tag: vá em Tags > Nova > selecione o tipo Yelp CAPI
- Configure as credenciais: insira o Access Token da API do Yelp (encontrado no painel de conta Yelp for Business)
- Configure o Event Name: escolha o tipo de evento que deseja rastrear (ex: purchase, lead, contact)
- Configure os parâmetros de usuário: adicione identificadores disponíveis (e-mail com hash, telefone) para melhorar a correspondência
- Adicione o trigger: defina quando a tag deve disparar (ex: evento de purchase, envio de formulário)
- Teste no Preview Mode e verifique se os eventos chegam corretamente ao painel Yelp
Para melhorar a qualidade da correspondência (match quality) no Yelp, forneça o máximo de informações de usuário com hash: e-mail, telefone e nome quando disponíveis.
Perguntas frequentes
O Yelp Ads é relevante para negócios fora dos EUA?
O Yelp Ads é principalmente voltado para o mercado americano. Para negócios no Brasil, plataformas como Google Ads, Meta Ads e plataformas locais são geralmente mais relevantes.
Preciso manter o pixel client-side do Yelp após implementar a CAPI?
Recomenda-se manter ambos para cobertura máxima, configurando deduplicação pelo Event ID. Mas se não houver pixel client-side, a CAPI por si só captura as conversões.
Quais eventos o Yelp Ads suporta via CAPI?
Os principais tipos de evento suportados incluem: compras/conversões, leads gerados, contatos recebidos e visualizações de página-chave do negócio.
Este artigo é uma adaptação em português de conteúdo originalmente publicado em inglês pela equipe da Stape. Ver artigo original.
