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

Desde 29 de outubro de 2021, apenas relatórios agregados estão disponíveis para os anunciantes. Isso significa que os dados de atribuição de view-through e de click-through aparecem como "restritos" nos relatórios de dados brutos. Outros campos relacionados com a fonte de mídia não são preenchidos. Ver 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 habilidades 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 analíticos.

API de Referência de Instalação do Google Play

Embora os dados a nível do usuário sejam restritos, o Meta Ads compartilha metadados de campanha com anunciantes para anúncios de aplicativos Android que direcionam para a Google Play Store. Nesse contexto, os campos de atribuição estão disponíveis para os anunciantes na Google Play Install Referrer API, que deve ser integrada ao seu aplicativo. Os campos fornecidos através da Google Play install referrer API preenchem os relatórios de dados brutos da AppsFlyer com o tipo de correspondência . Isso só está disponível após o envio da chave de descriptografia e depois que a instalação é atribuída ao Meta ads. Isso permite que a AppsFlyer atribua usuários que não têm um ID de publicidade (habilitado para LAT).

Referenciador da instalação

Além da Google Play install referrer API, o install referrer do Meta permite que a AppsFlyer receba metadados de campanha de anúncios do armazenamento local de um dispositivo. Esses dados são usados para a mensuração de atribuição. As principais diferenças entre a Google Play install referrer API e o install referrer do Meta são:

• O install referrer do Meta pode incluir dados de impressão e de clique, enquanto a Google Play install referrer API está limitada aos dados de clique
• O install referrer do Meta pode incluir dados de várias sessões, enquanto a Google Play install referrer API está limitada apenas aos dados da última sessão (o dispositivo tem que instalar o aplicativo na mesma sessão em que ocorreu o clique)

Como resultado, você pode ver um aumento nas instalações atribuídas ao Meta em relatórios de dados brutos. Quando uma instalação é atribuída através da Google Play install referrer API ou do install referrer do Meta, os dados estão disponíveis em relatórios de dados brutos. Os campos que podem estar disponíveis para atribuição por meio do install referrer do Meta preenchem os relatórios de dados brutos da AppsFlyer com o tipo de correspondência fb_referrer para a atribuição do aplicativo do Facebook e ig_referrer para a atribuição a partir do aplicativo do Instagram. Isso só está disponível quando a chave de descriptografia é submetida e uma instalação é atribuída ao Meta ads. A chave de descriptografia do install referrer do Meta é a mesma chave usada para o Google Play install referrer e não precisa ser fornecida à AppsFlyer uma segunda vez.

Campos de atribuição de campanha disponíveis por meio do referrer:

• Ad ID
• Nome do anúncio
• Adset ID
• Nome do Adset
• Campaign ID
• Nome da campanha
• Account ID
• Canal

Install referrer do Meta – Perguntas frequentes

Em que casos o install referrer se aplica à atribuição?

• Para atribuição de instalação:
  • Atribuição de click-through, para todas as campanhas
  • A atribuição de view-through é compatível com todas as campanhas de aplicativos Advantage+ e campanhas manuais de promoção de aplicativos com uma segmentação ampla (por exemplo, em que a idade e o gênero estão definidos como padrão).

• Compatibilidade: Google Play Store e lojas de aplicativos Android que não sejam do Google Play
• Exceções: não inclui campanhas que redirecionam para landing pages

Para que a "segmentação ampla" é usada no Meta ads?

A segmentação ampla é necessária para receber dados de view-through. A configuração de campanha inclui:

• Idade: Padrão (18-65+)
• Género: Padrão (todos os gêneros)
• Localização: Grupos de países e países. Atenção: Para localizações mais específicas (como cidades ou códigos postais), as campanhas que usam a segmentação por inclusão têm de ser definidas como flexíveis.
• Segmentação detalhada: Os segmentos de interesse, os comportamentos e os dados demográficos avançados são definidos como flexíveis.
• Audiências personalizadas: definidas como flexíveis.
• Para "flexível", deve ser selecionada a opção "Advantage detailed targeting" para campanhas de anúncios:

Dados criptografados da Google Play Referrer API ou do install referrer do Meta

Os dados da Google Play Referrer API ou do install referrer são criptografados pelo Meta. Estes dados podem ser descriptografados usando uma chave disponível na 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 tiver sido excluída, há alguns casos em que o Meta Ads ainda é atribuído para a instalação com base no referrer, mesmo sem os campos de atribuição da campanha (mencionados na lista acima). Isso acontece quando:

• O Meta Ads não reivindicou a instalação
• Os dados recebidos da Google Play Referrer API foram recebidos, mas não foram descriptografados
• Esse foi o último clique

Para obter sua chave de descriptografia do Meta:

1. Faça login no seu portal de 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: Observação: essa é 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. Evite confiar em versões anteriores.
2. Na AppsFlyer, vá para o menu lateral e selecione Colaborar > Integrações ativas.
3. Selecione Meta ads.
4. Na aba Integração, cole a chave em Chave de descriptografia do install referrer. Isso deve ser feito apenas uma vez por aplicativo.
5. Clique em Salvar integração.

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.

Atenção: os dados sobre cliques e impressões estão incluídos na integração. No entanto, os dados de custos requerem uma assinatura do ROI360.

