Principal Integrações Como integrar Yay! Forms com o pixel do Facebook/Meta

Como integrar Yay! Forms com o pixel do Facebook/Meta

Última atualização em Jan 23, 2026

Este guia detalha o processo de integração nativa entre o Yay! Forms e o Meta Ads (Facebook Ads), utilizando a API de Conversão da Meta para enviar eventos de forma automática e confiável. Ao final, você terá a integração configurada, saberá como testar o envio de eventos, entenderá quais eventos são enviados por padrão e como criar eventos personalizados para suas campanhas.

Caso você deseje, temos um tutorial em vídeo explicando passo a passo como fazer essa configuração:

1. Pré-Requisitos

  • Conta no Yay! Forms com formulário criado.

  • Conta de anúncio no Facebook com Pixel já criado.

  • Formulário com campos que capturam dados importantes (nome, e-mail, etc).

2. Configurando a Integração com o Meta Pixel

Acesse o formulário desejado e selecione a aba Integrar. Nessa seção, você encontrará a opção relativa ao Pixel do Facebook. Clique em Configurar para prosseguir com a configuração do seu Pixel.

Agora, é necessário obter o nome do Pixel, o identificador do Pixel e o token de acesso correspondente. Para isso, acesse o Gerenciador de Eventos do Facebook. Em seguida, selecione o Pixel desejado e copie os dados necessários, conforme exemplificado nas imagens abaixo.

Após obter esses dados, acesse o Yay! Forms e clique em Conectar conta Meta.

Em seguida, preencha os dados obtidos na aba correspondente e clique em Salvar:

3. Testando Eventos no Meta

Caso você queira testar a integração em tempo real, acesse o Gerenciador de Eventos e vá até a aba Eventos de teste. Em seguida, clique em Confirme se os eventos do seu servidor estão configurados corretamente, como mostrado na imagem abaixo:

Logo após, copie o código de teste:

No Yay! Forms, cole esse código na seção de teste:

É importante remover esse evento de teste após a verificação, pois, caso contrário, o Facebook poderá interpretar que as informações vindas dessa configuração são apenas testes e desconsiderá-las.

4. Eventos Padrão Enviados pelo Yay! Forms

O Yay! Forms envia os seguintes eventos por padrão:

  • YFView/PageView - Quando o formulário é carregado.

  • YFStart - Quando o usuário inicia o preenchimento.

  • YFAnswer - A cada resposta de pergunta.

  • YFSubmit - Quando o formulário é enviado.

5. Criando Eventos Personalizados

Você também pode criar um evento personalizado e definir uma condição para que ele seja enviado ao Facebook. Para isso, primeiramente, você deve habilitar a opção "Habilitar conversões personalizadas".

Nome do Evento: Insira o nome do evento personalizado na caixa correspondente.

Condição para executar o Evento: Insira a fórmula ou expressão para que o evento seja executado. Neste link você encontra todos os detalhes sobre como criar fórmulas ou expressões condicionais.

Evento personalizado sem distinção entre maiúsculas e minúsculas: Marque esta opção se desejar tornar a execução do evento insensível a maiúsculas e minúsculas na expressão anterior.

**Multiplos eventos personalizados: **Você pode ter multiplos eventos personalizados para isso basta clicar na opção "Adicionar condição" assim você poderá enviar mais eventos personalizados com condições diferentes.

Dica: caso você queira que a conversão sempre aconteça basta você colocar dentro do prompt a palavra TRUE

6. Verificando Domínio para Melhoria de Qualidade (Opcional)

Copie o subdomínio do seu formulário no Yay! Forms, conforme mostrado abaixo:

Em seguida, crie um novo domínio no Business Manager do Facebook:

Adicione o domínio copiado anteriormente do Yay! Forms:

Copie a meta tag do domínio, conforme mostrado abaixo:

Por fim, cole-a na sua integração e clique em Verificar no Facebook.

7. Pontuação de Eventos e Dados Avançados

Você pode marcar a opção "Correspondência avançada", permitindo que nossa IA colete dados compatíveis da resposta, como nome, e-mail, idade, gênero, localização, etc., e envie essas informações ao Facebook para aumentar a pontuação do evento.

8. Enviando Eventos com Formulário Incompleto

Caso deseje que, mesmo sem o usuário concluir o formulário, um evento seja disparado (caso a condição configurada anteriormente seja verdadeira), ative a opção Envio de respostas incompletas.

9. Orientações Finais

É necessário aprovar manualmente no Facebook para pode usá-los nas campanhas como mostrado abaixo:

  • Se sua conta de anúncio e o Pixel estiverem em contas de Business diferentes, compartilhe os ativos.

  • No conjunto de anúncio, selecione o evento de conversão desejado (após aprovado).

  • Sempre teste suas configurações antes de iniciar uma campanha oficial.


Se você tiver alguma dúvida ou sugestão, envie um email para [email protected].

Conclusão

Ao longo do guia, você viu como conectar o Yay! Forms ao Meta Ads via API de Conversão, validar o funcionamento com eventos de teste, entender os eventos padrão enviados, configurar eventos personalizados e, se necessário, melhorar a qualidade por meio de verificação de domínio, correspondência avançada e envio com formulário incompleto.