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 lances e integrações em cascata. 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 Unity.

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

Integração
Lances
Cascata
Formatos
Abertura do aplicativo 1, 2
Banner 1
Intersticial
Premiado
Intersticial premiado 1

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

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

Requisitos

  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Unity 4 ou mais recente
  • [Para lances]: para integrar todos os formatos de anúncio com suporte nos lances, use o plug-in de mediação de anúncios para dispositivos móveis do Google para AppLovin 5.1.0 ou mais recente (a versão mais recente é recomendada)
  • Para implantar no Android
    • API do Android de nível 21 ou mais recente
  • Para implantar no iOS
    • Destino de implantação do iOS 12.0 ou mais recente
  • Um projeto do Unity configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • 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.

Android

iOS

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

Android

iOS

Anote o ID do app.

Android

iOS

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:

Abertura do aplicativo

Selecione Intersticial e insira um nome de canal. Em seguida, selecione Sim para Pode ser ignorado e preencha o restante do formulário. [Somente lances] Em Monetização, ative a chave Lances no app para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.

Selecione Banner, insira um nome de posição e preencha o restante do formulário. [Somente lances] Em Monetização, ative a chave Lances no app para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.

Banner de 300 x 250

Selecione MREC, insira um nome de posição e preencha o restante do formulário. [Somente lances] Em Monetização, ative a chave Lances no app para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.

Intersticial

Selecione Intersticial, insira um nome de posicionamento e preencha o restante do formulário. [Somente lances] Em Monetização, ative a chave Lances no app para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.

Premiado

Selecione Recompensado, insira um nome de posição e preencha o restante do formulário. [Somente lances] Em Monetização, ative a chave Lances no app para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.

Intersticial premiado

Selecione Prêmio. Insira um nome de canal, ative a opção Skippável e preencha o restante do formulário. [Somente lances] Em Monetização, mude a chave Lances no app para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.

Nativo

Selecione Nativo, insira um nome de posição e preencha o restante do formulário. [Somente lances] Em Monetização, ative a chave Lances no app para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.

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

Abertura do aplicativo

Banner de 300 x 250

Intersticial

Premiado

Intersticial premiado

Nativo

Localizar sua chave da API Reporting

Lances

Esta etapa não é necessária para integrações de lances.

Cascata

Além do ID do app e do ID de referência, você também vai precisar da chave da API Reporting do Liftoff Monetize para configurar o ID do bloco de anúncios da AdMob. Navegue até o painel de relatórios do Liftoff Monetize e clique no botão Chave da API Reporting para conferir 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.

Android

iOS

Etapa 2: configurar a demanda da Monetização Liftoff na interface da AdMob

Configurar as configurações de mediação do bloco de anúncios

Android

Para instruções, consulte a etapa 2 no guia para Android.

iOS

Para ver as instruções, consulte a etapa 2 no guia para iOS.

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 da AdMob.

Etapa 3: importar o SDK do Vungle e o adaptador Liftoff Monetize

OpenUPM-CLI

Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação de monetização Liftoff do Google Mobile Ads para Unity no seu projeto executando o seguinte comando no diretório raiz do projeto:

openupm add com.google.ads.mobile.mediation.liftoffmonetize

OpenUPM

No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Unity Package Manager Settings.

Na guia Scoped Registries, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Escopo(s): com.google

Detalhes do OpenUPM

Em seguida, navegue até Window > Package Manager para abrir o Unity Package Manager e selecionar My Registries no menu suspenso.

Registros do Unity

Selecione o pacote Google Mobile Ads Liftoff Monetize Mediation e clique em Install.

Instalar do OpenUPM

Pacote do Unity

Faça o download da versão mais recente do plug-in de mediação de anúncios para dispositivos móveis do Google para Liftoff Monetize no link de download no Changelog e extraia o GoogleMobileAdsLiftoffMonetizeMediation.unitypackage do arquivo zip.

No editor do projeto do Unity, selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsLiftoffMonetizeMediation.unitypackage que você transferiu por download. Verifique se todos os arquivos estão selecionados e clique em Import.

Importar do Unity

Em seguida, selecione Assets > External Dependency Manager > Android Resolver > Force Resolve. A biblioteca do Gerenciador de dependências externas vai realizar a resolução de dependências do zero e copiar as dependências declaradas para o diretório Assets/Plugins/Android do app do Unity.

