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 mostrar 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 o 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

• API do Android de nível 21 ou mais recente

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

• Concluir o Guia para iniciantes de mediação

Etapa 1: configurar a interface do Liftoff Monetize

Crie ou faça login na sua conta da Liftoff Monetize.

Adicione seu app ao painel de 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 do Ad Manager, acesse o painel Liftoff Monetize Placements, clique no botão Add Placement e selecione seu app na lista suspensa.

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 app para o qual você quer ativar os anúncios de teste na seção ID de referência do posicionamento. Para ativar os anúncios de teste, selecione Modo de teste para Mostrar apenas anúncios de teste na seção Status.

Etapa 2: configurar a demanda da Monetização Liftoff na interface do Ad Manager

Faça login na sua conta do Ad Manager.

Adicionar o Liftoff Monetize nas empresas

Ativar o compartilhamento de indicador seguro

Configurar os lances do Liftoff Monetize

Configurar o mapeamento de blocos de anúncios

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

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.6.0")
    implementation("com.google.ads.mediation:vungle:7.4.2.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 e adicione 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 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 buscar 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 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 abaixo mostra como transmitir essas informações de consentimento para o SDK da 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). Essa opção é disponibilizada por um link "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O guia de compliance com as leis de privacidade dos estados dos EUA oferece a capacidade de ativar o processamento de dados restrito para veiculação de anúncios do Google, mas o Google não pode aplicar essa configuração a cada rede de anúncios na sua cadeia de mediação. Portanto, é necessário identificar cada rede de publicidade na sua 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 abaixo mostra como transmitir essas informações de consentimento para o SDK da 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 com a Liftoff Monetize.

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste no Ad Manager 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 da rede

O adaptador Liftoff Monetize oferece suporte aos seguintes parâmetros de solicitação adicionais que podem ser transmitidos a ele:

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.

Confira um exemplo de código para 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 que vêm do SDK do Vungle, consulte Códigos de erro: SDK do Vungle para iOS e Android.

Registro de alterações do adaptador de mediação do Liftoff Monetize para Android

Versão 7.4.2.0

• Compatibilidade verificada com o SDK do Vungle 7.4.2.

Criado e testado com:

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

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.
• 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

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

• Foi adicionado suporte a 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.
• Adicionamos 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.
• SDK do Vungle versão 6.12.0.

Versão 6.11.0.3

• Adicionamos 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

• Suporte adicionado para carregar vários anúncios do 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 da 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 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 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 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 do Vungle.
• Atualização de códigos e mensagens de erro 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.
• SDK do Vungle versão 6.9.1.

Versão 6.8.1.1

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

Criado e testado com:

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

Versão 6.8.0.0

• Compatibilidade verificada com o SDK do Vungle 6.8.0.
• Atualizamos o adaptador para que ele não encaminhe onAdClosed() quando os anúncios de banner forem atualizados ou destruídos.
• FlexFeed e FlexView foram removidos (descontinuados no Vungle 6.8.0).
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 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 eram carregados se um anúncio fosse carregado usando um contexto do aplicativo.
• Atualizamos targetSdkVersion para a API 29.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 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 em que os anúncios de banner não eram atualizados.

Versão 6.4.11.0

• Compatibilidade verificada com o SDK do Vungle 6.4.11.
• Foi adicionado suporte a anúncios em banner.
• Migramos o 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.
• Atualizamos o projeto Adpater 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 da 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.