Integrar a InMobi com a mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios da InMobi usando mediação, cobrindo integrações de leilão e de lances. Ele aborda 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 Unity.

Integrações e formatos de anúncio compatíveis

Integração
Lances  1
Cascata
Formatos
Banner
Intersticial
Premiado

1 A integração de lances está em fase beta aberta.

Requisitos

  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Unity 4 ou mais recente
  • [Para lances]: para integrar todos os formatos de anúncio com suporte nos lances, use o plug-in de mediação de anúncios para dispositivos móveis do Google para InMobi 4.5.0 ou mais recente (recomendamos a versão mais recente).
  • Para implantar no Android
    • API do Android de nível 21 ou mais recente
  • Para implantar no iOS
    • Destino de implantação do iOS 10.0 ou mais recente
  • Um projeto do Unity configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • Concluir o Guia para iniciantes de mediação

Etapa 1: configurar a interface da InMobi

Crie uma conta da InMobi. Ao criar uma conta, deixe a opção Use InMobi SSP with Google Open Bidding desmarcada.

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

Adicionar um app

Para adicionar o 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 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 Compliance com apps e sites e clique em Salvar e criar canais.

Canais

Depois de configurar o inventário, o sistema redireciona você para o fluxo de trabalho de criação de posicionamento.

Lances

Selecione o tipo de bloco de anúncios. Insira um Nome do posicionamento, selecione Ativado e Google Open Bidding para Lances de 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 do posicionamento, selecione Desativado para Lances de 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 do posicionamento, que será usado para configurar seu bloco de anúncios da AdMob.

ID da conta

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

Localizar a chave da API InMobi Reporting

Lances

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

Cascata

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

Selecione o e-mail do usuário para quem a chave é necessária e clique em Gerar chave de API. Um arquivo contendo a chave da 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 chave de API passando o cursor sobre seu e-mail na guia Chave de API.

Ativar o modo de teste

Ative o modo de teste para sua veiculação em todas as impressões ao vivo ou apenas em determinados dispositivos de teste.

Etapa 2: configurar a demanda da InMobi na interface da AdMob

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

Android

Para instruções, consulte a etapa 2 no guia para Android.

iOS

Para ver as 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 do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar a InMobi à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA na interface da AdMob.

Etapa 3: importar o SDK e o adaptador da InMobi

OpenUPM-CLI

Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação InMobi do Google Mobile Ads para Unity no seu projeto executando o comando abaixo no diretório raiz do projeto:

openupm add com.google.ads.mobile.mediation.inmobi

OpenUPM

No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Unity Package Manager Settings.

Na guia Scoped Registries, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Escopo(s): com.google

Detalhes do OpenUPM

Em seguida, navegue até Window > Package Manager para abrir o Unity Package Manager e selecionar My Registries no menu suspenso.

Registros do Unity

Selecione o pacote Google Mobile Ads InMobi Mediation e clique em Install.

Instalar do OpenUPM

Pacote do Unity

Faça o download da versão mais recente do plug-in de mediação de anúncios para dispositivos móveis do Google para InMobi no link de download no Changelog e extraia o GoogleMobileAdsInMobiMediation.unitypackage do arquivo zip.

No editor do projeto do Unity, selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsInMobiMediation.unitypackage que você transferiu por download. Verifique se todos os arquivos estão selecionados e clique em Import.

Importar do Unity

Em seguida, selecione Assets > External Dependency Manager > Android Resolver > Force Resolve. A biblioteca do Gerenciador de dependências externas vai realizar a resolução de dependências do zero e copiar as dependências declaradas para o diretório Assets/Plugins/Android do app do Unity.

Forçar resolução

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

De acordo com a Política de consentimento para usuários da União Europeia do Google, é necessário garantir que algumas informações sejam fornecidas e que o consentimento seja obtido dos usuários no Espaço Econômico Europeu (EEE) sobre o uso de identificadores de dispositivo e dados pessoais. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Ao buscar consentimento, você precisa identificar cada rede de publicidade na cadeia de mediação que pode coletar, receber ou usar dados pessoais e fornecer informações sobre o uso de cada rede. No momento, o Google não pode transmitir a escolha de consentimento do usuário para essas redes automaticamente.

O plug-in de mediação de anúncios para dispositivos móveis do Google para InMobi versão 2.1.0 adicionou o método InMobi.UpdateGDPRConsent(), que permite transmitir informações de consentimento para InMobi. O exemplo de código abaixo mostra como transmitir informações de consentimento para o SDK da InMobi. Se você optar por chamar esse método, recomendamos que o faça antes de solicitar anúncios com o SDK dos anúncios para dispositivos móveis do Google.

using GoogleMobileAds.Api.Mediation.InMobi;
using System.Collections.Generic;
// ...

