Integrar a InMobi com a mediação

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

Este guia mostra como usar GMA Next-Gen SDK para carregar e exibir anúncios da InMobi usando a Mediação da AdMob, 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 Android.

Integrações e formatos de anúncio aceitos

O adaptador de mediação da InMobi tem os seguintes recursos:

Requisitos

• API Android nível 24 ou mais recente.

• [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o adaptador da InMobi 10.6.3.0 ou uma versão mais recente (recomendamos usar a última versão).

• Mais recentes de GMA Next-Gen SDK

• Leia todo o guia para iniciantes da mediação.

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

Inscreva-se em uma conta da InMobi.

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

Adicionar um app

Para adicionar seu app ao painel do InMobi, clique em Inventário > Configurações de inventário.

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

Comece a digitar o URL da loja de apps publicada 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 com apps e sites e clique em Salvar e criar canais.

Canais

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

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

ID da conta

O ID da sua conta do InMobi está disponível em Finanças > Configurações de pagamento > Informações de pagamento.

Localizar a chave da API Reporting da InMobi

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 app-ads.txt no InMobi, adicione seu snippet de código personalizado.

Ativar o modo de teste

Ative o modo de teste para seu posicionamento em todas as impressões ativas 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

Adicione a InMobi à configuração de mediação do seu bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Navegue até a guia Mediação. Se você tiver um grupo de mediação que quer modificar, clique no nome dele para editar e pule para Adicionar a InMobi como uma origem de anúncios.

Para criar um grupo de mediação, selecione Criar grupo de mediação.

Insira o formato e a plataforma do anúncio, depois clique em Continuar.

Dê um nome ao grupo de mediação e selecione os locais de segmentação. Em seguida, defina o status do grupo de mediação como Ativado e clique em Adicionar blocos de anúncios.

Associe esse grupo de mediação a um ou mais dos seus blocos de anúncios da AdMob. Em seguida, clique em Concluído.

O card "Blocos de anúncios" vai aparecer com os blocos selecionados:

Adicionar a InMobi como uma origem de anúncios

Lances

No card Lances da seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione InMobi (SDK).

Clique em Como assinar um contrato de parceria e estabeleça uma parceria de lances com a InMobi.



Clique em Confirmar e concordar e em Continuar.



Se você já tiver um mapeamento para a InMobi, selecione-o. Caso contrário, clique em Adicionar mapeamento.



Em seguida, insira o ID da conta e o ID da posição obtidos na seção anterior. Em seguida, clique em Concluído.

Cascata

No card Hierarquia da seção Origens de anúncios, selecione Adicionar origem do anúncio.

Selecione InMobi e ative a chave Otimizar. Insira o nome de usuário e a chave de API obtidos na seção anterior para configurar a otimização da origem de anúncios para a InMobi. Em seguida, insira um valor de eCPM para a InMobi e clique em Continuar.



Se você já tiver um mapeamento para a InMobi, selecione-o. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira o ID da conta e o ID da posição obtidos na seção anterior. Em seguida, clique em Concluído.

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

Integração com o Android Studio (recomendada)

No arquivo gradle do app, adicione as seguintes dependências e configurações de implementação:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:inmobi:11.1.1.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:inmobi:11.1.1.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integração manual

1. Faça o download do SDK do InMobi para Android, extraia o arquivo InMobiSDK.aar na pasta libs e adicione-o ao seu projeto.

2. Navegue até os artefatos do adaptador da InMobi no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo .aar do adaptador da InMobi e adicione-o ao projeto.

3. A InMobi também exige a inclusão de outras dependências. Consulte a documentação da InMobi para mais detalhes.

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

Consentimento da UE e GDPR

Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer determinadas declarações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de receber o consentimento deles para o uso de cookies ou outros armazenamentos locais quando exigido por lei e para a coleta, o compartilhamento e o uso de dados pessoais para a 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. O Google não consegue transmitir automaticamente a escolha de consentimento do usuário para essas redes.

Na versão 7.1.0.0, o adaptador da InMobi adicionou a classe InMobiConsent, que permite transmitir informações de consentimento para a InMobi. O exemplo de código a seguir chama updateGDPRConsent() na classe InMobiConsent. Se você optar por chamar esse método, recomendamos fazer isso antes de solicitar anúncios pelo GMA Next-Gen SDK.

import com.inmobi.sdk.InMobiSdk
import com.google.ads.mediation.inmobi.InMobiConsent
// ...

val consentObject = JSONObject()
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true)
  consentObject.put("gdpr", "1")
} catch (exception: JSONException) {
  Log.e(TAG, "Error creating GDPR consent JSON.", exception)
}

InMobiConsent.updateGDPRConsent(consentObject)

import com.inmobi.sdk.InMobiSdk;
import com.google.ads.mediation.inmobi.InMobiConsent;
// ...

JSONObject consentObject = new JSONObject();
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true);
  consentObject.put("gdpr", "1");
} catch (JSONException exception) {
  Log.e(TAG, "Error creating GDPR consent JSON.", exception);
}

InMobiConsent.updateGDPRConsent(consentObject);

Consulte Detalhes da implementação do GDPR da InMobi para mais informações sobre as possíveis chaves e valores que a InMobi aceita nesse objeto de consentimento.

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.

Na versão 10.5.7.1, o adaptador da InMobi adicionou suporte para ler a string de privacidade dos EUA do IAB em preferências compartilhadas. Siga as instruções na documentação sobre as Leis Estaduais de Privacidade dos EUA para definir a string de privacidade dos EUA em preferências compartilhadas.

Além disso, consulte a documentação da CCPA da InMobi para conferir as diretrizes sobre como ativar as configurações da CCPA no painel da InMobi.

Etapa 5: código extra necessário

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

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

Permissões

Para ter o desempenho ideal, 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" />

Parâmetros específicos da rede

O adaptador da InMobi é compatível com outros parâmetros de solicitação que podem ser transmitidos para o adaptador como um pacote do Android. O adaptador procura as seguintes chaves no pacote:

Confira um exemplo de código de como definir esses parâmetros de solicitação de anúncio:

val extras = Bundle()
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_44)
extras.putString(InMobiNetworkKeys.AREA_CODE, AREA_CODE_VALUE)
val request = AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(InMobiAdapter::class.java, extras)
   .build()

Bundle extras = new Bundle();
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_44);
extras.putString(InMobiNetworkKeys.AREA_CODE, AREA_CODE_VALUE);
AdRequest request = new AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(InMobiAdapter.class, extras)
   .build();

• Substitua AD_UNIT_ID pelo ID do seu bloco de anúncios.

• Substitua AREA_CODE_VALUE pelo código de área.

Como usar anúncios nativos

Renderização de anúncios

O adaptador da InMobi retorna os anúncios nativos como objetos NativeAd. Ele preenche as seguintes descrições de campos de anúncios nativos para um NativeAd.

¹ O adaptador da InMobi não fornece acesso direto ao recurso de imagem principal dos anúncios nativos. Em vez disso, o adaptador preenche o MediaView com um vídeo ou uma imagem.

Rastreamento de impressões e cliques

O GMA Next-Gen SDK usa os callbacks do SDK da InMobi para rastreamento de impressões e cliques. Portanto, os relatórios nos dois painéis precisam corresponder com poucas ou nenhuma discrepância.

Códigos de erro

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

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

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