Integrar a InMobi com a mediação

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

Este guia mostra como usar o Google Mobile Ads Unity Plugin 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 Unity.

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:

  • Versão mais recente do Google Mobile Ads Unity Plugin.
  • Unity Editor versão 4 ou mais recente.
  • [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o plug-in de mediação do Google Mobile Ads para InMobi 4.5.0 ou mais recente (recomendamos usar a última versão).
  • Para implantar no Android
    • API Android nível 24 ou mais recente.
  • Para implantar no iOS
    • Destino de implantação do iOS 10.0 ou mais recente.
  • Um projeto do Unity em funcionamento configurado com Google Mobile Ads Unity Plugin. Consulte Configurar Google Mobile Ads Unity Plugin para mais detalhes.
  • Configure a mediação.

    • 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 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 do app e do site 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 posições.

    Lances

    Selecione o tipo de bloco de anúncios. Em seguida, insira um Nome do posicionamento, selecione Ativado e Lances do SDK do Google 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 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 do Ad Manager.

    ID da conta

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

    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. Navegue até 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ê tiver esquecido 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, crie um arquivo app-ads.txt para o Ad Manager.

    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 reais ou apenas em determinados dispositivos de teste.

    Etapa 2: configurar a demanda da InMobi na interface do Ad Manager

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

    Etapa 3: importar o SDK e o adaptador da InMobi

    OpenUPM-CLI

    Se a CLI do OpenUPM estiver instalada, você poderá instalar o plug-in de mediação da InMobi dos anúncios para dispositivos móveis do Google para Unity no seu projeto executando o seguinte comando no diretório raiz do projeto:

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

    OpenUPM

    No editor do projeto do Unity, selecione Edit > Configurações do Projeto > Package Manager para abrir as configurações do gerenciador de pacotes do Unity.

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

    • Nome: OpenUPM
    • URL: https://package.openupm.com
    • Escopos: com.google

    Detalhes do OpenUPM

    Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.

    Registros do Unity

    Selecione o pacote Mediação do Google Mobile Ads InMobi e clique em Instalar.

    Instalar pelo OpenUPM

    Pacote do Unity

    Baixe a versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para a InMobi no link de download do registro de alterações 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ê salvou. Verifique se todos os arquivos estão selecionados e clique em Importar.

    Importar do Unity

    Em seguida, selecione Recursos > Gerenciador de dependências externas > Resolvedor do Android > Forçar resolução. A biblioteca do External Dependency Manager vai realizar a resolução de dependências do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do seu app Unity.

    Forçar resolução

    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 algumas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de pedir o consentimento deles para usar cookies ou outro 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 partir da versão 4.6.4 do plug-in de mediação da InMobi para Unity, a InMobi lê automaticamente o consentimento do GDPR definido por plataformas de gestão de consentimento que aceitam a especificação de consentimento adicional do Google, incluindo o SDK da UMP. Para mais informações, consulte a documentação da InMobi sobre como inicializar o SDK para Android e iOS.

    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.

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

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

    Android

    Nenhum código adicional é necessário 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 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

    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" />

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

    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 subjacente 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 do Ad Manager 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 compatível com a InMobi.
    103 A solicitação de anúncio não é uma solicitação de anúncio nativo unificado.
    104 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 de anúncios nativos da InMobi contêm um URL inválido.
    109 O adaptador não conseguiu fazer o download dos recursos de imagem de anúncio nativo da InMobi.

    iOS

    Código do erro Motivo
    101 Os parâmetros do servidor da InMobi configurados na interface do Ad Manager estão ausentes ou são inválidos.
    102 O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível com a 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.

    Registro de alterações do plug-in de mediação da InMobi para Unity

    Versão 5.4.0 (em andamento)

    Versão 5.3.3

    Versão 5.3.2

    Versão 5.3.1

    Versão 5.3.0

    Versão 5.2.0

    Versão 5.1.0

    Versão 5.0.2

    Versão 5.0.1

    Versão 5.0.0

    Versão 4.7.7

    Versão 4.7.6

    Versão 4.7.5

    Versão 4.7.4

    Versão 4.7.3

    Versão 4.7.2

    Versão 4.7.1

    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 para Android.
    • Compatível com a versão 7.3.2.0 do adaptador do iOS.

    Versão 2.2.2

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

    Versão 2.2.1

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

    Versão 2.2.0

    • Compatível com a versão 7.2.1.0 do adaptador para Android.
    • Compatível com a versão 7.2.0.0 do adaptador para iOS.

    Versão 2.1.2

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

    Versão 2.1.1

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

    Versão 2.1.0

    • Compatível com a versão 7.1.0.0 do adaptador para Android.
    • Compatível com a versão 7.1.1.1 do adaptador para 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 do Android.
    • Compatível com a versão 7.1.1.0 do adaptador do iOS.

    Versão 1.0.0

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