Integrar a InMobi com a mediação

Selecione a plataforma: Android Novo Android iOS Unity Flutter

Este guia mostra como usar Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da InMobi usando a mediação, incluindo integrações de lances e em hierarquia. 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 Flutter.

Integrações e formatos de anúncio aceitos

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo

Requisitos

  • Mais recente Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 ou mais recente
  • [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o plug-in de mediação dos anúncios para dispositivos móveis do Google para InMobi 4.5.0 ou uma versão mais recente (recomendamos usar a última versão)
  • Para implantação no Android
    • Nível 23 ou mais recente da API Android
  • Para implantação no iOS
    • Destino de implantação do iOS 10.0 ou mais recente
  • Um projeto do Flutter em funcionamento configurado com Google Mobile Ads Flutter Plugin. Consulte Configurar Google Mobile Ads Flutter Plugin para mais detalhes.
  • Configurar a mediação.

Etapa 1: configurar 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 da InMobi, clique em Inventory > Inventory Settings.

Clique em Add Inventory e selecione o canal Mobile App 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 Link manually e insira os detalhes necessários. Clique em Continuar.

Revise as configurações de App &Website Compliance e clique em Save and Create Placements.

Canais

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

Lances

Selecione o tipo de bloco de anúncios. Em seguida, insira um Nome do canal, selecione Ativado e Open Bidding do Google para Lances de público-alvo e Parceiro respectivamente, e preencha o restante do formulário. Clique em Criar canal quando terminar.

Cascata

Selecione o tipo de bloco de anúncios. Em seguida, insira um Nome do canal, selecione Desativado para Lances de público-alvo e preencha o restante do formulário. Clique em Criar canal quando terminar.

Depois que o canal é criado, os detalhes dele são mostrados. Anote o ID do canal, 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 Finance > Payment Settings > Payment Information.

Localizar a chave da API Reporting da InMobi

Lances

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

Cascata

Acesse My Account > Account Settings. Navegue até a guia API Key e clique em Generate API Key.

Selecione o e-mail do usuário para o qual a chave é necessária e clique em Generate API Key. Um arquivo contendo a chave de API e o nome de usuário/login será gerado.

Somente o administrador da conta do editor poderá gerar uma chave de API para todos os usuários. Se você esqueceu a chave de API gerada anteriormente, redefina-a passando o cursor sobre o e-mail na guia API Key.

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 anúncios, você precisa implementar 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 seu canal 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

Definir 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 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

Google Mobile Ads Flutter Plugin

Integração pelo pub.dev

Adicione a dependência abaixo com as versões mais recentes do SDK e do adaptador da InMobi no arquivo pubspec.yaml do pacote:

dependencies:
  gma_mediation_inmobi: ^2.1.0

Integração manual

Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para InMobi, extraia o arquivo baixado e adicione a pasta do plug-in extraído (e o conteúdo dela) ao seu projeto do Flutter. Em seguida, faça referência ao plug-in no arquivo pubspec.yaml adicionando a dependência abaixo:

dependencies:
  gma_mediation_inmobi:
    path: path/to/local/package

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 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.

A partir da versão 1.1.0 do plug-in de mediação da InMobi para Flutter, 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 na sua cadeia de mediação que possa participar da venda de informações pessoais e siga as orientações de cada uma dessas redes para garantir a conformidade.

O plug-in de mediação dos anúncios para dispositivos móveis do Google para InMobi não oferece suporte à transmissão de informações de consentimento para o SDK da InMobi.

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

Android

Nenhum código extra é 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 seu projeto.

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste no Ad Manager 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 InMobi (lances) e InMobi (hierarquia) origens de anúncios.

Etapas opcionais

Android

Permissões

Para um desempenho ideal, a InMobi recomenda adicionar as seguintes permissões opcionais ao arquivo AndroidManifest.xml do seu 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

Nenhuma etapa extra é necessária para a integração do iOS.

Códigos de erro

Se o adaptador não receber um anúncio da InMobi, os editores 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 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 Tentativa de solicitar um anúncio da InMobi sem inicializar o SDK da InMobi. Em teoria, isso nunca acontece, 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 malformado.
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 da InMobi configurados na interface do Ad Manager estão ausentes ou são inválidos.
102 O adaptador da InMobi não oferece suporte ao formato de anúncio solicitado.
103 Um anúncio da InMobi já está carregado para essa configuração de rede.
Outro O SDK da InMobi retornou um erro. Consulte IMRequestStatus.h para mais detalhes.

Registro de alterações do adaptador de mediação da InMobi para o Flutter

Versão 2.1.0

  • Versão mínima do Flutter atualizada para 3.38.1.
  • Atualizado para oferecer suporte à versão 8.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
  • Oferece suporte à versão 11.2.0.0 do adaptador da InMobi para Android.
  • Oferece suporte à versão 11.2.0.0 do adaptador da InMobi para iOS.
  • Criado e testado com a versão 8.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 2.0.1

  • Versão mínima do Flutter atualizada para 3.35.1
  • Atualizado para oferecer suporte à versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter
  • Oferece suporte à versão 11.1.0.1 do adaptador da InMobi para Android.
  • Oferece suporte à versão 11.1.0.1 do adaptador da InMobi para iOS .
  • Criado e testado com a versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 2.0.0

  • Oferece suporte à versão 11.1.0.0 do adaptador da InMobi para Android.
  • Oferece suporte à versão 11.1.0.0 do adaptador da InMobi para iOS.
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.1.6

  • Oferece suporte à versão 10.8.8.1 do adaptador da InMobi para Android.
  • Oferece suporte à versão 10.8.8.0 do adaptador da InMobi para iOS.
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.1.5

  • Oferece suporte à versão 10.8.8.0 do adaptador da InMobi para Android.
  • Oferece suporte à versão 10.8.8.0 do adaptador da InMobi para iOS.
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.1.4

  • Oferece suporte à versão 10.8.7.0 do adaptador da InMobi para Android .
  • Oferece suporte à versão 10.8.6.0 do adaptador da InMobi para iOS.
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.1.3

  • Oferece suporte à versão 10.8.3.1 do adaptador da InMobi para Android.
  • Oferece suporte à versão 10.8.3.1 do adaptador da InMobi para iOS.
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.1.2

  • Oferece suporte à versão 10.8.3.1 do adaptador da InMobi para Android.
  • Oferece suporte à versão 10.8.3.0 do adaptador da InMobi para iOS.
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.1.1

  • Oferece suporte à versão 10.8.2.0 do adaptador da InMobi para Android.
  • Oferece suporte à versão 10.8.2.0 do adaptador da InMobi para iOS.
  • Criado e testado com a versão 6.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.1.0

  • O plug-in do iOS agora é um framework estático.
  • Oferece suporte à versão 10.8.0.0 do adaptador da InMobi para Android.
  • Oferece suporte à versão 10.8.0.0 do adaptador da InMobi para iOS.
  • Criado e testado com a versão 5.3.1 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.0.0

  • Versão inicial.
  • Oferece suporte à versão 10.6.7.1 do adaptador da InMobi para Android.
  • Oferece suporte à versão 10.7.2.0 do adaptador da InMobi para iOS.
  • Criado e testado com a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.