Forçar resolução

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

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 plug-in de mediação dos anúncios para dispositivos móveis do Google para a Liftoff Monetize inclui métodos para transmitir informações de consentimento ao SDK da Vungle. O exemplo de código abaixo mostra como transmitir 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.

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetGDPRStatus(true, "v1.0.0");
#if UNITY_IPHONE
LiftoffMonetize.SetGDPRMessageVersion("v1.0.0");
#endif

Consulte as instruções de implementação recomendadas do GDPR para Android e iOS 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, é 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 plug-in de mediação dos anúncios para dispositivos móveis do Google para a monetização da Liftoff inclui métodos para transmitir informações de consentimento ao SDK da Vungle. O exemplo de código abaixo mostra como transmitir 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.

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetCCPAStatus(true);

Consulte as instruções de implementação recomendadas da CCPA para Android e iOS para mais detalhes e os valores que podem ser fornecidos no método.

Etapa 5: adicionar o código necessário

Android

Nenhum código adicional é necessário para a integração da monetização do Liftoff.

iOS

Integração da SKAdNetwork

Siga a documentação do Liftoff Monetize para adicionar os identificadores do SKAdNetwork ao arquivo Info.plist do projeto.

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

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 nas seguintes classes:

Android

Formato Nome da classe
Abertura do app (lances) com.google.ads.mediation.vungle.VungleMediationAdapter
Abertura do app (hierarquia) 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 (hierarquia) com.vungle.mediation.VungleInterstitialAdapter
Premiada (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

iOS

Formato Nome da classe
Abertura do app (lances) GADMediationAdapterVungle
Abertura do app (hierarquia) GADMediationAdapterVungle
Banner (lances) GADMediationAdapterVungle
Banner (cascata) GADMAdapterVungleInterstitial
Intersticial (lances) GADMediationAdapterVungle
Intersticial (hierarquia) GADMAdapterVungleInterstitial
Premiada (lances) GADMediationAdapterVungle
Premiado (cascata) GADMAdapterVungleRewardBasedVideoAd
Intersticial premiado (lances) GADMediationAdapterVungle
Intersticial premiado (cascata) GADMediationAdapterVungle

Confira os códigos e as mensagens exibidas pelo adaptador Liftoff Monetize quando um anúncio não é carregado:

Android

Código do erro Motivo
101 Parâmetros do servidor inválidos (por exemplo, ID do app ou ID da posição).
102 O tamanho do banner solicitado não é mapeado para um tamanho de anúncio válido do Liftoff Monetize.
103 A Liftoff Monetize exige um contexto Activity para solicitar anúncios.
104 O SDK do Vungle não pode carregar vários anúncios para o mesmo ID de canal.
105 O SDK do Vungle não foi inicializado.
106 O SDK do Vungle retornou um callback de carregamento bem-sucedido, mas Banners.getBanner() ou Vungle.getNativeAd() retornaram nulo.
107 O SDK do Vungle não está pronto para exibir o anúncio.
108 O SDK Vungle retornou um token de lance inválido.

iOS

Código do erro Motivo
101 Parâmetros do servidor inválidos (por exemplo, ID do app ou ID da posição).
102 Um anúncio já foi carregado para essa configuração de rede. O SDK do Vungle não pode carregar um segundo anúncio para o mesmo ID de posição.
103 O tamanho do anúncio solicitado não corresponde a um tamanho de banner aceito pela Liftoff Monetize.
104 O SDK Vungle não conseguiu renderizar o anúncio de banner.
105 O SDK do Vungle só oferece suporte ao carregamento de um anúncio de banner por vez, independente do ID da veiculação.
106 O SDK Vungle enviou um callback informando que o anúncio não pode ser veiculado.
107 O SDK do Vungle não está pronto para exibir o anúncio.

Para erros que vêm do SDK do Vungle, consulte Códigos de erro: SDK do Vungle para iOS e Android.

Registro de mudanças do plug-in de mediação do Liftoff Monetize para Unity

Versão 5.2.2

Versão 5.2.1

Versão 5.2.0

Versão 5.1.1

Versão 5.1.0

  • Correção de um NullPointerException que causava uma falha na build ao exportar como um projeto do Android.
  • Atualização das APIs de privacidade:
    • Os métodos UpdateConsentStatus() e UpdateCCPAStatus() foram removidos.
    • Os tipos enumerados VungleConsentStatus e VungleCCPAStatus foram removidos.
    • O método SetGDPRStatus(bool) foi atualizado para SetGDPRStatus(bool, String).
  • Os seguintes métodos foram removidos da classe LiftoffMonetizeMediationExtras:
    • SetAllPlacements(String[])
    • SetSoundEnabled(bool)
  • Suporte à versão 7.3.1.0 do adaptador Liftoff Monetize para Android.
  • Suporte à versão 7.3.1.0 do Adaptador Liftoff Monetize para iOS.
  • Criado e testado com a versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 5.0.0

Versão 4.0.0

  • O plug-in de mediação do Unity foi renomeado de Vungle para Liftoff Monetize.
  • O conteúdo do adaptador foi movido para GoogleMobileAds/Mediation/LiftoffMonetize/.
  • O namespace do adaptador foi refatorado para usar GoogleMobileAds.Mediation.LiftoffMonetize.
  • Os seguintes métodos foram adicionados à classe LiftoffMonetize:
    • SetGDPRStatus(bool)
    • SetGDPRMessageVersion(String)
    • SetCCPAStatus(bool)
  • Suporte à versão 6.12.1.1 do adaptador do Liftoff Monetize para Android.
  • Suporte à versão 7.0.1.0 do adaptador Liftoff Monetize para iOS.
  • Criado e testado com a versão 8.4.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.9.2

Versão 3.9.1

Versão 3.9.0

Versão 3.8.2

Versão 3.8.1

Versão 3.8.0

Versão 3.7.5

Versão 3.7.4

Versão 3.7.3

Versão 3.7.2

Versão 3.7.1

Versão 3.7.0

Versão 3.6.0

Versão 3.5.1

Versão 3.5.0

Versão 3.4.1

Versão 3.4.0

Versão 3.3.1

Versão 3.3.0

Versão 3.2.0

Versão 3.1.4

  • Compatível com a versão 6.3.24.1 do adaptador Android.
  • Suporte à versão 6.3.2.3 do adaptador para iOS.

Versão 3.1.3

  • Compatível com a versão 6.3.24.1 do adaptador Android.
  • Compatível com a versão 6.3.2.2 do adaptador para iOS.

Versão 3.1.2

  • O plug-in foi atualizado para oferecer suporte à nova API Rewarded Beta aberta.
  • Compatível com a versão 6.3.24.1 do adaptador Android.
  • Suporte à versão 6.3.2.1 do adaptador do iOS.

Versão 3.1.1

  • Suporte à versão 6.3.24.0 do adaptador Android.
  • Compatível com a versão 6.3.2.0 do adaptador para iOS.
  • O método Vungle.UpdateConsentStatus() foi atualizado para tornar o parâmetro consentMessageVersion opcional. O valor de consentMessageVersion agora é ignorado para iOS.
  • O Vungle.GetCurrentConsentMessageVersion() foi descontinuado para iOS.

Versão 3.1.0

  • Compatível com a versão 6.3.17.0 do adaptador Android.
  • Suporte à versão 6.3.0.0 do adaptador para iOS.
  • O método Vungle.UpdateConsentStatus() foi atualizado para usar outro parâmetro String para a versão da mensagem de consentimento fornecida pelo editor.
  • O método Vungle.GetCurrentConsentMessageVersion() foi adicionado para receber a versão da mensagem de consentimento fornecida pelo editor.

Versão 3.0.1

  • Compatível com a versão 6.2.5.1 do adaptador Android.
  • Suporte à versão 6.2.0.3 do adaptador iOS.

Versão 3.0.0

  • Compatível com a versão 6.2.5.0 do adaptador Android.
  • Compatível com a versão 6.2.0.2 do adaptador para iOS.
  • Os seguintes métodos foram adicionados:
    • O método Vungle.UpdateConsentStatus() define o status de consentimento que será registrado no SDK do Vungle.
    • método Vungle.GetCurrentConsentStatus() para receber o status de consentimento atual do usuário.

Versão 2.0.0

  • Compatível com a versão 5.3.2.1 do adaptador Android.
  • Compatível com a versão 6.2.0.0 do adaptador para iOS.

Versão 1.1.0

  • Compatível com a versão 5.3.2.1 do adaptador Android.
  • Compatível com a versão 5.4.0.0 do adaptador para iOS.

Versão 1.0.0

  • Primeira versão!
  • Suporte à versão 5.3.0.0 do adaptador Android.
  • Suporte à versão 5.3.0.0 do adaptador para iOS.