Dictionary<string, string> consentObject = new Dictionary<string, string>();
consentObject.Add("gdpr_consent_available", "true");
consentObject.Add("gdpr", "1");

InMobi.UpdateGDPRConsent(consentObject);

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

Leis Estaduais de Privacidade dos EUA

Leis estaduais de privacidade dos EUA exigem que os usuários tenham o direito de recusar a "venda" das próprias "informações pessoais" (conforme a lei define esses termos), com a opção de recusa oferecida por um link "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O guia de compliance com as leis de privacidade dos estados dos EUA oferece a capacidade de ativar o processamento de dados restrito para veiculação de anúncios do Google, mas o Google não pode aplicar essa configuração a cada rede de anúncios na sua cadeia de mediação. Portanto, é necessário identificar cada rede de publicidade na sua cadeia de mediação que possa participar da venda de informações pessoais e seguir as orientações de cada uma dessas redes para garantir a conformidade.

Consulte a documentação da CCPA da InMobi para conferir diretrizes sobre como ativar as configurações da CCPA para a InMobi.

Etapa 5: adicionar o código necessário

Android

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

iOS

Integração da SKAdNetwork

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

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste na AdMob e ative 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

Android

Permissões

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

Se quiser, adicione essas permissões ao arquivo Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml.

iOS

Não são necessárias outras etapas para a integração com o iOS.

Códigos de erro

Se o adaptador não receber um anúncio da InMobi, os editores poderão verificar o erro subjacente da 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 que acompanham os códigos gerados pelo adaptador 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 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 do anúncio solicitado não corresponde a um tamanho de banner compatível com a InMobi.
103 A solicitação de anúncio não é uma solicitação de anúncio nativo unificado.
104 Tentar solicitar um anúncio da InMobi sem inicializar o SDK da InMobi. Isso não 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 mostrado.
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 de anúncios nativos da InMobi contêm um URL com formato incorreto.
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 InMobi configurados na interface da AdMob estão ausentes ou são inválidos.
102 O InMobi Adapter não oferece suporte ao formato de anúncio solicitado.
103 Um anúncio da InMobi já foi carregado para essa configuração de rede.
Outro O SDK da InMobi retornou um erro. Consulte IMRequestStatus.h para mais detalhes.

Registro de mudanças do plug-in da InMobi Unity Mediation

Versão 4.7.0

Versão 4.6.7

Versão 4.6.6

Versão 4.6.5

Versão 4.6.4

Versão 4.6.3

Versão 4.6.2

Versão 4.6.1

Versão 4.6.0

Versão 4.5.1

Versão 4.5.0

Versão 4.4.1

Versão 4.4.0

Versão 4.3.3

Versão 4.3.0

Versão 4.2.2

Versão 4.2.1

Versão 4.2.0

Versão 4.1.0

Versão 4.0.4

Versão 4.0.3

Versão 4.0.2

Versão 4.0.1

Versão 4.0.0

Versão 3.2.0

Versão 3.1.2

Versão 3.1.1

Versão 3.1.0

Versão 3.0.3

Versão 3.0.2

Versão 3.0.1

Versão 3.0.0

Versão 2.4.0

Versão 2.3.0

  • Compatível com a versão 7.2.9.0 do adaptador Android.
  • Suporte à versão 7.3.2.0 do adaptador para iOS.

Versão 2.2.2

  • Atualizamos o plug-in para oferecer suporte à nova API Rewarded.
  • Compatível com a versão 7.2.7.0 do adaptador Android.
  • Compatível com a versão 7.2.7.0 do adaptador para iOS.

Versão 2.2.1

  • Suporte à versão 7.2.2.0 do adaptador Android.
  • Compatível com a versão 7.2.4.0 do adaptador para iOS.

Versão 2.2.0

  • Suporte à versão 7.2.1.0 do adaptador Android.
  • Suporte à versão 7.2.0.0 do adaptador iOS.

Versão 2.1.2

  • Suporte à versão 7.1.1.1 do adaptador Android.
  • Compatível com a versão 7.1.2.0 do adaptador para iOS.

Versão 2.1.1

  • Suporte à versão 7.1.1.1 do adaptador Android.
  • Compatível com a versão 7.1.1.2 do adaptador para iOS.

Versão 2.1.0

  • Compatível com a versão 7.1.0.0 do adaptador Android.
  • Suporte à versão 7.1.1.1 do adaptador iOS.
  • O método InMobi.UpdateGDPRConsent() foi adicionado

Versão 2.0.0

  • Compatível com a versão 7.0.4.0 do adaptador Android.
  • Compatível com a versão 7.1.1.0 do adaptador para iOS.

Versão 1.0.0

  • Primeira versão!
  • Compatível com a versão 6.2.4.0 do adaptador Android.
  • Compatível com a versão 6.2.1.0 do adaptador para iOS.