Integrar a Audience Network da Meta aos lances

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios da Meta Audience Network usando a mediação, incluindo integrações de lances. Ele aborda 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 Flutter.

Integrações e formatos de anúncio aceitos

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

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

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

Requisitos

  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Flutter 3.7.0 ou mais recente
  • Para fazer a implantação no Android,
    • API do Android de nível 23 ou mais recente
  • Para fazer a implantação no iOS:
    • Destino de implantação do iOS 10.0 ou mais recente
    • A versão mais recente do SDK da Audience Network da Meta geralmente exige a versão mais recente do Xcode.
  • Um projeto funcional do Flutter configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • Conclua o guia para iniciantes da mediação.

Etapa 1: definir configurações na interface da Rede de público-alvo da Meta

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.

Android

iOS

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

O app-ads.txt de vendedores autorizados para apps é 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 tiver feito 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 Audience Network da Meta.

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

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

Android

Para 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 do Ad Manager.

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

Integração pelo pub.dev

Adicione a seguinte dependência com as versões mais recentes do SDK e do adaptador da Meta Audience Network no arquivo pubspec.yaml do pacote:

dependencies:
  gma_mediation_meta: ^

Integração manual

Baixe a versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para a Meta Audience Network, extraia o arquivo baixado e adicione a pasta do plug-in extraído (e o conteúdo dela) ao seu projeto do Flutter. Em seguida, referencie o plug-in no arquivo pubspec.yaml adicionando a seguinte dependência:

dependencies:
  gma_mediation_meta:
    path: path/to/local/package

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

De acordo com a Política de consentimento de usuários da União Europeia do Google, você precisa garantir que determinadas divulgações sejam feitas e que os consentimentos sejam obtidos dos usuários no Espaço Econômico Europeu (EEE) em relação ao uso de identificadores de dispositivo e dados pessoais. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Ao buscar consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que possa coletar, receber ou usar dados pessoais e fornecer informações sobre o uso de cada rede. No momento, o Google não consegue transmitir automaticamente a opção de consentimento do usuário para essas redes.

Leia as orientações do Meta para informações sobre o GDPR e a publicidade da plataforma.

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 legal desses termos). Essa opção é disponibilizada por um link em destaque com a mensagem "Não vender minhas informações pessoais" na página inicial do terceiro. O guia de compliance com as leis de privacidade dos estados 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 anúncios na sua cadeia de mediação. Portanto, identifique cada rede de publicidade na sua cadeia de mediação 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

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

iOS

Integração da SKAdNetwork

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

O acompanhamento de publicidade está ativado

Se você estiver criando para iOS 14 ou versões mais recentes, confira 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

Confira se você registrou seu dispositivo de teste no Ad Manager e ativou o modo de teste na interface da rede de público-alvo da Meta.

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 da Audience Network da Meta (lances).

Etapas opcionais

Armazenamento em cache no Android 9

Android

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.

iOS

Não aplicável a integrações do iOS.

Códigos de erro

Se o adaptador não receber um anúncio da Rede de público-alvo, 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 da posição ausente).
102 O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível com a Audience Network da Meta.
103 O editor precisa solicitar anúncios com um contexto Activity.
104 Não foi possível inicializar o SDK da 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 de anúncio nativo obrigatórios.
109 Não foi possível criar um anúncio nativo com base no payload de 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.

iOS

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 a Audience Network da Meta.
103 Não foi possível inicializar o objeto de anúncio da Audience Network da Meta.
104 O SDK do Audience Network da Meta não conseguiu apresentar o anúncio intersticial/premiado.
105 O controlador de visualização raiz do anúncio de banner é nil.
106 Não foi possível inicializar o SDK da 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.

Registro de alterações do adaptador de mediação do Flutter da Audience Network da Meta

Versão 1.4.0

Versão 1.3.0

Versão 1.2.0

Versão 1.1.0

Versão 1.0.1

  • Adicionamos uma classe Dart para permitir a análise de compatibilidade correta com plataformas host.
  • Criado e testado com a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.0.0

  • Versão inicial.
  • Criado e testado com a versão 5.0.0 do plug-in de anúncios para dispositivos móveis do Google para Flutter.