Integrar a Liftoff Monetize com a mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios da Liftoff Monetize usando mediação, cobrindo integrações de lances e hierarquia. Ele aborda como adicionar o Liftoff Monetize à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do Vungle a um app Android .

Integrações e formatos de anúncio compatíveis

O adaptador de mediação para Liftoff Monetize tem os seguintes recursos:

¹ A integração de lances está na versão Beta aberta.

² A integração de hierarquia para esse formato está na versão Beta aberta.

Requisitos

• Android API de nível 21 ou mais recente

• SDK dos anúncios para dispositivos móveis do Google mais recente

• Concluir o Guia explicativo de mediação

Etapa 1: configurar a interface do Liftoff Monetize

Inscreva-se ou faça login na sua conta da Liftoff Monetize.

Adicione seu app ao painel Monetização do Liftoff clicando no botão Add Application.

Preencha o formulário com todos os detalhes necessários.

Depois que o app for criado, selecione-o no Painel de apps da Liftoff Monetize.

Anote o ID do app.

Adicionar novos canais

Para criar um novo canal a ser usado com a mediação da AdMob, acesse o Painel "Monetize Placements" do Liftoff, clique no botão Add Placement e selecione seu app na lista desejada.

Confira abaixo os detalhes para adicionar novas posições:

Anote o ID de referência e clique em Tudo certo.

Localizar sua chave da API Reporting

Ativar o modo de teste

Para ativar os anúncios de teste, acesse o painel da Liftoff Monetize e navegue até Aplicativos.

Selecione o aplicativo em que você quer ativar anúncios de teste na seção Código de referência do canal. Para ativar os anúncios de teste, selecione Modo de teste como Exibir somente anúncios de teste na seção Status.

Etapa 2: configurar a demanda de monetização do Liftoff na interface Ad Manager

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 de regulamentos estaduais dos EUA para adicionar a Liftoff à lista de parceiros de publicidade do GDPR e dos regulamentos estaduais dos EUA na interface da AdMob.

Etapa 3: importar o SDK e o adaptador do Vungle

Integração com o Android Studio (recomendada)

No arquivo build.gradle.kts do app, adicione as seguintes dependências e configurações de implementação. Use as versões mais recentes do SDK e do adaptador do Vungle:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:vungle:7.4.1.0")
}

Integração manual

• Faça o download do SDK do Vungle para Android (link em inglês) mais recente e extraia os arquivos .jar na pasta libs. Em seguida, adicione-os ao projeto.

• Navegue até os artefatos do adaptador Liftoff Monetize no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo .aar do adaptador Vungle e adicione-o ao projeto.

Etapa 4: implementar as configurações de privacidade no SDK da Liftoff Monetize

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 solicitar o consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode coletar, receber ou usar dados pessoais, além de 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 Liftoff Monetize inclui uma API que permite transmitir o consentimento para o 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 pelo 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")

Consulte 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

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 na lei) fornecendo uma opção de desativação pelo link "Não vender minhas informações pessoais" na página inicial da parte "vendedora". O Guia de conformidade com as leis de privacidade dos estados dos EUA permite ativar o processamento de dados restrito para a veiculação de anúncios do Google, mas não é possível aplicar essa configuração a cada rede de publicidade na sua cadeia de mediação. Portanto, é necessário identificar cada rede de publicidade na 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 Liftoff Monetize inclui uma API que permite transmitir o consentimento para o 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 pelo 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 Implementação da CCPA para mais detalhes e os valores que podem ser fornecidos no método.

Etapa 5: adicionar o código necessá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 na AdMob e ative o modo de teste na interface da Liftoff Monetize.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste da Liftoff Monetize, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Liftoff Monetize (Bidding) e Liftoff Monetize (Waterfall).

Etapas opcionais

Parâmetros específicos de rede

O adaptador Liftoff Monetize é compatível com os seguintes parâmetros de solicitação extras, que podem ser transmitidos ao 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 da 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 objetos NativeAd . Ele preenche os seguintes campos para um NativeAd.

¹ O adaptador Liftoff Monetize não oferece acesso direto ao recurso de imagem principal dos anúncios nativos. Em vez disso, o adaptador preenche o MediaView com um vídeo ou uma imagem.

Códigos de erro

Se o adaptador não receber um anúncio do Liftoff Monetize, os editores poderão verificar o erro subjacente da resposta do anúncio usando ResponseInfo.getAdapterResponses() nas seguintes classes:

