Integrar a AppLovin à mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios do AppLovin usando a mediação, cobrindo as integrações de lances e de hierarquia. Ele aborda como adicionar o AppLovin à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do AppLovin a um app Unity.

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

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

Integração
Lances
Cascata
Formatos
Banner  1
Intersticial
Premiado

Os anúncios em banner (exceto banners MREC) são aceitos apenas na mediação. Os lances não são compatíveis com nenhum tipo de anúncio de banner.

Requisitos

  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Unity 5.6 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 4.2.0 ou mais recente (recomenda-se a versão mais recente).
  • 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 AppLovin

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

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

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

Selecionar um app para mediação

Lances

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

Cascata

Na interface do AppLovin, selecione Applications na seção Monetization para acessar os apps registrados. Selecione o app que você quer usar com a mediação na lista de apps disponíveis.

Criar uma zona

Lances

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

Cascata

Na interface do AppLovin, selecione Zones na seção Monetization para acessar os IDs de zona registrados. Se você já criou as zonas necessárias para o app, pule para a Etapa 2. Para criar um novo ID de zona, clique em Criar zona.

Insira o nome do ID da zona, selecione Android como Plataforma e escolha o Tipo de anúncio.

Configure a precificação da zona selecionando CPM fixo ou Otimizado pelo AppLovin. Os CPMs podem ser configurados por país para a opção CPM fixo. Em seguida, clique em Salvar.

Android

iOS

Depois que a zona for criada, o ID dela poderá ser encontrado na coluna ID da zona.

Android

iOS

Ativar o modo de teste

Siga as instruções no guia Modo de teste do MAX do AppLovin sobre como ativar anúncios de teste.

Etapa 2: configurar a demanda da AppLovin 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.

Adição da AppLovin Corp. à lista de parceiros de publicidade do GDPR e dos regulamentos estaduais dos EUA

Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar a Applovin Corp. à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA na interface da AdMob.

Etapa 3: importar o SDK e o adaptador da AppLovin

OpenUPM-CLI

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

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

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 Applovin 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 Applovin no link de download no Changelog e extraia o GoogleMobileAdsApplovinMediation.unitypackage do arquivo zip.

No editor do projeto do Unity, selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsApplovinMediation.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 da AppLovin

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.

Desde a versão 7.0.0 do plug-in de mediação do Google Mobile Ads, o AppLovin oferece suporte à leitura da string de consentimento das preferências compartilhadas e à configuração do status de consentimento.

Se você não estiver usando o plug-in de mediação de anúncios para dispositivos móveis do Google para a versão 7.0.0 ou mais recente do Applovin ou não estiver usando uma CMP que grava a string de consentimento nas preferências compartilhadas, use os métodos AppLovin.SetHasUserConsent() e AppLovin.SetIsAgeRestrictedUser(). O exemplo de código abaixo mostra como transmitir informações de consentimento para o SDK da AppLovin. Essas opções precisam ser definidas antes de você inicializar o SDK dos anúncios para dispositivos móveis do Google para garantir que elas sejam encaminhadas corretamente para o SDK da AppLovin.

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetHasUserConsent(true);

Além disso, se o usuário estiver em uma categoria com restrição de idade, você também poderá definir a flag abaixo como true.

AppLovin.SetIsAgeRestrictedUser(true);

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

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 versão 6.3.1 do AppLovin inclui o método AppLovin.SetDoNotSell(). O exemplo de código abaixo mostra como transmitir informações de consentimento para o SDK da AppLovin. Essas opções precisam ser definidas antes de você inicializar o SDK dos anúncios para dispositivos móveis do Google para garantir que elas sejam encaminhadas corretamente para o SDK da AppLovin.

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetDoNotSell(true);

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

Etapa 5: adicionar o código necessário

Android

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

iOS

Integração da SKAdNetwork

Siga a documentação do AppLovin para adicionar os identificadores da 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 Applovin.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste do 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

Otimizações

Adicionar uma chamada para AppLovin.Initialize() à sua atividade de inicialização permite que o AppLovin rastreie eventos assim que o app é iniciado.

Códigos de erro

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

Android

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

iOS

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

Android

Código do erro Motivo
-1.009 a -1.204 O SDK AppLovin retornou um erro. Consulte a documentação do AppLovin's para mais detalhes.
101 O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com o AppLovin.
103 O contexto é nulo.
104 O token de lance da AppLovin está vazio.
105 Vários anúncios foram solicitados para a mesma zona. O AppLovin só pode carregar um anúncio por zona.
106 O anúncio não está pronto para ser exibido.
108 O adaptador AppLovin não oferece suporte ao formato de anúncio solicitado.

iOS

