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

Visão geral: saiba como integrar o Facebook Ads com a AppsFlyer

Guia de configuração de anúncios do Facebook

Quanto tempo leva para começar a atribuir seus anúncios de aplicativos móveis do Facebook com a AppsFlyer?

Se você já tem o SDK da AppsFlyer integrado em seu aplicativo e já definiu seu aplicativo no Facebook, 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 Facebook.

ID do aplicativo do Facebook

Para integrar o Facebook Ads na AppsFlyer, primeiro, crie um Facebook App ID, e depois o recupere. 

Para criar um ID do aplicativo do Facebook:

  1. No Facebook, acesse seu Dashboard de aplicativos.
  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 Facebook, acesse seu Dashboard de aplicativos.
  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+, o Facebook Ads limita o número de contas de anúncios para nove contas por aplicativo.

Configuração básica de atribuição do Facebook

Para começar a atribuir campanhas do Facebook com a AppsFlyer, siga os passos abaixo:

 Assista
 Leia
  1. Para ativar a integração com o Facebook Ads:
    1. Acesse seus aplicativos no Facebook 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, acesse Configuração > Parceiros integrados.
    5. Selecione Facebook Ads na lista de parceiros.
    6. Na aba de Integração, habilite Ativar parceiro.

      Activating-integration-with-FB-en_us.png

      Saiba mais sobre a ativação de parceiros.
    7. Cole a ID do aplicativo no campo ID do aplicativo do Facebook.
    8. Clique em Save Integration (Salvar integração).
  2. [opcional] Para definir as configurações recomendadas:

    FB-recommanded-settings-en_us.png


    1. Para corresponder à janela de lookback de cliques do Facebook Ads, defina-a para 7 dias.
      (Observe que existem alguns casos específicos em que o padrão é diferente).
    2. Para corresponder à janela de lookback de exibição do Facebook Ads, defina-a para um dia.
    3. 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.
    4. Para salvar a configuração, clique em Salvar integração.

Ainda não está vendo os resultados do Facebook na AppsFlyer? Consulte a solução de problemas de integração do Facebook Ads.

Configuração avançada de atribuição do Facebook

Com a atribuição básica já configurada para o Facebook, é 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 recebendo dados a nível de dispositivo do Facebook, o que significa que nossas habilidades de atribuição e de gerar relatórios (incluindo atribuição multitoque, LTV, ROI, cohort, relatórios de retenção, proteção contra fraudes, Audiences e outros serviços) permanecem inalterados. Saiba mais em ferramentas de análise e de relatórios agregados.

Como obter dados a 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 da campanha com os anunciantes de anúncios de aplicativos Android que direcionam para a Google Play Store. Neste caso, campos de atribuição estão disponíveis para os anunciantes no Google Install Referrer, que deve ser integrado ao seu aplicativo. Os campos fornecidos através do referrer povoam os relatórios de dados brutos da AppsFlyer disponíveis para você uma vez que a chave de descriptografia é enviada e uma instalação é atribuída aos Anúncios do Facebook. Isto permite ao AppsFlyer atribuir usuários que não possuem um ID de publicidade (habilitado para LAT). Note que o Google Play Install Referrer não é aplicável a campanhas de redirecionamento.

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

Atenção! A versão do SDK da AppsFlyer deve ser 5.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.  

Os dados do referenciador são criptografados pelo Facebook e descriptografados usando uma chave disponível para você em sua conta de desenvolvedor do Facebook. 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 tiver sido excluída, há alguns casos em que o Facebook Ads ainda é atribuído para a instalação com base no referenciador, mesmo sem os campos de atribuição da campanha (mencionados na lista acima). Isso acontece quando:

  • O Facebook Ads não reivindicou a instalação
  • O referenciador da instalação do Facebook foi recebido, mas não foi decodificado
  • E esse foi o último clique.

Para obter sua chave de descriptografia do Facebook:

  1. Faça login no seu portal de desenvolvedor do Facebook.
  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, acesse Configuração >Parceiros integrados.
  3. Selecione Facebook.

    FB-for-install-referrer-decryption-key2.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 dados de impressões

fb-cost-tab.png

Habilitar o recurso Custo para Facebook possibilita que você obtenha os dados de custos para suas campanhas, conjuntos de anúncios, anúncios e níveis de canais do Facebook. Também possibilita que você obtenha cliques agregados completos e os dados de impressões correspondentes. 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 de custo exigem uma assinatura do Xpend. 

Para ativar a API de custo:

  1. Certifique-se de fazer login em sua conta de usuário do Facebook, que está habilitada para gerenciar as campanhas da conta no Facebook. O login deve ser feito com um usuário que tem permissões para executar todas as campanhas no Facebook Business Manager.
  2. Acesse a aba Custo.
  3. Ative Obter dados de Custo, Cliques e Impressões.
  4. Clique no botão de login do Facebook.
  5. Quando solicitado, permita que a AppsFlyer acesse os dados de suas campanhas do Facebook.
    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 Facebook até os últimos 7 dias retroativamente.

