Integrar a Audience Network da Meta aos lances

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google a fim de carregar e exibir anúncios da Meta Audience Network usando mediação, que abrange lances integrações. Ele explica como adicionar a Meta Audience Network aos blocos de anúncios configuração de mediação e como integrar a Meta Audience Network e adaptador em um Unity app.

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

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

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

1 Audience Network da Meta se tornaram 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 (recomendamos a versão mais recente)
  • Para implantar no Android
    • API do Android 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 mais recente da Meta Audience Network geralmente exige a versão mais recente do Xcode.
  • Um projeto Unity em funcionamento configurado com SDK dos anúncios para dispositivos móveis do Google. Consulte Acesse Primeiros passos para ver mais detalhes.
  • Leia o Guia explicativo de mediação

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

Sign up and log in to the Business Manager Start page.

Click Get started then Create new account.

Fill out the required fields with your business details and click Next.

Create a property

After you've filled out the required information, you're prompted to create a property for your app. Enter the desired name of the property for your app and click Next.

Next, select your platform to monetize.

Add your app details and click Next.

Android

iOS

Set up your payment account by clicking Add a new payment account. You will be redirected to a new page to enter your payment information. Fill out the necessary details, then click Next.

Select Google AdMob as the Mediation platform, then click Create placement.

Select a format, fill out the form and click Create.

Take note of the Placement ID.

Click Done.

Turn on test mode

See the Testing Audience Network Implementation guide for detailed instructions on how to enable Meta Audience Network test ads.

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 no link de download log de mudanças e extraia o GoogleMobileAdsFacebookMediation.unitypackage do arquivo ZIP.

No editor de projetos do Unity, selecione Assets > Importar pacote > Pacote personalizado e encontre o GoogleMobileAdsFacebookMediation.unitypackage que você transferiu por download. Verifique se todos os arquivos estão selecionados e clique em Importação.

Selecione Recursos > Resolvedor do Play Services > Resolvedor do Android > Forçar resolução. Em seguida, a biblioteca Unity Play Services Resolvedor realiza a resolução de dependências. do zero e copia as dependências declaradas no 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 o Consentimento dos usuários da UE do Google política, você precisa garantir que determinadas divulgações sejam fornecidas e consentimentos de usuários no Espaço Econômico Europeu (EEE) em relação a: o uso de identificadores de dispositivos e dados pessoais. Essa política reflete requisitos da Diretiva de privacidade eletrônica da UE e da Lei Geral de Proteção de Dados (GDPR). Ao solicitar consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que podem coletar, receber ou usar dados pessoais. que oferecem informações sobre o uso de cada rede. No momento, o Google não pode repassar a opção de consentimento do usuário a essas redes automaticamente.

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

Leis Estaduais de Privacidade dos EUA

Estados Unidos leis estaduais de privacidade exigem que os usuários tenham para desativar a "promoção" das suas "informações pessoais" (como a lei define esses termos), com a opção de desativação oferecida por um aviso "Não vender meus dados pessoais" Informações" na página "vendas" da página inicial de seu grupo. A Estados Unidos define a privacidade guia de conformidade com as leis, permite ativar processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não consegue aplicar essa configuração a cada anúncio rede na sua cadeia de mediação. Portanto, você deve identificar cada rede de anúncios na sua cadeia de mediação que possam participar da venda de e seguir as orientações de cada uma dessas redes para garantir compliance.

Para usuários na Califórnia, consulte o 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. para adicionar os identificadores SKAdNetwork ao arquivo Info.plist do projeto.

Acompanhamento de publicidade ativado

Se você estiver criando para o iOS 14 ou mais recente, consulte a página da Meta Audience instruções sobre como configurar o acompanhamento de publicidade Sinalização.

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 pela padrão, o que afetará a funcionalidade do armazenamento em cache de mídia da Meta Audience SDK da rede e pode afetar a experiência do usuário e a receita de publicidade. Siga a Meta documentação 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 seguintes classes:

Android

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

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

Estes são os códigos e as mensagens correspondentes gerados pela Meta Audience Adaptador de rede 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 da 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 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 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 da Audience Network da Meta.
1000-9999 A Audience Network da Meta retornou um erro específico do SDK. Consulte Documentação da Meta Audience Network para mais detalhes.

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.