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 exibir anúncios da InMobi usando a mediação, abrangendo integrações de hierarquia e 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
Nativo  2

1 A integração de lances está na versão Beta fechada. Entre em contato com seu gerente de contas para solicitar acesso.

Requisitos

  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Unity 4 ou mais recente
  • Para implantar no Android:
    • Android API de nível 21 ou mais recente
  • Para implantar no iOS:
    • Destino de implantação do iOS de 10.0 ou mais recente
  • Um projeto Unity em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte o artigo Começar para ver mais detalhes.
  • Leia o Guia explicativo de mediação.

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

Inscreva-se para uma conta da InMobi.

Lances

Selecione Usar InMobi SSP com o Google Open Bidding e insira seu ID de editor do Google.

Cascata

Nenhuma outra etapa é necessária para integrações de hierarquia.

Faça login na sua conta da InMobi após a verificação.

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 app store 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 Compliance do aplicativo 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 da posição.

Lances

Selecione o tipo de bloco de anúncios. Insira um nome de posição, 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 veiculação quando terminar.

Cascata

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

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

ID da conta

O ID da conta da 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 o qual a chave é necessária e clique em Gerar chave de API. Um arquivo contendo 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 do mouse sobre o e-mail na guia Chave de API.

Ativar modo de teste

Ative o modo de teste da posição em todas as impressões ativas ou somente em determinados dispositivos de teste.

Etapa 2: configurar a demanda da InMobi na AdMob interface

Definir as configurações de mediação para seu bloco de anúncios

Android

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

iOS

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

Adicionar InMobi ao GDPR e à lista de parceiros de publicidade 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 InMobi à lista de parceiros de anúncios do GDPR e das regulamentações estaduais dos EUA na AdMob IU.

Etapa 3: importar o SDK e o adaptador da InMobi

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 a InMobi pelo link de download no log de mudanças e extraia o GoogleMobileAdsInMobiMediation.unitypackage do arquivo ZIP.

No editor de projetos do Unity, selecione Assets > Import Package > Custom Package e escolha o arquivo GoogleMobileAdsInMobiMediation.unitypackage transferido por download. Verifique se todos os arquivos estão selecionados e clique em Import.

Em seguida, selecione Assets > Play Services Resolver > Android Resolver > Force Resolve. A biblioteca do resolvedor do Unity Play Services vai realizar a resolução das dependências do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do seu app do Unity.

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

De acordo com a Política de consentimento de usuários da União Europeia do Google, você precisa garantir que algumas divulgações sejam fornecidas aos usuários no Espaço Econômico Europeu (EEE) e que eles tenham o consentimento deles em relação ao uso de identificadores de dispositivos 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 solicitar o consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode coletar, receber ou usar dados pessoais, além de fornecer informações sobre o uso de cada rede. No momento, o Google não pode transmitir a opção de consentimento do usuário a essas redes automaticamente.

O plug-in de mediação de anúncios para dispositivos móveis do Google para a InMobi versão 2.1.0 adicionou o método InMobi.UpdateGDPRConsent(), que permite transmitir informações de consentimento para a InMobi. O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK da InMobi. Se você optar por chamar esse método, recomendamos que faça isso 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 de 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

Leis Estaduais de Privacidade dos EUA exigem que os usuários escolham não autorizar a "venda" das próprias "informações pessoais" (conforme a definição desses termos) usando um link em destaque "Não vender minhas informações pessoais" na página inicial do "vendedor". O Guia de conformidade com as leis de privacidade dos estados dos EUA permite ativar o processamento 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, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode 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 ver diretrizes sobre 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 à InMobi.

iOS

Integração com a SKAdNetwork

Siga a documentação da InMobi (link em inglês) 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 em AdMob e ative o modo de teste na InMobi interface.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste do InMobi, ative os testes de uma única origem no Ad Inspector usando as InMobi (Bidding) and InMobi (Waterfall) origens de anúncios.

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

Também é possível adicionar essas permissões ao arquivo Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml.

iOS

Nenhuma outra etapa é necessária 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 classes abaixo:

Android

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

iOS

GADMAdapterInMobi
GADMediationAdapterInMobi

Veja a seguir os códigos e as mensagens correspondentes geradas 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 InMobi configurados na AdMob interface estão ausentes/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 unificada.
104 Você tentou solicitar um anúncio da InMobi sem inicializar o SDK da InMobi. Teoricamente, 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 exibido.
106 A InMobi não conseguiu exibir um anúncio.
107 A InMobi retornou um anúncio nativo sem um recurso obrigatório.
108 Os recursos de imagem do anúncio nativo da InMobi contêm um URL incorreto.
109 O adaptador falhou ao fazer o download dos recursos de imagem do anúncio nativo da InMobi.

iOS

Código do erro Motivo
101 Os parâmetros do servidor InMobi configurados na AdMob interface estão ausentes/inválidos.
102 O adaptador InMobi não é compatível com o formato de anúncio solicitado.
103 Um anúncio da InMobi já foi carregado para esta configuração de rede.
Outros O SDK da InMobi retornou um erro. Consulte IMRequestStatus.h para mais detalhes.

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

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

  • Oferece suporte ao adaptador do Android versão 7.2.9.0.
  • Oferece suporte ao adaptador para iOS versão 7.3.2.0.

Versão 2.2.2

  • O plug-in foi atualizado para oferecer suporte à nova API Premiada.
  • Oferece suporte ao adaptador do Android versão 7.2.7.0.
  • Oferece suporte ao adaptador para iOS versão 7.2.7.0.

Versão 2.2.1

  • Oferece suporte ao adaptador do Android versão 7.2.2.0.
  • Oferece suporte ao adaptador para iOS versão 7.2.4.0.

Versão 2.2.0

  • Oferece suporte ao adaptador do Android versão 7.2.1.0.
  • Compatível com o adaptador de iOS versão 7.2.0.0.

Versão 2.1.2

  • Oferece suporte ao adaptador do Android versão 7.1.1.1.
  • Oferece suporte ao adaptador para iOS versão 7.1.2.0.

Versão 2.1.1

  • Oferece suporte ao adaptador do Android versão 7.1.1.1.
  • Compatível com o adaptador de iOS versão 7.1.1.2.

Versão 2.1.0

  • Oferece suporte ao adaptador do Android versão 7.1.0.0.
  • Oferece suporte ao adaptador de iOS versão 7.1.1.1.
  • O método InMobi.UpdateGDPRConsent() foi adicionado

Versão 2.0.0

  • Oferece suporte ao adaptador do Android versão 7.0.4.0.
  • Oferece suporte ao adaptador para iOS versão 7.1.1.0.

Versão 1.0.0

  • Primeira versão!
  • Oferece suporte ao adaptador do Android versão 6.2.4.0.
  • Compatível com o adaptador de iOS versão 6.2.1.0.