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 Liftoff Monetize usando mediação, cobrindo integrações de lances e hierarquia. Nele, explicamos como adicionar o Liftoff Gere receita com a configuração de mediação de um bloco de anúncios e como integrar o SDK do Vungle e adaptador em um Android app.
Integrações e formatos de anúncio compatíveis
O adaptador de mediação para Liftoff Monetize tem os seguintes recursos:
Integração | |
---|---|
Lances | 1 |
Cascata | |
Formatos | |
Abertura do aplicativo | |
Banner | |
Intersticial | |
Premiado | |
Intersticial premiado | 3 |
Nativo | 2 |
1 Integração de lances está na versão Beta aberta.
2 Lances para esse formato está na versão Beta fechada.
3 Premiado
intersticial requer assistência na configuração. Entre em contato com sua conta
na Liftoff Monetize ou na monetize@liftoff.io
.
Requisitos
Android API de nível 21 ou mais recente
SDK dos anúncios para dispositivos móveis do Google mais recente
Concluir a mediação Guia explicativo
Etapa 1: definir as configurações na interface do Liftoff Monetize
Etapa 2: configurar a demanda da Liftoff Monetize na Ad Manager interface
Adicionar Liftoff ao GDPR e à lista de parceiros de publicidade das regulamentações estaduais dos EUA
Etapa 3: importar o SDK e o adaptador do Vungle
Integração com o Android Studio (recomendado)
No arquivo build.gradle.kts
no nível do app, adicione a seguinte implementação:
dependências e configurações. Usar as versões mais recentes do SDK do Vungle
e adaptador:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:vungle:7.4.0.1")
}
Integração manual
Faça o download do SDK mais recente da Vungle para Android. e extraia os arquivos
.jar
na pastalibs
e adicione à sua pasta projeto.Acesse os artefatos do adaptador Liftoff Monetize. no repositório Maven do Google. Selecione a versão mais recente e faça o download do Vungle
.aar
do adaptador e adicione-o ao projeto.
Etapa 4: implementar configurações de privacidade no SDK Liftoff Monetize
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.
A Liftoff Monetize inclui uma API que permite transmitir consentimento ao SDK do Vungle. O exemplo de código a seguir mostra como transmitir essas informações de consentimento para o SDK do Vungle. Se você optar por chamar esse método, recomendamos que o faça antes de solicitar anúncios por meio do SDK dos anúncios para dispositivos móveis do Google.
Java
import com.vungle.ads.VunglePrivacySettings;
// ...
VunglePrivacySettings.setGDPRStatus(true, "v1.0.0");
Kotlin
import com.vungle.ads.VunglePrivacySettings
// ...
VunglePrivacySettings.setGDPRStatus(true, "v1.0.0")
Confira as instruções de implementação recomendadas do GDPR para mais detalhes e os valores que podem ser fornecidos no método.
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" da 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.
A Liftoff Monetize inclui uma API que permite transmitir consentimento ao SDK do Vungle. O exemplo de código a seguir mostra como transmitir essas informações de consentimento para o SDK do Vungle. Se você optar por chamar esse método, recomendamos que o faça antes de solicitar anúncios por meio do SDK dos anúncios para dispositivos móveis do Google.
Java
import com.vungle.ads.VunglePrivacySettings;
// ...
VunglePrivacySettings.setCCPAStatus(true);
Kotlin
import com.vungle.ads.VunglePrivacySettings
// ...
VunglePrivacySettings.setCCPAStatus(true)
Consulte a implementação da CCPA para mais detalhes e os valores que podem ser fornecidos no método.
Etapa 5: adicionar o código obrigatório
Nenhum código adicional é necessário para a integração da Liftoff Monetize.
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 Liftoff Monetize interface.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do Liftoff Monetize, ative os testes de uma única origem no Ad Inspector usando as Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) origens de anúncios.
Etapas opcionais
Parâmetros específicos de rede
O adaptador Liftoff Monetize é compatível com a solicitação adicional a seguir. que podem ser passados para o adaptador:
userId
- Uma string que representa o ID do usuário incentivado da Liftoff Monetize.
adOrientation
- Um número inteiro que especifica a orientação de apresentação para anúncios em tela cheia.
Veja um exemplo de código que explica como criar uma solicitação de anúncio que define esses parâmetros:
Java
Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
.addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
.build();
Kotlin
val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)
val request = AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(VungleAdapter::class, extras) // Rewarded.
.addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
.build()
Renderização de anúncios nativos
O adaptador Liftoff Monetize retorna os anúncios nativos como
NativeAd
objetos. Ele preenche os seguintes campos:
campos
para um
NativeAd
.
Campo | Recursos sempre incluídos pelo adaptador Liftoff Monetize |
---|---|
Título | |
Imagem | 1 |
Visualização de mídia | |
Corpo | |
Ícone do app | |
Call-to-action | |
Star rating | |
Loja | |
Preço |
1 The Liftoff Monetize
não fornece acesso direto ao recurso de imagem principal para o
anúncios. Em vez disso, o adaptador preenche a
MediaView
com um vídeo ou uma imagem.
Códigos de erro
Se o adaptador não receber um anúncio da Liftoff Monetize, os editores poderão
verifique o erro subjacente na resposta do anúncio usando
ResponseInfo.getAdapterResponses()
nas seguintes classes:
Formato | Nome da classe |
---|---|
Abertura do app (lances) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Abertura do app (Cascata) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Banner (lances) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Banner (Cascata) | com.vungle.mediation.VungleInterstitialAdapter |
Intersticial (lances) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Intersticial (cascata) | com.vungle.mediation.VungleInterstitialAdapter |
Premiado (lances) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Premiado (Cascata) | com.vungle.mediation.VungleAdapter |
Intersticial premiado (lances) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Intersticial premiado (cascata) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Nativo (lances) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Nativo (Cascata) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Aqui estão os códigos e as mensagens de acompanhamento gerados pela Liftoff Monetize quando um anúncio não for carregado:
Código do erro | Domínio | Motivo |
---|---|---|
101 | com.google.ads.mediation.vungle | Parâmetros de servidor inválidos (por exemplo, ID do app ou da posição). |
102 | com.google.ads.mediation.vungle | O tamanho do banner solicitado não está associado a um anúncio da Liftoff Monetize válido. tamanho. |
103 | com.google.ads.mediation.vungle | A Liftoff Monetize requer um Activity contexto para fazer a solicitação.
anúncios. |
104 | com.google.ads.mediation.vungle | O SDK do Vungle não pode carregar vários anúncios para a mesma posição. ID. |
105 | com.google.ads.mediation.vungle | Falha ao inicializar o SDK do Vungle. |
106 | com.google.ads.mediation.vungle | O SDK do Vungle retornou um callback de carregamento bem-sucedido, mas Banners.getBanner(). ou Vungle.getNativeAd() retornar nulo. |
107 | com.google.ads.mediation.vungle | O SDK do Vungle não está pronto para reproduzir o anúncio. |
108 | com.google.ads.mediation.vungle | O SDK do Vungle retornou um token de lances inválido. |
Para erros provenientes do SDK do Vungle, consulte Códigos de erro: SDK do Vungle para iOS e Android (em inglês).
Registro de alterações do adaptador de mediação para Android da Liftoff Monetize
Versão 7.4.0.1
- Foi adicionado suporte a tamanho de anúncio personalizado para anúncios de banner em hierarquia e lances.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.2.0.
- O SDK do Vungle versão 7.4.0.
Versão 7.4.0.0
- A classe
VungleInterstitialAdapter
foi estendida deVungleMediationAdapter
. para adicionar suporte em hierarquia ao formato de anúncio de abertura do app no Google Ad Manager. - Compatibilidade verificada com o SDK do Vungle 7.4.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.2.0.
- O SDK do Vungle versão 7.4.0.
Versão 7.3.2.0
- Compatibilidade verificada com o SDK do Vungle 7.3.2.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
- O SDK do Vungle versão 7.3.2.
Versão 7.3.1.0
- Compatibilidade verificada com o SDK do Vungle 7.3.1.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
- O SDK do Vungle versão 7.3.1.
Versão 7.3.0.0
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 23.0.0.
- Compatibilidade verificada com o SDK do Vungle 7.3.0.
- Foi adicionado suporte à hierarquia e aos lances para o formato de anúncio de abertura do app.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
- O SDK do Vungle versão 7.3.0.
Versão 7.1.0.0
- Compatibilidade verificada com o SDK do Vungle 7.1.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.3.0.
- O SDK do Vungle versão 7.1.0.
Versão 7.0.0.1
- Correção de um problema em que o SDK dos anúncios para dispositivos móveis do Google não registrava impressões para dar lances em anúncios nativos.
- O adaptador foi revertido para depender do SDK dos anúncios para dispositivos móveis do Google versão 22.3.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.3.0.
- SDK do Vungle versão 7.0.0.
Versão 7.0.0.0
- Agora é possível carregar vários anúncios com o mesmo ID de posição em todos os formatos de hierarquia.
- O nome do adaptador passou de Vungle para Liftoff Monetize.
- Compatibilidade verificada com o SDK do Vungle 7.0.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.4.0.
- SDK do Vungle versão 7.0.0.
Versão 6.12.1.1
- O adaptador foi atualizado para usar a nova classe
VersionInfo
. - Atualização da versão mínima exigida do SDK dos anúncios para dispositivos móveis do Google para a 22.0.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
- O SDK do Vungle versão 6.12.1.
Versão 6.12.1.0
- Compatibilidade verificada com o SDK do Vungle 6.12.1.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.4.0.
- O SDK do Vungle versão 6.12.1.
Versão 6.12.0.1
- Agora é possível definir lances para o formato de anúncio de banner.
- Compatibilidade verificada com o SDK do Vungle 6.12.0.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 21.4.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.4.0.
- O SDK do Vungle versão 6.12.0.
Versão 6.12.0.0
- Foi adicionado suporte à mediação em hierarquia e aos lances para o formato de anúncio intersticial premiado.
- Agora é possível definir lances para o formato de anúncio nativo.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.1.0.
- O SDK do Vungle versão 6.12.0.
Versão 6.11.0.3
- Foi adicionado suporte à mediação em hierarquia para o formato de anúncio nativo.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 21.1.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.1.0.
- O SDK do Vungle versão 6.11.0.
Versão 6.11.0.2
- Agora é possível carregar vários anúncios para o mesmo código de posição em anúncios de lances premiados.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
- O SDK do Vungle versão 6.11.0.
Versão 6.11.0.1
compileSdkVersion
etargetSdkVersion
foram atualizados para a API 31.- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 21.0.0.
- O nível mínimo necessário da API do Android foi atualizado para 19.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
- O SDK do Vungle versão 6.11.0.
Versão 6.11.0.0
- Compatibilidade verificada com o SDK do Vungle 6.11.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.6.0.
- O SDK do Vungle versão 6.11.0.
Versão 6.10.5.0
- Compatibilidade verificada com o SDK do Vungle 6.10.5.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.6.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.6.0.
- O SDK do Vungle versão 6.10.5.
Versão 6.10.4.0
- Compatibilidade verificada com o SDK do Vungle 6.10.4.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.5.0.
- O SDK do Vungle versão 6.10.4.
Versão 6.10.3.0
- Compatibilidade verificada com o SDK do Vungle 6.10.3.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.5.0.
- O SDK do Vungle versão 6.10.3.
Versão 6.10.2.1
- Compatibilidade verificada com o SDK do Vungle 6.10.2.
- Agora é possível definir lances para formatos de anúncios intersticiais e premiados.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.5.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.5.0.
- O SDK do Vungle versão 6.10.2.
Versão 6.10.2.0
- Compatibilidade verificada com o SDK do Vungle 6.10.2.
- Correção de um problema no adaptador com a substituição do parâmetro
serverParameters
pormediationExtras
para receber parâmetros específicos da rede Vungle ao solicitar anúncios intersticiais e de banner.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.3.0.
- O SDK do Vungle versão 6.10.2.
Versão 6.10.1.0
- Compatibilidade verificada com o SDK do Vungle 6.10.1.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.3.0.
- Os anúncios MREC agora são compatíveis com a API de banner da Vungle.
- Atualização de códigos de erro e mensagens padronizados.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.3.0.
- O SDK do Vungle versão 6.10.1.
Versão 6.9.1.1
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.0.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.0.0.
- O SDK do Vungle versão 6.9.1.
Versão 6.9.1.0
- Compatibilidade verificada com o SDK do Vungle 6.9.1.
- Foi adicionado suporte ao OMSDK.
- Várias correções de bug.
- Suporte a anúncios premiados para o callback do Vungle onOpenCensused.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 19.7.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.7.0.
- O SDK do Vungle versão 6.9.1.
Versão 6.8.1.1
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 19.6.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.6.0.
- O SDK do Vungle versão 6.8.1.
Versão 6.8.1.0
- Compatibilidade verificada com o SDK do Vungle 6.8.1.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 19.5.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.5.0.
- O SDK do Vungle versão 6.8.1.
Versão 6.8.0.0
- Compatibilidade verificada com o SDK do Vungle 6.8.0.
- O adaptador foi atualizado para não encaminhar
onAdClosed()
quando os anúncios de banner são atualizados ou destruídos. FlexFeed
eFlexView
foram removidos (descontinuados no Vungle 6.8.0).- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 19.4.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.4.0.
- SDK do Vungle versão 6.8.0.
Versão 6.7.1.0
- Compatibilidade verificada com o SDK do Vungle 6.7.1.
- Correção de um bug em que os anúncios não carregavam se um anúncio fosse carregado usando um contexto de aplicativo.
targetSdkVersion
foi atualizado para a API 29.- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 19.3.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.3.0.
- O SDK do Vungle versão 6.7.1.
Versão 6.7.0.0
- Compatibilidade verificada com o SDK do Vungle 6.7.0.
- O adaptador foi atualizado para oferecer suporte a solicitações de banner adaptativo inline.
- Os anúncios intersticiais e premiados agora são ativados por padrão.
- Os anúncios intersticiais agora encaminham o callback
onAdLeftApplication()
quando clicados. - Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 19.2.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.2.0.
- O SDK do Vungle versão 6.7.0.
Versão 6.5.3.0
- Compatibilidade verificada com o SDK do Vungle 6.5.3.
- Adicione suporte para o formato de banner recém-lançado Vungle.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 19.0.1.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.0.1.
- O SDK do Vungle versão 6.5.3.
Versão 6.4.11.1
- Correção de um problema que impedia a atualização de anúncios de banner.
Versão 6.4.11.0
- Compatibilidade verificada com o SDK do Vungle 6.4.11.
- Agora é possível usar anúncios de banner.
- Migração do adaptador para o AndroidX.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 18.2.0.
Versão 6.3.24.1
- Adaptador atualizado para oferecer suporte à nova API Premiada em versão Beta aberta.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 17.2.0.
Versão 6.3.24.0
- Compatibilidade verificada com o SDK do Vungle 6.3.24.
Versão 6.3.17.0
- Compatibilidade verificada com o SDK do Vungle 6.3.17.
Versão 6.3.12.0
- Compatibilidade verificada com o SDK do Vungle 6.3.12.
Versão 6.2.5.1
- O adaptador foi atualizado para invocar o evento de anúncio
onRewardedVideoComplete()
.
Versão 6.2.5.0
- Compatibilidade verificada com o SDK do Vungle 6.2.5.
Versão 5.3.2.1
- O adaptador foi atualizado para informar corretamente os cliques ao SDK dos anúncios para dispositivos móveis do Google.
Versão 5.3.2.0
- Compatibilidade verificada com o SDK do Vungle 5.3.2.
- Atualização do projeto do Adpater para o Android Studio 3.0.
- Os métodos a seguir foram adicionados à classe Bundle Builder.
setOrdinalViewCount
: esse campo é usado para transmitir o ordinal de mediação, sempre que o Editor receber os relatórios de dados ordinais da Vungle.setFlexViewCloseTimeInSec
: esta opção é usada para criar anúncios de visualização flexível são dispensados por conta própria após o número especificado de segundos.
Versão 5.3.0.0
- Compatibilidade verificada com o SDK do Vungle 5.3.0.
Versão 5.1.0.0
- O adaptador foi atualizado para ser compatível com o SDK do Vungle 5.1.0.
- O sistema de nomenclatura de versões foi alterado para [Versão do SDK do Vungle].[versão do patch do adaptador].
Versões anteriores
- Agora é possível usar anúncios em vídeo premiados e intersticiais.