Como Meta Mobile Measurement Partner, 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.

O Singular obtém dados de atribuição do Meta de duas maneiras:

• API de auto-atribuição do Meta: Devido à limitação de compartilhamento de dados do Meta, os dados sobre instalações recebidos dessa API só estão disponíveis nos relatórios agregados do Singular (não nos logs de dados no nível do usuário).
• Solução Meta Install Referrer do Meta: Este mecanismo de medição exclusivo para Android suporta a atribuição no caso em que a ID de publicidade não está disponível. Consulte as FAQ do Meta Referrer.

Disponível a partir de 18 de junho de 2025, o relatório Meta Advanced Mobile Measurement permite aos anunciantes a capacidade de aceder a dados de atribuição ao nível do utilizador para dispositivos iOS e Android - incluindo dados da integração de auto-atribuição MMP - eliminando a limitação anterior de instalações apenas para Android atribuídas através do Meta Referrer.

Para acessar os relatórios no nível do usuário, os termos do MVA devem ser aceitos para o(s) ID(s) do aplicativo relevante(s). Siga as orientações abaixo para ativar o Meta em seus relatórios:

1. Visite os Termos de medição móvel avançada do Meta.
2. Selecione o(s) ID(s) da aplicação relevante(s).
3. Aceitar os termos.

A Singular utiliza todas as medidas de segurança necessárias exigidas pela MEta para garantir que as comunicações entre a Singular e a Meta são seguras. Também cumprimos todas as políticas de privacidade estabelecidas pela Meta para proteger os seus dados.

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

Você precisará ter uma conta de desenvolvedor. Vá para o Painel de aplicativos Meta. Encontre seu aplicativo na lista de aplicativos e copie a ID do aplicativo.

Como parte das actualizações relacionadas com o iOS 14, o Meta anunciou novas diretrizes para a utilização da bandeira Advertiser Tracking Enabled com MMPs, incluindo a forma como utilizam a bandeira ATE. Sua integração com o Singular implementa automaticamente esse sinalizador e ele é definido para usuários que optam pelo rastreamento por meio da Transparência de rastreamento do aplicativo iOS . Nenhuma ação adicional é necessária na implementação do SDK Singular.

Se tiver implementado a atribuição de receitas de anúncios Singular, os dados de receitas de anúncios podem ser comunicados ao Meta através do evento AdImpression do Meta. A receita de anúncios comunicada ao Meta pode ser utilizada para otimização, desde que os dados da receita de anúncios cumpram os requisitos de elegibilidade do Meta.

• Integrar a atribuição de receitas de anúncios Singular
• Passe os dados de receita de anúncios para o Meta através da configuração de parceiro do Facebook. Selecione o evento SDK"__ADMON_USER_LEVEL_REVENUE__" e mapeie-o para"AdImpression" com aopção "Incluir valor de receita" selecionada.
  
• Reveja os requisitos de elegibilidade do Meta para maximizar os valores das conversões

Se encontrar este erro no Meta, isso indica que se espera que o evento seja um evento do tipo receita. Para resolver isso, certifique-se de que, ao enviar o evento de seu aplicativo usando o Singular SDK, você inclui os parâmetros de moeda e valor necessários. Além disso, nas definições de Configuração do parceiro, certifique-se de que ativa a opção "Incluir valor de receita" para este evento.

Não, quaisquer alterações ao mapeamento de eventos só se aplicarão a partir do ponto de configuração em diante. Os dados históricos não serão alterados retroativamente.

Certifique-se de que todas as permissões no Meta estão configuradas de modo a permitir-lhe executar campanhas para o anunciante. Inclua o nome da sua empresa no nome da campanha do Meta para que possamos identificar a sua campanha em comparação com outras campanhas de agências ou campanhas de anunciantes internos existentes.

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

O App AEM utiliza dados de conversão que a Singular envia para o Meta por meio da integração MMP. Isto inclui eventos associados a utilizadores que não forneceram a permissão App Tracking Transparency (ATT) do iOS, caso em que o Meta limitará o processamento desses eventos apenas à 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 AEM de aplicativo, consulte o artigo da central de ajuda do Meta.

