Integrar o InMobi à Mediação da AdMob

Este guia mostra como usar o Google Mobile Ads SDK for React Native para carregar e exibir anúncios da InMobi usando a mediação, incluindo integrações em hierarquia e de lances. Ele explica como adicionar a InMobi à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da InMobi a um app React Native.

Integrações e formatos de anúncio aceitos

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 InMobi

Inscreva-se para criar uma conta da InMobi.

Depois que sua conta for verificada, faça login.

Adicionar um app

Para adicionar seu app ao painel da InMobi, clique em Inventory > Inventory Settings.

Clique em Adicionar inventário e selecione o canal App para dispositivos móveis no menu suspenso.

Comece a digitar o URL da app store em que o app foi publicado na barra de pesquisa e selecione o app nos resultados preenchidos automaticamente. Clique em Continuar.

Se o app não estiver publicado, clique em Vincular manualmente e insira os detalhes necessários. Clique em Continuar.

Revise as configurações de Conformidade do app e do site e clique em Salvar e criar canais.

Canais

Depois de configurar seu inventário, o sistema redireciona você para o fluxo de trabalho de criação de posições.

Lances

Selecione o tipo de bloco de anúncios. Em seguida, insira um Nome do canal, selecione Ativado e Lances do SDK do Google para Lance por público-alvo e Parceiro, respectivamente, e preencha o restante do formulário. Clique em Criar posição quando terminar.

Cascata

Selecione o tipo de bloco de anúncios. Em seguida, insira um Nome da posição, selecione Desativado para Lances por público-alvo e preencha o restante do formulário. Clique em Criar posição quando terminar.

Depois que a posição é criada, os detalhes dela são mostrados. Anote o ID de posição, que será usado para configurar o bloco de anúncios da AdMob.

ID da conta

O ID da sua conta da InMobi está disponível em Finance > Payment Settings > Payment Information.

Localizar a chave de API Reporting da InMobi

Lances

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

Cascata

Acesse Minha conta > Configurações da conta. Acesse a guia Chave de API e clique em Gerar chave de API.

Selecione o e-mail do usuário que precisa da chave e clique em Gerar chave de API. Um arquivo com a chave de API e o nome de usuário/login será gerado.

Somente o administrador do editor da conta poderá gerar uma chave de API para todos os usuários. Se você esqueceu a chave de API gerada anteriormente, redefina-a passando o cursor sobre seu e-mail na guia Chave de API.

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 na InMobi, adicione seu snippet de código personalizado.

Ativar o modo de teste

Ative o Modo de teste para sua posição em todas as impressões em tempo real ou apenas em determinados dispositivos de teste.

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

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

    novelo

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

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

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 da InMobi 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 InMobi. Para mais informações, consulte o GDPR.

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 dos anúncios para dispositivos móveis do Google para a InMobi não permite transmitir informações de consentimento ao SDK da InMobi.

Etapa 5: adicionar o código extra necessário

Android

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

iOS

Integração da SKAdNetwork

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

Etapa 6: testar a implementação

Ativar anúncios de teste

Não se esqueça de registrar seu dispositivo de teste na AdMob e ativar o modo de teste na interface da InMobi.

Verificar anúncios de teste

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

Etapas opcionais

Parâmetros específicos da rede

O adaptador da InMobi permite transmitir um objeto InMobiMediationExtras à solicitação de anúncio para definir parâmetros específicos da rede. Para mais informações sobre os parâmetros disponíveis, consulte a documentação de referência da InMobi.

O exemplo de código a seguir mostra como configurar parâmetros de segmentação e registro para a InMobi:

import {
  InMobiMediationExtras,
  InMobiAgeGroup,
  InMobiEducation,
  InMobiLogLevel,
} from '@google/gma-mediation-inmobi';

const request = {
  // ...
  mediationExtras: [
    new InMobiMediationExtras({
      ageGroup: InMobiAgeGroup.BETWEEN_25_AND_29,
      education: InMobiEducation.COLLEGE_OR_GRADUATE,
      logLevel: InMobiLogLevel.DEBUG,
      age: 25,
      postalCode: '12345',
      areaCode: '678',
      language: 'en',
      city: 'NY',
      state: 'NY',
      country: 'US',
      interests: 'sports',
    }),
  ],
};

Android

Permissões

Para otimizar a performance, a InMobi recomenda adicionar as seguintes permissões opcionais ao arquivo AndroidManifest.xml do app.

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

iOS

Não é necessário fazer mais nada para a integração com o iOS.

Códigos de erro

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

Android

com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter

iOS

GADMAdapterInMobi
GADMediationAdapterInMobi

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

Android

Código do erro Motivo
0-99 Erros do SDK da InMobi. Consulte o código para mais detalhes.
100 Os parâmetros do servidor da InMobi configurados na interface da AdMob estão ausentes ou são inválidos.
101 Falha ao inicializar o SDK da InMobi.
102 O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela InMobi.
103 A solicitação de anúncio não é uma solicitação de anúncio nativo unificado.
104 Foi feita uma tentativa de solicitar um anúncio da InMobi sem inicializar o SDK da InMobi. Em teoria, isso nunca deveria acontecer, já que o adaptador inicializa o SDK da InMobi antes de solicitar anúncios da InMobi.
105 O anúncio da InMobi ainda não está pronto para ser veiculado.
106 A InMobi não conseguiu mostrar um anúncio.
107 A InMobi retornou um anúncio nativo que não tem um recurso obrigatório.
108 Os recursos de imagem do anúncio nativo da InMobi contêm um URL inválido.
109 O adaptador não conseguiu fazer o download dos recursos de imagem de anúncios nativos da InMobi.

iOS

Código do erro Motivo
101 Os parâmetros do servidor da InMobi configurados na interface da AdMob estão ausentes ou são inválidos.
102 O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela InMobi.
103 Um anúncio da InMobi já foi carregado para essa configuração de rede.
104 O anúncio nativo da InMobi foi retornado sem recursos nativos, ou não foi possível fazer o download dos recursos de imagem necessários.
105 Um anúncio da InMobi não está pronto para ser veiculado.
106 Um token de lance vazio ou nulo é retornado pela InMobi.
Outro O SDK da InMobi retornou um erro. Consulte IMRequestStatus.h para mais detalhes.

Versão 0.1.0

  • Versão inicial.