Interoperação da SKAN com o Facebook Ads

Visão geral: a interoperabilidade permite que o Facebook compartilhe conosco dados da SKAN decodificados e, assim, podemos compartilhar seus bits de mensuração de CV (mapeamento) com o Facebook Ads.

Interoperabilidade da SKAN: AppsFlyer <-> Facebook

Se você trabalha com vários parceiros de ad networks, recomendamos que você os configure na AppsFlyer. Assim, as métricas de performance da SKAN, enriquecidas com outras métricas como custo, estarão disponíveis através da plataforma da AppsFlyer. 

Leitura relacionada: Guia de soluções da AppsFlyer para SKANetwork

Escopo da interoperabilidade da SKAN com o Facebook

A interoperação com o Facebook permite que:

  • A AppsFlyer e Facebook compartilhem o esquema do valores de conversão (CV) da SKAN, o que permite que ambos forneçam métricas de performance.
  • A AppsFlyer é compatível com todos os objetivos de campanhas do Facebook Ads, o que permite as otimizações das campanhas:
    • Instalação do aplicativo mobile (MAI)
    • Engajamento no aplicativo mobile (MAE)
    • Otimização do valor (VO)
  • Após ativar a integração da SKAN, ocorre o seguinte: 
    • O SDK do Facebook para de atualizar o SKAN CV (kill switch).
    • O SDK da AppsFlyer atualiza o CV.
    • O Facebook compartilha os dados de postback da SKAN para inclusão no dashboard da SKAN e relatórios agregados.

Outras considerações: 

  • Se você não permitir a integração de parceiros da SKAN, no dashboard da SKAN, as instalações trazidas pelo Facebook são contadas como instalações orgânicas. 
  • No contexto da atribuição da AppsFlyer (dashboard de visão geral):
    • As instalações de usuários consentidos trazidas pelo Facebook são atribuídas corretamente.
    • Os usuários que não consentem são atribuídos aos dados orgânicos. 
  • Implicações do iOS 14.5 nos relatórios de SRNs
  • Nossa integração de MMP com o Facebook sempre implementa o Advertiser Tracking Enabled flag (essa informação é fornecida de acordo com a lista de verificação do aplicativo do iOS 14 do Facebook, de fevereiro de 2021).

Considerações

  • Se a interoperabilidade estiver habilitada, cada vez que você mudar as configurações de mensuração na AppsFlyer, o Facebook pausa suas campanhas (Facebook guidance). Antes de habilitá-las, verifique se todos os eventos relevantes do sistema estão mapeados. Observação:
    • Não repita o procedimento de integração do MMP neste artigo. Ou seja, você não precisa copiar a URL de conexão com o MMP novamente. 
    • O Facebook tem a opção de Auto-unpause ads que retoma a campanha após 24 horas.
  • Na AppsFlyer, se você desativar a mensuração da SKAdNetwork, o Facebook não poderá mais obter o mapeamento de CV. 
  • SDK da AppsFlyer vs. SDK do Facebook: o SDK do Facebook é útil somente se você executar campanhas com o Facebook. Se você executar campanhas com vários parceiros, você pode visualizar os dados de todos os parceiros usando o SDK da AppsFlyer.
  • Revise a seção sobre discrepâncias neste artigo. 

Guia para anúncios de instalação de apps do Facebook

Ao configurar suas campanhas de instalação do aplicativo do iOS 14 no Facebook, leve em conta as seguintes orientações do Facebook

  • É permitido um máximo de 9 campanhas por aplicativo, cada uma com 5 conjuntos de anúncios. Os anunciantes podem executar essas 9 campanhas em 9 contas de anúncio por ID de aplicativo.
  • Você não precisa de uma conta separada para as campanhas no iOS 14. Você pode realizar campanhas no iOS 14 a partir de contas existentes.
  • Há uma relação entre o método de otimização do Facebook e o tipo de mensuração que você seleciona na AppsFlyer:
    • Mensuração de receita: VO e AEO 
    • Mensuração de conversão: AEO — Inclui eventos padrão do Facebook e evento de compra. Você deve mapear o evento do aplicativo na AppsFlyer para o evento relevante no Facebook. 

Procedimentos de interoperação

Complete os procedimentos abaixo para permitir a interoperação. 

Para a atribuição de instalação de aplicativos:

