Resumo: Use campanhas web do Meta Ads para atribuir conversões web-to-app partir do Meta Ads
Visão geral
A AppsFlyer é compatível com a integração com o Meta Ads (metaweb_int) para campanhas baseadas na web, permitindo que você reporte dados de atribuição e conversão diretamente por meio da Conversion API (CAPI) do Meta. Os dados são então usados pelo Meta Ads para otimizar a segmentação de anúncios, mensurar a performance e construir audiências personalizadas.
Atenção
Atualmente, a integração com o Meta Web não oferece suporte para o envio de postbacks de reengajamento para a CAPI.
Pré-requisitos
Antes de ativar a integração do Meta Ads, certifique-se de que você possui uma conta comercial no Meta Business Manager.
Como criar uma campanha web no Meta Ads
Esse artigo contém informações relevantes e um passo-a-passo sobre como configurar uma campanha web no Meta Ads para mobile, PC e apps de console com a AppsFlyer. Assim, vamos explicar como configurar a integração entre Meta Ads e AppsFlyer, como definir a configuração da campanha em ambas as plataformas e como criar landing pages com o Smart Script ou Smart Banners do OneLink.
O processo de configuração inclui as seguintes etapas obrigatórias:
- Configurar a integração do Meta Web Ads na AppsFlyer (obrigatório)
- Configurar a integração da AppsFlyer no Meta Ads (obrigatório)
E as seguintes etapas opcionais:
- Crie uma página inicial com o OneLink Smart Script (opcional)
- Crie uma página inicial com os banners inteligentes do OneLink (opcional)
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 o CAPI.
1. Ative a integração do Meta Web Ads
Para ativar a integração do Meta Web Ads:
- Na AppsFlyer, no menu lateral, acesse Colaborar > Partner Marketplace.
- Pesquise por Meta Ads e selecione-o.
- Clique em Configurar a integração. Você será direcionado para a página de configuração de Integrações ativas.
- Na aba Integração selecione Ativar parceiro. Atenção: O botão deve permanecer ativado (ligado) enquanto trabalhar com o parceiro.
- Desative a Privacidade avançada (se você estiver configurando uma integração de aplicativos iOS).
- Preencha o campo Pixel ID. Você pode recuperar o ID do pixel do seu Meta Ads Manager:
- No menu lateral do Ads manager, vá para 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 ID do pixel 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 de informações pessoais dos usuários no Meta Ads (CCPA) para ativar a complicance com as leis de proteção de dados. Atenção: O cumprimento dos regulamentos de privacidade da CCPA limita os dados provenientes de usuários do Anúncios da Meta com sede na Califórnia.
2. Ative a atribuição de view-through
A AppsFlyer oferece suporte para a atribuição de view-through através de campanhas Meta Web usando um Smart Script ou uma landing page habilitada para Smart Banner. Isso permite a atribuição de instalação de aplicativos por modelagem probabilística (PMOD), que é acionada por impressões de anúncios, mesmo quando os usuários não clicam diretamente no anúncio.
Quando um usuário clica em um anúncio do Meta Web e acessa uma landing page habilitada para Smart Script ou Smart Banner, a AppsFlyer pode atribuir a instalação do aplicativo mais adiante. Se disponível, fbclid será incluído no postback enviado para o Meta, para garantir a confiança na atribuição.
Para habilitar a atribuição de view-through para Meta Web:
- Na AppsFlyer, no menu lateral, abra Integrações Ativas > anúncios de Meta web.
- Em Integração, vá até a seção Atribuição de instalação.
- Ative a Atribuição de instalação por view-through.
- [opcional] Ative a Prioridade de atribuição equitativa entre plataformas e defina sua janela de lookback. Para mais informações, veja o artigo Ativar prioridade equitativa para impressões entre plataformas.
- Clique na aba link de atribuição.
- Vá até Atribuição de view-through e defina a janela de lookback de view-through desejada (de até 24 horas).
- Clique em Salvar integração para aplicar suas configurações.
3. Configurar postbacks de eventos in-app
Atualmente, as instalações são os únicos eventos que acionam postbacks padrão automáticos para o Meta Ads. Para outros tipos de eventos, você pode criar postbacks personalizados mapeando eventos da AppsFlyer para eventos do Meta Ads, que podem ser visualizados no Meta Events Manager.
Para definir os postbacks de eventos in-app, faça o seguinte:
- Ative Postbacks de eventos in-app.
- Se necessário, defina a janela de postback de eventos in-app (leia mais sobre a configuração da janela de postback de eventos in-app em geral neste artigo).
- Clique em Adicionar evento para adicionar um evento à lista.
- Na coluna de eventos da AppsFlyer, selecione o nome do evento na caixa suspensa. A AppsFlyer recebe o nome do evento do SDK integrado ao seu aplicativo ou dos eventos de servidor para servidor.
- Na coluna mapeado para o evento do parceiro, selecione na caixa suspensa o evento de parceiro predefinido mais adequado ou selecione PERSONALIZADO.
- Na coluna oara usuários de, selecione a opção de envio para o evento:
- Apenas este parceiro: enviar postbacks apenas quando este evento for atribuído a Meta Ads.
- Todas as fontes de mídia, incluindo orgânicas: envie postbacks para eventos atribuídos a qualquer parceiro e eventos orgânicos.
-
Na coluna including, selecione se os eventos serão enviados com os valores de receita. Dados a incluir nos postbacks
Atenção
Se você estiver configurando um evento de compra, defina a coluna including para Values and revenue. Selecionar qualquer outra opção fará com que o postback falhe.
- [Opcional] Clique no ícone Adicionar condição para definir condições para um evento.
- Clique em Guardar Integração.
- [Opcional] Após salvar a integração, você pode integrar mais aplicativos com o parceiro em questão:
- No canto superior esquerdo clique no nome do aplicativo para abrir a lista de aplicativos.
- Selecione um aplicativo diferente a partir da lista suspensa.
- Repita as etapas de integração para o aplicativo selecionado.
Configurar a integração da AppsFlyer no Meta Ads
Execute as próximas etapas no Meta Ads Manager.
1. Defina o tipo, o objetivo e as 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 o Meta faça a otimização visando um evento específico (seu principal KPI).
- Tráfego: Isso permite que o Meta faça a otimização visando cliques em anúncios. Essa opção só deve ser usada se você não possui outros KPIs, ou se o volume de outros eventos de KPI for muito baixo.
- [Opcional] Se você quiser adicionar um objetivo personalizado às opções acima, 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 em Meta Ads.
-
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 de eventos mapeados para parceiros) e nomeie-o com o mesmo nome da ação de conversão no Meta Ads.
Atenção
Para saber mais sobre os objetivos da campanha no Meta, consulte a documentação da Meta.
- Em Local de conversão, selecione Website.
- Em Pixel, insira o mesmo ID de pixel que você inseriu para
metaweb_intno Marketplace de parceiros da AppsFlyer. Para saber mais sobre o Meta Pixel, consulte a documentação do Meta (é necessário fazer login). - Clique em Próximo.
2. Definir URL de destino
-
Em Destination, na URL do site, insira a URL que serve como destino para seu anúncio. A URL deve ser para um dos seguintes:
-
Uma página inicial na web: O uso de uma página inicial é recomendado quando:
- Você tem um aplicativo em várias plataformas.
- Você deseja usar a landing page para fornecer mais informações sobre o produto anunciado.
- Você quer usar a página de destino para coletar mais dados.
Para todos esses casos de uso, crie uma landing page com um Smart Script ou um Smart Banner.
-
Links de atribuição da AppsFlyer: O uso de links de atribuição da AF (OneLink, plataforma única ou multiplataforma) é recomendado quando você deseja que o usuário seja redirecionado diretamente para a loja para baixar o aplicativo sem antes visitar uma página inicial.
Importante!
Às vezes, o uso de links de atribuição de AF pode levar a erros. Se isso ocorrer, peça uma solução aos representantes da Meta ou simplesmente use uma página de destino da web como URL de destino.
-
- Clique em Criar um parâmetro de URL para adicionar os parâmetros de URL ao URL (seja um URL de página de destino ou um link de atribuição de AF).
-
Em Parâmetros personalizados, clique em Adicionar parâmetro
-
Mapeie os parâmetros da AppsFlyer de acordo com seus valores do Meta.
-
Se a URL de destino for uma landing page, um link de atribuição do OneLink ou um link de atribuição de plataforma única, mapeie os seguintes parâmetros da AF para os equivalentes no Meta:
Parâmetro AF Valor mapeado no Meta pidmetaweb_intc{{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}}Um exemplo do URL resultante deve ser:
https://app.appsflyer.com/{app_id}?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}}&af_r={https://Add-your-store-url.com}- Se o APK do seu aplicativo NÃO estiver hospedado na Google Play Store, adicione o parâmetro
af_re mapeie-o para a URL da loja, por exemplo,https://Add-your-store-url.com
- Se o APK do seu aplicativo NÃO estiver hospedado na Google Play Store, adicione o parâmetro
-
Se a URL de destino for um PC ou uma loja de console, crie o link seguindo as instruções na tabela abaixo. Para informações adicionais, consulte: Links de atribuição direta da plataforma CTV, PC e console
Estrutura do link de atribuição URL base engagements.appsflyer.com/v1.0/c2s/click/app/ Parâmetros de caminho obrigatórios - platform
Exemplo: steam - app_id
Exemplo: 123456
Parâmetros de consulta obrigatórios - af_media_source
- af_campaign_id
- af_r
Outros parâmetros Ver todos os parâmetros Estrutura da URL https://engagements.appsflyer.com/v1.0/c2s/click/app/{platform}/{app_id}?af_media_source={media_source}&af_campaign_id={campaign_id}&af_r={app_store_url}Mapeie os seguintes parâmetros da AppsFlyer para seus equivalentes Meta:
Parâmetro AF Valor mapeado do Meta af_media_sourcemetaweb_intaf_campaign{{campaign.name}}af_siteid{{site_source_name}}af_campaign_id{{campaign.id}}af_adset{{adset.name}}af_adset_id{{adset.id}}af_ad{{ad.name}}af_ad_id{{ad.id}}Um exemplo de URL multiplataforma:
https://engagements.appsflyer.com/v1.0/c2s/click/app/steam/123456?af_media_source=metaweb_int&af_campaign_id={{campaign.id}}&af_campaign={{campaign.name}}&af_adset={{adset.name}}&af_adset_id={{adset.id}}&af_ad={{ad.name}}&af_ad_id={{ad.id}}&af_r=https%3A%2F%2Fstore.steampowered.com%2Fapp%2F440%2FTest_app2%2F%3Futm_term%3Dhello - platform
Atenção
O Meta adiciona
fbclid={{fbclid}}à URL de destino automaticamente quando o anúncio é clicadoDica
Para simplificar a análise da campanha, inclua o tipo de campanha, (web ou mobile) como um prefixo ou sufixo no nome da campanha (por exemplo, nome-da-campanha_web)
-
Atenção
Para obter um guia abrangente sobre os parâmetros do link de AF, consulte Parâmetros do link de atribuição.
3. Selecione eventos monitorados
Use a seção Rastreamento para selecionar os eventos de conversão promovidos pelo seu anúncio (a configuração dos eventos é feita por meio do Gerenciador de Eventos).
Importante!
Certifique-se de não escolher Eventos de aplicativos, pois o Meta reivindicará essas conversões usando a SRN API, o que pode causar desalinhamentos de relatórios e de otimização.
Crie uma landing page com o OneLink Smart Script
Jornada do usuário: O usuário clica em um anúncio Meta e é direcionado para seu site mobile. Ele chegam a uma página com botões de CTA, solicitando que ele faça download do seu aplicativo de uma ou mais plataformas. Clicar no botão redireciona o usuário para a loja.
Fluxo de dados de ponta a ponta
- O URL do anúncio do Meta inclui o parâmetro
pid=metaweb_int. Quando o usuário clica no anúncio, um parâmetrofbclidé automaticamente anexado ao URL clicado. - O usuário é redirecionado para o destino da URL - uma página de destino contendo um script inteligente.
- Quando a página inicial é carregada, o Smart Script envia uma impressão para a AppsFlyer contendo os parâmetros de URL de entrada. A impressão permitirá a atribuição de visualização completa na página inicial da web. Para saber mais sobre impressões e atribuição de visualizações, clique aqui.
- O Smart Script gera os URLs de saída para os botões de CTA na página com base nos parâmetros do URL de entrada, incluindo o parâmetro
fbclid. Os botões podem levar a:- Google Play e App Store por meio de um link de atribuição do OneLink.
- Lojas de várias plataformas (por exemplo, CTV, Epic e Steam). Nesse caso de uso, o Smart Script gera um único link de atribuição de plataforma para cada plataforma, levando à loja da plataforma especificada.
- Baixando um arquivo APK para o dispositivo do usuário.
- Quando o usuário clica no botão CTA, o clique é acionado e registrado na AppsFlyer.
- O usuário é redirecionado para a loja e baixa o aplicativo.
- Quando o usuário abre o aplicativo, o evento de instalação é registrado na AppsFlyer.
- A AppsFlyer atribui a instalação com base em modelagem probabilística ou deterministicamente se um referenciador de instalação estiver disponível.
- Um postback contendo os
fbclidparâmetros e outros parâmetros do evento é gerado e enviado ao Meta por meio da API CAPI. O Meta usa o parâmetrofbclidpara identificar o clique específico, enquanto os outros parâmetros ajudam a otimizar a campanha.
Configurar uma página inicial do Smart Script
Para configurar suas campanhas do Meta Ads, faça o seguinte:
- Configure o template para os links de atribuição do OneLink da campanha. Para obter mais informações, consulte Como criar templates do OneLink.
-
Crie um script inteligente. Para mais informações, consulte Como criar um Smart Script do OneLink.
Atenção
As instruções abaixo correspondem às etapas específicas necessárias para configurar uma campanha do Meta Ads com o Smart Script. Para um guia abrangente sobre como configurar campanhas de Smart Script, consulte Como criar um Smart Script do OneLink no artigo de configuração do OneLink Smart Script V2.
- Certifique-se de que todos os parâmetros de URL relevantes sejam anexados ao URL de entrada. Para revisar os parâmetros anexados ao URL de entrada, abra o Meta Ads Manager e verifique os parâmetros de URL definidos durante a criação do URL de destino. Para mais informações, consulte: Configurar URL de destino.
- Mapeie os parâmetros de URL de entrada necessários para a campanha de Meta Ads com os parâmetros de URL de saída que serão enviados à AppsFlyer quando o usuário clicar no botão CTA:
-
PID: Certifique-se de que o Smart Script pegue o valor do parâmetro
pid=metaweb_intda URL de entrada e o mapeie para os parâmetros correspondentes na URL de saída. -
FBCLID: O parâmetro
fbclidé essencial para enviar com sucesso postbacks de eventos in-app para o Meta. O mapeamento do parâmetro FBCLID da URL de saída depende da sua versão do Smart Script:- SDK versão 2.8.1 e superior O parâmetro
fbclidé encaminhado automaticamente para o parâmetro de URL de saída quando presente na URL de entrada, eliminando a necessidade de mapeamento manual. - Versão 2.8.0 e inferior: O parâmetro
fbcliddeve ser mapeado manualmente na seção de mapeamento de parâmetros de URL da página do Smart Script:- Em Mapeamento para, selecione parâmetro personalizado.
- Em parâmetro de URL de saída e parâmetros de URL de entrada, insira fbclid.
Atenção
Para exibir nos relatórios de dados brutos da AppsFlyer, o
fbclidparâmetro de entrada também deve ser mapeado (além do parâmetro de saídafbclid) para um dos parâmetros de saída.af_sub[1-5]Para mais informações, consulte Facebook FBCLID. - SDK versão 2.8.1 e superior O parâmetro
-
PID: Certifique-se de que o Smart Script pegue o valor do parâmetro
Configurar uma landing page multiplataforma do Smart Script
Para configurar suas campanhas do Meta Ads com o smart script para páginas de destino multiplataforma, faça o seguinte:
- Configure o template para os links de atribuição do OneLink da campanha. Para obter mais informações, consulte Como criar templates do OneLink.
- Ative seu template do OneLink para atribuição multiplataforma, veja aqui.
- Certifique-se de que todos os parâmetros de URL relevantes sejam anexados ao URL de entrada. Para revisar os parâmetros anexados ao URL de entrada, abra o Meta Ads Manager e examine os parâmetros de URL definidos durante a criação do URL de destino. Para obter mais informações, consulte Definir URL de destino.
- Decida para cada parâmetro de entrada o parâmetro de saída para o qual ele será mapeado. Por exemplo,
af_site_ido URL de entrada será mapeado para o URLaf_site_idde saída. - Decida o valor padrão para os parâmetros de saída obrigatórios que não podem estar vazios.
- Envie ao desenvolvedor as seguintes informações:
- Seu mapeamento de parâmetros de entrada e saída. O desenvolvedor criará um script que gera um URL direto de saída com base no mapeamento de parâmetros de entrada e saída.
- Os valores padrão dos parâmetros. O script preencherá os parâmetros de URL de saída com os valores padrão sempre que não houver valores de parâmetros de URL de entrada correspondentes.
- Se você estiver usando um link de atribuição do OneLink, envie o ID do domínio e do modelo para seu desenvolvedor. O desenvolvedor usa isso para criar o URL de saída do OneLink. Por exemplo:
yourbrand.onelink.me/A1b2exemplo de domínio de marca:click.yourbrand.com/A1b2 - Envie ao seu desenvolvedor os seguintes links do Dev Hub:
- Exemplos de instruções e códigos sobre como criar URLs diretos de saída para plataformas não móveis.
- Uma demonstração e instruções para criar uma página inicial multiplataforma.
-
Lembre seu desenvolvedor de incluir o parâmetro de entrada
fbclidna URL de saída.Atenção
Para exibir nos relatórios de dados brutos da AppsFlyer, o
fbclidparâmetro de entrada também deve ser mapeado (além do parâmetro de saídafbclid) para um dos parâmetros de saída.af_sub[1-5]
Crie uma página inicial com os Smart Banners do OneLink
Jornada do usuário: O usuário clica em um anúncio Meta e é direcionado para seu site mobile. Eles chegam a uma página e um Smart Banner é exibido com um CTA para baixar o aplicativo na loja de aplicativos.
Fluxo de dados de ponta a ponta
- O URL do anúncio do Meta inclui o parâmetro
pid=metaweb_int. Quando o usuário clica no anúncio, um parâmetrofbclidé automaticamente anexado ao URL clicado. - O usuário é redirecionado para o destino da URL - uma página inicial que contém um Smart Banner.
- Quando a página inicial é carregada, o Smart Banner envia um evento de impressão para a AppsFlyer contendo os parâmetros do URL de entrada. Essa impressão permite a atribuição de view-through para a landing page. Para saber mais sobre atribuição de impressões e de view-through, clique aqui.
- O Smart Banner gera a URL de saída para o botão CTA no banner. O URL de saída é baseado nos parâmetros do URL de entrada, incluindo o parâmetro
fbclid. O Smart Banner pode gerar somente links baseados no OneLink. - Quando o usuário clica no botão CTA do Smart Banner, o clique é acionado e registrado na AppsFlyer.
- O usuário é redirecionado para a loja e baixa o aplicativo.
- Quando o usuário abre o aplicativo, o evento de instalação é registrado na AppsFlyer.
- A AppsFlyer atribui a instalação com base em modelagem probabilística ou deterministicamente se o referenciador de instalação estiver disponível.
- Um postback contendo os
fbclidparâmetros e outros parâmetros do evento é gerado e enviado ao Meta por meio da API CAPI. O Meta usa o parâmetrofbclidpara identificar o clique específico, enquanto os outros parâmetros ajudam a otimizar a campanha.
Configurar uma página inicial de Smart Banners
Para configurar suas campanhas de Smart Banners do Meta Ads, faça o seguinte:
- Configure o template para os links de atribuição do OneLink da campanha. Para obter mais informações, consulte Como criar templates do OneLink.
-
Como criar um Smart Banner
Atenção
As instruções abaixo correspondem às etapas específicas necessárias para configurar uma campanha do Meta Ads com Smart Banners. Para obter um guia abrangente sobre como configurar campanhas de Smart Banners, consulte a seção de configuração do artigo Smart Banners —mobile web-to-app (para profissionais de marketing).
- Defina os parâmetros do Smart Banner para campanhas do Meta Ads:
- Certifique-se de que todos os parâmetros de URL relevantes sejam anexados à URL de entrada. Mais importante ainda,
pid=metaweb_intefbclidestão disponíveis na URL de entrada para permitir que o Smart Banner os colete. Esses dois parâmetros são necessários para atribuição e envio de postbacks para o Meta Ads. Para revisar os parâmetros que são anexados ao URL de entrada, abra o Meta Ads Manager e examine os parâmetros de URL definidos durante a criação do URL de destino, consulte: Configurar URL de destino.
- Certifique-se de que todos os parâmetros de URL relevantes sejam anexados à URL de entrada. Mais importante ainda,
Veja os dados de atribuição de web-to-app
Embora os eventos de conversão baseados na web sejam enviados para a Meta sob o PID original metaweb_int, eles são relatados no dashboard da AppsFlyer e nos relatórios de dados brutos com o PID Facebook Ads. Isso se aplica tanto a eventos de conversão primários quanto a eventos de assistência de conversão.
Essa visão unificada permite que você analise a performance de campanhas na web e no app em um só local, incluindo relatórios completos de custos na web e no mobile.
Ver no dashboard
Todas as atribuições de web-to-app do Meta aparecem sob Facebook Ads nos dashboards de Visão Geral e de Atividade. Isso fornece uma visão única e consolidada dos resultados da campanha em várias plataformas. Use filtros e análises padrão para comparar o tráfego do app e da web dentro dos seus dados do Meta Ads.
Ver em dados brutos e relatórios da API
-
Exportações de dados brutos e respostas da API incluem o PID
Facebook Adsno campomedia_sourcepara a atividade web do Google. Para verificar os detalhes da configuração da campanha web, consulte o campooriginal_url, que mostrametaweb_intcomo o PID usado durante a criação de campanhas web. -
Relatórios de postback mostram
metaweb_intcomo a fonte de mídia original para a qual o postback foi enviado.
Perguntas frequentes
Por que estou vendo instalações e eventos in-app atribuídos ao Meta Ads (Facebook Ads) em vez do Meta Web (metaweb_int)?
Quando você configurou o evento rastreado no Meta Ads, você o definiu como um evento de aplicativo em vez de um evento da web. Certifique-se de defini-lo como um evento da web.
Características e Limitações
| Características | Observações |
|---|---|
| Custo, cliques e dados de impressões | Dados de custo, cliques e impressões para Meta Ads Web (
|