Integrar a Liftoff Monetize com a mediação

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

Este guia mostra como usar o GMA Next-Gen SDK 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 Vungle a um app Android.

Integrações e formatos de anúncio aceitos

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

Requisitos

• Última GMA Next-Gen SDK.

• Leia todo o guia para iniciantes da 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.

Clique no botão Adicionar aplicativo para adicionar seu app ao painel da Liftoff Monetize.

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

Depois que o app for criado, selecione-o no painel de aplicativos do Liftoff Monetize.

Anote o ID do app.

Adicionar novos canais

Para criar um novo canal que será usado com a mediação, navegue até o painel "Canais de monetização da Liftoff", clique no botão Adicionar canal 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

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 anúncios de teste, acesse o painel da Liftoff Monetize e navegue até Aplicativos.

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

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

Faça login na sua conta do Ad Manager.

Adicionar a Liftoff Monetize em "Empresas"

Ativar o compartilhamento de indicador seguro

Compartilhar indicadores seguros em solicitações de lance

Permitir o compartilhamento de indicadores seguros para Lances do SDK

Configurar os lances da 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 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 da Vungle e o adaptador da Liftoff Monetize

Integração com o Android Studio (recomendada)

No arquivo gradle do app, adicione as seguintes dependências e configurações de implementação:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:vungle:7.7.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:vungle:7.7.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integração manual

• Faça o download da versão mais recente do SDK do Android do Vungle, extraia os arquivos .aar e JAR na pasta libs e adicione ao seu projeto.

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

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

Consentimento para a UE e o GDPR

Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer determinadas declarações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de receber o consentimento deles para o uso de cookies ou outros armazenamentos locais quando exigido por lei e para a coleta, o compartilhamento e o uso de dados pessoais para a 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. O Google não consegue transmitir automaticamente a escolha de consentimento do usuário para essas redes.

A partir da versão 7.4.1 do SDK da Vungle, 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.

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.

A Liftoff Monetize inclui uma API que permite transmitir o consentimento ao SDK da Vungle. O exemplo de código a seguir mostra como transmitir essas informações de consentimento para o SDK da Vungle. Se você optar por chamar esse método, recomendamos fazer isso antes de solicitar anúncios pelo GMA Next-Gen SDK.

VunglePrivacySettings.setCCPAStatus(true);
LiftoffMonetizeMediationSnippets.java

VunglePrivacySettings.setCCPAStatus(true)
LiftoffMonetizeMediationSnippets.kt

Consulte Implementação da CCPA para mais detalhes e informações que podem ser inseridas no método.

Etapa 5: adicionar o código necessário

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

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 Liftoff Monetize é compatível com os seguintes parâmetros de solicitação adicionais, que podem ser transmitidos ao adaptador:

userId

Uma string que representa o ID de 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.

setBackButtonImmediatelyEnabled

Um booleano para ativar ou desativar o botão "Voltar" nos anúncios de abertura do app imediatamente. 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 abrir app para mais informações.

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);
// Optional: Enables the back button on App Open ads immediately.
extras.putBoolean(VungleConstants.KEY_BACK_BUTTON_IMMEDIATELY_ENABLED, true);

AdRequest request =
    new AdRequest.Builder()
        .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
        .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
        // App Open ads use VungleMediationAdapter
        .addNetworkExtrasBundle(VungleMediationAdapter.class, extras)
        .build();
LiftoffMonetizeMediationSnippets.java

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)
// Optional: Enables the back button on App Open ads immediately.
extras.putBoolean(VungleConstants.KEY_BACK_BUTTON_IMMEDIATELY_ENABLED, true)

val request =
  AdRequest.Builder()
    .addNetworkExtrasBundle(VungleAdapter::class.java, extras) // Rewarded.
    .addNetworkExtrasBundle(VungleInterstitialAdapter::class.java, extras) // Interstitial.
    // App Open ads use VungleMediationAdapter
    .addNetworkExtrasBundle(VungleMediationAdapter::class.java, extras)
    .build()
LiftoffMonetizeMediationSnippets.kt

Renderização de anúncios nativos

O adaptador da Liftoff Monetize retorna os anúncios nativos como objetos NativeAd. Ele preenche os seguintes campos para um NativeAd.

¹ O adaptador da 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 da Liftoff Monetize, os editores poderão verificar o erro subjacente na resposta do anúncio usando ResponseInfo.getAdSourceResponses() nas seguintes classes:

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

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