Permita que o Facebook compartilhe dados da SKAdNetwork com a AppsFlyer

Permita que o Facebook compartilhe os dados da SKAdNetwork com a AppsFlyer. Se você não fizer isso, você não verá as instalações da SKAdNetwork atribuídas ao Facebook no dashboard da SKAdNetwork da AppsFlyer. 

Este procedimento precisa ser realizado uma vez por aplicativo. 

Para conceder permissão ao Facebook para compartilhar dados da SKAdNetwork com a AppsFlyer:

  1. Na AppsFlyer, acesse Configuração > Parceiros integrados.
  2. Selecione Facebook.

    FacebookEnable.png

  3. Vá para a aba da SKAdNetwork.
  4. Clique em login no Facebook. A conta que você usa deve ser uma conta Admin ou Advertiser, que tenha:
  5. Siga as instruções na interface do usuário.
    Depois de completar o processo no Facebook, você retorna à AppsFlyer. 
  6. Verifique se o status da conta à espera de sincronização aparece.
    Esta mensagem será exibida até recebermos dados do Facebook.
  7. Espere até depois das 02:00 UTC do dia seguinte, depois verifique se o status muda para sucesso.
    Os dados no dashboard da SKAdNetwork são atualizados diariamente até as 08:00 UTC.
  8. Leia a seção sobre diferenças entre mensurações

Para a atribuição de eventos in-app:

Compartilhe o esquema de CV com o Facebook

SKAdNetwork-Facebook-AppsFlyer_integration__5_.png

Para permitir a interoperação na SKAdNetwork da AppsFlyer com o Facebook:
Etapa Ação Detalhes 

1

Pré-requisitos do aplicativo

2

Revisão das configurações da SKAdNetwork 

Verifique se a solução da SKAN da AppsFlyer está configurada e funcionando. Ao fazer isso, o SDK da AppsFlyer pode fazer uma chamada para as APIs da SKAdNetwork e definir o CV.

Para visualizar as configurações da SKAdNetwork:

  1. Na AppsFlyer, acesse Configuração > SKAN Conversion Studio.
  2. Clique no ícone de opções e verifique se a mensuração da SKAN está ativada.
    Measurement_mode_on_facebook_ads.png
  3. Selecione seu modo de mensuração preferido.
    Saiba mais sobre o SKAN Conversion Studio.
  4. Anote os nomes exatos dos eventos definidos. Você precisa deles para a próxima etapa. Observação: os nomes diferenciam maiúsculas e minúsculas.

3

Mapeamento de eventos in-app

Revise, e se necessário, faça mudanças em seus mapeamentos de eventos in-app no Facebook. 

Para visualizar e definir mapeamentos de eventos in-app:

  1. Na AppsFlyer, acesse Configuração > Parceiros integrados.
  2. Selecione Facebook.
  3. Acesse a aba de Integração.
  4. [Obrigatório] Ative Postbacks de eventos in-app.
    • Você deve mapear o tipo de mensuração selecionado para a SKAdNetwork. O tipo de mensuração padrão é receita.
      in-app_events_fb_en-us.png
    • Verifique se os eventos in-app que você define na mensuração da SKAdNetwork (evento da AppsFlyer) estão mapeados para identificadores de eventos no Facebook (mapeados para o evento do parceiro). Se você não mapear os eventos, o Facebook não poderá otimizar e contará apenas as instalações.

       Observação

      Ao adicionar, alterar ou remover um valor de conversão (CV) no SKAN Conversion Studio, certifique-se de que o evento seja mapeado nos postbacks de eventos in-app. Caso contrário, o CV não será atualizado no Facebook.

      Guia de mapeamento de eventos in-app
      Tipo de mensuração Requisitos de mapeamento
      Personalizada

      Mapeie os eventos in-app que você definir na área de "Custom" (personalizado) para os eventos correspondentes no Facebook.

      Para informar a receita por postback, você deve definir Send revenue para Values & revenue

      SendValueandRevenue.png

      af_skad_revenue é usado para a receita geral e mapeado para o evento de receita do Facebook, geralmente fb_mobile_purchase.

      Atenção! Você pode mapear mais de um evento para fb_mobile_purchase.

      Receita

      Se você relata a receita por meio de um postback enviado para as ad networks, verifique se os mapeamentos de postbacks de eventos in-app incluem os eventos de receita in-app definidos por você.

      af_skad_revenue é usado para a receita geral e mapeado para o evento de receita do Facebook, geralmente fb_mobile_purchase.

      Atenção! Você pode mapear mais de um evento para fb_mobile_purchase.

      Conversão Mapeie de 1 a 6 eventos de conversão para os eventos correspondentes do Facebook.
  5. Clique em Salvar integração.
  6. Vá até Configuração da SKAN e clique na URL de conexão MMP para copiá-la. Na próxima seção, informaremos onde colar a URL no Facebook.

    skan_configuration_mmp_url.jpg