Código do erro Motivo
-1.009 a -1.204 O SDK AppLovin retornou um erro. Consulte a documentação do AppLovin's para mais detalhes.
101 O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com o AppLovin.
102 Os parâmetros do servidor da AppLovin configurados na interface da AdMob estão ausentes ou inválidos.
103 Falha ao mostrar o anúncio do AppLovin.
104 Vários anúncios foram solicitados para a mesma zona. O AppLovin só pode carregar um anúncio por zona.
105 A chave do SDK da AppLovin não foi encontrada.
107 O token de lance está vazio.
108 O adaptador AppLovin não oferece suporte ao formato de anúncio solicitado.
110 O AppLovin enviou um callback de carregamento, mas não carregou nenhum anúncio.
111 Não foi possível recuperar a instância do SDK do AppLovin.
112 O usuário é uma criança.

Registro de alterações do plug-in de mediação do AppLovin Unity

Versão 8.0.3

Versão 8.0.2

Versão 7.4.1

Versão 7.4.0

Versão 7.3.1

Versão 7.3.0

Versão 7.2.2

Versão 7.2.1

Versão 7.2.0

Versão 7.1.0

Versão 7.0.1

Versão 7.0.0

Versão 6.9.1

Versão 6.9.0

Versão 6.8.0

Versão 6.7.0

Versão 6.6.0

Versão 6.5.1

Versão 6.5.0

Versão 6.4.3

Versão 6.4.2

Versão 6.4.1

Versão 6.4.0

Versão 6.3.1

Versão 6.3.0

Versão 6.2.1

Versão 6.2.0

Versão 6.1.0

Versão 6.0.0

Versão 5.1.3

Versão 5.1.2

Versão 5.1.1

Versão 5.1.0

Versão 5.0.0

Versão 4.8.1

Versão 4.8.0

Versão 4.7.0

Versão 4.6.2

Versão 4.6.1

Versão 4.6.0

Versão 4.5.8

Versão 4.5.7

Versão 4.5.6

Versão 4.5.5

Versão 4.5.4

Versão 4.5.3

Versão 4.5.2

Versão 4.5.1

Versão 4.5.0

Versão 4.4.1

Versão 4.4.0

Versão 4.3.0

Versão 4.2.0

  • Compatível com a versão 9.4.2.0 do adaptador Android AppLovin.
  • Compatível com a versão 6.6.1.0 do adaptador AppLovin para iOS.

Versão 4.1.0

  • O plug-in foi atualizado para oferecer suporte à nova API Rewarded Beta aberta.
  • Suporte à versão 9.2.1.1 do adaptador Android da AppLovin.
  • Suporte ao adaptador AppLovin para iOS versão 6.3.0.0.

Versão 4.0.0

  • Compatível com a versão 9.2.1.0 do adaptador Android do AppLovin.
  • Suporte ao adaptador AppLovin para iOS versão 6.2.0.0.

Versão 3.1.2

  • Compatível com a versão 8.1.4.0 do adaptador Android do AppLovin.
  • Compatível com a versão 5.1.2.0 do adaptador AppLovin para iOS.

Versão 3.1.1

  • Compatível com a versão 8.1.0.0 do adaptador Android AppLovin.
  • Compatível com a versão 5.1.1.0 do adaptador iOS do AppLovin.

Versão 3.1.0

  • Compatível com a versão 8.1.0.0 do adaptador Android AppLovin.
  • Compatível com a versão 5.1.0.0 do adaptador AppLovin para iOS.

Versão 3.0.3

  • Compatível com a versão 8.0.2.1 do adaptador Android da AppLovin.
  • Compatível com a versão 5.0.2.0 do adaptador AppLovin para iOS.

Versão 3.0.2

  • Suporte à versão 8.0.1 do SDK do AppLovin para Android.
  • Suporte ao SDK do AppLovin para iOS versão 5.0.1.

Versão 3.0.1

  • Suporte ao SDK do AppLovin para Android versão 8.0.0.
  • Suporte ao SDK do AppLovin para iOS versão 5.0.1.
  • Adição do método AppLovin.SetIsAgeRestrictedUser() para indicar se o usuário está em uma categoria com restrição de idade.

Versão 3.0.0

  • Suporte ao SDK do AppLovin para Android versão 8.0.0.
  • Suporte ao SDK do AppLovin para iOS versão 5.0.1.
  • Adição do método AppLovin.SetHasUserConsent() para encaminhar a flag de consentimento do usuário ao SDK da AppLovin.

Versão 2.0.0

  • Suporte à versão 7.8.6 do SDK do AppLovin para Android.
  • Suporte ao SDK do AppLovin para iOS versão 5.0.1.

Versão 1.2.1

  • Suporte à versão 7.8.6 do SDK do AppLovin para Android.
  • Suporte ao SDK do AppLovin para iOS versão 4.8.3.

Versão 1.2.0

  • Suporte à versão 7.8.5 do SDK do AppLovin para Android.
  • Suporte ao SDK do AppLovin para iOS versão 4.8.3.

Versão 1.1.0

  • Suporte à versão 7.7.0 do SDK do AppLovin para Android.
  • Suporte ao SDK AppLovin para iOS versão 4.7.0.

Versão 1.0.0

  • Primeira versão!
  • Suporte à versão 7.4.1 do SDK do AppLovin para Android.
  • Suporte ao SDK AppLovin para iOS versão 4.4.1.