Leia mais sobre como o Facebook define cliques e visualizações.

Para excluir uma conta conectada do Facebook: na coluna ações, passe o mouse sobre uma conta e clique emExcluir conexão.

 Observações

  • Se você já estiver conectado ao Facebook, ao clicar no botão de Login do Facebook, a janela do Facebook abre e fecha imediatamente. Esse é um comportamento padrão.
  • Se você tiver vários usuários com permissões para o Facebook, o melhor a se fazer é fazer login do Facebook para todos eles, de modo a evitar obter 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 de anúncios) ou no dashboard individual da ad network.

O Facebook permite sincronizar várias contas para extração de dados de custo. Para cada conta sincronizada, a AppsFlyer exibe o status da integração de custo e a última vez que a AppsFlyer extraiu dados de custo correspondentes.

Saiba mais sobre como enriquecer suas informações do Facebook 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 Facebook 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 Facebook. As configurações de mapeamento possíveis são:

    • Campo de texto: obtenha a identificação do evento correspondente no Facebook
    • 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: enviar postbacks somente quando este evento for atribuído ao Facebook.
    • 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, o Facebook rejeita caracteres chineses. A AppsFlyer não testou outros conjuntos de caracteres e você deve usá-los somente depois de verificar com o Facebook 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 do Facebook Ads.

Atribuição de retargeting

A atribuição de retargeting para Facebook da AppsFlyer permite que os anunciantes atribuam um engajamento existente de um usuário com um anúncio no Facebook e meçam 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 no Facebook.

  1. Ative o retargeting na página Configurações do aplicativo.
  2. Na página de parceiros do Facebook Ads, 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 uma janela de lookback em horas ou dias e configure a barra deslizante para o valor desejado.
  4. 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.

    facebook_reengagement_attribution.png

Saiba mais sobre a atribuição de retargeting da AppsFlyer.

Saiba mais sobre usuários de deep link de SRNs como o Facebook.

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 Facebook com sede na Califórnia, EUA.

Para habilitar a conformidade com a CCPA: habilite Limitar o uso do Facebook sobre informações pessoais dos usuários (CCPA) na aba Integração.

Saiba mais sobre a conformidade com CCPA.

Gravação de receita de anúncios

mceclip0.png

Se seu aplicativo usa a Receita de anúncios do Facebook Audience Network para monetização de anúncios, é possível registrar suas receitas do Facebook 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 Facebook Audience Network:

  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 Facebook para ativar a coleta de Receita de Anúncios do Audience Network do Facebook. Faça login com suas credenciais do Facebook para autorizar a Receita de Anúncios do Audience Network do Facebook.
  5. Insira a ID do aplicativo Audience Network (ID do aplicativo do Facebook). Você pode obtê-la no Facebook Audience Network (FAN).
  6. Clique em Salvar receita do anúncio.

Permissões

Ative o Facebook Ads 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 com o Facebook Ads

Se você concluiu a integração básica e ainda não consegue ver os resultados do Facebook no dashboard da AppsFlyer, verifique se você tem novas instalações do Facebook 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 ativar o botão da campanha do iOS 14 no Facebook ao configurar campanhas do iOS 14.

ID do aplicativo do Facebook incorreto

O ID do aplicativo do Facebook foi configurado na Appsflyer.
Verifique se o ID do aplicativo está correto e se corresponde ao valor presente no dashboard do Facebook Ads.

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 Facebook

O aplicativo deve ser definido no Facebook como Ao vivo em vez de Em desenvolvimento para que a atribuição funcione.

Make_Test_App_Public.png

Tipo de campanha do Facebook incorreto

Certifique-se de que a campanha do Facebook 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 Facebook.

Instalação do aplicativo do Facebook

Ao configurar a campanha de instalação de aplicativo do Facebook, é possível selecionar o aplicativo em uma lista suspensa ou colar o URL completo da loja no aplicativo. Embora ambos funcionem para você no Facebook, o segundo método falha a atribuição da AppsFlyer. 

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

how_to_set_campaign_FB.png

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

how_not_to_set_a_campaign_on_Facebook.png

 

Atualizações do Facebook Ads

 Importante!

Desde 29 de outubro de 2021, apenas os relatórios agregados do Facebook Ads 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 ao Facebook

A AppsFlyer confirma que nossa integração de MMP com o Facebook sempre implementa o sinalizador Rastreamento de anunciantes habilitado. 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 Facebook.

Leitura relacionada: interoperabilidade da SKAdNetwork com a AppsFlyer. Consulte este artigo para assuntos relacionados a campanhas no iOS 14. 

Este artigo foi útil?