4

Conectar a AppsFlyer ao Facebook
  1. No Facebook, abra o gerenciador de eventos.

    FacebookSkadNetworkSetup.jpg

  2. Vá para a aba Settings.

    mceclip0.png

  3. Na seção "Configure App Events for SKAdNetwork", clique em Set Up Events. 

    mceclip1.png

  4. Selecione Import from partner app (importar do app do parceiro).
    Depois, um campo no qual você pode colar a MMP Connection URL aparece. 
    Isso atualiza o Facebook com o mapeamento do CV e envia o comando para que o SDK do Facebook no seu aplicativo pare de configurar o CV. Se "import from partner app" for desativado—Troubleshoot.
  5. Siga as instruções na interface do usuário do Facebook. Uma das seguintes opções ocorre:
    1. Você cola o MMP Connection URL com sucesso na interface do usuário do Facebook. Parabéns! Você completou a integração. Leia as observações a seguir. 
    2. Colar o MMP connection URL falha, e uma mensagem de erro é exibida na interface do usuário do Facebook. Se for o caso:
      - Espere 24 horas, depois repita esse procedimento.
      - Se o erro persistir (mais de 24 horas), entre em contato com o suporte da AppsFlyer.

Observações

  • Você precisa realizar esse procedimento apenas uma vez. Ou seja, não há necessidade de copiar e colar a URL de conexão após alterar as configurações de mensuração na AppsFlyer. Por exemplo, se você mudar de mensuração da receita para a mensuração de conversão, o Facebook usa a URL existente para obter o esquema atual. 
  • A conclusão do procedimento permite que o Facebook obtenha o esquema de CV da AppsFlyer usando uma estrutura aleatória própria. Não é possível configurar isso de outra forma.
  • Leva até 24 horas para que as configurações de mensuração atualizadas entrem em vigor no Facebook. 

5

Configuração de campanha do iOS 14

No Facebook, verifique se a configuração da campanha do iOS 14 está ativada. 

Esta configuração pode ser encontrada na página de configuração New App installs Campaign

FBiOS14.png

Informações adicionais

Desativando a integração do SKAN

Ao desativar a integração do seu Facebook Ads, não é suficiente desabilitar o botão Ativar parceiro, você deve remover separadamente as conexões SKAN para interromper a gravação de dados SKAN.

Para desativar a integração da SKAN:

  1. Na AppsFlyer, acesse Configuração > Parceiros integrados.
  2. Selecione Facebook Ads.
  3. Vá para a aba SKAN.
  4. Clique no ícone de exclusão para a conta que você deseja remover.

Diferenças de mensuração e tempo entre a AppsFlyer e o Facebook

Considerações sobre a mensuração
Item Detalhes 
Nomes de eventos in-app 

Até 15 de agosto de 2021, os nomes dos eventos no dashboard usavam os nomes dos eventos do Facebook. Desde então, isso mudou. 

Modo receita para métricas de usuários convertidos

[Desativado em 16 de agosto de 2021].

No modo receita, a métrica de usuários convertidos (usuários pagantes) não considera o número de usuários que relatam a receita por meio de campanhas no Facebook. Isso se deve à convernção de nomenclatura de receitas mencionada na seção anterior (nomes de eventos in-app)

Disponibilidade de dados inicial

Na primeira sincronização de dados após a integração, assim como nas sincronizações subsequentes, a AppsFlyer recebe dados do Facebook por até 7 dias retroativamente.

Data de instalação 

