Integração de atribuição de anúncios do Facebook (Meta)

 

Resumo da integração

Como um parceiro de medição móvel do Facebook, a Singular permite que os editores de aplicativos rastreiem referências de download de anúncios do Facebook e do Instagram. Uma vez que um download tenha sido verificado pela Singular, você também pode rastrear o engajamento subsequente desses usuários em seu aplicativo móvel.

A Singular informa sobre os dados de atribuição do Facebook de várias maneiras:

  1. API de autoatribuição do Facebook: A Singular reporta a atividade do aplicativo no nível do usuário para uma API dedicada do Facebook para MMPs, que é autoatribuída pelo Facebook e atribuível na Singular. As atribuições por meio dessa API estão sujeitas às restrições de dados do Facebook para anunciantes.
  2. "Meta Referrer" do Facebook (somente Android): Consulte"Meta Referrer"
  3. "Aggregated Event Measurement" (Medição de evento agregado) do Facebook (somente iOS): Consulte"Aggregated Event Measurement" (Medição deeventos agregados)
  4. Relatório da SKAdNetwork do Facebook (somente iOS): Consulte"Guia de integração da SKAdNetwork do Facebook"

(Consulteo Glossário de integrações de parceiros)

Parceiro Facebook
Tipo de parceiro

Rede de anúncios de auto-atribuição

Criativos Com suporte
Editor Com suporte
Visualização Suportado
Relatórios em nível de usuário disponíveis via Android Meta Referrer, para campanhas de aplicativos Advantage+ e campanhas manuais de promoção de aplicativos com segmentação ampla
Deep Linking A integração da Singular com o Facebook não usa links de rastreamento da Singular (incluindo links profundos da Singular). Consulte a documentação do Facebook para configurar os deep links do Facebook.
Reengajamento

Suportado
Relatórios em nível de usuário somente para iOS Aggregated Event Measurement (AEM)

Tag de clique Não (auto-atribuição)
Recebimento de todas as instalações

Recomendado (auto-atribuição)
Necessário para o iOS AEM

Recebimento de todos os eventos

Recomendado (auto-atribuição)
Necessário para o iOS AEM

Instruções de configuração

A configuração da integração de atribuição do Facebook Ads é necessária para aproveitar todos os métodos de medição com o Facebook.

Pré-requisitos

1

Configurar anúncios do Facebook

Registre o aplicativo no Facebook: Para executar o Facebook Mobile App Ads, o aplicativo deve ser registrado no Facebook. Visite o Facebook App Dashboardpara configurar seu aplicativo.

2

Configurar o Facebook como um parceiro na Singular

  1. Vá para o Painel de aplicativos do Facebook, localize seu aplicativo na lista de aplicativos e copie o ID do aplicativo.

    Where to find the Facebook App ID

  2. No Singular, vá para Attribution > Partner Configuratione digite "Facebook" na caixa de pesquisa.
  3. Digite sua ID de aplicativo do Facebook. Você pode adicionar várias IDs de aplicativos do Facebook separando-as com uma vírgula.

    fb_app_id.png

  4. Somente para aplicativos Android: Insira sua Install Referrer Decryption Key(consulte Onde posso encontrar a Install Referrer Decryption Key?abaixo).

    Importante: essa etapa é necessária para usar o Meta Referrerpara atribuição.

    fb_decryption_key.png

3

Especificar configurações de atribuição

  1. Ative a atribuiçãode visualização se você quiser atribuir conversões de visualização de anúncios do Facebook.
  2. Ative o Rastreamento de reengajamentose quiser atribuir reengajamentos para usuários de aplicativos existentes que se envolvem com um anúncio do Facebook.
    partnerconfig_settings1.png
  3. Escolha sua janela de lookback de atribuição de cliquespara especificar por quanto tempo um anúncio pode ser creditado com uma instalação.
    partnerconfig_window.png
  4. Salve a integração.
    Observação: Ao salvar a configuração de integração do Facebook Ads aqui, a Singular rastreia automaticamente as instalações e sessõespara o Facebook. Isso corresponde aos eventos mobile_app_install e fb_mobile_activate_app. Não é necessário configurar esses eventos separadamente na etapa 6.
