Integrar a AppLovin com a mediação

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

Este guia mostra como usar GMA Next-Gen SDK para carregar e exibir anúncios de display da AppLovin usando a mediação, incluindo integrações em hierarquia e de lances. Ele explica como adicionar a AppLovin à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da AppLovin a um app Android.

Integrações e formatos de anúncio aceitos

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

¹ O formato de anúncio de abertura do app está disponível apenas para integrações em hierarquia.

² O waterfall só é compatível com tamanhos de banner 320 x 50 e 728 x 90. Os lances não são compatíveis com anúncios de banner.

Requisitos

• API Android nível 24 ou mais recente.

• [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o adaptador da AppLovin 9.4.2.0 ou uma versão mais recente (recomendamos usar a última versão).

• Mais recentes de GMA Next-Gen SDK

• Leia todo o guia para iniciantes da mediação.

Etapa 1: definir as configurações na interface da AppLovin

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

Para configurar seu bloco de anúncios do Ad Manager, você precisa da chave do SDK e da chave de relatório da AppLovin. Para encontrá-los, acesse a interface da AppLovin > Conta > Chaves para conferir os dois valores.

Se você planeja apenas integrar os lances, siga para configurar as definições de mediação.

Selecione o app para mediação

Criar uma zona

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 o app-ads.txt na AppLovin, adicione a AppLovin ao seu arquivo app-ads.txt.

Ativar o modo de teste

Siga as instruções no guia do modo de teste do MAX da AppLovin para saber como ativar os anúncios de teste da plataforma.

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

Faça login na sua conta do Ad Manager.

Adicionar a AppLovin 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 AppLovin

Configurar o mapeamento de blocos de anúncios

Adicionar a AppLovin Corp. à 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 AppLovin Corp. à 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 AppLovin

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:applovin:13.5.1.0")
}

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:applovin:13.5.1.0'
}

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 do SDK do AppLovin para Android, extraia o applovin-sdk-x.y.z.jar e adicione-o ao seu projeto.

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

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

Consentimento da UE e 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.

Desde a versão 12.0.0 do SDK, a AppLovin oferece suporte à leitura da string de consentimento de preferências compartilhadas e à definição do status de consentimento de acordo com isso.

Se você não estiver usando a versão 12.0.0 ou mais recente do SDK da AppLovin ou uma CMP que grava a string de consentimento nas preferências compartilhadas , use o método setHasUserConsent. O exemplo a seguir transmite informações de consentimento para o SDK da AppLovin. É preciso definir essas opções antes de inicializar GMA Next-Gen SDK para garantir que elas sejam encaminhadas corretamente ao SDK da AppLovin.

AppLovinPrivacySettings.setHasUserConsent(true);
AppLovinMediationSnippets.java

AppLovinPrivacySettings.setHasUserConsent(true)
AppLovinMediationSnippets.kt

Consulte as configurações de privacidade da AppLovin para mais informações.

Declarar usuários menores de idade

A partir do SDK 13.0.0, a AppLovin não oferece mais suporte a flags de usuário com restrição de idade, e não é permitido inicializar ou usar o SDK da AppLovin em conexão com uma "criança", conforme definido nas leis aplicáveis. Para mais informações, consulte a documentação da AppLovin sobre Proibição de dados de crianças ou uso dos serviços para crianças ou apps destinados exclusivamente a crianças.

A versão 13.0.0.1 ou mais recente do adaptador da AppLovin desativa a mediação da AppLovin automaticamente para apps que declaram uma das seguintes configurações com o GMA Next-Gen SDK:

• Configuração feita para crianças

• Usuários abaixo da idade de consentimento

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 SDK da AppLovin inclui o método setDoNotSell para permitir que os editores desativem a venda de informações pessoais.

O exemplo a seguir transmite essas informações de consentimento para o SDK da AppLovin. Você precisa definir essas opções antes de inicializar GMA Next-Gen SDK para garantir que elas sejam encaminhadas corretamente ao SDK da AppLovin.

AppLovinPrivacySettings.setDoNotSell(true);
AppLovinMediationSnippets.java

AppLovinPrivacySettings.setDoNotSell(true)
AppLovinMediationSnippets.kt

Consulte a documentação de privacidade da AppLovin para mais informações.

Etapa 5: adicionar o código necessário

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

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

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste da AppLovin, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios AppLovin (lances) e AppLovin (hierarquia).

Etapas opcionais

Parâmetros específicos da rede

O adaptador da AppLovin é compatível com setMuteAudio(), que pode desativar o áudio em anúncios em vídeo. Esse método pode ser chamado de um objeto AppLovinExtras.Builder():

Bundle extras = new AppLovinExtras.Builder()
  .setMuteAudio(true)
  .build();
AdRequest request = new AdRequest.Builder(AD_UNIT_ID)
  .putAdSourceExtrasBundle(ApplovinAdapter.class, extras)
  .build();

val extras = AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build()
val request = AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(ApplovinAdapter::class.java, extras)
   .build()

Otimizações

Códigos de erro

Se o adaptador não receber um anúncio da AppLovin, os editores poderão verificar o erro subjacente na resposta do anúncio usando ResponseInfo.getAdSourceResponses() nas seguintes classes:

com.google.ads.mediation.applovin.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

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