Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google a fim de carregar e exibir anúncios da InMobi usando mediação, cobrindo integrações de hierarquia e lances. Ele aborda como adicionar a InMobi a a configuração de mediação de um bloco de anúncios e como integrar o SDK da InMobi e adaptador em um Unity app.
Integrações e formatos de anúncio compatíveis
Integração | |
---|---|
Lances | 1 |
Cascata | |
Formatos | |
Banner | |
Intersticial | |
Premiado |
1 A integração de lances está 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 Google SDK de anúncios para dispositivos móveis. Consulte Acesse Primeiros passos para ver mais detalhes.
- Concluir a mediação Guia explicativo
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
no link de download
Registro de alterações e extração
GoogleMobileAdsInMobiMediation.unitypackage
do arquivo ZIP.
No editor de projetos do Unity, selecione Assets > Importar pacote > Personalizado
Package e selecione o arquivo GoogleMobileAdsInMobiMediation.unitypackage
baixado. Verifique se todos os arquivos estão selecionados e clique em Import.
Em seguida, selecione Recursos > Resolvedor do Play Services > Resolvedor do Android > Forçar
Resolver. A biblioteca Unity Play Services Resolver vai executar dependências
do zero e copiar as dependências declaradas no
Assets/Plugins/Android
do seu app Unity.
Etapa 4: implementar configurações de privacidade no SDK da InMobi
Consentimento da UE e GDPR
De acordo com o Consentimento dos usuários da UE do Google política, você precisa garantir que determinadas divulgações sejam fornecidas e consentimentos de usuários no Espaço Econômico Europeu (EEE) em relação a: o uso de identificadores de dispositivos e dados pessoais. Essa política reflete requisitos da Diretiva de privacidade eletrônica da UE e da Lei Geral de Proteção de Dados (GDPR). Ao solicitar consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que podem coletar, receber ou usar dados pessoais. que oferecem informações sobre o uso de cada rede. No momento, o Google não pode repassar 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
InMobi.UpdateGDPRConsent()
, que permite transmitir informações de consentimento a
InMobi. O exemplo de código a seguir mostra como transmitir informações de consentimento para o
SDK da InMobi. Se optar por chamar esse método, recomendamos que o faça antes
à solicitação de 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 a implementação do GDPR pela InMobi detalhes para mais informações sobre as possíveis chaves e valores que a InMobi aceita no esse objeto de consentimento.
Leis Estaduais de Privacidade dos EUA
Estados Unidos leis estaduais de privacidade exigem que os usuários tenham para desativar a "promoção" das suas "informações pessoais" (como a lei define esses termos), com a opção de desativação oferecida por um aviso "Não vender meus dados pessoais" Informações" na página "vendas" na página inicial de seu grupo. A Estados Unidos define a privacidade guia de conformidade com as leis, permite ativar processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não consegue aplicar essa configuração a cada anúncio rede na sua cadeia de mediação. Portanto, você deve identificar cada rede de anúncios na sua cadeia de mediação que possam participar da venda de e seguir as orientações de cada uma dessas redes para garantir compliance.
Veja os Documentação da CCPA 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 InMobi
documentação
para adicionar os identificadores 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 um desempenho ideal, a InMobi recomenda adicionar as seguintes opções
permissões 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" />
Também é possível adicionar essas permissões ao
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
no
seguintes classes:
Android
com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter
iOS
GADMAdapterInMobi
GADMediationAdapterInMobi
Aqui estão os códigos e as mensagens correspondentes gerados pelo adaptador da InMobi ao quando ocorre uma falha no carregamento do anúncio:
Android
Código do erro | Motivo |
---|---|
0-99 | Erros do SDK da InMobi. Veja 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. Isso isso nunca deve 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. |
Outro | 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 seguinte
DummyClient
foi renomeado comoPlaceholderClient
Versão 4.6.2
- Compatível com o adaptador para Android InMobi versão 10.7.4.0.
- Compatível com o adaptador para iOS da InMobi versão 10.7.4.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.1.
Versão 4.6.1
- Compatível com o adaptador para Android InMobi versão 10.7.4.0.
- Compatível com o adaptador para iOS da InMobi versão 10.7.2.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.0.
Versão 4.6.0
- Oferece suporte ao adaptador para Android InMobi versão 10.7.3.0.
- Compatível com o adaptador para iOS da InMobi versão 10.7.2.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.0.
Versão 4.5.1
- Oferece suporte ao adaptador para Android InMobi versão 10.6.7.1.
- Compatível com o adaptador para iOS da InMobi versão 10.7.2.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.0.
Versão 4.5.0
- Oferece suporte ao adaptador para Android InMobi versão 10.6.7.1.
- Compatível com o adaptador para iOS da InMobi versão 10.7.1.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.0.0.
Versão 4.4.1
- Oferece suporte ao adaptador para Android InMobi versão 10.6.2.0.
- Compatível com o adaptador para iOS da InMobi versão 10.6.0.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.6.0.
Versão 4.4.0
- Oferece suporte ao adaptador para Android InMobi versão 10.6.0.0.
- Compatível com o adaptador para iOS da InMobi versão 10.6.0.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.6.0.
Versão 4.3.3
- Oferece suporte ao adaptador para Android InMobi versão 10.5.8.0.
- Compatível com o adaptador para iOS da InMobi versão 10.5.8.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.5.2.
Versão 4.3.0
- O conteúdo do adaptador foi movido para
GoogleMobileAds/Mediation/InMobi/
. - O namespace do adaptador foi refatorado para usar
GoogleMobileAds.Mediation.InMobi
. - Oferece suporte ao adaptador para Android InMobi versão 10.5.4.1.
- Compatível com o adaptador para iOS da InMobi versão 10.5.4.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.1.0.
Versão 4.2.2
- Oferece suporte ao adaptador para Android InMobi versão 10.1.2.1.
- Compatível com o adaptador para iOS da InMobi versão 10.1.2.1.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.3.1.
Versão 4.2.1
- Oferece suporte ao adaptador para Android InMobi versão 10.1.2.0.
- Compatível com o adaptador para iOS da InMobi versão 10.1.2.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.3.1.
Versão 4.2.0
- Oferece suporte ao adaptador para Android InMobi versão 10.1.1.0.
- Compatível com o adaptador para iOS da InMobi versão 10.1.1.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.3.0.
Versão 4.1.0
- Oferece suporte ao adaptador para Android InMobi versão 10.0.9.0.
- Compatível com o adaptador para iOS da InMobi versão 10.1.0.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.3.0.
Versão 4.0.4
- Oferece suporte ao adaptador para Android InMobi versão 10.0.7.0.
- Compatível com o adaptador para iOS da InMobi versão 10.0.7.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.0.2.
Versão 4.0.3
- Oferece suporte ao adaptador para Android InMobi versão 10.0.5.0.
- Compatível com o adaptador para iOS da InMobi versão 10.0.5.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.0.0.
Versão 4.0.2
- Oferece suporte ao adaptador para Android InMobi versão 10.0.3.0.
- Compatível com o adaptador para iOS da InMobi versão 10.0.2.1.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.0.0.
Versão 4.0.1
- Oferece suporte ao adaptador para Android InMobi versão 10.0.3.0.
- Compatível com o adaptador para iOS da InMobi versão 10.0.2.0.
Versão 4.0.0
- Oferece suporte ao adaptador para Android InMobi versão 10.0.1.0.
- Compatível com o adaptador para iOS da InMobi versão 10.0.1.0.
Versão 3.2.0
- Oferece suporte ao adaptador para Android InMobi versão 9.2.0.0.
- Compatível com o adaptador para iOS da InMobi versão 9.2.1.0.
Versão 3.1.2
- Oferece suporte ao adaptador para Android InMobi versão 9.1.9.0.
- Compatível com o adaptador para iOS da InMobi versão 9.1.7.0.
Versão 3.1.1
- Oferece suporte ao adaptador para Android InMobi versão 9.1.1.0.
- Oferece suporte ao adaptador para iOS da InMobi versão 9.1.1.0.
Versão 3.1.0
- Oferece suporte ao adaptador para Android InMobi versão 9.1.0.0.
- Compatível com o adaptador para iOS da InMobi versão 9.1.0.0.
Versão 3.0.3
- Oferece suporte ao adaptador para Android InMobi versão 9.0.7.1.
- Compatível com o adaptador para iOS da InMobi versão 9.0.7.2.
Versão 3.0.2
- Oferece suporte ao adaptador para Android InMobi versão 9.0.7.0.
- Compatível com o adaptador para iOS da InMobi versão 9.0.7.0.
Versão 3.0.1
- Oferece suporte ao adaptador para Android InMobi versão 9.0.6.0.
- Compatível com o adaptador para iOS da InMobi versão 9.0.7.0.
Versão 3.0.0
- Oferece suporte ao adaptador para Android InMobi versão 9.0.4.0.
- Compatível com o adaptador para iOS da InMobi versão 9.0.4.0.
Versão 2.4.0
- Oferece suporte ao adaptador para Android InMobi versão 7.3.0.1.
- Compatível com o adaptador para iOS da InMobi versão 7.4.0.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.
- Compatível com o 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.
- Oferece suporte à versão 6.2.1.0 do adaptador para iOS.