A AppsFlyer e o Facebook determinam a data de instalação de formas diferentes. No caso:

  • Os postbacks da SKAdNetwork não possuem um timestamp de instalação. 
  • O Facebook considera a hora de chegada do postback como a hora da instalação, e considera o fuso horário do aplicativo no Facebook ao definir a data.
  • A AppsFlyer deriva o tempo de instalação de acordo com as configurações da janela de atividades. Nem o fuso horário do aplicativo nem o fuso horário da Conta de anúncios do Facebook são considerados no cálculo.
Atualização de dados
  • Coletamos dados da SKAdNetwork no Facebook às 01:00 UTC
  • Dashboards e atualização de dados agregados 7 horas depois.

Verificando a permissão de ads_read

A permissão ads_read fornece aos clientes do Facebook Ads o acesso da API a dados de performance de anúncios para uso em dashboards personalizados e análise de dados.

Para verificar se sua conta do Facebook Ads tem permissão ads_read:

  1. Vá para sua conta no Facebook developer account.
  2. Selecione um Facebook App ID.
  3. Vá até App Review > Permissions and Features.

    FBad_permission.png

  4. Verifique se ads_read tem o status ready for use. Se esse for o caso, nenhuma outra ação é necessária.
  5. Se você não tiver a permissão ads_read, você deve solicitá-la:
    1. Vá para App Review > Requests.
    2. Solicite a permissão ads_admin.
    3. Repita as etapas desse procedimento para verificar se você recebeu a permissão necessária.

Solução de problemas, discrepâncias e FAQ

Ação Detalhes 

O Facebook não consegue se conectar

Problema

No Facebook, se você receber a mensagem, we can't connect. Check that you're using the correct URL. If the problem continues, contact your partner app for help - Nós não conseguimos nos conectar. Verifique se você está usando a URL correta. Se o problema continuar, entre em contato com seu aplicativo parceiro para obter ajuda. - em tradução livre.

Solução

Na AppsFlyer, verifique se você ativou o mapeamento de eventos in-app e mapeou seus eventos da AppsFlyer para seus eventos do Facebook. (como descrevemos no mapeamento de eventos in-app na seção anterior) 

[Solução atualizada em 20 de abril de 2021].

Prioridade do evento

P: Como posso definir a prioridade do evento no Facebook?

R: Não há necessidade de estabelecer prioridades no Facebook. O recurso de prioridades está relacionado aos aplicativos que utilizam o SDK do Facebook para configurar o CV. No seu caso, o SDK da AppsFlyer configura o CV. Desconsidere a opção de prioridade no Facebook. A AppsFlyer mensura 6 eventos em conversão sem prioridades. 

[Solução atualizada em 20 de abril de 2021].

Ocorrências de eventos

P: Por que eu tenho mais eventos exibidos na AppsFlyer do que no Facebook?

R: O Facebook conta apenas 0-1 ocorrências de eventos. Portanto, mesmo se você definir mais ocorrências como parte de um intervalo, as ocorrências adicionais são contadas apenas pela AppsFlyer.

Importação de aplicativo parceiro está desativada

ImportFromPartnerApp.png

Problema

No Facebook, se a opção import from partner app estiver desativada, o aplicativo nunca enviou um evento para o Facebook usando o SDK de um MMP.

Solução

Siga um dos procedimentos abaixo:

  • Comece a transmitir eventos para o Facebook usando o SDK do MMP o mais rápido possível.
  • Comece a transmitir eventos para o Facebook usando o SDK do Facebook ou a API App Events e use um dos outros fluxos para configurar o esquema de conversão.

Feito isso, após os primeiros eventos serem registrados no Facebook, configure a integração com a AppsFlyer. 

[Solução atualizada em 25 de abril de 2021].

Os intervalos não podem se sobrepor e devem estar em ordem consecutiva 

Problema

Você utiliza o modo de mensuração personalizada da AppsFlyer para a SKAdNetwork. Ao importar o esquema de mensuração para o Facebook, a seguinte mensagem é exibida: Ranges can't overlap and must be in consecutive order, ou seja, os intervalos não podem se sobrepor e devem estar em ordem consecutiva

Solução

Os valores de receita no esquema de conversão personalizado devem estar em ordem ascendente consecutiva. 

[Solução atualizada em 26 de abril de 2021].

Envio de eventos para o Facebook

P: Posso enviar postbacks de eventos adicionais para eventos não selecionados na opção de mensuração de CV para o Facebook?

R: Para usuário que permitem o rastreamento, envie todos os eventos para maximizar a otimização do Facebook.

