Visão geral: saiba como integrar os anúncios do Meta com a AppsFlyer
Guia de configuração de anúncios no Meta
Quanto tempo leva para começar a atribuir seus anúncios de aplicativos mobile do Meta ads com a AppsFlyer?
Se você já tem o SDK da AppsFlyer integrado em seu aplicativo e já definiu seu aplicativo no Meta ads, a resposta é: menos de um minuto!
Não é necessário implementar o Login do Facebook ou integrar seu aplicativo com o SDK do Facebook para realizar a atribuição mobile. Basta seguir as instruções do passo a passo da configuração abaixo. Depois, confira as opções de configuração avançada para o Meta ads.
Leitura relacionada
Para ter uma visão completa do trabalho com anúncios do Meta na AppsFlyer, confira estes artigos:
- Configuração de integração do Meta Ads (este artigo)
- Mapeamento de eventos in-app do Meta Ads
- Interoperação da SKAN com o Meta ads
- Perguntas frequentes sobre os anúncios do Meta (geral / custo / SDK /atribuição)
- Discrepâncias dos anúncios do Meta
- Configuração de Meta campaign management partners (Bidalgo) / Kenshoo / Adquant / Webpals)
- Configuração do Instagram
- Atribuir instalações de aplicativos a anúncios não mobile
ID do aplicativo do Facebook
Para integrar os anúncios do Meta com a AppsFlyer, primeiro crie um ID de aplicativo do Facebook e depois o recupere.
Para criar um ID do aplicativo do Facebook:
- No Meta ads, acesse o dashboard do aplicativo.
- Em Aplicativos, clique em Criar novo aplicativo.
- Preencha o nome do seu aplicativo e insira um namespace exclusivo. Certifique-se de adicionar a plataforma correta para seu aplicativo. Caso contrário, as instalações podem não ser atribuídas corretamente.
Para recuperar a ID do aplicativo do Facebook:
- No Meta ads, acesse o dashboard do aplicativo.
- Clique no aplicativo necessário.
-
Clique no ID do aplicativo, que aparece na parte superior esquerda da tela, para copiá-lo.
A AppsFlyer atribui dados por ID do aplicativo. O mesmo ID de aplicativo do Facebook pode ser usado para aplicativos Android e iOS. Observe que, para iOS 14+, os anúncios do Meta limitam as contas de anúncios a nove contas por aplicativo.
Configuração básica de atribuição do Meta ads
Para iniciar a atribuição das campanhas do Meta Ads com a AppsFlyer, siga as etapas abaixo:
-
Para ativar a integração com os anúncios do Meta:
- Vá para seus aplicativos no Meta para desenvolvedores.
- Selecione o aplicativo.
- Para copiar a ID do aplicativo, clique nela na parte superior da tela.
- Na AppsFlyer, em Configuração, vá para Marketplace de parceiros.
- Pesquise por Meta Ads e selecione-o.
- Clique em Configurar integração. Você é direcionado para a página de configuração da integração.
- Na aba Integração, habilite Ativar parceiro.
Observação: A alavanca deve permanecer habilitada (ativada) enquanto você trabalhar com o parceiro. - Em Configurações gerais:
- Cole a ID do aplicativo no campo ID do aplicativo do Facebook.
- Cole a chave de install referrer decryption do Meta Ads.
- Clique em Save Integration (Salvar integração).
- [opcional] Defina as configurações recomendadas:
- Para fazer a correspondência com a janela de lookback de click-through do Meta Ads, defina-a para 7 dias.
(lembre-se de que existem alguns casos específicos em que o padrão é diferente). - Para corresponder à janela de lookback de visualização dos anúncios do Meta, defina-a para um dia.
- Para atribuir usuários que reinstalam o aplicativo durante a janela de reatribuição, ative a atribuição de reinstalação.
Você não precisa habilitar a atribuição de exibição ou configurar janelas de lookback para atribuição de reinstalação, pois ela leva sua configuração a partir das configurações de atribuição de instalação.
- Para fazer a correspondência com a janela de lookback de click-through do Meta Ads, defina-a para 7 dias.
Ainda não está vendo resultados na AppsFlyer? Consulte a Solução de problemas de integração do Meta Ads.
Configuração avançada de atribuição do Meta ads
Com a atribuição básica já configurada para o Meta ads, é hora de algumas configurações rápidas e avançadas de atribuição.
Dados em nível de usuário
Desde 29 de outubro de 2021, apenas os relatórios agregados estão disponíveis para os anunciantes. Isso significa que os dados de atribuição de visualização e de cliques aparecem como “restritos” nos relatórios de dados brutos. Outros campos relacionados à fonte de mídia não são preenchidos. Veja Restrição de conteúdo de dados brutos.
Isso se aplica a todos os anunciantes, sistemas operacionais e MMPs. Além disso, também se aplica aos dados a nível do dispositivo para todos os usuários do iOS e Android, independentemente do status de consentimento à ATT ou da personalização dos anúncios.
A AppsFlyer continua a receber dados do Meta ads no nível do dispositivo, o que significa que nossas capacidades de atribuição e geração de relatórios (incluindo atribuição multi-touch, LTV, ROI, chort, relatórios de retenção, proteção contra fraudes, Audiences e outros serviços) permanecem inalteradas. Veja ferramentas de relatórios agregados e analytics.
Como obter dados no nível do usuário para instalações do Android?
Embora os dados em nível de usuário sejam restritos, o Facebook Ads compartilha metadados de campanha com anunciantes para anúncios de aplicativos Android direcionados à Google Play Store. Nesse caso, os campos de atribuição estão disponíveis para os anunciantes no referenciador da instalação do Google, que deve ser integrado ao seu aplicativo. Os campos fornecidos por meio do referenciador preenchem os relatórios de dados brutos da AppsFlyer disponíveis para você assim que a chave de descriptografia é enviada e uma instalação é atribuída aos anúncios do Meta. Isso permite que a AppsFlyer atribua usuários que não têm um ID de publicidade (habilitado para LAT). Observe que o campanhas de redirecionamento do Google Play não é aplicável a campanhas de retargeting.
Campos de atribuição de campanha disponíveis por meio do referenciador:
- ID do anúncio
- Nome do anúncio
- ID do conjunto de anúncios
- Nome do conjunto de anúncios
- ID da campanha
- Nome da campanha
- ID da conta
- Canal
Observação
- O SDK da AppsFlyer deve ser V5.4.0+ para que os dados do referenciador sejam transmitidos corretamente. Os dados do referenciador têm prioridade sobre os dados fornecidos pela API e não são restritos. Essa solução se aplica à atribuição de cliques e não à atribuição de exibição.
- O campo Canal é determinado pelo valor do canal recebido da API do referenciador do Google Play (enviado ao Google Play pelo Meta). Se uma string vazia for recebida, o campo Canal mostrará "Nenhum".
Dados criptografados da API do referenciador do Google Play
Os dados no referenciador são criptografados pelo Meta e são descriptografados usando uma chave disponível para você em sua conta de desenvolvedor do Meta. Você deve nos fornecer a chave de descriptografia descrita nas ações necessárias. A chave de descriptografia precisa ser enviada apenas uma vez por aplicativo.
Observe que, se a chave não for fornecida ou for excluída, há alguns casos em que os anúncios do Meta ainda são atribuídos para a instalação com base no referenciador, mesmo sem os campos de atribuição da campanha (mencionados na lista acima). Isso acontece quando:
- Os anúncios do Meta não reivindicaram a instalação
- Os dados recebidos da API do referenciador de instalação do Google Play foram recebidos, mas não decodificados
- E este foi o último clique
Para obter sua chave de descriptografia do Meta:
- Faça login no portal do desenvolvedor do Meta.
- Navegue até Meus aplicativos no canto superior direito.
- Selecione o aplicativo para o qual você gostaria de acessar sua chave de descriptografia.
-
Navegue até Configurações > Básico no lado esquerdo da página.
- Vá até a seção Android e você verá sua chave de descriptografia chamada Chave de descriptografia do referenciador da instalação (Install Referrer decryption key) abaixo do campo Nomes do pacote (Package Names). Observação: esta é a mesma seção na qual você configurou o nome do pacote e a Google Play Store.
Para definir a chave de descriptografia na AppsFlyer:
- [Obrigatório] Verifique se o SDK da AppsFlyer V5.4+ é a versão utilizada em seu aplicativo. Não utilize versões anteriores.
- Na AppsFlyer, vá para Configuração > Integrações ativas.
- Selecione Meta ads.
- Na aba Integração, cole a chave em Chave de descriptografia do referenciador da instalação. Isso deve ser feito apenas uma vez por aplicativo.
- Clique em Salvar integração.
Custo, cliques e impressões
Essa integração fornece dados agregados sobre custo, cliques e impressões para suas campanhas, conjuntos de anúncios, anúncios e regiões geográficas/países. Consulte a tabela de integração de custos da ad network para obter detalhes completos sobre as dimensões, métricas e recursos compatíveis.
Observação: os dados sobre cliques e impressões estão incluídos na integração. No entanto, os dados de custo exigem uma assinatura ROI360.
Para ativar a API de custo:
- Certifique-se de fazer o login na sua conta de usuário do Meta ads, que está habilitada para gerenciar as campanhas da conta no Meta ads. O login deve ser feito com um usuário que tem permissão para executar todas as campanhas no Meta Business Manager.
- Acesse a aba Custo.
- Ative Obter dados de Custo, Cliques e Impressões.
- Clique no botão f login.
- Quando solicitado, permita que a AppsFlyer acesse os dados de suas campanhas do Meta ads.
Observação: na primeira sincronização de dados após a integração, assim como nas sincronizações subsequentes, a AppsFlyer recebe dados de custo do Meta ads até os últimos 7 dias retroativamente.
Saiba mais sobre como o Meta ads define cliques e visualizações.
Para excluir uma conta conectada do Meta ads: na coluna ações, passe o mouse sobre uma conta e clique em Excluir conexão.
Observações
- Se você já estiver conectado ao Meta ads, quando clicar no botão f login, a janela abre e fecha imediatamente. Esse é um comportamento padrão.
- Se você tiver vários usuários com permissões para o Meta ads, recomendamos que você faça o login para todos eles, para evitar receber dados parciais.
Status de sincronização dos dados de custo
Veja o status da API de custo e a última vez que a AppsFlyer conseguiu extrair dados de custo correspondentes no dashboard de status da integração de custo (e receita publicitária) ou no painel individual da ad network.
Você pode sincronizar várias contas para extrair dados de custo. Para cada conta sincronizada, a AppsFlyer exibe o status da integração de custo e a última vez que foi feita a extração dos dados de custo correspondentes.
Saiba mais sobre como enriquecer seus dados com dados de custo, cliques e impressões.
Mapeamento de eventos in-app