Para ativar a Cost API:

1. Faça 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ões para executar todas as campanhas no Meta Business Manager.
2. Acesse a aba Custo.
3. Ative a opção para obter dados de custos, cliques e impressões.
4. Clique no botão fazer login. Você pode fazer login com uma conta business ou admin do Meta ads.
5. Quando solicitado, permita que a AppsFlyer acesse os dados de suas campanhas do Meta.
   Observação: Na primeira sincronização de dados após a integração, assim como nas sincronizações subsequentes, a AppsFlyer recebe dados do Anúncios da Meta por até 7 dias retroativamente.

Saiba mais sobre como o Meta ads define cliques e visualizações.

Para excluir uma conta do Meta Ads conectada: Na coluna ações, passe o mouse sobre uma conta, clique em Remover conexão.

Status de sincronização dos dados de custo

Veja o status da Cost API e a última vez que a AppsFlyer conseguiu extrair os 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.

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.

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 fb_mobile_activate_app.
2. Preencha os seguintes parâmetros:

   Nome do parâmetro	Descrição
   Evento AppsFlyer	O nome do evento, conforme recebido do SDK integrado no aplicativo ou de eventos de servidor para servidor. Dica: não encontrou o evento que está procurando? Certifique-se de ativar o evento em um dispositivo com uma instalação não orgânica e verifique novamente. Digite-o em Evento da AppsFlyer, depois clique em Criar personalizado. Leia mais sobre o mapeamento de eventos personalizados.
   mapeado para evento do 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: Campo de texto:obtenha o ID do evento correspondente no Anúncios da Meta. Caixa suspensa: selecione o evento predefinido mais adequado. Sem alterações: envie os eventos como eles estiverem, sem mapeamento de nomes.
   para 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.
   incluindo	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 S2S à lista, clique em Adicionar evento.

Limitações relacionadas aos nomes de eventos:

• Limitação do tamanho dos nomes de eventos: 2 a 40 caracteres 
• Os seguintes caracteres não são permitidos:
  • Dois pontos (:)
  • Ponto (.)
  • Conjuntos de caracteres não latinos (ingleses): desde o dia 12 de janeiro de 2020, o Meta ads rejeita caracteres chineses. A AppsFlyer não testou outros conjuntos de caracteres e você deve usá-los somente depois de verificar com o Meta ads se há suporte para esses conjuntos de caracteres em postbacks.  
• Os nomes dos eventos são sensíveis a 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 do aplicativo.

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 do Meta ads, ative a atribuição de reengajamento.
3. Configure a janela de lookback de reengajamento por click-through.
   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.
   
4. Ative 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). Esse é o período de tempo que se inicia com a impressão do anúncio, durante a qual o aplicativo deve ser iniciado para que a impressão seja registrada como um reengajamento. re-engagement_view-through_toggle.png/span>
6. Defina 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.

Quando o compartilhamento avançado de dados está ativo, o Meta recebe postbacks e eventos com identificadores a nível de dispositivo para todos os dispositivos, incluindo dispositivos que não tornaram seu advertising ID (IDFA) disponível.

Além disso, quando o compartilhamento avançado de dados está ativado, a AppsFlyer atribui esses eventos. Quando desativado, apenas postbacks e eventos de dispositivos com um IDFA são enviados e atribuídos.

Esse método atribui dispositivos com opt-out simples e duplo. Aplica-se a reengajamentos de deep link no iOS e instalações por clique no iOS com base na atribuição de último clique, com uma janela de atribuição máxima de 24 horas.

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 permitir a conformidade com a CCPA: Ative a opção Limitar a utilização de informações pessoais dos usuários pelo Anúncios da Meta (CCPA) na aba Integração.

Saiba mais sobre as leis de proteção de dados.

Se seu aplicativo usa Audience Network Ad Revenue do Meta para monetização de anúncios, é possível registrar 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.

Registrar a receita de anúncios do Audience Network do Meta

1. Na aba Receita de anúncios , ative Obter dados de receita de anúncios.
2. Selecione o tipo de dados de receita de anúncios que você deseja receber. Receitas atribuídas e/ou Dados agregados de receitas de monetização:
   • Receita atribuída: Ou seja, receita com base na fonte de aquisição do usuário.
     Configure a Fonte do evento, que é o evento que representa seu modelo de receita de anúncios da melhor forma 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.
   • Dados agregados de receita de monetização: Receita baseada na fonte do anúncio.
3. O evento receita 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 ativar a coleta da receita de anúncios do Audience Network do Meta. Faça login com suas credenciais do Meta ads para autorizar a receita de anúncios do Audience Network.
5. Insira o Audience Network App ID (Facebook App ID). Obtenha-o no Meta Audience Network.
   • Obtenha o Facebook App ID.
   • Copie o ID no campo Audience Network App ID na AppsFlyer.
6. Clique em Salvar receita de anúncio.

Ative o Meta 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.

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.

Nota: A atribuição da SKAdNetwork não é afetada pela disponibilidade do IDFA. No entanto, certifique-se de ativar a opção de campanha do iOS 14 no Meta ads ao configurar campanhas do iOS 14.

O aplicativo deve ser definido no Meta ads como Live em vez de In development para que a atribuição funcione.

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 – a atribuição funciona.

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