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 Flutter.
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á em fase beta aberta.
2 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 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 Flutter 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
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: ^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,
extraia o arquivo transferido 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 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 escolha de consentimento do usuário para essas redes automaticamente.
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.
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.
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 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 associadas 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 alterações do adaptador de mediação do Flutter da 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 a versão 10.7.5.0 do adaptador InMobi para Android.
- Compatibilidade verificada com a versão 10.7.5.0 do adaptador 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.
1.0.0
- Versão inicial.
- Compatibilidade verificada com a versão 10.6.7.1 do adaptador InMobi para Android.
- Compatibilidade verificada com a versão 10.7.2.0 do adaptador InMobi 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.