Integrar a InMobi com a mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google com o objetivo de 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 Flutter .

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

Integração
Lances	^1
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo	^2

¹ A integração de lances está na versão Beta aberta.

² Tem suporte apenas para mediação em hierarquia.

Requisitos

• SDK dos anúncios para dispositivos móveis do Google mais recente
• Flutter 3.7.0 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 Flutter em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
• Concluir o Guia explicativo de mediação

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

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

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 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 de apps e sites e clique em Salvar e criar canais.

Canais

Depois de configurar o inventário, o sistema redirecionará você para o fluxo de trabalho de criação de posições.

Observação :se o sistema não redirecionar você para o fluxo de trabalho de criação de posições, acesse Inventário > Configurações de inventário. Em seguida, pesquise o app ou site para criar um posicionamento. Clique em Adicionar uma veiculação.

Lances

Observação :entre em contato com seu gerente de contas para ter acesso e configurar os lances no painel da InMobi.

Selecione o tipo de bloco de anúncios. Insira o Nome da 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 posição quando terminar.

Cascata

Selecione o tipo de bloco de anúncios. Em seguida, insira o Nome da veiculação, 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 for criada, os detalhes serão mostrados. Anote o ID do posicionamento, que será usado para configurar seu bloco de anúncios da AdMob.

Observação: o ID da posição do InMobi está presente no nome da posição.

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 o qual 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, passe o cursor sobre seu e-mail na guia Chave de API para redefini-la.

Ativar o modo de teste

Ative o Modo de teste para a posição em todas as impressões ativas ou somente em determinados dispositivos de teste.

Observação: o modo de teste fica desativado por padrão para todas as posições. No entanto, o modo de teste pode ser ativado para posições em todas as instâncias do app ou apenas nos dispositivos especificados.

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 à lista de parceiros de publicidade do GDPR e dos regulamentos estaduais dos EUA

Importante: verifique se você tem a permissão Gerenciamento de conta para concluir a configuração do consentimento para usuários da UE e do GDPR, da CPRA e da plataforma de mensagens do usuário. Consulte Gerenciar o acesso do usuário à sua conta para mais detalhes.

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

Observação: a falha na integração das versões compatíveis do SDK da InMobi e dos anúncios para dispositivos móveis do Google pode causar problemas de build.

Integração pelo pub.dev

Adicione a dependência a seguir com as versões mais recentes da InMobi O SDK e o adaptador na Arquivo pubspec.yaml:

dependencies:
  gma_mediation_inmobi: ^1.0.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, extrair o arquivo baixado e adicionar a pasta do plug-in extraído (e o conteúdo dela) ao seu projeto Flutter. Em seguida, consulte o plug-in pubspec.yaml adicionando a seguinte dependência:

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

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

Consentimento da UE e GDPR

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 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 não é compatível com a transmissão de informações de consentimento ao SDK da InMobi.

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 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, é necessário identificar cada rede de publicidade na 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.

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 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 em AdMob e ative o modo de teste na InMobi interface.

Importante: desative o modo de teste para AdMob e InMobi antes de lançar o app.

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

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 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 associadas 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 unificado.
104	Tentar 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 mostrado.
106	A InMobi não conseguiu mostrar um anúncio.
107	A InMobi retornou um anúncio nativo sem 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 AdMob interface estão ausentes/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 alterações do adaptador de mediação do Flutter para InMobi

Próxima versão

• Criado e testado com a versão 5.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

1.1.0

• Compatibilidade verificada com o adaptador InMobi para Android versão 10.7.5.0.
• Compatibilidade verificada com o adaptador iOS da InMobi versão 10.7.5.0.
• Criado e testado com a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

1.0.0

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