4

Enviar postbacksde eventos para o Facebook

A Singular suporta o envio de notificações de eventos para o Facebook com todos os requisitos do Facebook.

facebook_events.png

  • Primeiro, selecione os eventos a serem enviados ao Facebook no menu suspenso.
  • Em seguida, mapeie seus eventos In-app:

    • Selecione o nome do evento no campo esquerdo, de acordo com o nome usado no SDK, e mapeie o nome para um dos eventos de conversão predefinidos do Facebook.
    • Como alternativa, escolha "(Use SDK Event Name)" para poder usar o evento nas campanhas de otimização de eventos personalizados do Facebook (somente campanhas para Android e < iOS 14).
    • Marque a caixa de seleção "Include Revenue Value" (Incluir valor da receita) se for relevante. Se não estiver marcada, somente as contagens do evento serão enviadas.

Veja também: Uso do Facebook SDK e do Singular SDK/S2S no mesmo aplicativo.

5

Configurar os requisitos do evento in-app do Facebook

Alguns eventos in-app do Facebook exigem que determinados argumentos sejam passados para serem processados pelo Facebook:

Nome do evento do Facebook Argumento(s) necessário(s) Valores suportados
AdClick ad_type ad_type - "banner", "interstitial", "rewarded_video", "native"
AdImpression Tipo de anúncio tipo de anúncio - "banner", "intersticial", "rewarded_video", "nativo"

Por exemplo, se você estiver enviando um evento SDK chamado "Click" e quiser mapeá-lo para o nome do evento do Facebook "AdClick", certifique-se de que "ad_type" esteja sendo enviado no evento "Click".

Exemplo de Android:

Singular.event("Click", "ad_type", "banner");

Exemplo do iOS:

[Singular eventWithArgs:@"Click", @"ad_type", @"banner", nil];
6

Rastreamento de instalações do Facebook no Singular

Após concluir as etapas acima, você poderá ver os resultados de suas campanhas do Facebook Audience Network em seus relatórios do Singular.

Cada instalação atribuída a um anúncio de instalação de aplicativo móvel do Facebook é relatada com base no nome da campanha, no conjunto de anúncios e no nome do grupo de anúncios criados no Facebook.

Mapeamento de dados

Os valores do Facebook são mapeados para as dimensões do relatório Singular da seguinte forma:

Valor Singular Valor do Facebook Exemplo
Nome da campanha do rastreador Nome da campanha "MinhaCampanha"
ID da campanha do rastreador ID da campanha 12345678
Nome do AdGroup do rastreador Nome do AdSet "MyAdGroup" (Meu grupo de anúncios)
ID do AdGroup do rastreador ID do AdSet 98123747
ID do criativo do rastreador ID do anúncio 123192873

Ao executar um relatório do Facebook, a Singular também fará a correspondência dos dados do SDK com os dados de marketing fornecidos pela API do Facebook Ads, incluindo:

  • Gastos por campanha
  • Gastos por criativo, incluindo a imagem ou o vídeo
  • ID da conta

Perguntas frequentes gerais

Como a Singular rastreia as atribuições do Facebook?

Como um parceiro de mensuração móvel do Facebook, a Singular permite que os editores de aplicativos rastreiem as referências de download de anúncios do Facebook e do Instagram. Uma vez que um download tenha sido verificado pela Singular, você também pode rastrear o engajamento subsequente desses usuários em seu aplicativo móvel.

A Singular obtém dados de atribuição do Facebook de duas maneiras:

  • API de autoatribuição do Facebook: Devido à limitação de compartilhamento de dados do Facebook, os dados sobre instalações recebidos dessa API só estão disponíveis nos relatórios agregados da Singular (não nos logs de dados no nível do usuário).
  • Solução de referenciador de instalação do Facebook (Meta):essa nova solução de medição para instalações de aplicativos Android permite que os dados sejam exibidos nos relatórios agregados do Singular e nos registros de dados no nível do usuário. Consulte Perguntas frequentes sobre o Meta Referrer.
