Integrar a Audience Network da Meta aos lances

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 Unity app.

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

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

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

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

Requisitos

  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Unity 5.6 ou mais recente
  • Plug-in de mediação de anúncios para dispositivos móveis do Google para a Meta Audience Network 2.11.0 (versão mais recente recomendada)
  • Para implantar no Android:
    • Android API de nível 21 ou mais recente
  • Para implantar no iOS:
    • Destino de implantação do iOS de 10.0 ou mais recente
    • O SDK da Meta Audience Network mais recente geralmente requer a versão mais recente do Xcode.
  • Um projeto Unity em funcionamento 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: defina as configurações na interface do Audience Network da Meta

Inscreva-se e faça login na página inicial do Business Manager.

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ê precisará 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

Configure sua conta para pagamentos clicando em Adicionar uma nova conta para pagamentos. Você 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 da posição.

Clique em Concluído.

Ativar modo de teste

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

Etapa 2: configurar a demanda da Meta Audience Network na AdMob 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 Facebook 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 Facebook à lista de parceiros de anúncios do GDPR e das regulamentações estaduais dos EUA na AdMob IU.

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

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

No editor de projetos do Unity, selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsFacebookMediation.unitypackage que você baixou. Verifique se todos os arquivos estão selecionados e clique em Importar.

Selecione Assets > Play Services Resolver > Android Resolver > Force Resolve. Em seguida, a biblioteca do resolvedor do Unity Play Services executa a resolução de dependências do zero e copia as dependências declaradas no diretório Assets/Plugins/Android do seu app do Unity.

Etapa 4: implementar as 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 algumas divulgações sejam fornecidas aos usuários no Espaço Econômico Europeu (EEE) e que eles tenham o consentimento deles em relação ao uso de identificadores de dispositivos 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.

Consulte as orientações da Meta para mais informações sobre o GDPR e a publicidade na Meta.

Leis Estaduais de Privacidade dos EUA

Leis Estaduais de Privacidade dos EUA exigem que os usuários escolham não autorizar a "venda" das próprias "informações pessoais" (conforme a definição desses termos) usando um link em destaque "Não vender minhas informações pessoais" na página inicial do "vendedor". 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, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode 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 obrigatório

Android

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

iOS

Integração com a 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ê está criando para iOS 14 ou versões mais recentes, confira as instruções da Meta Audience Network sobre como definir a sinalização de acompanhamento de publicidade.

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste em AdMob e ative o modo de teste na Meta Audience Network interface.

Verificar anúncios de teste

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

Etapas opcionais

Como armazenar em cache no Android 9

Android

No Android 9 (nível 28 da API) e versões mais recentes, o suporte a texto não criptografado é 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 para atualizar a configuração de segurança de rede no seu app.

iOS

Não aplicável 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 correspondentes gerados pelo adaptador da Meta Audience Network quando um anúncio não é carregado:

Android

