Configure uma integração do Meta Ads para o aplicativo do seu site para enviar sinais de conversão web para a Meta via API de Conversões (CAPI). A Meta usa esses sinais para otimizar a segmentação de anúncios e medir a performance da campanha.
Visão geral
A AppsFlyer permite a integração com o Meta Ads (metaweb_int) para campanhas de aplicativos de site. Com essa integração, você registra os dados de atribuição e conversão diretamente pela API de Conversões (CAPI) da Meta. Em seguida, esses dados são usados para otimizar a segmentação de anúncios, mensurar a performance e criar audiências personalizadas.
Veja como funciona: um usuário clica em um anúncio da Meta e acessa seu site. A AppsFlyer registra todos os eventos de conversão que o usuário conclui, como uma compra ou cadastro, e envia esse sinal para a Meta via CAPI. A Meta usa os dados para melhorar a segmentação e avaliar os resultados de campanha.
Atenção
A integração atual com a Meta Web não oferece suporte para o envio de postbacks de reengajamento para a CAPI.
Pré-requisitos
Antes de ativar a integração com o Meta Ads, verifique se você tem:
- Um aplicativo de site configurado na AppsFlyer. Para mais informações, consulte:
- Conta empresarial no Gerenciador do Meta Business Manager.
Configurar campanhas de anúncios da Meta para aplicativos de sites
O processo envolve definir a integração entre o Meta Ads e a AppsFlyer e configurar a campanha em ambas as plataformas. Conclua as duas partes a seguir em sequência.
- Parte 1: Configurar a integração do Meta Web Ads na AppsFlyer (obrigatória)
- Parte 2: Configurar a integração da AppsFlyer no Meta Ads (obrigatória)
Parte 1: Configurar a integração do Meta Web Ads na AppsFlyer
Comece ativando a integração do Meta Ads e definindo os postbacks que a AppsFlyer envia para a CAPI.
Etapa 1: Ative a integração do Meta Ads
Para ativar a integração do Meta Ads:
- Na AppsFlyer, no menu lateral, acesse Colaborar > Partner Marketplace.
- Pesquise e selecione Meta Ads.
- Clique em Configurar integração. Você será direcionado para a página de configuração Integrações ativas.
-
Na aba Integração, selecione Ativar parceiro.
Atenção
O botão deve permanecer ativado enquanto você trabalhar com o parceiro.
- Preencha o campo Pixel ID. Para recuperar seu Pixel ID do Gerenciador do Meta Ads:
-
No menu lateral do Gerenciador de Anúncios, acesse Todas as ferramentas > Gerenciador de eventos.
Atenção
Certifique-se de selecionar a empresa certa no menu suspenso no canto superior direito.
- No menu lateral do Gerenciador de Eventos, selecione Fontes de dados. Você verá uma lista dos seus pixels. Caso você não encontre um pixel para o negócio selecionado, você pode criá-lo.
- Copie o Pixel ID exibido abaixo do nome do pixel e cole-o no campo Pixel ID na AppsFlyer.
-
- Preencha o campo Token de acesso. Para recuperar o token de acesso, siga estas instruções.
-
Ative a opção Limitar o uso do Meta Ads sobre informações pessoais dos usuários (CCPA) para garantir compliance com as leis de proteção de dados.
Atenção
O cumprimento dos requisitos de privacidade (CCPA) limita os dados provenientes de usuários do Meta Ads na Califórnia.
Etapa 2: Configure os postbacks de eventos in-app
Você pode definir quais eventos de conversão na web a AppsFlyer envia para o Meta Ads ao mapear eventos da AppsFlyer para eventos do Meta Ads. Esses postbacks podem ser visualizados no Gerenciador de Eventos da Meta. A Meta usa os eventos mapeados para otimizar campanhas e relatórios.
Para configurar postbacks de eventos in-app:
- Ative Postbacks de eventos in-app.
- Se necessário, configure a janela de postback de eventos in-app. Para mais informações, consulte Configuração da janela de postback de evento in-app.
- Clique em Adicionar evento para adicionar um evento à lista.
- Na coluna Evento da AppsFlyer, selecione o nome do evento na lista do menu suspenso. A AppsFlyer recebe o nome do evento do SDK web integrado ao seu site ou dos eventos de servidor para servidor (S2S) que você envia para a AppsFlyer.
- Na coluna Mapeado para evento de parceiro, selecione o evento de parceiro predefinido mais adequado na lista do menu suspenso ou selecione PERSONALIZADO.
-
Na coluna Para usuários de, selecione a
opção de
envio do evento:
- Apenas este parceiro: Envie postbacks somente quando esse evento for atribuído ao Meta Ads.
- Todos os canais de mídia, incluindo orgânico: Envie postbacks para eventos atribuídos a qualquer parceiro e eventos orgânicos.
-
Na coluna Incluindo, selecione se os eventos serão enviados com os valores de receita. Veja Dados a incluir nos postbacks.
Importante!
Se você estiver configurando um evento de compra, defina a coluna Incluindo como Valores e receita. Selecionar qualquer outra opção faz com que o postback falhe.
- [Opcional] Clique no ícone Adicionar condição para definir condições para um evento.
- Clique em Salvar integração.
-
Inclua
af_customer_event_idno payload do evento que você envia para a AppsFlyer. No SDK web, envie-o dentro deeventValue. Na API S2S (server-to-server), envie-o como um campo de nível superior ou dentro deevent_value. - Envie o mesmo valor no evento correspondente do Pixel.
Se você também usa o Meta Pixel no seu site, envie o mesmo ID de evento para a AppsFlyer e para a Meta para que a AppsFlyer possa remover a duplicação dos eventos:
A AppsFlyer encaminha esse valor para a Meta como o ID do evento. A Meta então o usa para desduplicar o evento do lado do servidor que recebe da AppsFlyer em relação ao evento do Pixel, para que a AppsFlyer contabilize a conversão uma única vez.
Se você não enviar af_customer_event_id,
a AppsFlyer gera um ID de evento automaticamente. Esse ID
não corresponderá aos seus eventos do Pixel.
Para mais informações, consulte [Beta] Integrar o SDK web da AppsFlyer.
Atenção
Se você enviar eventos S2S e quiser que a AppsFlyer envie postbacks para o Meta Ads, verifique se cada evento inclui pelo menos um de ip, user_agent ou customer_user_id. Se os três estiverem ausentes, a AppsFlyer não enviará o postback. Para ver todos os campos de evento compatíveis, consulte API Server-to-Server (S2S) para Mensuração de performance web.
Parte 2: Configurar a integração da AppsFlyer no Meta Ads
Complete as etapas abaixo no Gerenciador do Meta Ads:
Etapa 1: Defina o tipo, objetivo e metas da campanha.
- Faça login no Meta Ads e crie uma campanha.
- Em Objetivo da campanha, selecione uma das seguintes opções:
- Vendas: Isso permite que a Meta otimize visando um evento específico (seu principal KPI).
- Tráfego: Isso permite que a Meta otimize visando cliques em anúncios. Use essa opção somente se você não possui outros KPIs ou se o volume de outros eventos de KPI for muito baixo.
-
[Opcional] Para adicionar um objetivo personalizado, faça o seguinte:
- No Meta Ads, selecione o evento personalizado que você deseja definir como objetivo da campanha e marque-o como uma ação de conversão.
- Na AppsFlyer, na página de integração do Meta Web, em postbacks de eventos in-app, mapeie um evento da AppsFlyer para um evento de parceiro personalizado na coluna Mapeado para evento de parceiro. Dê a ele o mesmo nome da ação de conversão no Meta Ads.
Atenção
Para saber mais sobre os objetivos da campanha na Meta, consulte a documentação da Meta.
- Em Local de conversão, selecione Site.
- Em Pixel, insira o mesmo Pixel ID que você inseriu para
metaweb_intno Marketplace de parceiros da AppsFlyer. Para saber mais sobre o Pixel da Meta, consulte a documentação da Meta (é necessário fazer login). - Clique em Próximo.
Etapa 2: Defina o URL de destino
-
Em Destino, no URL do site, insira o URL que serve como destino para seu anúncio. Escolha uma das seguintes opções:
- URL do site: Use o URL do seu site quando você quiser que os usuários acessem diretamente seu site e concluam eventos de conversão na web, como uma compra ou assinatura.
- Link de atribuição da AppsFlyer (OneLink): Use um link de atribuição da AppsFlyer quando você quiser que os usuários sejam redirecionados para o seu aplicativo mobile, com um fallback para o seu site se o app não estiver instalado. Isso é útil quando sua campanha visa tanto usuários de aplicativos quanto da web. Para mais informações, consulte a seção Links e experiências do OneLink.
Importante!
Em alguns casos, o uso de links de atribuição da AppsFlyer pode causar erros. Se isso ocorrer, peça uma solução ao seu representante da Meta ou use o URL do seu site como o URL de destino.
- Clique em Criar um parâmetro de URL para adicionar parâmetros de URL ao URL de destino.
- Em Parâmetros personalizados, clique em Adicionar parâmetro.
- Mapeie os parâmetros da AppsFlyer para seus valores da Meta de acordo com a tabela abaixo:
| Parâmetro da AppsFlyer | Valor mapeado na Meta |
|---|---|
pid |
metaweb_int |
C |
{{campaign.name}} |
af_siteid |
{{site_source_name}} |
af_c_id |
{{campaign.id}} |
af_adset |
{{adset.name}} |
af_adset_id |
{{adset.id}} |
af_ad |
{{ad.name}} |
af_ad_id |
{{ad.id}} |
Exemplo de um URL resultante:
https://www.example.com?pid=metaweb_int&c={{campaign.name}}&af_siteid={{site_source_name}}&af_c_id={{campaign.id}}&af_adset={{adset.name}}&af_adset_id={{adset.id}}&af_ad={{ad.name}}&af_ad_id={{ad.id}}
Atenção
A Meta anexa automaticamente fbclid={{fbclid}} ao URL de destino quando o anúncio é clicado.
Observação
Para simplificar a análise da campanha, inclua o tipo de campanha (web ou mobile) como um prefixo ou sufixo no nome da campanha. Exemplo: campaign-name_web.
Veja também
- Para conferir as práticas recomendadas sobre como criar o URL do seu anúncio com todos os parâmetros relevantes, leia o artigo Sobre a identificação de fontes de tráfego.
Etapa 3: Selecione eventos monitorados
Use a seção Rastreamento para selecionar os eventos de conversão promovidos pelo seu anúncio. Você pode configurar eventos através do Gerenciador de Eventos.
Importante!
Não escolha Eventos do aplicativo. Ao fazer isso, a Meta reivindicará essas conversões por meio da SRN API, podendo desalinhar relatórios e otimizações.
Visualizar dados de atribuição web
Veja o que esperar ao revisar seus dados de atribuição após a configuração:
- Dashboard: No dashboard cross-platform, os dados da web e do aplicativo são apresentados lado a lado, oferecendo uma visão unificada da performance de campanhas em todas as plataformas.
-
As exportações de dados brutos e respostas da API incluem a Meta Web no campo
media_sourcepara a atividade web da Meta.
Mensurar os dados de atribuição web com os custos da web
Você pode ter uma visão completa da performance dos dados de atribuição web e dos dados de custo do Meta Ads no dashboard e nos relatórios do Cost ETL. Para fazer isso, verifique se você tem o pacote ROI360 e conclua a configuração a seguir:
- Conecte custos ao aplicativo do seu site via
facebook_int(não viametaweb_int) da aba Custos ou da página Configurações de custo. Para mais informações sobre como conectar custos, leia o artigo Configure a ROI360 cost API para mensurar dados de custo. - Inclua o ID da campanha (
af_c_id) no URL da landing page. Certifique-se de que o URL inclua toda a hierarquia da campanha para visualizar custos, cliques e impressões correspondentes à atribuição web no nível mais granular.
Características e limitações
| Caraterística | Observações |
|---|---|
| Cliques e impressões | Cliques e impressões para campanhas na web exigem uma assinatura do ROI360. |
| Reengajamento | No momento, os postbacks de reengajamento via CAPI não são compatíveis. |
Veja também