As comunicações entre a Singular e o Facebook são seguras?

A Singular usa todas as medidas de segurança necessárias exigidas pelo Facebook para garantir que as comunicações entre a Singular e o Facebook sejam seguras. Também estamos em conformidade com todas as políticas de privacidade estabelecidas pelo Facebook para proteger seus dados.

Ainda não estou vendo as instalações atribuídas pelo Facebook. Onde posso obter ajuda?

Se você seguiu as etapas de configuração, mas ainda não está vendo instalações atribuídas ao Facebook após realizar o teste, entre em contato com a equipe de suporte da Singular para obter ajuda adicional. Forneça o nome de sua conta, o aplicativo aplicável e sua ID de aplicativo do Facebook em seu e-mail inicial para ajudar a garantir uma resolução rápida.

Onde posso encontrar o ID de aplicativo do Facebook de um aplicativo?

Vá para o Painel de aplicativos do Facebook, localize seu aplicativo na lista de aplicativos e copie o ID do aplicativo.

Where to find the Facebook App ID

Preciso definir o sinalizador AdvertiserTrackingEnabled (ATE)?

Como parte das atualizações relacionadas ao iOS 14, o Facebook anunciou novas diretrizes para o uso do sinalizador Advertiser Tracking Enabled com MMPs, incluindo como eles usam o sinalizador ATE. Sua integração com o Singular implementa automaticamente esse sinalizador e ele é definido para usuários que optam pelo rastreamento por meio do iOS App Tracking Transparency. Nenhuma ação adicional é necessária em sua implementação do SDK da Singular.

Perguntas frequentes sobre a medição de eventos agregados (iOS)

O que é o Facebook App AEM?

O App AEM é uma solução que ajuda os anunciantes a alcançar mais pessoas e medir o desempenho dos anúncios em sua plataforma.

O App AEM utiliza dados de conversão que a Singular envia ao Facebook por meio da integração MMP. Isso inclui eventos associados a usuários que não forneceram a permissão App Tracking Transparency (ATT) do iOS; nesse caso, o Facebook limitará o processamento desses eventos somente à Aggregated Event Measurement (AEM). O App AEM suporta campanhas de promoção de aplicativos (instalações) e engajamento de aplicativos (reengajamento) para iOS 14 e superior.

Para obter mais informações sobre o App AEM, consulte o artigo da central de ajuda do Facebook.

Quais são os requisitos para ativar o App AEM?

Para ativar o AEM para campanhas de "Promoção de aplicativos" (instalações):

  • Uma configuração de parceiro do Facebook do Singular iOS ativa
    • Relatar postbacks de eventos in-app para o Facebook é opcional, mas recomendado para ativar a otimização de VO e AEO. Observe que o AEM exige o relatório dos dados de ativação e desativação da ATT para o Meta, que é o comportamento padrão com uma configuração de parceiro do Facebook.
  • Um conector de dados do Facebookda Singular configurado
  • A opção AEM estará disponível ao criar uma campanha de promoção de aplicativo no Meta:

  • Certifique-se de que "MMP" esteja selecionado como o"Método de conexão preferencial" no Gerenciador de eventos do Facebook.

 

Para ativar o AEM para campanhas de "Engajamento de aplicativos" (reengajamentos):

    • Um aplicativo iOS que ofereça suporte a links diretos
    • Um aplicativo integrado Singular com suporte a deep links
      • Integração do SDK da Singular, ou
        • iOS SDK 12.0.3+, ou
        • iOS SDK 11.0.7+ com supportedDomainsimplementados para quaisquer links universais usados em campanhas do App AEM
      • Integração do Singular Server-to-Server (S2S)
    • Uma configuração ativa do parceiro Singular iOS Facebook com reengajamento ativado
Como a Singular atribui e relata as campanhas do App AEM?

A Singular suporta relatórios de instalações e reengajamentos (de links diretos) fornecidos por campanhas do App AEM.

  • As instalações do AEM são relatadas apenas de forma agregada, como "Instalações de rede" por meio da integração do conector de dados do Facebook
  • Os reengajamentos do AEM são relatados tanto no nível do usuário quanto no agregado (reengajamentos do rastreador), a partir de links profundos fornecidos por campanhas de engajamento do aplicativo. A granularidade da campanha suportada inclui:
    • ID da campanha
    • ID da subcampanha
    • ID do criativo