Confira os códigos e as mensagens exibidas pelo adaptador Liftoff Monetize quando um anúncio não é 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 do Liftoff Monetize para Android

Versão 7.4.1.0

• Compatibilidade verificada com o SDK do Vungle 7.4.1.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 23.3.0.
• SDK Vungle versão 7.4.1.

Versão 7.4.0.1

• Adição de suporte a tamanhos de anúncio personalizados para lances e anúncios de banner em hierarquia.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 23.2.0.
• SDK Vungle versão 7.4.0.

Versão 7.4.0.0

• A classe VungleInterstitialAdapter foi estendida de VungleMediationAdapter para adicionar suporte à hierarquia ao formato de anúncio de abertura de 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.
• SDK 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.
• SDK 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.
• Adição de suporte a hierarquia e 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.
• SDK 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 lances de anúncios nativos.
• O adaptador foi revertido para depender da versão 22.3.0 do SDK dos anúncios para dispositivos móveis do Google.

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

• Adição de suporte para carregar vários anúncios com o mesmo ID de veiculação para todos os formatos de anúncio em cascata.
• 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 necessária 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.
• SDK 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.
• SDK 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.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 21.4.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 21.4.0.
• SDK do Vungle versão 6.12.0.

Versão 6.12.0.0

• Adição de suporte à mediação em hierarquia e ao lance para o formato de anúncio intersticial premiado.
• Adicionado suporte a 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

• Adição de suporte à mediação em hierarquia para o formato de anúncio nativo.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 21.1.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 21.1.0.
• 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 ID de canal 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.
• SDK do Vungle versão 6.11.0.

Versão 6.11.0.1

• compileSdkVersion e targetSdkVersion foram atualizados para a API 31.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 21.0.0.
• O nível mínimo de API do Android necessário foi atualizado para 19.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
• 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.
• SDK do Vungle versão 6.11.0.

Versão 6.10.5.0

• Compatibilidade verificada com o SDK do Vungle 6.10.5.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 20.6.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 20.6.0.
• SDK 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.
• SDK 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.
• SDK Vungle versão 6.10.3.

Versão 6.10.2.1

• Compatibilidade verificada com o SDK do Vungle 6.10.2.
• Adição de suporte a lances para formatos de anúncios intersticiais e premiados.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 20.5.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 20.5.0.
• SDK 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 ao substituir o parâmetro serverParameters por mediationExtras para receber parâmetros específicos da rede Vungle ao solicitar anúncios de banner e intersticiais.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 20.3.0.
• SDK Vungle versão 6.10.2.

Versão 6.10.1.0

• Compatibilidade verificada com o SDK do Vungle 6.10.1.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 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.
• SDK Vungle versão 6.10.1.

Versão 6.9.1.1

• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 20.0.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 20.0.0.
• SDK do Vungle versão 6.9.1.

Versão 6.9.1.0

• Compatibilidade verificada com o SDK do Vungle 6.9.1.
• Adição de suporte ao OMSDK.
• Várias correções de bug.
• Suporte a anúncios premiados para o callback onAdViewed do Vungle.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 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.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 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.
• Atualizamos targetSdkVersion 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.
• SDK 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 banners adaptativos inline.
• A reprodução de áudio dos anúncios intersticiais e premiados foi ativada por padrão.
• Os anúncios intersticiais agora encaminham o callback onAdLeftApplication() quando clicados.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.2.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 19.2.0.
• SDK do Vungle versão 6.7.0.

Versão 6.5.3.0

• Compatibilidade verificada com o SDK do Vungle 6.5.3.
• Adicionamos suporte ao formato de banner recém-introduzido da Vungle.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.0.1.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 19.0.1.
• 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.
• Foi adicionado suporte a anúncios em banner.
• Migração do adaptador para o AndroidX.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 18.2.0.

Versão 6.3.24.1

• O adaptador foi atualizado para oferecer suporte à nova API Rewarded Beta aberta.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 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

• Atualizamos o adaptador 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.
• O projeto Adpater foi atualizado para o Android Studio 3.0.
• Os seguintes métodos foram adicionados à classe Bundle builder:
  • setOrdinalViewCount : esse campo é usado para transmitir o ordinal de mediação sempre que o Editor recebe os relatórios de dados ordinais do Vungle.
  • setFlexViewCloseTimeInSec: essa opção é usada para fazer com que os anúncios flexíveis sejam encerrados automaticamente 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 oferecer compatibilidade 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

• Adição de suporte para formatos de anúncio em vídeo intersticial e premiado.