Mapear vários eventos para o mesmo evento do Facebook

P: Posso mapear vários eventos in-app para um evento do Facebook?

R: Se vários eventos forem mapeados para um evento padrão do Facebook, o Facebook não será capaz de diferenciar os eventos. Assim, o Facebook otimizará para o único evento que ele reconhece.

Os dados do Facebook não estão no dashboard

Problema

Na aba de integração da SKAdNewtork, a mensagem failed to pull data é exibida.

FacebookSKAdIntegration.png

Solução

Verifique se a conta conectada é um administrador do Facebook ou uma conta de Anunciante do Facebook com permissão ads_read.

Há um erro no Facebook quando você tenta realizar campanhas no iOS 14

Problema

Você:

  • Recebe uma mensagem de erro no Facebook quando tenta executar uma campanha no iOS 14
  • Adicionou recentemente um novo aplicativo ou um aplicativo para crianças na App Store.

Isso ocorre porque o Facebook não está ciente de que você está usando um SDK que inclui suporte para SKAdNetwork. Ou seja, o SDK da AppsFlyer.

Solução

  1. Na AppsFlyer, acesse Configuração > Parceiros integrados.
  2. Selecione Facebook
  3. Acesse a aba de Integração.
  4. Desabilite Ativar parceiro.
  5. Clique em Salvar integração.
  6. Aguarde 15 segundos.
  7. Habilite Ativar parceiro.
  8. Clique em Salvar integração.
  9. Aguarde até 24 horas para que o Facebook receba o sinal. 

Receita relatada pelo Facebook

[Atualizado em 12 de julho de 2021].

O Facebook obtém receita a partir do CV usando suas configurações da SKAdNetwork. No entanto, esse não é um cálculo direto, e o Facebook usa algoritmos para determinar a receita. 

Um sinal de que isso está ocorrendo é quando a receita possui valores que não estão arredondados, mesmo que você mensure a receita em dólares completos. 

Instalações vs. redownloads

[Atualizado em 30 de novembro de 2021].

  • O Facebook nos fornece os dados de postback dos usuários que instalam e fazem download do seu aplicativo novamente, sem indicar se foi uma instalação ou um redownload. Consequentemente, as métricas de instalação podem estar inflacionadas.
  • A partir do iOS 15, você pode enviar cópias de postback diretamente para a AppsFlyer. Elas estão disponíveis como dados brutos. Utilize-as para calcular o número de instalações e de redownloads. 

Preenchimento retroativo de dados

[Atualizado em 23 de dezembro de 2021].

Às vezes não conseguimos nos conectar ao Facebook para obter os dados. Por exemplo, devido a falhas no login. Não se preocupe. Preencheremos as lacunas de relatórios dos 7 dias anteriores na próxima vez em que pudermos fazer o login. 

A AppsFlyer está mostrando significativamente mais instalações/eventos/receita do que o Facebook

Em muitos casos, esta discrepância ocorre porque o painel do Facebook exibe apenas instalações ou eventos de cliques por padrão, enquanto o dashboard da AppsFlyer exibe tanto instalações e eventos de cliques (click-through) quanto de visualização (view-through)  .

Integração de agência

Se a agência tiver um papel de usuário Administrador na conta do anunciante no Facebook Ads, então eles podem realizar o procedimento neste artigo para permitir a interoperação da SKAN em nome do anunciante. Os anunciantes não precisam fazer login em sua conta do Facebook Ads também. O login da agência será indicado na conta do anunciante.

Um CV atualizado não aparece no Facebook

Ao adicionar, alterar ou remover um valor de conversão (CV) no SKAN Conversion Studio, certifique-se de que o evento seja mapeado nos postbacks de eventos in-app. Caso contrário, o CV não será atualizado no Facebook.

Diferenças de dados modelados na AppsFlyer e no Facebook Ads Manager

Os modelos da AppsFlyer agregam dados que os relatórios básicos do SKAdNetwork são incapazes de fornecer. Saiba mais

Quando a AppsFlyer modela dados, os dados que são modelados pelo Facebook não são levados em consideração, já que AppsFlyer se baseia apenas em dados confirmados e imparciais. Portanto, pode haver discrepâncias de dados e granularidade entre os relatórios do Facebook Ads Manager e os relatórios da AppsFlyer.