Se eu também usar o SDK do Facebook para iOS, o que devo fazer para ativar a Medição de evento agregado ao aplicativo?
Para evitar a duplicação de eventos de aplicativos no Facebook para AEM, recomenda-se que somente o SDK da Singular implemente e transmita esses eventos para o Facebook por meio da integração MMP. Consulte nosso guia sobre interoperabilidade entre o Facebook e o Singular SDKpara obter mais informações.
Como o Meta's App AEM funciona com a SKAdNetwork?
O App AEM do Meta e a SKAdNetwork são duas metodologias de medição distintas. O Meta documenta as diferenças esperadas ao comparar as duas metodologias em seu guia sobre o assunto.
  • O App AEM utiliza dados de conversão de aplicativos relatados por meio da integração de atribuição de MMP da Singular com o Meta (este artigo)
  • SKAdNetwork utiliza a estrutura de atribuição da Apple para atribuir. Para obter mais informações sobre a integração da Singular com o Meta para SKAdNetwork, leia nosso artigo da Central de Ajuda sobre o assunto.

Perguntas frequentes sobre o Meta Referrer (Android)

O que é o Meta Referrer?

O "Meta Referrer" é uma solução de mensuração específica para Android introduzida pelo Facebook para permitir que os anunciantes acessem dados granulares de atribuição em nível de usuário para instalações de aplicativos Android (consulte as políticas de dados do Facebook). Ele é composto pelas tecnologias "Google Play Install Referrer" e "Meta Install Referrer" para mensuração de instalações de aplicativos.

Referenciador de instalação do Google Play Meta Install Referrer

(Disponível a partir de outubro de 2021)
Usa o"Google Play Install Referrer" para atribuir instalações de cliques do Android para campanhas de instalação do aplicativo Meta por meio da loja Google Play.

(Disponível a partir de novembro de 2023)
Além de suportar os mesmos cenários de mensuração que o Google Play Install Referrer, o Meta Install Referrer também suporta fluxos de mensuração que não são suportados pelo Google Play Install Referrer:

  • a maioria dos cenários de atribuição de visualização (campanhas de aplicativos Advantage+ e campanhas manuais de promoção de aplicativos com segmentação ampla)
  • Suporte a lojas de aplicativos que não são do Google
  • atribuição de cliques de sessão não idêntica

"Sessão não idêntica" refere-se a quando um usuário clica em um anúncio e é redirecionado para a loja de aplicativos, mas não clica imediatamente em "Download/Instalação". O usuário retorna à página da loja de aplicativos mais tarde para clicar em "Download/Instalação".

A partir de novembro de 2023, a integração da Singular com o Meta suporta tanto o "Google Install Referrer" quanto o "Meta Install Referrer", sob o que a Singular chama de mensuração "Meta Referrer".

Como a Singular atribui instalações entre os dados autoatribuídos e os dados do "Meta Referrer"?

A Singular prioriza os dados do Meta Referrer para mensurar atribuições, a fim de priorizar a disponibilidade de dados no nível do usuário para o anunciante. Para uma determinada instalação de aplicativo Android, a Singular priorizará os seguintes métodos de atribuição, como segue:

  1. (Meta Referrer) Meta Install Referrer
  2. (Meta Referrer) Referrer de instalação do Google
  3. API de autoatribuição de meta

A Singular usa a reivindicação de autoatribuição se algum dado do Meta Referrer não estiver disponível ou for perdido devido à metodologia de último toque para uma conversão autoatribuída do Facebook. Isso maximiza os dados de atribuição no nível do usuário e garante uma medição agregada precisa das campanhas do Facebook.

As atribuições via Meta Install Referrer ou Google Install Referrer estão disponíveis em relatórios de nível de usuário como fonte "Facebook" e podem ser distinguidas por meio do método de atribuição ("Método") "meta_referral_id" e "referral_id", respectivamente.