Para ativar o relatório do Meta Advanced AEM (ou seja, instalações do rastreador)

• (Singular) Verifique se a configuração do parceiro do Facebook está configurada para seu aplicativo iOS e se a opção"Incluir atribuições do AEM avançado" está marcada. A configuração padrão do parceiro Singular no Meta envia eventos do aplicativo para usuários que não forneceram a permissão App Tracking Transparency (ATT) do iOS, na qual o Meta limitará o processamento desses eventos ao AEM.
• (Meta) Verifique se o seu aplicativo é elegível para a Medição de eventos agregados no seu Meta Events Manager. Se a sua aplicação for elegível para AEM, os dados avançados de AEM estarão disponíveis através da sua integração Singular.
  
  Nota: O relatório Singular para AEM avançado não exige que a opção"Medição de eventos agregados" seja selecionada como"Atribuição" ao configurar sua campanha de promoção de aplicativo Meta

Para ativar as campanhas de "Promoção de aplicativo" do relatório do Meta AEM (ou seja, instalações de rede):

• (Singular) Uma configuração de parceiro do Facebook do Singular iOS ativa
  • A comunicação de postbacks de eventos in-app ao Meta é opcional, mas recomendada para permitir a otimização 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
• (Singular) Um conetor de dados do FacebookSingular configurado
• (Meta) Certifique-se de que"MMP" esteja selecionado como o"Método de conexão preferido" no Gerenciador de eventos do Meta.
• (Meta) Ao criar uma campanha de Promoção de aplicativo Meta:
  • Na configuraçãoda "Campanha", ativar a opção"Campanha iOS 14+"
    
  • Na configuração de"Conjunto de anúncios", selecione a opção AEM como método de atribuição:
    

Para ativar o Meta AEM para campanhas de "Envolvimento da aplicação" (ou seja, reengajamentos):

• • (Singular) Um aplicativo iOS que suporta links diretos
  • ( Singular) Um aplicativo integrado Singular com suporte a links diretos
    • Integração do SDK do Singular, ou
      • SDK do iOS 12.0.3+, ou
      • SDK do iOS 11.0.7+ com supportedDomains implementado para qualquer Universal Links usado em campanhas do App AEM
    • Integração Singular Server-to-Server (S2S)
      • O suporte a links profundos é implementado e openuri= é passado em todas as sessões relatadas
  • (Singular) Uma configuração de parceiro Singular iOS Facebook ativa com reengajamento ativado
  • (Meta) Certifique-se de que"MMP" está selecionado como o"Método de ligação preferencial" no Gestor de eventos Meta.

A Singular suporta relatórios de instalações e reengajamentos (de deep links) atendidos 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
• As instalações do Advanced AEM são relatadas nas"Instalações do rastreador" agregadas do Singular. As atribuições no nível do usuário para AEM avançado estão disponíveis por meio de relatórios AMM.
• Os reengajamentos do AEM são relatados no nível do usuário e no agregado, a partir de links diretos fornecidos por campanhas de envolvimento do aplicativo. A granularidade da campanha suportada inclui:
  • ID da campanha
  • ID da subcampanha
  • ID criativa

Para evitar a duplicação de eventos de aplicativo no Meta para AEM, é recomendável que apenas o SDK Singular implemente e passe esses eventos para o Meta por meio da integração MMP. Consulte nosso guia sobre interoperabilidade do Meta e do Singular SDK para obter mais informações.

Certifique-se de que"MMP" está selecionado como"Método de ligação preferencial" no Gestor de eventos do Meta.

O Meta's App AEM e a SKAdNetwork são duas metodologias de medição distintas. A Meta documenta as diferenças esperadas ao comparar as duas metodologias no seu guia sobre o tema.

• O App AEM utiliza dados de conversão de aplicativos relatados através 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.

