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

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 a nível do usuário sejam restritos, o Facebook Ads compartilha metadados de campanha com anunciantes para anúncios de aplicativos do Android que direcionam os usuários para a Google Play Store. Nesse caso, os campos de atribuição estão disponíveis para anunciantes no Google Install Referrer, que deve ser integrado ao seu app. Os campos fornecidos pelo referenciador preenchem os relatórios de dados brutos da AppsFlyer disponíveis depois que a chave de descriptografia é enviada e uma instalação é atribuída ao Facebook Ads. Isso permite que a AppsFlyer atribua usuários que não têm um ID de anúncio (habilitado para LAT). 

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.
   

   

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.

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.

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.

Para mapear eventos in-app:

1. Ative os 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
   Nome do evento do SDK	O nome do evento, conforme recebido pela AppsFlyer por meio do SDK integrado no aplicativo ou por meio de eventos de servidor para servidor. Dica - não está encontrando o evento desejado na lista? Certifique-se de ativar o evento em um dispositivo com uma instalação não-orgânica e verifique novamente. Você também pode digitar o nome do evento, clicar em Criar personalizado e fazer o mapeamento normalmente. Leia mais sobre o mapeamento de eventos personalizados.
   Identificador de evento do parceiro	Selecione a tag de evento predefinida para Facebook mais adequada ao seu evento. Você também pode enviar eventos PERSONALIZADOS do Facebook.
   Opção de envio	Selecione a opção de envio para o evento: Esse parceiro corresponde apenas a eventos que têm origem  a partir de usuários atribuídos ao Facebook Ads. Todas as fontes de mídia, inclusive orgânicas,para que toda a sua base de usuários esteja disponível para ser reportada ao Facebook Ads.
   Enviar receita	Sem valores e sem receita: envia apenas o próprio evento sem o valor do evento. Com valores e sem receita: envia todos os parâmetros excluindo o valor da receita. Com valores e com receita: envia todos os parâmetros do evento, incluindo o valor da receita (caso ela exista no evento).

3. Para adicionar um evento SDK à 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.

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.
   

   

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

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

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.

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).
   • Obtenha a ID do aplicativo do Facebook.
   • Copie o ID no campo ID do aplicativo Audience Network na AppsFlyer.
6. Clique em Salvar receita do anúncio.

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.