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 da AdMob, 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 para esse formato 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

• [Para lances]: adaptador Liftoff Monetize 6.11.0.2 ou mais recente (recomendamos a versão mais recente)

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

• Leia o Guia explicativo de mediação

Etapa 1: definir as configurações na interface do Liftoff Monetize

Crie 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 de criar o app, selecione-o no painel Liftoff Monetize Applications (em inglês).

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 novos canais:

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

Localize sua chave da API de relatórios

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 de monetização do Liftoff na interface AdMob

Definir as configurações de mediação para seu bloco de anúncios

Você precisa adicionar Liftoff Monetize à configuração de mediação do seu bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Em seguida, acesse a guia Mediação. Se você quiser modificar um grupo de mediação, clique no nome dele para editá-lo e prossiga para Adicionar Liftoff Monetize como uma origem de anúncios.

Para criar um novo grupo de mediação, selecione Criar grupo de mediação.

Insira a plataforma e o formato do anúncio e clique em Continuar.

Atribua um nome ao seu grupo de mediação e selecione locais para segmentar. Em seguida, defina o status do grupo de mediação como Ativado e clique em Adicionar blocos de anúncios.

Associe esse grupo de mediação a um ou mais dos seus blocos de anúnciosAdMob existentes. Em seguida, clique em Concluído.

Agora você verá o card de blocos de anúncios preenchido com os blocos selecionados:

Adicionar Liftoff Monetize como uma origem de anúncios

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 de usuários da União Europeia do Google, você precisa garantir que algumas divulgações sejam fornecidas aos usuários no Espaço Econômico Europeu (EEE) e que eles tenham o consentimento 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 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 opção de consentimento do usuário a 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

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 lei define esses termos), com a opção de recusa oferecida 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, 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.

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 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 Liftoff Monetize.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste da Liftoff Monetize, ative os testes de origem de anúncios única no Ad Inspector usando as origens de anúncios Liftoff Monetize (lances) e Liftoff Monetize (Cascata).

Etapas opcionais

Parâmetros específicos de 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);

AdRequest request = new AdRequest.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 = AdRequest.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 descrições de campos de anúncios nativos para um NativeAd.

¹ O adaptador Liftoff Monetize não fornece 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.
• 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.
• 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.
• 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.
• O SDK do Vungle versão 6.12.1.

Versão 6.12.0.1

• Suporte adicionado para lances no 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.
• 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.
• 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

• Adição de 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.
• 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.
• O 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 6.10.5 do 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 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.
• 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.
• 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.
• 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 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.
• O SDK do 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 Vungle onOpenCensused.
• 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

• 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.
• 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.
• 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 carregavam se um anúncio fosse carregado usando um contexto de aplicativo.
• targetSdkVersion foi atualizado 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.
• Os anúncios intersticiais e premiados agora são ativados 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.
• 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.
• 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.
• 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 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.