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 em hierarquia 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 Unity.
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á em versão Beta fechada. Entre em contato com seu gerente de contas para solicitar acesso.
Requisitos
- Unity 4 ou mais recente
- SDK dos anúncios para dispositivos móveis do Google mais recente
- Para implantar no Android
- Android API de nível 19 ou mais recente
- Para implantar no iOS:
- Meta de implantação do iOS 10.0 ou mais recente
- Um projeto do Unity 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
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.
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únciosAd Manager .
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
Acesse Minha conta > Configurações da conta. Acesse 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ê esqueceu 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 Ad Manager 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 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 Ad Manager 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 InMobi no link de download no Registro de mudanças e extraia GoogleMobileAdsInMobiMediation.unitypackage
do arquivo ZIP.
No editor de projetos do Unity, selecione Assets > Import Package > Custom
Package e selecione o arquivo GoogleMobileAdsInMobiMediation.unitypackage
que você
fez o 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 Play Services do Unity executará a resolução
de dependências do zero e copiará as dependências declaradas para o
diretório Assets/Plugins/Android
do seu app Unity.
Etapa 4: implementar as configurações de privacidade no SDK da InMobi
Consentimento da UE e o GDPR
De acordo com a Política de consentimento de usuários da União Europeia do Google, você precisa garantir que determinadas divulgações sejam fornecidas aos usuários no Espaço Econômico Europeu (EEE) e recebam os consentimentos 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 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 uma delas. No momento, o Google não pode transmitir automaticamente a escolha de consentimento do usuário a essas redes.
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 chaves e os valores possíveis que a InMobi aceita nesse objeto de consentimento.
Leis Estaduais de Privacidade dos EUA
As 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 definição desses termos) com um link "Não vender minhas informações pessoais" destacado na página inicial do vendedor. O guia de conformidade com as leis de privacidade dos EUA oferece a capacidade de ativar o processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não pode 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 essas configurações.
Etapa 5: adicionar o código extra necessário
Android
A integração com a InMobi não é necessária.
iOS
Integração da SKAdNetwork
Siga a documentação
da InMobi (link em inglês)
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 em Ad Manager 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 permissões opcionais
abaixo 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
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
seguintes classes:
Android
com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter
iOS
GADMAdapterInMobi
GADMediationAdapterInMobi
Veja os códigos e as mensagens associadas 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. Confira o código para mais detalhes. |
100 | Os parâmetros do servidor InMobi configurados na interface Ad Manager estão ausentes/inválidos. |
101 | Falha ao inicializar o SDK da InMobi. |
102 | O tamanho de 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 | Tentativa de solicitar um anúncio da InMobi sem inicializar o SDK da InMobi. Em teoria, 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 falhou ao 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 têm um URL incorreto. |
109 | Ocorreu uma falha no adaptador 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 interface Ad Manager estão ausentes/inválidos. |
102 | O adaptador InMobi não é compatível com o formato de anúncio solicitado. |
103 | Um anúncio InMobi já está carregado para esta configuração de rede. |
Outros | O SDK da InMobi retornou um erro. Consulte IMRequestStatus.h para mais detalhes. |
Registros de alterações do plug-in de mediação do Unity da InMobi
Versão 4.4.1
- Compatível com a versão 10.6.2.0 do adaptador para Android InMobi.
- Compatível com a versão 10.6.0.0 do adaptador para iOS da InMobi.
- 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
- Compatível com a versão 10.6.0.0 do adaptador para Android InMobi.
- Compatível com a versão 10.6.0.0 do adaptador para iOS da InMobi.
- 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
- Compatível com a versão 10.5.8.0 do adaptador para Android InMobi.
- Compatível com a versão 10.5.8.0 do adaptador para iOS da InMobi.
- 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
- Compatível com a versão 10.5.4.1 do adaptador para Android InMobi.
- Compatível com a versão 10.5.4.0 do adaptador para iOS da InMobi.
- 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
- Compatível com a versão 10.1.2.1 do adaptador para Android da InMobi.
- Compatível com a versão 10.1.2.1 do adaptador para iOS da InMobi.
- 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
- Compatível com a versão 10.1.2.0 do adaptador para Android InMobi.
- Compatível com a versão 10.1.2.0 do adaptador para iOS da InMobi.
- 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
- Compatível com a versão 10.1.1.0 do adaptador para Android InMobi.
- Compatível com a versão 10.1.1.0 do adaptador para iOS da InMobi.
- Criada e testada 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
- Compatível com a versão 10.0.9.0 do adaptador para Android InMobi.
- Compatível com a versão 10.1.0.0 do adaptador para iOS da InMobi.
- Criada e testada 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
- Compatível com a versão 10.0.7.0 do adaptador para Android InMobi.
- Compatível com a versão 10.0.7.0 do adaptador para iOS da InMobi.
- 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
- Compatível com a versão 10.0.5.0 do adaptador para Android InMobi.
- Compatível com a versão 10.0.5.0 do adaptador para iOS da InMobi.
- 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
- Compatível com a versão 10.0.3.0 do adaptador para Android InMobi.
- Compatível com a versão 10.0.2.1 do adaptador para iOS da InMobi.
- 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
- Compatível com a versão 10.0.3.0 do adaptador para Android InMobi.
- Compatível com a versão 10.0.2.0 do adaptador para iOS da InMobi.
Versão 4.0.0
- Compatível com a versão 10.0.1.0 do adaptador para Android InMobi.
- Compatível com a versão 10.0.1.0 do adaptador para iOS da InMobi.
Versão 3.2.0
- Compatível com a versão 9.2.0.0 do adaptador para Android InMobi.
- Compatível com a versão 9.2.1.0 do adaptador para iOS da InMobi.
Versão 3.1.2
- Compatível com a versão 9.1.9.0 do adaptador para Android InMobi.
- Compatível com a versão 9.1.7.0 do adaptador para iOS da InMobi.
Versão 3.1.1
- Compatível com a versão 9.1.1.0 do adaptador para Android InMobi.
- Compatível com a versão 9.1.1.0 do adaptador para iOS da InMobi.
Versão 3.1.0
- Compatível com a versão 9.1.0.0 do adaptador para Android InMobi.
- Compatível com a versão 9.1.0.0 do adaptador para iOS da InMobi.
Versão 3.0.3
- Compatível com a versão 9.0.7.1 do adaptador para Android da InMobi.
- Compatível com a versão 9.0.7.2 do adaptador para iOS da InMobi.
Versão 3.0.2
- Compatível com a versão 9.0.7.0 do adaptador para Android InMobi.
- Compatível com a versão 9.0.7.0 do adaptador para iOS da InMobi.
Versão 3.0.1
- Compatível com a versão 9.0.6.0 do adaptador para Android InMobi.
- Compatível com a versão 9.0.7.0 do adaptador para iOS da InMobi.
Versão 3.0.0
- Compatível com a versão 9.0.4.0 do adaptador para Android InMobi.
- Compatível com a versão 9.0.4.0 do adaptador para iOS da InMobi.
Versão 2.4.0
- Compatível com a versão 7.3.0.1 do adaptador para Android da InMobi.
- Compatível com o adaptador para iOS InMobi versão 7.4.0.0.
Versão 2.3.0
- Oferece suporte ao adaptador para Android versão 7.2.9.0.
- Compatível com o adaptador para iOS versão 7.3.2.0.
Versão 2.2.2
- Atualização do plug-in para oferecer suporte à nova API Premiada.
- Oferece suporte ao adaptador para Android versão 7.2.7.0.
- Compatível com o adaptador para iOS versão 7.2.7.0.
Versão 2.2.1
- Oferece suporte ao adaptador para Android versão 7.2.2.0.
- Compatível com o adaptador para iOS versão 7.2.4.0.
Versão 2.2.0
- Compatível com o adaptador do Android versão 7.2.1.0.
- Compatível com o adaptador para iOS versão 7.2.0.0.
Versão 2.1.2
- Compatível com o adaptador do Android versão 7.1.1.1.
- Compatível com o adaptador para iOS versão 7.1.2.0.
Versão 2.1.1
- Compatível com o adaptador do Android versão 7.1.1.1.
- Compatível com o adaptador para iOS versão 7.1.1.2.
Versão 2.1.0
- Compatível com o adaptador do Android versão 7.1.0.0.
- Compatível com o adaptador para iOS versão 7.1.1.1.
- O método
InMobi.UpdateGDPRConsent()
foi adicionado
Versão 2.0.0
- Compatível com o adaptador do Android versão 7.0.4.0.
- Compatível com o adaptador para iOS versão 7.1.1.0.
Versão 1.0.0
- Primeira versão!
- Oferece suporte ao adaptador para Android versão 6.2.4.0.
- Compatível com o adaptador para iOS versão 6.2.1.0.