Integrar a Audience Network da Meta aos lances

Este guia mostra como usar o Google Mobile Ads Unity Plugin para carregar e exibir anúncios da Audience Network da Meta com 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 Unity.

Integrações e formatos de anúncio aceitos

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

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

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

Pré-requisitos

Antes de continuar, verifique o seguinte:

  • Versão mais recente do Google Mobile Ads Unity Plugin.
  • Unity Editor versão 5.6 ou mais recente.
  • Plug-in de mediação dos anúncios para dispositivos móveis do Google para Meta Audience Network 2.11.0 (recomendamos usar a versão mais recente).
  • 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 Unity em funcionamento configurado com Google Mobile Ads Unity Plugin. Consulte Configurar Google Mobile Ads Unity Plugin para mais detalhes.
  • Configure a mediação.
  • Etapa 1: definir 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 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 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

    Configure sua conta para pagamentos clicando em Adicionar uma nova conta para pagamentos. 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 Ad Manager 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, crie um arquivo app-ads.txt para o Ad Manager.

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

    Definir 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 Audience Network da Meta

    OpenUPM-CLI

    Se a OpenUPM-CLI estiver instalada, você poderá instalar o plug-in de mediação da Audience Network da Meta para Unity dos anúncios para dispositivos móveis do Google no seu projeto executando o seguinte comando no diretório raiz do projeto:

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

    OpenUPM

    No editor do projeto do Unity, selecione Edit > Configurações do projeto > Package Manager para abrir as Configurações do gerenciador de pacotes do Unity.

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

    • Nome: OpenUPM
    • URL: https://package.openupm.com
    • Escopos: com.google

    Detalhes do OpenUPM

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

    Registros do Unity

    Selecione o pacote Google Mobile Ads MetaAudienceNetwork Mediation e clique em Install.

    Instalar pelo OpenUPM

    Pacote do Unity

    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 usando o link de download no Registro de alterações 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ê salvou. Verifique se todos os arquivos estão selecionados e clique em Importar.

    Importar do Unity

    Em seguida, selecione Recursos > Gerenciador de dependências externas > Resolvedor do Android > Forçar resolução. A biblioteca do Gerenciador de Dependências Externas vai realizar a resolução de dependências do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do seu app Unity.

    Forçar resolução

    Etapa 4: implementar configurações de privacidade no SDK do 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 processamento 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 da SKAdNetwork ao arquivo Info.plist do seu projeto.

    Acompanhamento de publicidade 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

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

    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 Audience Network da Meta (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 da 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 geradas 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 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 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 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 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 plug-in de mediação do Unity da Audience Network da Meta

    Versão 3.20.1

    Versão 3.20.0

    Versão 3.19.0

    Versão 3.18.7

    Versão 3.18.6

    Versão 3.18.5

    Versão 3.18.4

    Versão 3.18.3

    Versão 3.18.2

    Versão 3.18.1

    Versão 3.18.0

    Versão 3.17.3

    Versão 3.17.2

    Versão 3.17.1

    Versão 3.17.0

    Versão 3.16.0

    Versão 3.15.0

    Versão 3.14.0

    Versão 3.13.1

    Versão 3.13.0

    Versão 3.12.2

    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 a 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 a versão 5.5.0.0 do adaptador do Facebook para Android.
    • Compatível com a versão 5.5.1.0 do adaptador do Facebook para iOS.

    Versão 2.5.0

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

    Versão 2.4.1

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

    Versão 2.4.0

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

    Versão 2.3.2

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

    Versão 2.3.1

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

    Versão 2.3.0

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

    Versão 2.2.0

    • Atualizamos o plug-in para oferecer suporte à nova API Rewarded em versão Beta aberta.
    • Compatível com a versão 5.2.0.1 do adaptador do Facebook para Android.
    • Compatível com a versão 5.2.0.1 do adaptador do Facebook para iOS.

    Versão 2.1.1

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

    Versão 2.1.0

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

    Versão 2.0.0

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

    Versão 1.2.1

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

    Versão 1.2.0

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

    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

    • Foi corrigido um possível conflito com o plug-in de mediação do Unity Ads.

    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

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

    Versão 1.0.0

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