O "Meta Referrer" é uma solução de medição específica para Android introduzida pelo Meta para permitir que os anunciantes acedam a dados granulares de atribuição ao nível do utilizador para instalações de aplicações Android (consulte as políticas de dados do Meta) a partir de anúncios veiculados no Facebook, Instagram e campanhas publicitárias da Audience Network em que o objetivo é a instalação de aplicações. É composto pelas tecnologias"Google Play Install Referrer" e"Meta Install Referrer" para a medição de instalações de aplicações.

Referenciador de instalação do Google Play

Meta Referenciador de Instalação

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

(Disponível a partir de novembro de 2023) Além de suportar os mesmos cenários de mensuração que o Referenciador de instalação do Google Play, o Referenciador de instalação do Meta também suporta fluxos de mensuração que não são suportados pelo Referenciador de instalação do Google Play: 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 para lojas de aplicativos que não são do Google atribuição de cliques de sessão não idêntica "Sessão diferente" refere-se a quando um utilizador clica num anúncio e é redireccionado para a loja de aplicações, mas não clica imediatamente em "Transferir/Instalar". O utilizador regressa à página da loja de aplicações mais tarde para clicar em "Transferir/Instalar".

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".

A partir de 18 de junho de 2025, o AMM do Meta altera como e quando as atribuições do Singular são instaladas entre os dados auto-atribuídos e os dados do "Meta Referrer"

Se a MVA tiver sido aceite

Se a MVA não foi aceite

O MVA permite a partilha de dados ao nível do utilizador para atribuições auto-atribuídas do Meta. Por conseguinte, as atribuições da API de auto-atribuição do Meta têm prioridade sobre as atribuições do Meta Referrer da seguinte forma. O Meta Referrer é utilizado para atribuir onde a API de auto-atribuição do Meta não consegue, por exemplo, para utilizadores Android sem um ID de publicidade.

A Singular prioriza os dados do Meta Referrer para mensurar atribuições para 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 da seguinte forma: (Meta Referrer) Meta Install Referrer (Meta Referenciador) Referenciador de instalação do Google API de auto-atribuição de meta A Singular usa a reivindicação de auto-atribuição se algum dado de Meta Referrer não estiver disponível ou for perdido devido à metodologia de último toque para uma conversão de Meta auto-atribuída. Ao fazê-lo, maximiza os dados de atribuição ao nível do utilizador e garante uma medição agregada precisa das campanhas Meta.

As atribuições através do Meta Install Referrer ou do Google Install Referrer estão disponíveis nos relatórios ao nível do utilizador como fonte "Facebook" e podem ser distinguidas através do método de atribuição ("Método") "meta_referral_id" e "referral_id", respetivamente.

A medição"Meta Referrer" da Singular consiste em duas tecnologias de referenciador de instalação usadas pelo Meta ao veicular anúncios de instalação de aplicativos Android por meio do Facebook, Instagram ou Audience Network.

Referenciador de instalação do Google Play

Referenciador de instalação do Meta

Quando um utilizador clica num anúncio de instalação de uma aplicação de um anunciante na aplicação do Meta (por exemplo, Facebook ou Instagram) ou na Audience Network, o Meta encripta e regista os metadados relevantes da campanha publicitária (Meta referrer) e anexa-os ao parâmetro referrer no URL da Play Store. O URL da Play Store redirecciona o utilizador para a página de produto da aplicação da Play Store, e o Meta referrer anexado é guardado pela loja. Assim que a instalação resultante é concluída e o utilizador abre a aplicação 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 Play para recuperar o Meta referenciador a partir 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 utilizador visualiza ou clica num anúncio de instalação da aplicação de um anunciante na aplicação do Meta (por exemplo, Facebook ou Instagram) ou na Audience Network, a aplicação do Facebook encripta e regista os metadados relevantes da campanha publicitária (referenciador do Meta) na camada de armazenamento local da aplicação do Facebook no dispositivo. Quando a instalação resultante estiver concluída e o utilizador abrir a aplicação pela primeira vez, o SDK da Singular lê o Meta referrer a partir dos dados do Meta install referrer 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 auto-atribuição da Singular com o Meta, para chegar a uma única decisão de atribuição. Consulte"Como o Singular atribui instalações entre os dados auto-atribuídos e o "Meta Referrer?"

