Integrar a Audience Network da Meta aos lances

Selecione a plataforma: Android (Beta) New-selected Android iOS Unity Flutter

Este guia mostra como usar GMA Next-Gen SDK para carregar e exibir anúncios da Meta Audience Network usando a mediação, incluindo as integrações de lances. Ele explica como adicionar a Audience Network da Meta à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da Audience Network da Meta a um app Android.

Integrações e formatos de anúncio aceitos

O adaptador de mediação da Meta Audience Network tem os seguintes recursos:

Integração
Lances
Cascata  1
Formatos
Banner 2
Intersticial
Premiado
Intersticial premiado
Nativo

1 A Audience Network da Meta passou a ser somente de lances em 2021.
2 A Audience Network da Meta não é compatível com banners adaptativos fixos e in-line.

Requisitos

  • API Android nível 24 ou mais recente.

Etapa 1: definir as configurações na interface da Meta Audience Network

Inscreva-se e faça login na página inicial do Gerenciador de empresa.

Clique em Começar e em Criar conta.

Preencha os campos obrigatórios com os detalhes da sua empresa e clique em Próxima.

Criar uma propriedade

Depois de preencher as informações necessárias, você vai precisar criar uma propriedade para seu app. Insira o nome desejado e clique em Próxima.

Em seguida, selecione a plataforma que você quer monetizar.

Adicione os detalhes do app e clique em Próxima.

Clique em Adicionar uma nova conta para pagamentos para configurar sua conta. Você vai ser redirecionado para uma nova página para inserir suas informações de pagamento. Preencha os detalhes necessários e clique em Próxima.

Selecione Google Ad Manager como a Plataforma de mediação e clique em Criar canal.

Selecione um formato, preencha o formulário e clique em Criar.

Anote o ID da posição.

Clique em Concluído.

Atualizar o app-ads.txt

Vendedores autorizados do inventário de anúncios de apps (app-ads.txt) é uma iniciativa do IAB Tech Lab que ajuda a garantir que o inventário de anúncios do seu aplicativo seja vendido apenas por canais autorizados. Para evitar uma perda significativa na receita de publicidade, implemente um arquivo app-ads.txt. Se ainda não fez isso, crie um arquivo app-ads.txt para o Ad Manager.

Para implementar o app-ads.txt na Meta Audience Network, consulte Identificar vendedores autorizados com app-ads.txt.

Ativar o modo de teste

Consulte o guia de teste da implementação do Audience Network para instruções detalhadas sobre como ativar os anúncios de teste do Meta Audience Network.

Etapa 2: configurar a demanda da Meta Audience Network na interface do Ad Manager

Faça login na sua conta do Ad Manager.

Ativar o compartilhamento de indicador seguro

Acesse Administrador > Configurações globais. Acesse a guia Configurações da conta do Ad Exchange e ative a opção Compartilhamento de indicador seguro. Clique em Salvar.

Compartilhar indicadores seguros em solicitações de lance

Acesse Inventário > Indicadores seguros. Em Indicadores seguros, pesquise Facebook e ative a opção Ativar integração com o app.

Clique em Salvar.

Permitir o compartilhamento de indicadores seguros para Lances do SDK

Acesse Exibição > Configurações do canal de demanda. Na guia Configurações padrão, ative a opção Permitir o compartilhamento de indicadores seguros para Lances do SDK.

Clique em Salvar.

Configurar os lances da Meta

Acesse Exibição > Bidders e clique em Acessar os Lances do SDK.

Clique em Novo bidder.

Selecione Meta como o bidder.

Clique em Continuar para ativar os lances do SDK para esse bidder.

Clique em Concluído.

Configurar o mapeamento de blocos de anúncios

Acesse Exibição > Bidders e clique em Acessar os Lances do SDK.

Selecione a empresa para a Audience Network da Meta.

Acesse a guia Mapeamento de bloco de anúncios e clique em Novo mapeamento de bloco de anúncios.

Escolha Bloco de anúncios específico. Selecione um bloco e um formato de anúncios, App para dispositivos móveis como o Tipo de inventário e seu Aplicativo para dispositivos móveis. Em seguida, insira o ID da posição obtido na seção anterior.

Se você estiver configurando o mapeamento de blocos de anúncios para um anúncio intersticial premiado na interface do Ad Manager, escolha o formato Premiado e use o ID de posição do intersticial premiado.

Por fim, clique em Salvar.

Adicionar a Meta à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA

Siga as etapas em Configurações das regulamentações europeias e Configurações das regulamentações estaduais dos EUA para adicionar a Meta à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface do Ad Manager.

Etapa 3: importar o SDK e o adaptador do Audience Network da Meta

No arquivo gradle do app, adicione as seguintes dependências e configurações de implementação:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:facebook:6.21.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:facebook:6.21.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integração manual

Etapa 4: implementar configurações de privacidade no SDK da Meta Audience Network

Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer determinadas declarações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de receber o consentimento deles para o uso de cookies ou outros armazenamentos locais quando exigido por lei e para a coleta, o compartilhamento e o uso de dados pessoais para a personalização de anúncios. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Você é responsável por verificar se o consentimento é propagado para cada origem de anúncios na sua cadeia de mediação. O Google não consegue transmitir automaticamente a escolha de consentimento do usuário para essas redes.

A Meta não está registrada na lista de fornecedores globais (GVL) do IAB Europe. Em vez disso, use a especificação técnica de consentimento adicional. Para mais detalhes, consulte Componentes do consentimento adicional. A especificação de consentimento adicional funciona em conjunto com a versão 2 do Transparency & Consent Framework (TCF) do IAB Europe. Essa especificação permite que você, junto com as plataformas de gestão de consentimento (CMPs) e parceiros, colete e transmita sinais de consentimento suplementares para empresas listadas na lista de provedores de adtech (ATP) do Google, mas que ainda não fazem parte da GVL do IAB Europe.