Para mapear eventos in-app:
- Ative Postbacks de eventos in-app.
Ao habilitar o mapeamento de eventos in-app no Meta ads para um aplicativo pela primeira vez, af_app_open é automaticamente mapeado para session_start. - Preencha os seguintes parâmetros:
Nome do parâmetro Descrição Evento AppsFlyer O nome do evento, conforme recebido pela AppsFlyer do SDK integrado no aplicativo ou de eventos de servidor para servidor.
Dica: não encontrou o evento que está procurando?- Lembre-se de ativar o evento em um dispositivo com uma instalação não orgânica e verifique novamente.
- Digite-o em Evento AppsFlyer, depois clique em Criar personalizado. Leia mais sobre o mapeamento de eventos personalizados.
mapeado para evento parceiro O nome ou ID exclusivo de cada evento, conforme definido no Meta Ads As configurações de mapeamento possíveis são:
- Campo de texto: obtenha o ID do evento correspondente no Meta ads.
- Caixa drop-down: selecione o evento AppsFlyer pré-definido mais adequado
- Como está: envie os eventos como eles estiverem, sem o mapeamento de nomenclaturas.
para usuários de Selecione a opção de envio para o evento:
- Somente este parceiro: envie postbacks somente quando esse evento for atribuído ao Meta Ads.
- Todas as fontes da mídia, incluindo a orgânica: enviar postbacks para eventos atribuídos a qualquer parceiro e eventos orgânicos.
Incluir - Nenhum dado (padrão): enviar somente o evento em si sem o valor do evento.
- Valores e receita: enviar todos os parâmetros do evento, incluindo o valor da receita (se existir no evento).
- Valores sem receita: envie todos os parâmetros excluindo o valor da receita.
- Para adicionar um evento SDK ou servidor para servidor à lista, clique em Adicionar evento.
Limitações relacionadas aos nomes de eventos:
- Limitação de comprimento dos nomes dos eventos: 2-40 caracteres
- Os seguintes caracteres não são permitidos:
- Dois pontos (:)
- Ponto final (.)
- Conjuntos de caracteres não latinos (inglês): desde o dia 12 de janeiro de 2020, os anúncios do Meta rejeitam caracteres chineses. A AppsFlyer não testou outros conjuntos de caracteres e você deve usá-los somente depois de verificar com os anúncios do Meta se há suporte para esses conjuntos de caracteres em postbacks.
- Os nomes de eventos diferenciam letras maiúsculas e minúsculas. Para evitar discrepâncias, use o nome do evento correto para todas as fontes de mídia e versões de aplicativos.
Saiba mais sobre o mapeamento de eventos in-app de anúncios do Meta.
Atribuição de retargeting
A atribuição de retargeting da AppsFlyer para Meta ads permite que os anunciantes atribuam o engajamento de um usuário existente com um anúncio do Facebook e mensurem a qualidade do usuário, pós-engajamento, usando os relatórios da AppsFlyer. Ela deve ser usada somente se você estiver executando ativamente campanhas direcionadas a seus próprios usuários do Facebook.
- Ative o retargeting na página Configurações do aplicativo .
- Na página de parceiro dos anúncios do Meta, ative a atribuição de reengajamento.
- Configure a janela de lookback de reengajamento por clique.
Que é o período de tempo que se inicia com o clique no anúncio, durante o qual o aplicativo deve ser iniciado para que o clique seja registrado como um reengajamento.
Selecione as unidades da janela de lookback (horas ou dias) e defina a barra deslizante para o valor desejado. - Habilite a atribuição de view-through de reengajamento.
-
Defina o controle deslizante da janela de lookback de exibição de reengajamento para o valor desejado (até 24 horas). Este é o período de tempo a partir de uma impressão de anúncio, durante o qual o aplicativo deve ser iniciado para que a impressão seja registrada como um reengajamento.
- Configure a Janela de reengajamento.
Este é o período em que os eventos in-app do usuário são atribuídos à fonte de mídia de retargeting como fonte principal.
Você pode definir o valor em dias (1 a 90), horas (até 23) ou até mesmo por tempo vitalício. O padrão é 30 dias.
Saiba mais sobre a atribuição de retargeting da AppsFlyer.
Saiba mais sobre usuários de deep link de SRNs como o Meta ads.
Cumprir com a Lei de Privacidade do Consumidor da Califórnia (CCPA)
O cumprimento dos regulamentos de privacidade da CCPA limita os dados provenientes de usuários do Meta ads com sede na Califórnia, EUA.
Para habilitar a compliance com a CCPA: ative Limitar o uso do Meta ads sobre informações pessoais dos usuários (CCPA) na aba Integração.
Saiba mais sobre as leis de proteção de dados.
Gravação de receita de anúncios
Se seu aplicativo usa o Meta Audience Network Ad Revenue para monetização de anúncios, é possível acompanhar suas receitas do Meta ads na AppsFlyer. É possível, com ou sem os dados de receitas de compras in-app, ter uma visão completa das receitas de seus usuários.
Para começar a registrar a receita de anúncios do Audience Network do Meta:
- Na aba Receita de anúncios , defina Obter dados de receita de anúncios como ATIVO.
- Selecione o tipo de dados de receita de anúncios agregados que você deseja receber: receita atribuída e/ou receita de monetização agregada:
-
Receita atribuída: com base na fonte de aquisição do usuário.
Defina a Origem do evento, que é o evento que representa o modelo de receita de anúncios da melhor maneira possível. Por exemplo, se sua receita for baseada em impressões, é recomendável enviar à AppsFlyer um evento ad_viewed. O melhor evento pode ser configurado separadamente para cada plataforma de monetização. No entanto, também é possível usar o eventoaf_app_opened
. Nesse caso, a receita de anúncios é atribuída para cada vez que o usuário abrir o aplicativo. - Receita de monetização agregada: com base na fonte do anúncio.
-
Receita atribuída: com base na fonte de aquisição do usuário.
- O evento de eceita de anúncios é exibido. É um campo somente de leitura, que apresenta o novo evento de receita de anúncios chamado [source event]_monetized (por exemplo, Ad_Watched_Monetized, conforme exibido abaixo). O evento de receita de anúncios é apresentado no dashboard como um evento adicional.
- Clique em Conectar ao Meta ads para habilitar a coleta do Meta Audience Network Ad Revenue no Meta ads. Faça login com suas credenciais do Meta ads para autorizar o Meta Audience Network Ad Revenue.
- Insira a ID do aplicativo Audience Network (ID do aplicativo do Facebook). Você pode obtê-la no Audience Network do Meta.
- Obtenha a ID do aplicativo do Facebook.
- Copie o ID no campo ID do aplicativo Audience Network na AppsFlyer.
- Clique em Salvar receita do anúncio.
Permissões
Ative os anúncios do Meta para executar várias ações e acessar seus dados de acordo com as permissões disponíveis.
Saiba mais sobre como conceder permissões a parceiros integrados.
Solução de problemas de integração de anúncios do Meta
Se você concluiu a integração básica e ainda não consegue ver os resultados do Meta ads no dashboard da AppsFlyer, verifique se você tem novas instalações do Meta ads desde a integração.
Se sim, consulte os principais motivos abaixo para resolver o problema:
Nenhuma coleta de IDFA
Conforme indicado no Guia de integração do SDK - iOS, você deve adicionar o AdSupport.framework ao seu projeto para que a coleta do IDFA ocorra. Verifique o relatório de dados brutos de instalações para ver se a coluna do IDFA está vazia ou não. Recomenda-se que seu aplicativo colete IDFA no caso de aplicativos iOS e GAID no caso de aplicativos Android.
A partir do iOS 14.5, será necessário exibir o prompt da ATT da Apple e obter o consentimento do usuário antes de poder coletar o IDFA.
Observação: a atribuição da SKAdNetwork não é afetada pela disponibilidade do IDFA. No entanto, certifique-se de habilitar o botão da campanha do iOS 14 em anúncios do Meta ao configurar as campanhas do iOS 14.
ID do aplicativo do Facebook incorreto
Verifique se o ID do aplicativo está correto e corresponde ao valor no painel do anúncios do Meta.
Observação - você também pode usar a Graph API do Facebook para validar o seu ID do aplicativo do Facebook.
Status do aplicativo no Meta ads
O aplicativo deve ser definido no Meta ads como Live em vez de In development para que a atribuição funcione.
Tipo incorreto de campanha do Meta ads
Instalação de aplicativos com o Meta ads
Configuração correta – atribuição funciona.
Configuração incorreta – atribuição falha.
Atualizações dos anúncios do Meta
Importante!
Desde 29 de outubro de 2021, apenas relatórios agregados dos anúncios do Meta estão disponíveis para os anunciantes. Isso inclui instalações e eventos in-app. Essa alteração se aplica a todos os anunciantes, sistemas operacionais e MMPs. Isso se aplica aos dados a nível do dispositivo para todos os usuários do iOS e Android, independentemente do status de consentimento à ATT ou da personalização dos anúncios.
Os dados brutos para instalações e eventos in-app enviados antes dessa mudança (29 de outubro de 2021) continuam disponíveis.
Observe que os dados a nível do usuário podem ser recebidos por meio do Google Install Referrer.
Veja o boletim de notícias para mais detalhes.
Atualizações do iOS 14 relacionadas a anúncios do Meta
A AppsFlyer se assegura de que a nossa integração de MMP com o Meta ads sempre implemente o sinalizador Advertiser Tracking Enabled. Ou seja, você não precisa executar nenhuma ação na AppsFlyer. Essas informações são oferecidas de acordo com a lista de fevereiro de 2021 de diretrizes do iOS 14 para aplicativos do Meta ads.
Leitura relacionada: interoperabilidade da SKAdNetwork com a AppsFlyer. Consulte este artigo para assuntos relacionados a campanhas no iOS 14.