O Meta Referrer usa tantoo "Google Play Install Referrer" quantoo "Meta Install Referrer" para mensuração. Recomenda-se a implementação de ambos para maximizar a disponibilidade de dados nos casos em que um ou outro não esteja disponível.

Requisitos de integração do Singular SDK e S2S

	Referenciador de instalação do Google Play	Meta Install Referrer
SDK da Singular	Certifique-se de que o Singular SDK do Android esteja implementado e que as dependências do Google Play Services sejam adicionadas	Singular Native SDK do Android versão 12.3.0 ou superior(Unity 4.2.0+, React Native 3.3.0+, Unreal 2.2.0+) Adicione o "Facebook App ID" do seu aplicativo na configuração do Singular SDK antes da inicialização do SDK. Consulte"Onde posso encontrar a ID de aplicativo do Facebook de um aplicativo?"
API S2S do Singular	Relatar o referenciador de instalação do Google Play para a API S2S do Singular	Relatório do referenciador de instalação do Meta para a API S2S do Singular

Requisitos de configuração do parceiro

• Configure a configuração de parceiro do Facebook e forneça a Meta "Install Referrer Decryption Key" de acordo com a etapa 2.4.

Algumas possíveis razões para discrepâncias entre os dois métodos de medição fornecidos pelo Meta são:

• O Meta Referrer é suportado para utilizadores rastreados por anúncios limitados no Android 12+, onde o ID de publicidade do Google não está disponível. A auto-atribuição do Meta só está disponível quando o ID de publicidade do Google está disponível.
• O Meta Referrer é suportado apenas para instalações de aplicações.
• O Meta Referrer só está disponível para cliques e visualizações que ocorreram nesse dispositivo. A auto-atribuição do Meta suporta reivindicações entre dispositivos para utilizadores do Meta com vários dispositivos.
• O Meta Referrer não é suportado para campanhas que redireccionam para páginas de destino
• O Meta Referrer suporta atribuições de visualização, mas apenas para campanhas de segmentação ampla ou Advantage+ App
• Se apenas o Google Install Referrer for utilizado, 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 Referenciador de instalação do Google não é suportado para a interação do utilizador com anúncios relevantes que não conduziram diretamente à Play Store
  • O Referenciador de instalação do Google suporta apenas atribuições de cliques, enquanto a Meta auto-atribuição suporta tanto cliques como visualizações
  • O Referenciador de instalação do Google utiliza o valor do referenciador imediatamente anterior ao download de uma aplicação. Os cliques repetidos no mesmo anúncio, após o download, mas antes da primeira abertura da aplicação, não resultarão num valor de referenciador atualizado. A lógica de auto-atribuição do Meta pode regressar com o ponto de contacto mais recente após o download, mas antes da primeira abertura da aplicação
  • O Google Install Referrer apenas suporta a Google Play Store, não é suportado por lojas de aplicações de terceiros.

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
• Sexo: A configuração padrão, "Todos os sexos", é aplicada.
• Localização: Regiões, grupos de países (por exemplo, Ásia) ou países específicos são aplicados como a localização.
• Direcionamento detalhado: Se for aplicada uma segmentação detalhada, como dados demográficos, interesses ou comportamentos, é necessário optar pela segmentação detalhada do Advantage.
  
• Públicos personalizados: Se forem aplicados públicos personalizados, é necessário optar pelo público personalizado do Advantage
  
  
  
  

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

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

1. No Portal de programadores Meta, vá a As minhas aplicações e selecione a aplicação relevante.
2. Vá para Definições básicas e desloque-se para baixo até à secção Android App Store.
3. Em Nomes de pacotes, encontre a chave denominada Install Referrer Decryption Key.