Código do erro Motivo
101 Parâmetros de servidor inválidos (por exemplo, ID do canal 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 Falha ao inicializar o SDK do Audience Network da Meta.
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 Falha ao criar um anúncio nativo a partir do payload de lance.
110 O SDK da 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 Audience Network da Meta 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 de servidor inválidos (por exemplo, ID do canal ausente).
102 O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com a Meta Audience Network.
103 Falha ao 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 visualização raiz do anúncio de banner é nil.
106 Falha ao inicializar o SDK do Audience Network da Meta.
1000-9999 A Audience Network da Meta retornou um erro específico do SDK. Consulte a documentação da Meta Audience Network para saber mais.

Registro de alterações do plug-in de mediação para Unity da Meta Audience Network

Versão 3.12.1

Versão 3.12.0

Versão 3.11.0

Versão 3.10.0

Versão 3.9.1

Versão 3.9.0

Versão 3.8.0

Versão 3.7.0

Versão 3.6.1

Versão 3.6.0

Versão 3.5.0

Versão 3.4.0

Versão 3.3.2

Versão 3.3.1

Versão 3.3.0

Versão 3.2.0

Versão 3.1.0

Versão 3.0.0

Versão 2.12.0

Versão 2.11.1

Versão 2.11.0

Versão 2.10.0

Versão 2.9.2

Versão 2.9.1

Versão 2.9.0

Versão 2.8.1

Versão 2.8.0

Versão 2.7.1 (descontinuada, use 2.8.0 ou mais recente)

Versão 2.7.0 (descontinuada, use a 2.8.0 ou mais recente)

Versão 2.6.1 (descontinuada, use a 2.8.0 ou mais recente)

Versão 2.6.0

Versão 2.5.1

  • Compatível com o adaptador do Facebook para Android na versão 5.5.0.0.
  • Compatível com o adaptador do Facebook para iOS versão 5.5.1.0.

Versão 2.5.0

  • Compatível com o adaptador do Facebook para Android na versão 5.5.0.0.
  • Compatível com o adaptador do Facebook para iOS versão 5.5.0.0.

Versão 2.4.1

  • Compatível com a versão 5.4.1.1 do adaptador do Facebook para Android.
  • Compatível com o adaptador do Facebook para iOS versão 5.4.0.0.

Versão 2.4.0

  • Compatível com a versão 5.4.0.0 do adaptador do Facebook para Android.
  • Compatível com o adaptador do Facebook para iOS versão 5.4.0.0.

Versão 2.3.2

  • Compatível com a versão 5.3.1.2 do adaptador do Facebook para Android.
  • Compatível com o adaptador do Facebook para iOS versão 5.3.2.0.

Versão 2.3.1

  • Compatível com o adaptador do Facebook para Android versão 5.3.1.0.
  • Compatível com o adaptador do Facebook para iOS versão 5.3.2.0.

Versão 2.3.0

  • Compatível com a versão 5.3.0.0 do adaptador do Facebook para Android.
  • Compatível com o adaptador do Facebook para iOS versão 5.3.0.0.

Versão 2.2.0

  • O plug-in foi atualizado para oferecer compatibilidade com a nova API Premiada em versão Beta aberta.
  • Compatível com a versão 5.2.0.1 do adaptador do Facebook para Android.
  • Compatível com o adaptador do Facebook para iOS versão 5.2.0.1.

Versão 2.1.1

  • Compatível com a versão 5.1.0.1 do adaptador do Facebook para Android.
  • Compatível com o adaptador do Facebook para iOS versão 5.1.0.0.

Versão 2.1.0

  • Compatível com o adaptador do Facebook para Android versão 5.1.0.0.
  • Compatível com o adaptador do Facebook para iOS versão 5.1.0.0.

Versão 2.0.0

  • Compatível com o adaptador do Facebook para Android versão 5.0.1.0.
  • Compatível com o adaptador do Facebook para iOS versão 5.0.1.0.

Versão 1.2.1

  • Compatível com a versão 4.99.3.0 do adaptador do Facebook para Android.
  • Compatível com o adaptador do Facebook para iOS versão 4.99.3.0.

Versão 1.2.0

  • Compatível com a versão 4.99.1.1 do adaptador do Facebook para Android.
  • Compatível com o adaptador do Facebook para iOS versão 4.99.2.0.

Versão 1.1.3

  • Compatível com a versão 4.28.2.1 do adaptador do Facebook para Android.
  • Compatível com a versão 4.28.1.2 do adaptador do Facebook para iOS.

Versão 1.1.2

  • Correção de um possível conflito com o plug-in de mediação do Unity Ads para Unity

Versão 1.1.1

  • Compatível com a versão 4.28.2.0 do adaptador do Facebook para Android.
  • Compatível com a versão 4.28.1.1 do adaptador do Facebook para iOS.

Versão 1.1.0

  • Compatível com o SDK do Facebook para Android versão 4.28.1.
  • Compatível com o SDK do Facebook para iOS versão 4.28.1.

Versão 1.0.0

  • Primeira versão!
  • Compatível com o SDK do Facebook para Android versão 4.27.0.
  • Compatível com o SDK do Facebook para iOS versão 4.27.1.