Integrar a monetização de Liftoff com a mediação

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 de lances está na versão Beta aberta.

² Lances para esse formato está na versão Beta fechada.

³ 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

Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar Liftoff à 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 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 pasta libs 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.

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0");

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.

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setCCPAStatus(true);

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:

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();

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.

¹ 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:

Aqui estão os códigos e as mensagens de acompanhamento gerados pela Liftoff Monetize quando um anúncio não for carregado:

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 de VungleMediationAdapter. 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 e targetSdkVersion 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 por mediationExtras 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 e FlexView 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.