Integrar a Moloco à mediação

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 do SDK da Moloco Ads com a mediação, incluindo as integrações de lances. Ele explica como adicionar o SDK de anúncio da Moloco à configuração de mediação de um bloco de anúncios e como integrar o SDK de anúncio da Moloco 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 o SDK de anúncio da Moloco tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Abertura do aplicativo
Banner
Intersticial
Premiado
Intersticial premiado
Nativo

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 13.0 ou mais recente.
  • 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 do SDK da Moloco Ads

    Faça login no Portal do editor da Moloco.

    Navegue até a guia Overview > Apps e clique no botão Add app para criar um novo app.

    Selecione o SO e as Configurações de privacidade do app, preencha o restante do formulário e clique em Create.

    Android

    iOS

    Depois que o app for criado, selecione-o na guia Apps para ver os detalhes e anote a chave do app.

    Android

    iOS

    Acesse a guia Overview > Blocos de anúncios, selecione o app no menu suspenso e clique em Novo bloco de anúncios.

    Selecione In-app bidding como o Auction method e preencha o restante do formulário. Depois clique em Criar.

    Acesse o bloco de anúncios recém-criado na guia Ad Units para ver os detalhes dele. Anote o ID do bloco de anúncios.

    Etapa 2: configurar a demanda do SDK de anúncio da Moloco Ads 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 Moloco Ads à 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 Moloco Ads à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface do Ad Manager.

    Etapa 3: importar o SDK de anúncio e o adaptador da Moloco Ads

    Integração pelo pub.dev

    Adicione a seguinte dependência com as versões mais recentes do SDK de anúncio da Moloco Ads e do adaptador no arquivo pubspec.yaml do seu pacote:

    dependencies:
  gma_mediation_moloco: ^3.7.1

    Integração manual

    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 o SDK de anúncio da Moloco, 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_moloco:
    path: path/to/local/package

    Etapa 4: implementar configurações de privacidade no SDK da Moloco

    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.

    A versão 1.0.0 e mais recentes do adaptador do Flutter do SDK de anúncio da Moloco aceitam a transmissão de indicadores de consentimento do GDPR de plataformas de gestão de consentimento que se integram à Estrutura de Transparência e Consentimento (TCF) do IAB para o SDK de anúncio da Moloco. Para mais informações, consulte a documentação do MolocoPrivacy para Android e a string de consentimento da TCF para iOS.

    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.

    O plug-in de mediação do SDK de anúncios para dispositivos móveis do Google para Unity do SDK da Moloco inclui o método Moloco.SetDoNotSell(bool) para transmitir informações de consentimento ao SDK da Moloco. O exemplo de código a seguir mostra como transmitir essas informações de consentimento para o SDK de anúncio da Moloco Ads. Se você optar por definir essas flags, recomendamos fazer isso antes de solicitar anúncios pelo Google Mobile Ads Flutter Plugin.

    import 'package:gma_mediation_moloco/gma_mediation_moloco.dart';
// ...

GmaMediationMoloco.setDoNotSell(true);

    Consulte as instruções de implementação recomendadas do SDK de anúncio da Moloco para Android e iOS para mais detalhes.

    Etapa 5: adicionar o código necessário

    Nenhum código adicional é necessário para a integração do SDK da Moloco Ads.

    Etapa 6: testar a implementação

    Ativar anúncios de teste

    Registre seu dispositivo de teste no Ad Manager.

    Verificar anúncios de teste

    Para verificar se você está recebendo anúncios de teste do SDK de anúncio da Moloco, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Moloco (lances).

    Códigos de erro

    Se o adaptador não receber um anúncio da Moloco, os publishers poderão verificar o erro na resposta do anúncio usando ResponseInfo nas seguintes classes:

    Android

    com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

    iOS

    MolocoSDK.MolocoError
GADMediationAdapterMoloco

    Confira os códigos e as mensagens correspondentes gerados pelo adaptador da Moloco quando um anúncio não é carregado:

    Android

    Código do erro Domínio Motivo
    101 com.google.ads.mediation.moloco A chave do app da Moloco está ausente ou é inválida.
    102 com.google.ads.mediation.moloco O ID do bloco de anúncios da Moloco está ausente ou é inválido.
    103 com.google.ads.mediation.moloco O objeto de anúncio da Moloco retornado era nulo.
    -1 a 5000 com.moloco.sdk O SDK da Moloco retornou um erro. Consulte a documentação da empresa para mais detalhes.

    iOS

    Código do erro Domínio Motivo
    101 com.google.ads.mediation.moloco O SDK da Moloco não oferece suporte à veiculação de anúncios no iOS 12 e em versões anteriores.
    102 com.google.ads.mediation.moloco A chave do app da Moloco está ausente ou é inválida.
    103 com.google.ads.mediation.moloco O ID do bloco de anúncios da Moloco está ausente ou é inválido.
    104 com.google.ads.mediation.moloco O anúncio não está pronto para ser veiculado.
    105 com.google.ads.mediation.moloco O anúncio não foi exibido.
    106 com.google.ads.mediation.moloco Os dados de renderização não estão disponíveis para renderizar o anúncio.
    -1 a 5000 Enviado pelo SDK da Moloco. O SDK da Moloco retornou um erro. Consulte a documentação da empresa para mais detalhes.

    Registro de alterações do adaptador de mediação da Moloco para o Flutter

    Versão 3.8.0 (em andamento)

    Versão 3.7.1

    Versão 3.7.0

    Versão 3.6.1

    Versão 3.6.0

    Versão 3.5.1

    Versão 3.5.0

    Versão 3.4.0

    Versão 3.3.0

    Versão 3.2.0

    Versão 3.1.0

    Versão 3.0.0

    Versão 2.1.0

    Versão 2.0.0

    Versão 1.6.0

    Versão 1.5.0

    Versão 1.4.0

    Versão 1.3.1

    Versão 1.3.0

    Versão 1.2.0

    Versão 1.1.0

    Versão 1.0.0