Integrar a Moloco com a Mediação da AdMob

Este guia mostra como usar o Google Mobile Ads SDK for React Native 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 da Moloco Ads à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da Moloco Ads a um app React Native.

Integrações e formatos de anúncio aceitos

O adaptador de mediação da AdMob 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

Pré-requisitos

Antes de continuar, verifique o seguinte:

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 da Moloco Ads na interface da AdMob

Definir as configurações de mediação do bloco de anúncios

Android

Para ver as 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 da AdMob.

Etapa 3: importar o SDK e o adaptador da Moloco Ads

No diretório raiz do seu projeto, instale o adaptador de mediação para o SDK de anúncio da Moloco Ads.Google Mobile Ads SDK for React Native Preencha os campos:

  1. Copie o arquivo tar do adaptador Google Mobile Ads SDK for React Native do diretório gma-sdk-react-native/adapters/moloco/ para o diretório local_packages/ do projeto. Se você não tiver a pasta adapters, consulte Pré-requisitos.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/moloco/gma-mediation-moloco-0.1.0.tgz local_packages/

    Substitua EXTRACT_DIR pelo caminho para o diretório em que você extraiu o arquivo.

  2. Instale o pacote do adaptador usando o gerenciador de pacotes de sua preferência:

    npm

    npm install ./local_packages/gma-mediation-moloco-0.1.0.tgz

    novelo

    yarn add ./local_packages/gma-mediation-moloco-0.1.0.tgz

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 0.1.0 e mais recentes do adaptador do SDK de anúncio da Moloco para React Native 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 SDK for React Native.

import { MolocoMediation } from '@google/gma-mediation-moloco';
// ...

MolocoMediation.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

Não é necessário nenhum código adicional para integrar o SDK de anúncio da Moloco.

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste na AdMob.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste do SDK da Moloco Ads, 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.
104 com.google.ads.mediation.moloco Falha ao inicializar o SDK da Moloco.
-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 exibido.
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.

Versão 0.1.0

  • Versão inicial.