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, 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 do Ad Manager.

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, crie um arquivo app-ads.txt para o Ad Manager.

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 do Ad Manager

Faça login na sua conta do Ad Manager.

Adicionar a InMobi em "Empresas"

Ativar o compartilhamento de indicador seguro

Compartilhar indicadores seguros em solicitações de lance

Permitir o compartilhamento de indicadores seguros para Lances do SDK

Configurar os lances da InMobi

Configurar o mapeamento de blocos de anúncios

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 do Ad Manager.

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 no Ad Manager 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 os seguintes campos 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: