Integrar a Liftoff Monetize com a mediação

Selecione a plataforma: Android iOS Unity Flutter Android (legada)

Este guia mostra como usar Google Mobile Ads Unity Plugin para carregar e exibir anúncios da Liftoff Monetize usando a mediação, incluindo integrações de lances e em hierarquia. Ele explica como adicionar a Liftoff Monetize à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da Liftoff Monetize a um app Unity.

Integrações e formatos de anúncio aceitos

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

Pré-requisitos

Antes de continuar, verifique o seguinte:

  • Versão mais recente do Google Mobile Ads Unity Plugin.
  • Unity Editor versão 4 ou mais recente.
  • [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o plug-in de mediação dos anúncios para dispositivos móveis do Google para a Liftoff Monetize 5.1.0 ou mais recente (recomendamos usar a última versão).
  • Para implantar no Android
    • API Android nível 24 ou mais recente.
  • Para implantar no iOS
    • Destino de implantação do iOS 13.0 ou mais recente.
  • Um projeto do Unity em funcionamento configurado com Google Mobile Ads Unity Plugin. Consulte Configurar o Google Mobile Ads Unity Plugin para mais detalhes.
  • Configure a mediação.

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

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

    Adicione seu app ao painel da Liftoff Monetize 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 aplicativos da Liftoff Monetize.

    Android

    iOS

    Anote o ID do app.

    Android

    iOS

    Adicionar novas posições

    Para criar um novo canal que será usado com a mediação, navegue até o painel "Canais do Liftoff Monetize", clique no botão Adicionar canal e selecione seu app na lista suspensa.

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

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

    Banner de 300 x 250

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

    Intersticial

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

    Premiado

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

    Intersticial premiado

    Selecione Premiado. Insira um Nome do canal, ative a opção Pular e preencha o restante do formulário. [Somente lances] Em Monetização, ative a opção Lances no app. Clique no botão Continuar na parte de baixo da página para criar o posicionamento.

    Nativo

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

    Anote o ID de referência e clique em Entendi.

    Banner de 300 x 250

    Intersticial

    Premiado

    Intersticial premiado

    Nativo

    Localizar sua chave de API Reporting

    Lances

    Essa 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 de API Reporting da Liftoff Monetize para configurar o ID do bloco de anúncios do Ad Manager. Navegue até o painel de relatórios da Liftoff Monetize e clique no botão Chave da API Reporting para conferir sua Chave da API Reporting.

    Atualizar o app-ads.txt

    Vendedores autorizados do inventário de anúncios de apps (app-ads.txt) é uma iniciativa do IAB Tech Lab que ajuda a garantir que o inventário de anúncios do seu aplicativo seja vendido apenas por canais autorizados. Para evitar uma perda significativa na receita de publicidade, implemente um arquivo app-ads.txt. Se ainda não fez isso, crie um arquivo app-ads.txt para o Ad Manager.

    Para implementar app-ads.txt na Liftoff Monetize, faça o download e adicione as entradas app-ads.txt da Liftoff Monetize ao arquivo app-ads.txt atual. Para mais informações, consulte app-ads.txt.

    Ativar o modo de teste

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

    Selecione o app em que você quer ativar os anúncios de teste na seção ID de referência do canal. Para ativar os anúncios de teste, selecione Modo de teste para Mostrar somente anúncios de teste na seção Status.

    Android

    iOS

    Etapa 2: configurar a demanda da Liftoff Monetize na interface do Ad Manager

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

    Android

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

    iOS

    Para 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 das regulamentações europeias e Configurações das regulamentações estaduais dos EUA para adicionar a Liftoff à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface do Ad Manager.

    Etapa 3: importar o SDK e o adaptador da Liftoff Monetize

    OpenUPM-CLI

    Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação do Google Mobile Ads Liftoff Monetize no 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 > Configurações do projeto > Package Manager para abrir as Configurações do gerenciador de pacotes do Unity.

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

    • Nome: OpenUPM
    • URL: https://package.openupm.com
    • Escopos: com.google

    Detalhes do OpenUPM

    Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.

    Registros do Unity

    Selecione o pacote Mediação da LiftoffMonetize para anúncios para dispositivos móveis do Google e clique em Instalar.

    Instalar pelo OpenUPM

    Pacote do Unity

    Baixe a versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para a Liftoff Monetize no link de download do registro de alterações e extraia o GoogleMobileAdsLiftoffMonetizeMediation.unitypackage do arquivo ZIP.

    No editor de projetos do Unity, selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsLiftoffMonetizeMediation.unitypackage que você baixou. Verifique se todos os arquivos estão selecionados e clique em Importar.

    Importar do Unity

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

    Forçar resolução

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

    Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer algumas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de pedir o consentimento deles para usar cookies ou outro armazenamento local quando exigido por lei e para coletar, compartilhar e usar dados pessoais para personalização de anúncios. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Você é responsável por verificar se o consentimento é propagado para cada origem de anúncios na sua cadeia de mediação.

    A partir da versão 5.2.2 do plug-in do Unity da Liftoff Monetize, a Liftoff Monetize lê automaticamente o consentimento do GDPR definido por plataformas de gestão de consentimento que aceitam a especificação de consentimento adicional do Google, incluindo o SDK da UMP. Para mais informações, consulte Instruções de implementação recomendadas do GDPR para Android e iOS.

    Leis Estaduais de Privacidade dos EUA

    As leis de privacidade dos estados 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 com a mensagem "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O guia de conformidade com as leis estaduais de privacidade dos EUA oferece a opção de ativar o tratamento 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, identifique cada rede de publicidade que possa participar da venda de informações pessoais e siga as orientações de cada uma delas para garantir a conformidade.

    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 Liftoff Monetize. O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK da Liftoff Monetize. Se você optar por chamar esse método, recomendamos fazer isso antes de solicitar anúncios pelo Google Mobile Ads Unity Plugin.

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

    iOS

    Integração da SKAdNetwork

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

    Etapa 6: testar a implementação

    Ativar anúncios de teste

    Não se esqueça de registrar seu dispositivo de teste no Ad Manager e ativar 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 (lances) e Liftoff Monetize (hierarquia).

    Etapas opcionais

    Parâmetros específicos da rede

    O adaptador da Liftoff Monetize aceita os seguintes parâmetros de solicitação adicionais que podem ser transmitidos a ele:

    SetBackButtonImmediatelyEnabled(bool)
    Um booleano para ativar ou desativar o botão "Voltar" imediatamente nos anúncios de abertura do app. Defina como true para ativar o botão "Voltar" imediatamente ou false caso contrário. O padrão é false. Consulte a documentação da Liftoff Monetize sobre como integrar anúncios de abertura do app para mais informações.

    O exemplo de código a seguir cria uma solicitação de anúncio que define estes parâmetros:

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

var adRequest = new AdRequest();
var liftoffExtras = new LiftoffMonetizeMediationExtras();
liftoffExtras.SetBackButtonImmediatelyEnabled(true);
adRequest.MediationExtras.Add(liftoffExtras);

    Códigos de erro

    Se o adaptador não receber um anúncio da Liftoff Monetize, os publishers poderão verificar o erro subjacente na 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 (cachoeira) com.vungle.mediation.VungleInterstitialAdapter
    Intersticial (lances) com.google.ads.mediation.vungle.VungleMediationAdapter
    Intersticial (hierarquia) com.vungle.mediation.VungleInterstitialAdapter
    Premiado (lances) com.google.ads.mediation.vungle.VungleMediationAdapter
    Premiado (cascata) com.vungle.mediation.VungleAdapter
    Intersticial premiado (lances) com.google.ads.mediation.vungle.VungleMediationAdapter
    Intersticial premiado (em hierarquia) 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 (hierarquia) GADMAdapterVungleInterstitial
    Intersticial (lances) GADMediationAdapterVungle
    Intersticial (hierarquia) GADMAdapterVungleInterstitial
    Premiado (lances) GADMediationAdapterVungle
    Premiado (hierarquia) GADMAdapterVungleRewardBasedVideoAd
    Intersticial premiado (lances) GADMediationAdapterVungle
    Intersticial premiado (hierarquia) GADMediationAdapterVungle

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

    Android

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

    iOS

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

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

    Registro de alterações do plug-in de mediação da Unity da Liftoff Monetize

    Versão 5.7.9

    Versão 5.7.8

    Versão 5.7.7

    Versão 5.7.6

    Versão 5.7.5

    Versão 5.7.4

    Versão 5.7.3

    Versão 5.7.2

    Versão 5.7.1

    Versão 5.7.0

    Versão 5.6.0

    Versão 5.5.3

    Versão 5.5.2

    Versão 5.5.1

    Versão 5.5.0

    Versão 5.4.1

    Versão 5.4.0

    Versão 5.3.5

    Versão 5.3.4

    Versão 5.3.3

    • Correção de um problema em que a instalação pelo OpenUPM fazia com que o plug-in não importasse os pacotes corretamente.

    Versão 5.3.2

    • Correção de um problema em que a instalação pelo OpenUPM fazia com que o plug-in não importasse os pacotes corretamente.

    Versão 5.3.1

    Versão 5.3.0

    Versão 5.2.6

    Versão 5.2.5

    Versão 5.2.4

    Versão 5.2.3

    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 de 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 do Android do Liftoff Monetize.
    • Compatível com a versão 7.3.1.0 do adaptador do Liftoff Monetize para iOS.
    • Criada e testada 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

    • Mudança da marca do plug-in de mediação do Unity da Vungle para Liftoff Monetize.
    • O conteúdo do adaptador foi movido para GoogleMobileAds/Mediation/LiftoffMonetize/.
    • Refatoração do namespace do adaptador 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 Android do Liftoff Monetize.
    • Compatível com a versão 7.0.1.0 do adaptador da Liftoff Monetize para iOS.
    • Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.4.1.

    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 do Android.
    • Suporte à versão 6.3.2.3 do adaptador do iOS.

    Versão 3.1.3

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

    Versão 3.1.2

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

    Versão 3.1.1

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

    Versão 3.1.0

    • Compatível com a versão 6.3.17.0 do adaptador para Android.
    • Compatível com a versão 6.3.0.0 do adaptador para iOS.
    • Atualizamos o método Vungle.UpdateConsentStatus() para usar um parâmetro String adicional para a versão da mensagem de consentimento fornecida pelo publisher.
    • Adição do método Vungle.GetCurrentConsentMessageVersion() para receber a versão da mensagem de consentimento fornecida pelo publisher.

    Versão 3.0.1

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

    Versão 3.0.0

    • Compatibilidade com a versão 6.2.5.0 do adaptador do Android.
    • Compatível com a versão 6.2.0.2 do adaptador do iOS.
    • Os seguintes métodos foram adicionados:
      • Método Vungle.UpdateConsentStatus() para definir o status de consentimento que será registrado no SDK da 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 para Android.
    • Compatível com a versão 6.2.0.0 do adaptador do iOS.

    Versão 1.1.0

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

    Versão 1.0.0

    • Primeira versão!
    • Compatível com a versão 5.3.0.0 do adaptador do Android.
    • Compatível com a versão 5.3.0.0 do adaptador para iOS.