Siga as orientações na documentação da Meta (link em inglês) sobre o GDPR e a publicidade da Meta.

Leis Estaduais de Privacidade dos EUA

As leis de privacidade dos estados dos EUA exigem que os usuários tenham o direito de recusar a "venda" das próprias "informações pessoais" (conforme a definição desses termos na lei). Essa opção é disponibilizada por um link com a mensagem "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O guia de conformidade com as leis estaduais de privacidade dos EUA oferece a opção de ativar o tratamento de dados restrito para a veiculação de anúncios do Google, mas não é possível aplicar essa configuração a cada rede de publicidade na sua cadeia de mediação. Portanto, identifique cada rede de publicidade que possa participar da venda de informações pessoais e siga as orientações de cada uma delas para garantir a conformidade.

Siga as orientações na documentação da Meta sobre opções de tratamento de dados para usuários na Califórnia.

Etapa 5: adicionar o código necessário

Nenhum código adicional é necessário para a integração com o Audience Network da Meta.

Etapa 6: testar a implementação

Ativar anúncios de teste

Não se esqueça de registrar seu dispositivo de teste no Ad Manager e ativar o modo de teste na interface da Meta Audience Network.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste da Audience Network da Meta, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Audience Network da Meta (lances).

Etapas opcionais

Anúncios nativos

Alguns recursos de anúncios nativos do Audience Network da Meta não são mapeados de um para um com os recursos de anúncios nativos do Google. Esses recursos são transmitidos de volta ao publisher em um pacote pelo método getExtras() em NativeAd. O adaptador aceita a transmissão dos seguintes recursos:

Parâmetros e valores de solicitação
FacebookMediationAdapter.KEY_ID String. Um ID exclusivo do anúncio nativo.
FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET String. O contexto social do anúncio

Confira um exemplo de código que mostra como extrair esses recursos:

Exemplo:

Kotlin 

val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
  var socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
  // ...
}

Java 

Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
    String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
    // ...
}

Usar anúncios nativos da Audience Network da Meta sem uma MediaView

O formato de anúncio nativo do Audience Network da Meta exige a renderização do recurso MediaView. Se você planeja renderizar anúncios nativos sem esse recurso, use o formato de anúncio de banner nativo da Rede de público-alvo da Meta.

Para usar os anúncios de banner nativos da Meta Audience Network, selecione o formato Native Banner ao configurar a Meta Audience Network. O adaptador vai carregar automaticamente o formato de anúncio nativo correspondente.

Renderização de anúncios

O adaptador da Rede de público-alvo retorna os anúncios nativos como objetos NativeAd. Ele preenche os seguintes campos para um NativeAd.

Campo Preenchido pelo adaptador da Audience Network da Meta.
Título
Imagem 1
Corpo
Ícone do app
Call-to-action
Nome do anunciante
Classificação por estrela
Loja
Preço

1 O adaptador da Meta Audience Network não oferece acesso direto ao recurso de imagem principal dos anúncios nativos. Em vez disso, o adaptador preenche o MediaView com um vídeo ou uma imagem.

Rastreamento de impressões e cliques

A tabela a seguir destaca quando as impressões e os cliques de anúncios nativos são registrados pelo GMA Next-Gen SDK.

Registro de impressões Gravação de cliques
1 pixel do recurso de anúncio nativo da Meta Audience Network na tela + requisitos de renderização de recursos Callback do SDK da Audience Network da Meta

A Audience Network da Meta tem requisitos específicos de renderização de recursos para que uma impressão seja considerada válida, dependendo se você selecionou o formato Nativo ou Banner nativo ao configurar a Audience Network da Meta.

Formato nativo da Audience Network da Meta Recurso obrigatório Classe de renderização obrigatória
Nativo Visualização de mídia MediaView
Banner nativo Ícone do app ImageView

Armazenamento em cache no Android 9

A partir do Android 9 (nível 28 da API), o suporte a texto simples é desativado por padrão, o que afeta a funcionalidade de armazenamento em cache de mídia do SDK da Meta Audience Network e pode afetar a experiência do usuário e a receita de anúncios. Siga a documentação da Meta para atualizar a configuração de segurança de rede no seu app.

Códigos de erro

Se o adaptador não receber um anúncio da Audience Network, verifique o erro subjacente na resposta do anúncio usando ResponseInfo.getAdSourceResponses() nas seguintes classes:

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

Confira os códigos e as mensagens geradas pelo adaptador da Rede de Audiência quando um anúncio não é carregado:

Código do erro Motivo
101 Parâmetros de servidor inválidos (por exemplo, ID da posição ausente).
102 O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível com o Audience Network da Meta.
103 O editor precisa solicitar anúncios com um contexto Activity.
104 Não foi possível inicializar o SDK do Audience Network da Meta.
105 O publisher não solicitou anúncios nativos unificados.
106 O anúncio nativo carregado é um objeto diferente do esperado.
107 O objeto Context usado é inválido.
108 O anúncio carregado não tem os recursos obrigatórios.
109 Não foi possível criar um anúncio nativo com base na carga útil do lance.
110 O SDK do Audience Network da Meta não conseguiu apresentar o anúncio intersticial/premiado.
111 Exceção gerada ao criar um objeto AdView da Meta Audience Network.
1000-9999 A Meta Audience Network retornou um erro específico do SDK. Consulte a documentação da Meta Audience Network para mais detalhes.