Configuração de integração do Meta Ads

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.

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:

  1. No Meta ads, acesse o dashboard do aplicativo.
  2. Em Aplicativos, clique em Criar novo aplicativo.
  3. 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:

  1. No Meta ads, acesse o dashboard do aplicativo.
  2. Clique no aplicativo necessário.
  3. Clique no ID do aplicativo, que aparece na parte superior esquerda da tela, para copiá-lo.

    FB-app-id-2-blur.png

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:

 Assista
 Leia
  1. Para ativar a integração com os anúncios do Meta:
    1. Vá para seus aplicativos no Meta para desenvolvedores.
    2. Selecione o aplicativo.

      FB-for-devs-app-selecrion-en_us.png

    3. Para copiar a ID do aplicativo, clique nela na parte superior da tela.

      FB-for-devs-app-ID-copy-en_us.png

    4. Na AppsFlyer, em Configuração, vá para Marketplace de parceiros
    5. Pesquise por Meta Ads e selecione-o.
    6. Clique em Configurar integração. Você é direcionado para a página de configuração da integração.
    7. Na aba Integração, habilite Ativar parceiro.
      Observação: A alavanca deve permanecer habilitada (ativada) enquanto você trabalhar com o parceiro.
    8. Em Configurações gerais:

      meta_ads_general_settings2.png

      • Cole a ID do aplicativo no campo ID do aplicativo do Facebook.
      • Cole a chave de install referrer decryption do Meta Ads
    9. Clique em Save Integration (Salvar integração).
  2. [opcional] Defina as configurações recomendadas:

    meta_ads_install_attribution.png

    • 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.

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.

 Assista
 Leia

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:

  1. Faça login no portal do desenvolvedor do Meta.
  2. Navegue até Meus aplicativos no canto superior direito.
  3. Selecione o aplicativo para o qual você gostaria de acessar sua chave de descriptografia.
  4. Navegue até Configurações > Básico no lado esquerdo da página.

  5. 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:

  1. [Obrigatório] Verifique se o SDK da AppsFlyer V5.4+ é a versão utilizada em seu aplicativo. Não utilize versões anteriores.
  2. Na AppsFlyer, vá para Configuração > Integrações ativas.
  3. Selecione Meta ads.
    meta_ads_general_settings2.png
  4. 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.
  5. Clique em Salvar integração.

Custo, cliques e impressões

meta_cost_tab.png

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:

  1. 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.
  2. Acesse a aba Custo.
  3. Ative Obter dados de Custo, Cliques e Impressões.
  4. Clique no botão f login.
  5. 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

In-app_event_postbacks_en-us.png

 

Para mapear eventos in-app:

  1. 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.
  2. 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.
  3. 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.

  1. Ative o retargeting na página Configurações do aplicativo .
  2. Na página de parceiro dos anúncios do Meta, ative a atribuição de reengajamento.
  3. 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.

    re-engagement_attribution_toggle.png

  4. Habilite a atribuição de view-through de reengajamento.
  5. 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.

    re-engagement_view-through_toggle.png

  6. 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.

    re-engagement_window.png

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

mceclip0.png

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:

  1. Na aba Receita de anúncios , defina Obter dados de receita de anúncios como ATIVO.
  2. 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 evento af_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.
  3. 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.
  4. 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.
  5. Insira a ID do aplicativo Audience Network (ID do aplicativo do Facebook). Você pode obtê-la no Audience Network do Meta.
  6. 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

A ID do aplicativo do Facebook foi configurada incorretamente na AppsFlyer.
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.

fb-app-status.png

Tipo incorreto de campanha do Meta ads

Certifique-se de que a campanha do Meta ads seja para anúncios de instalação de aplicativos mobile ou engajamento no aplicativo mobile. Para outros objetivos de campanha (por exemplo, clique no link para landing pages), para conseguir mensurar instalações mobile, o anunciante deve marcar a opção registro de evento do aplicativo ao definir a campanha do Meta ads.

Instalação de aplicativos com o Meta ads

Ao configurar uma campanha de instalação de aplicativo no Meta ads, é possível selecionar o aplicativo em uma lista suspensa ou colar a URL completa da loja no aplicativo. Enquanto ambas as opções funcionam no Meta ads, o segundo método falha na atribuição da AppsFlyer.

Configuração correta – atribuição funciona.

fb-app-install.png

Configuração incorreta – atribuição falha.

fb-app-incorrect_setup.png

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.