Integrar a Audience Network da Meta aos lances

Observação: a Audience Network do Facebook agora é a Audience Network da Meta. Consulte o anúncio da Meta para mais informações.

Neste guia, mostramos como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios da Meta Audience Network usando a mediação, abrangendo integrações de lances. Ele aborda como adicionar a Meta Audience Network à configuração de mediação de um bloco de anúncios e como integrar a Meta Audience Network e o adaptador a um app.

Integrações e formatos de anúncio compatíveis

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

Integração
Lances
Hierarquia  ^1
Formatos
Banner
Intersticial
Premiado
Intersticial premiado

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

Requisitos

• SDK dos anúncios para dispositivos móveis do Google mais recente
• Flutter 3.7.0 ou mais recente
• Para implantar no Android:
  • Android API de nível 21 ou mais recente
• Para implantar no iOS
  • Destino de implantação do iOS 10.0 ou mais recente
  • O SDK da Meta Audience Network mais recente geralmente requer a versão mais recente do Xcode.
• Um projeto funcional configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte o artigo Começar para ver mais detalhes.
• Leia o Guia explicativo de mediação

Etapa 1: configurar 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 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 receber uma solicitação para criar uma propriedade para o app. Insira o nome desejado da propriedade para o app e clique em Próxima.

Em seguida, selecione a plataforma para gerar receita.

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

Android

iOS

Clique em Adicionar uma nova conta de pagamento para configurar sua conta de pagamento. Redirecionaremos você a 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.

Observação: o formato Banner da Audience Network da Meta oferece suporte ao formato de exibição retangular médio e banners de largura flexível com alturas de 50, 90 ou 250.

Anote o ID da posição.

Clique em Concluído.

Ativar o modo de teste

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

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

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

Android

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

iOS

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

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

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

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

Observação: a falta de integração das versões compatíveis da Meta Audience Network e do SDK dos anúncios para dispositivos móveis do Google pode levar a problemas de build.

OpenUPM-CLI

Importante: se você estiver migrando de um .unitypackage para usar o OpenUPM-CLI, desinstale manualmente os recursos do local antigo excluindo todos os arquivos da pasta Assets/GoogleMobileAds/Mediation/MetaAudienceNetwork.

Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação da Meta de público-alvo da rede de anúncios para dispositivos móveis do Google para Unity no seu projeto executando o seguinte comando no diretório raiz:

openupm add com.google.ads.mobile.mediation.metaaudiencenetwork

OpenUPM

Importante: se você estiver migrando de um .unitypackage para usar o OpenUPM, desinstale manualmente os recursos do local antigo excluindo todos os arquivos da pasta Assets/GoogleMobileAds/Mediation/MetaAudienceNetwork.

No editor de projetos do Unity, selecione Edit > Project Settings > Package Manager para abrir as Configurações do Unity Package Manager.

Na guia Scoped Registries, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:

• Nome: OpenUPM
• URL: https://package.openupm.com
• Escopo(s): com.google

Em seguida, navegue até Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.

Selecione o pacote Mediação da rede de público-alvo na Meta de anúncios para dispositivos móveis do Google e clique em Instalar.

Pacote do Unity

Faça o download da versão mais recente do plug-in de mediação de anúncios para dispositivos móveis do Google para a Meta Audience Network no link de download no Changelog e extraia o GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage do arquivo zip.

No editor do projeto do Unity, selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage que você transferiu por download. Verifique se todos os arquivos estão selecionados e clique em Import.

Em seguida, selecione Assets > External Dependency Manager > Android Resolver > Force Resolve. A biblioteca External Dependency Manager vai executar a resolução do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do app Unity.

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

Consentimento da UE e GDPR

De acordo com a Política de consentimento para usuários da União Europeia do Google, é necessário garantir que algumas informações sejam fornecidas e que o consentimento seja obtido dos usuários no Espaço Econômico Europeu (EEE) sobre o 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 solicitar o consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode coletar, receber ou usar dados pessoais, além de fornecer informações sobre o uso de cada rede. No momento, o Google não pode transmitir a opção de consentimento do usuário a essas redes automaticamente.

Leia as orientações do Meta para saber mais sobre o GDPR e a publicidade do Meta.

Leis Estaduais de Privacidade dos EUA

As Leis Estaduais de Privacidade 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) fornecendo uma opção de desativação pelo link "Não vender minhas informações pessoais" na página inicial da parte "vendedora". O Guia de conformidade com as leis de privacidade dos estados dos EUA permite ativar o processamento 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, é necessário identificar cada rede de publicidade na cadeia de mediação que possa participar da venda de informações pessoais e seguir as orientações de cada uma dessas redes para garantir a conformidade.

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

Etapa 5: adicionar o código necessário

Android

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

iOS

Integração da SKAdNetwork

Siga a documentação da Meta Audience Network (link em inglês) para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do projeto.

Acompanhamento de publicidade ativado

Se você estiver criando para o iOS 14 ou mais recente, 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

Registre seu dispositivo de teste em

Importante: desative o modo de teste para e antes de lançar o app.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste do , ative os testes de uma única origem no Ad Inspector usando as origens de anúncios.

Etapas opcionais

Como armazenar em cache no Android 9

Android

A partir do Android 9 (nível 28 da API), 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 anúncios. Siga a documentação da Meta para atualizar a configuração de segurança de rede no seu app.

iOS

Não se aplica a integrações com iOS.

Códigos de erro

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

Android

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

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

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

Android

Código do erro	Motivo
101	Parâmetros do servidor inválidos (por exemplo, ID da posição ausente).
102	O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com a Meta Audience Network.
103	O editor precisa solicitar anúncios com um contexto Activity.
104	O SDK da Audience Network da Meta não foi inicializado.
105	O editor 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 necessários.
109	Não foi possível criar um anúncio nativo com o payload 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 saber mais.

iOS

Código do erro	Motivo
101	Parâmetros do servidor inválidos (por exemplo, ID da posição ausente).
102	O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com a Meta Audience Network.
103	Não foi possível inicializar o objeto de anúncio da Audience Network da Meta.
104	O SDK da Audience Network da Meta não conseguiu apresentar o anúncio intersticial/premiado.
105	O controlador de vista raiz do anúncio de banner é nil.
106	O SDK da Audience Network da Meta não foi inicializado.
1000-9999	A Audience Network da Meta retornou um erro específico do SDK. Consulte a documentação do Audience Network do Meta para mais detalhes.

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

Próxima versão

• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 5.2.0.

1.1.0

• Compatibilidade verificada com o adaptador Meta Android versão 6.17.0.0
• Compatibilidade verificada com o adaptador Meta iOS versão 6.15.2.0
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 5.1.0.

1.0.1

• A classe dart foi adicionada para permitir a análise de compatibilidade correta com plataformas de host.
• Compatibilidade verificada com o adaptador Meta Android versão 6.17.0.0
• Compatibilidade verificada com o adaptador Meta iOS versão 6.15.0.0
• Criado e testado com a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

1.0.0

• Versão inicial.
• Compatibilidade verificada com o adaptador Meta Android versão 6.17.0.0
• Compatibilidade verificada com o adaptador Meta para iOS versão 6.15.0.0
• Criado e testado com o plug-in de anúncios para dispositivos móveis do Google para Flutter versão 5.0.0.