Como funciona o Meta Referrer?

A medição "Meta Referrer" da Singular consiste em duas tecnologias de referência de instalação usadas pelo Facebook ao veicular anúncios de instalação de aplicativos Android.

Referenciador de instalação do Google Play Meta Referrer de instalação

Quando um usuário clica em um anúncio de instalação de aplicativo de um anunciante a partir de uma campanha de instalação de aplicativo do Facebook, o Facebook criptografa e registra os metadados relevantes da campanha de anúncios (Meta referrer) e os anexa ao parâmetro referrer no URL da Play Store. O URL da Play Store redireciona o usuário para a página de produto do aplicativo da Play Store, e o Meta referrer anexado é salvo pela loja.

Depois que a instalação resultante é concluída e o usuário abre o aplicativo pela primeira vez, o SDK da Singular lê o referenciador de instalação do Google Play a partir da API de referenciador de instalação do Playpara recuperar o metareferenciador dos dados de referenciador de instalação do Google Play. O Meta referrer é então descriptografado pelos servidores da Singular para atribuição de instalação.

Quando um usuário visualiza ou clica em um anúncio de instalação de aplicativo de um anunciante no aplicativo do Facebook (por exemplo, Facebook ou Instagram), o aplicativo do Facebook criptografa e registra os metadados relevantes da campanha publicitária (Meta referrer) na camada de armazenamento local do aplicativo do Facebook no dispositivo.

Quando a instalação resultante é concluída e o usuário abre o aplicativo pela primeira vez, o SDK da Singular lê o referenciador do Meta a partir dos dados do referenciador da instalação do Meta recuperados da camada de armazenamento local no dispositivo. O Meta referrer é então descriptografado pelos servidores da Singular para atribuição da instalação.

Ambas as tecnologias são usadas simultaneamente e juntamente com a integração de autoatribuição da Singular com o Meta, para chegar a uma única decisão de atribuição. Consulte"Como a Singular atribui instalações entre os dados autoatribuídos e o "Meta Referrer?"

Quais são os requisitos para habilitar o Meta Referrer para medição?
O Meta Referrer usa tanto o "Google Play Install Referrer" quanto o "Meta Install Referrer" para medição. Recomenda-se implementar ambos para maximizar a disponibilidade de dados nos casos em que um ou outro não estiver disponível.

Requisitos de integração do Singular SDK e S2S

  Referenciador de instalação do Google Play Referenciador de instalação do Meta

SDKda Singular

API S2S da Singular

  • Relatório de referência de instalação do Metapara a API S2S da Singular

 

Requisitos de configuração do parceiro

  • Defina a configuração do parceiro do Facebook e forneça a "Install Referrer Decryption Key" do Facebook, de acordo com a etapa 2.4.
Por que há discrepâncias entre as atribuições do Meta Referrer e as autoatribuições do Facebook?

Alguns possíveis motivos para discrepâncias entre os dois métodos de medição fornecidos pelo Facebook são:

  • O Meta Referrer é compatível com usuários rastreados por limite de anúncios no Android 12+, onde o ID de publicidade do Google não está disponível. A autoatribuição do Facebook só está disponível quando a ID de publicidade do Google está disponível.
  • O Meta Referrer é compatível apenas com instalações de aplicativos.
  • O Meta Referrer só está disponível para cliques e visualizações que ocorreram nesse dispositivo. A autoatribuição do Facebook oferece suporte a reivindicações entre dispositivos para usuários do Facebook com vários dispositivos.
  • O Meta Referrer não é compatível com campanhas que redirecionam para páginas de destino
  • O Meta Referrer oferece suporte a atribuições de visualização, mas somente para campanhas de segmentação amplaou de aplicativos Advantage+
  • Se apenas o Google Install Referrer for usado, se o Meta Install Referrer não estiver ativado:
    • O Google Install Referrer mede apenas as instalações de aplicativos, especificamente para campanhas que levam à Play Store. O Google Install Referrer não é compatível com a interação do usuário com anúncios relevantes que não levam diretamente à Play Store
    • O Referenciador de instalação do Google suporta apenas atribuições de cliques, enquanto a autoatribuição do Facebook suporta tanto cliques quanto visualizações.
    • O Referenciador de instalação do Google usa o valor do referenciador imediatamente anterior ao download de um aplicativo. Cliques repetidos no mesmo anúncio, após o download, mas antes da primeira abertura do aplicativo, não resultarão em um valor de referência atualizado. A lógica de autoatribuição do Facebook pode retornar com o ponto de contato mais recente após o download, mas antes da primeira abertura do aplicativo
    • O Google Install Referrer é compatível apenas com a Google Play Store, não é compatível com lojas de aplicativos de terceiros.
