Configurar rastreio e postbacks
Resumo da integração
Como um parceiro de mensuração do Meta Mobile, 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 Meta de várias maneiras:
- API de auto-atribuição do Meta: A Singular reporta a atividade do aplicativo no nível do usuário para uma API Meta dedicada para MMPs, que é auto-atribuída pela Meta e atribuível na Singular. As atribuições através desta API estão sujeitas às restrições de dados do Meta para anunciantes.
- "Meta Referrer" do Meta (apenas Android): Ver"Meta Referrer"
- Meta's "Aggregated Event Measurement" (apenas iOS): Consulte"Aggregated Event Measurement" (Medição de eventos agregados)
- Relatório SKAdNetwork do Meta (apenas iOS): Consulte"Guia de integração Meta SKAdNetwork"
(Consulte o Glossário de integrações de parceiros)
Parceiro | Facebook (Meta) |
Tipo de parceiro |
Rede de anúncios de auto-atribuição |
Criativos | Com suporte |
Editor | Apoiado |
Visualização |
Suportado Relatórios ao nível do utilizador disponíveis através do Android Meta Referrer, para campanhas de aplicações Advantage+ e campanhas de promoção manual de aplicações com segmentação ampla |
Ligação profunda | A integração do Singular com o Meta não usa links de rastreamento do Singular (incluindo links profundos do Singular). Consulte a documentação do Meta para configurar os deep links do Meta. |
Reengajamento |
Suportado |
Etiqueta de clique | Não (auto-atribuição) |
Receber todas as instalações |
Recomendado (auto-atribuição) |
Receber todos os eventos |
Recomendado (auto-atribuição) |
Instruções de configuração
A configuração da integração de atribuição do Facebook (Meta) Ads é necessária para aproveitar todos os métodos de medição com o Meta.
Pré-requisitos
- Certifique-se de que seu aplicativo esteja integrado ao Singular por meio de uma integração SDK ou S2S (consulte Introdução ao Singular SDK/S2S)
- Apenas para aplicativos iOS: O suporte a links profundos deve ser implementado para suportar a mensuração de Aggregated Events Measurement (AEM) para campanhas de engajamento do aplicativo Meta. Consulte Requisitos de AEM
1 |
Configurar anúncios do Facebook (Meta)Registar a aplicação no Meta: Para executar o Meta Mobile App Ads, a aplicação deve ser registada no Meta. Visite o Painel de controlo da aplicação Meta para configurar a sua aplicação. |
2 |
Configurar o Facebook (Meta) como um parceiro no Singular
|
3 |
Especificar definições de atribuição
|
4 |
Enviar postbacksde eventos para o MetaO Singular suporta o envio de notificações de eventos para o Meta com todos os requisitos do Meta.
Veja também: Utilização do Meta SDK e do Singular SDK/S2S na mesma aplicação. |
5 |
Rastreamento de instalações do Facebook (Meta) no SingularDepois de concluir as etapas acima, você pode ver os resultados de suas campanhas do aplicativo móvel Meta em seus relatórios Singular.
Cada instalação atribuída a um anúncio de instalação de aplicativo móvel do Meta é relatada com base no nome da campanha, no conjunto de anúncios e no nome do grupo de anúncios criados no Meta. |
Mapeamento de dados
Os valores da campanha Meta são mapeados para as dimensões de relatório Singular da seguinte forma:
Valor Singular | Valor do Meta | Exemplo |
Tracker Campaign Name | Campaign Name | “MyCampaign” |
Tracker Campaign ID | Campaign ID | 12345678 |
Tracker AdGroup Name | AdSet Name | “MyAdGroup” |
Tracker AdGroup ID | AdSet ID | 98123747 |
Tracker Creative ID | Ad ID | 123192873 |
Ao executar um relatório do Meta, o Singular também fará a correspondência dos dados do SDK com os dados de marketing fornecidos pela API do Meta Ads, incluindo:
- Gastos por campanha
- Gastos por criativo, incluindo a imagem ou o vídeo
- ID da conta
Perguntas frequentes gerais
Como Meta Mobile Measurement Partner, a Singular permite que os editores de aplicativos acompanhem 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: 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 logs de dados no nível do usuário. Veja as Perguntas Frequentes do Meta Referrer.
A Singular usa todas as medidas de segurança necessárias exigidas pela MEta para garantir que as comunicações entre a Singular e a Meta sejam seguras. Também cumprimos com 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 a opçã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 forma 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.
(iOS) Perguntas frequentes sobre a medição de eventos agregados
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.
Apartir de 9 de outubro de 2024, o Meta e o Singular oferecerão suporte adicional a um aprimoramento do AEM chamado "Advanced AEM". O Advanced AEM melhora ainda mais a instalação da mensuração do AEM, permitindo que as atribuições do AEM sejam relatadas nos dados do rastreador Singular, para aplicativos elegíveis para o AEM. Consulte Atribuição e relatórios de AEM
Para obter mais informações sobre o AEM de aplicativo, consulte o artigo da central de ajuda do Meta.
Apartir de 9 de outubro, o Advanced AEM estará disponível para todas as configurações existentes e novas do Facebook e será ativado por padrão, desde que seu aplicativo seja elegível para o AEM no Meta Events Manager.
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ção da "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:
- Na configuração da "Campanha", ativar a opção "Campanha iOS 14+"
Para ativar o Meta AEM para campanhas de "Envolvimento da aplicação" (ou seja, reengajamentos do rastreador):
-
- (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
- iOS SDK 12.0.3+, ou
- iOS SDK 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
- Integração do SDK do Singular, ou
- (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 AEM avançado são relatadas nas "Instalações do rastreador" agregadas do Singular. As atribuições ao nível do utilizador para o Advanced AEM não estão disponíveis devido às políticas de partilha de dados do Meta.
- Os reengajamentos do AEM são relatados tanto no nível do usuário quanto no agregado (reengajamentos do rastreador), a partir de links diretos fornecidos por campanhas de engajamento do aplicativo. A granularidade da campanha suportada inclui:
- ID da campanha
- ID da subcampanha
- ID criativa
Certifique-se de que "MMP" está selecionado como"Método de ligação preferencial" no Gestor de eventos do Meta.
- 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.
FAQ do Meta Referrer (Android)
"Meta Referrer" é uma solução de mensuração específica para Android introduzida pelo Meta para permitir que os anunciantes acessem dados granulares de atribuição no nível do usuário para instalações de aplicativos Android (consulte as políticas de dados do Meta) de anúncios veiculados no Facebook, Instagram e campanhas publicitárias da Audience Network em que o objetivo é a instalação de aplicativos. É 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) |
(Disponível a partir de novembro de 2023)
"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 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 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?"
Requisitos de integração do Singular SDK e S2S
Referenciador de instalação do Google Play | Meta Install Referrer | |
SDK da Singular |
|
|
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 do Google Install 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:
- No Portal de programadores Meta, vá a As minhas aplicações e selecione a aplicação relevante.
- Vá para Definições básicas e desloque-se para baixo até à secção Android App Store.
- Em Nomes de pacotes, encontre a chave denominada Install Referrer Decryption Key.
Políticas de dados do parceiro
Como um Parceiro de medição móvel da Meta integrado com a API de auto-atribuição da Meta, a Singular adere aos seguintes requisitos de manuseio de dados.
Observe que essas políticas se aplicam apenas às conversões auto-atribuídas da Meta e não se aplicam às conversõesdo Meta Referrer no Android.
Retenção de dados
Os dados ao nível do utilizador do Meta são removidos após 6 meses da atribuição original. Após 6 meses, os utilizadores atribuídos ao Meta são tratados/marcados como"Orgânicos" e reflectidos como tal nos relatórios agregados e ao nível do utilizador no Singular.
Acesso aos dados
Para proteger a privacidade dos utilizadores finais, a Meta não permite o acesso dos anunciantes a quaisquer dados ao nível do utilizador que se baseiem em conversões auto-atribuídas. Qualquer campo que identifique normalmente uma conversão Meta auto-atribuída é marcado como "Não atribuído".
Utilização limitada de dados
O Meta permite que os anunciantes notifiquem o Meta se os utilizadores finais optarem por limitar ou permitir o processamento de dados para utilizadores nos seguintes estados dos Estados Unidos, utilizando um sinalizador de "utilização limitada 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)
O Singular usa o valor limitDataSharing passado para o Singular SDK e S2S em integrações com parceiros compatíveis com a privacidade, como o Meta. Quando Singular.limitDataSharing(true), o Meta irá "limitar a utilização de dados" para este utilizador na segmentação do Meta se este for residente na Califórnia, Colorado ou Connecticut. Se um valor limitDataSharing não for explicitamente fornecido, o Singular tem como padrão notificar o Meta de que "limitar o uso de dados" deve ser aplicado para 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 Meta.