Integrar a Audience Network da Meta aos lances

Selecione a plataforma: Android iOS Unity Flutter Android (legada)

Este guia mostra como usar o Google Mobile Ads Flutter 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 do Flutter.

Integrações e formatos de anúncio aceitos

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

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

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

Pré-requisitos

Antes de continuar, verifique o seguinte:

  • Versão mais recente do Google Mobile Ads Flutter Plugin.
  • Versão 3.7.0 ou mais recente do framework do Flutter.
  • 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 Flutter em funcionamento configurado com Google Mobile Ads Flutter Plugin. Consulte Configurar o Google Mobile Ads Flutter Plugin para mais detalhes.
  • Configure a mediação.

    • Etapa 1: definir as configurações na interface da Audience Network da Meta

    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 precisar criar uma propriedade para o app. Insira o nome desejado para a propriedade e clique em Próxima.

    Em seguida, selecione a plataforma para monetizar.

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

    Android

    iOS

    Clique em Adicionar uma nova conta para pagamentos para configurar a sua. Você vai ser redirecionado a 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

    Integração pelo pub.dev

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

    dependencies:
  gma_mediation_meta: ^1.7.1

    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, faça referência ao 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 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 tratamento 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 o 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 do Audience Network 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 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 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 (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 do 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 do 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 pelo 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 pelo 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 adaptador de mediação da Audience Network da Meta para Flutter

    Versão 1.7.1

    Versão 1.7.0

    Versão 1.6.0

    Versão 1.5.4

    Versão 1.5.3

    Versão 1.5.2

    Versão 1.5.1

    Versão 1.5.0

    Versão 1.4.3

    Versão 1.4.2

    Versão 1.4.1

    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

    Versão 1.0.0