Integrar a Mintegral 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 da Mintegral com a mediação, incluindo integrações em hierarquia e de lances. Ele explica como adicionar a Mintegral à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da Mintegral a um app React Native.

Integrações e formatos de anúncio aceitos

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

Etapa 1: definir as configurações na interface da Mintegral

Inscreva-se ou faça login na sua conta da Mintegral.

Localizar a chave do app

Acesse a guia APP Setting e anote a APP Key.

Adicionar um novo aplicativo

Na guia Configuração do app, clique no botão Adicionar app.

Selecione a Plataforma e preencha o restante do formulário. Depois, clique em Salvar.

Android

iOS

Anote o ID do app.

Android

iOS

Criar uma posição do anúncio

Depois de criar o aplicativo, acesse a guia Placements & Units e clique no botão Add Placement, conforme mostrado abaixo, para criar a posição do anúncio.

Android

iOS

Insira um Nome do canal e um Formato do anúncio.

Lances

Selecione Lances de cabeçalho como o Tipo de lance. Preencha o restante do formulário e clique em Salvar.

Cascata

Selecione Hierarquia como o Tipo de lance. Preencha o restante do formulário e clique em Salvar.

Depois de criar a posição do anúncio, anote o ID da posição.

Android

iOS

Clique no menu suspenso 1 bloco de anúncios e anote o ID do bloco de anúncios.

Android

iOS

Localizar sua chave de API Reporting da Mintegral

Lances

Essa etapa não é necessária para integrações de lances.

Cascata

Você vai precisar da chave de API Reporting da Mintegral para configurar o ID do bloco de anúncios da AdMob. Acesse Conta > Ferramentas de API. Anote sua Skey e sua Secret.

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, configure um arquivo app-ads.txt para seu app.

Para implementar o app-ads.txt para a Mintegral, consulte Como o app-ads.txt pode ajudar a combater a fraude de anúncios.

Etapa 2: configurar a demanda da Mintegral 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 Mobvista/Mintegral à 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 Mobvista/Mintegral à 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 Mintegral

No diretório raiz do projeto, instale o adaptador de mediação Google Mobile Ads SDK for React Native para a Mintegral. 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/mintegral/ 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/mintegral/gma-mediation-mintegral-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-mintegral-0.1.0.tgz

    novelo

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

  3. Se você estiver criando para Android, adicione o seguinte repositório ao arquivo build.gradle no diretório android do seu projeto:

    repositories {
    google()
    mavenCentral()
    maven {
        url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
    }
}

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

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 Mintegral 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 da Mintegral. Para mais informações, consulte a documentação da Declaração de Conformidade de Privacidade do SDK da Mintegral para Android e iOS.

Etapa 5: adicionar o código necessário

Android

Não é necessário nenhum código adicional para a integração da Mintegral.

iOS

Integração da SKAdNetwork

Siga a documentação da Mintegral para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do seu projeto.

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste na AdMob.

Para receber anúncios de teste da Mintegral para formatos de anúncio nativo, premiado, intersticial e de banner, a Mintegral recomenda usar as chaves de app, os IDs de app, os IDs de posição e os IDs de bloco de anúncios fornecidos na página de ID de teste da Mintegral.

Verificar anúncios de teste

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

Códigos de erro

Se o adaptador não receber um anúncio da Mintegral, verifique o erro na resposta do anúncio usando ResponseInfo nas seguintes classes:

Android

com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

iOS

GADMediationAdapterMintegral

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

Android

Código do erro Domínio Motivo
100 com.mbridge.msdk O SDK da Mintegral retornou um callback de falha.
101 com.google.ads.mediation.mintegral Parâmetros de servidor inválidos (por exemplo, ID do app ou ID de posição ausente).
102 com.google.ads.mediation.mintegral O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela Mintegral.
103 com.google.ads.mediation.mintegral A resposta à solicitação de lance está ausente ou é inválida.
104 com.google.ads.mediation.mintegral O SDK da Mintegral retornou um erro de preenchimento.
105 com.mbridge.msdk Falha ao inicializar o SDK da Mintegral.
106 com.google.ads.mediation.mintegral Um anúncio para o espaço da Mintegral já foi carregado e ainda não foi exibido.

iOS

Código do erro Domínio Motivo
101 com.google.mediation.mintegral Parâmetros de servidor inválidos (por exemplo, ID do app ou ID de posição ausente).
102 com.google.mediation.mintegral O SDK da Mintegral retornou um erro de preenchimento.
103 com.google.mediation.mintegral O SDK da Mintegral não conseguiu mostrar um anúncio.
104 com.google.mediation.mintegral O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela Mintegral.

Versão 0.1.0

  • Versão inicial.