Integrar a Audience Network da Meta aos lances

Este guia mostra como usar o Google Mobile Ads SDK for React Native para carregar e exibir anúncios do Audience Network da Meta usando a mediação, incluindo 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 a Audience Network da Meta e o adaptador a um app React Native.

Integrações e formatos de anúncio aceitos

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

Integração
Lances
Cascata  1
Formatos
Abertura do aplicativo
Banner
Intersticial
Premiado
Intersticial premiado
Nativo

1 A Audience Network da Meta passou a ser somente lances em 2021.

Pré-requisitos

Antes de continuar, verifique o seguinte:

  • Versão mais recente do Google Mobile Ads SDK for React Native.
  • Versão 0.85.0 ou mais recente do framework React Native.
  • Para implantar no Android
    • API Android nível 24 ou mais recente.
  • Para implantar no iOS
    • Destino de implantação do iOS 15.0 ou mais recente.
    • O SDK mais recente da Audience Network da Meta geralmente requer a versão mais recente do Xcode.
  • Um projeto do React Native em funcionamento configurado com Google Mobile Ads SDK for React Native. Consulte Configurar o Google Mobile Ads SDK for React Native para mais detalhes.
  • Configure a Mediação da AdMob.

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

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

Clique em Começar e em Criar nova 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 o app. Insira o nome desejado para a propriedade do app e clique em Próxima.

Em seguida, selecione a plataforma para monetizar.

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

Android

iOS

Clique em Adicionar uma nova conta para pagamentos para configurar a sua. 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 AdMob como a Plataforma de mediação e clique em Criar posição.

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

Anote o ID de lugar.

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, configure um arquivo app-ads.txt para seu app.

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

Ativar o modo de teste

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

Etapa 2: configurar a demanda da Audience Network da Meta na interface da AdMob

Definir as configurações de mediação do bloco de anúncios

Android

Para ver as instruções, consulte a etapa 2 no guia para Android.

iOS

Para instruções, consulte a etapa 2 no guia para iOS.

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 da AdMob.

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

No diretório raiz do projeto, instale o adaptador de mediação Google Mobile Ads SDK for React Native para a Audience Network da Meta. Preencha os campos:

  1. Copie o arquivo tar do adaptador Google Mobile Ads SDK for React Native do diretório gma-sdk-react-native/adapters/meta/ para o diretório local_packages/ do projeto. Se você não tiver a pasta adapters, consulte Pré-requisitos.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/meta/gma-mediation-meta-0.1.0.tgz local_packages/

    Substitua EXTRACT_DIR pelo caminho para o diretório em que você extraiu o arquivo.

  2. Instale o pacote do adaptador usando o gerenciador de pacotes de sua preferência:

    npm

    npm install ./local_packages/gma-mediation-meta-0.1.0.tgz

    novelo

    yarn add ./local_packages/gma-mediation-meta-0.1.0.tgz

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

Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer certas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça e obter o consentimento deles para usar cookies ou outra forma de armazenamento local, quando exigido por lei, e para coletar, compartilhar e usar dados pessoais para 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.

Consulte as orientações da Meta para informações 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.

Para usuários na Califórnia, consulte as opções de tratamento de dados da Meta.

Etapa 5: adicionar o código necessário

Android

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

iOS

Integração da SKAdNetwork

Siga a documentação da Meta Audience Network para adicionar os identificadores do SKAdNetwork ao arquivo Info.plist do seu projeto.

Acompanhamento de publicidade ativado

Se você estiver criando para o iOS 14 ou versões mais recentes, consulte as instruções da Meta Audience Network sobre como definir a flag de rastreamento de publicidade.

Etapa 6: testar a implementação

Ativar anúncios de teste

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

Verificar anúncios de teste

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

Etapas opcionais

Armazenamento em cache no Android 9

Android

No Android 9 (nível 28 da API) e mais recentes, o suporte a texto não criptografado fica 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 publicidade. Siga a documentação da Meta (link em inglês) para atualizar a configuração de segurança de rede no seu app.

iOS

Não relevante para integrações do iOS.

Códigos de erro

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

Android

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

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

Confira os códigos e as mensagens correspondentes gerados pelo adaptador da Audience Network da Meta quando um anúncio não é carregado:

Android

Código do erro Motivo
101 Parâmetros de servidor inválidos (por exemplo, ID de lugar ausente).
102 O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela Audience Network da Meta.
103 O publisher precisa solicitar anúncios com um contexto Activity.
104 Falha ao inicializar o SDK do Audience Network da Meta.
105 O publisher não solicitou anúncios nativos unificados.
106 O carregamento de anúncios nativos é um objeto diferente do esperado.
107 O objeto Context usado é inválido.
108 O anúncio carregado não tem os recursos de anúncio nativo necessários.
109 Falha ao criar um anúncio nativo com base no payload do lance.
110 O SDK do Audience Network da Meta não apresentou 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.

iOS

Código do erro Motivo
101 Parâmetros de servidor inválidos (por exemplo, ID de lugar ausente).
102 O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela Audience Network da Meta.
103 Falha ao inicializar o objeto de anúncio da Audience Network da Meta.
104 O SDK do Audience Network da Meta não apresentou o anúncio intersticial/premiado.
105 O controlador de visualização raiz do anúncio de banner é nil.
106 Falha ao inicializar o SDK do Audience Network da Meta.
1000-9999 A Meta Audience Network retornou um erro específico do SDK. Consulte a documentação da Meta Audience Network para mais detalhes.

Versão 0.1.0

  • Versão inicial.