O que é o Broad Targeting e como ele é relevante para a atribuição do Meta Referrer?

A segmentação ampla é necessária para receber dados de instalação de visualização por meio do Meta Referrer. Você pode encontrar a configuração de campanha suportada abaixo:

  • Idade: a configuração padrão, "18-65+", é aplicada
  • Gênero: A configuração padrão, "Todos os gêneros", é aplicada.
  • Localização: Regiões, grupos de países (por exemplo, Ásia) ou países específicos são aplicados como local.
  • Direcionamento detalhado: Se for aplicada uma segmentação detalhada, como dados demográficos, interesses ou comportamentos, será necessário optar pela segmentação detalhada do Advantage.
  • Públicos personalizados: Se os públicos personalizados forem aplicados, será necessário optar pelo público personalizado do Advantage



A solução Meta Referrer está disponível para campanhas iOS?

A atribuição do Meta Referrer só está disponível em dispositivos Android.

Onde posso encontrar minha "Install Referrer Decryption Key"?

Para encontrar sua chave de descriptografia, siga as etapas abaixo:

  1. No Portal de desenvolvedores do Facebook, vá para Meus aplicativose selecione o aplicativo relevante.
  2. Vá para Configurações básicas e role para baixo até a seção Android App Store.
  3. Em Nomes de pacotes, localize a chave denominada Install Referrer Decryption Key.

Políticas de dados do parceiro

Como um parceiro de medição móvel do Facebook integrado à API de autoatribuição do Facebook, a Singular adere aos seguintes requisitos de manuseio de dados.

Observe que essas políticas se aplicam apenas às conversões autoatribuídas do Facebook e não se aplicam às conversõesdo Meta Referrer no Android.

Retenção de dados

Os dados de nível de usuário do Facebook são removidos após 6 meses da atribuição original. Após 6 meses, os usuários atribuídos ao Facebook são tratados/marcados como"Orgânicos" e refletidos como tal nos relatórios agregados e no nível do usuário no Singular.

Acesso aos dados

Para proteger a privacidade dos usuários finais, o Facebook não permite o acesso do anunciante a nenhum dado no nível do usuário que seja baseado em conversões autoatribuídas. Qualquer campo que normalmente identifique uma conversão autoatribuída do Facebook é marcado como "Não atribuído".

Uso limitado de dados

O Facebook permite que os anunciantes notifiquem o Facebook se os usuários finais optarem por limitar ou permitir o processamento de dados para usuários nos seguintes estados dos Estados Unidos, usando um sinalizador de "uso limitado de dados" (LDU):

  • Califórnia (a partir de julho de 2020)
  • Colorado (a partir de junho de 2023)
  • Connecticut (a partir de junho de 2023)

A Singular usa o valor limitDataSharing passado para o Singular SDK e S2S em integrações com parceiros em conformidade com a privacidade, como o Facebook. Quando Singular.limitDataSharing(true), o Facebook "limitará o uso de dados" para esse usuário na segmentação do Facebook se ele for residente da Califórnia, Colorado ou Connecticut. Se um valor limitDataSharing não for explicitamente fornecido, o padrão do Singular é notificar o Facebook de que "limitar o uso de dados" deve ser aplicado aos residentes da Califórnia, Colorado e Connecticut.

Para obter detalhes e exemplos de implementação, consulte nossos guias iOS SDK, Android SDK e S2S API. Para obter mais informações sobre o recurso "LDU", consulte a documentação do desenvolvedor do Facebook.