Integrar a AppLovin à mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios do AppLovin usando a mediação, abrangendo integrações de lances e hierarquia. Ele mostra 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 Ad Manager para AppLovin tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Banner  1
Intersticial
Premiado

Os anúncios de banner (exceto banners MREC) são compatíveis somente com a 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
  • [For Bidding]: plug-in de mediação de anúncios para dispositivos móveis do Google para AppLovin 4.2.0 ou mais recente (versão mais recente recomendada)
  • Para implantar no Android:
    • Android API de nível 21 ou mais recente
  • Para implantar no iOS:
    • Destino de implantação do iOS de 12.0 ou mais recente
  • Um projeto Unity em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte o artigo Começar para ver mais detalhes.
  • Leia o Guia explicativo de mediação.

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

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

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

Se você pretende apenas integrar os lances, defina as configurações de mediação.

Selecione o app para mediação

Lances

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

Cascata

Na interface do AppLovin, selecione Aplicativos na seção Monetização para acessar seus apps registrados. Selecione o aplicativo que você quer usar com a mediação na lista de aplicativos disponíveis.

Criar uma zona

Lances

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

Cascata

Na interface do AppLovin, selecione Zonas na seção Monetização para acessar os IDs de zonas registrados. Se você já tiver criado as zonas necessárias para o app, avance 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 a Plataforma e escolha o Tipo de anúncio.

Configure Preços para a 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

Após a criação da zona, você encontra o ID dela na coluna ID da zona.

Android

iOS

Ativar modo de teste

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

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

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

Android

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

iOS

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

Adicionar a AppLovin Corp. ao GDPR e à lista de parceiros de publicidade das regulamentações estaduais dos EUA

Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar AppLovin Corp. à lista de parceiros de anúncios do GDPR e das regulamentações estaduais dos EUA na Ad Manager IU.

Etapa 3: importar o SDK e o adaptador do AppLovin

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 o AppLovin no link de download do Changelog e extraia o GoogleMobileAdsAppLovinMediation.unitypackage do arquivo ZIP.

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

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

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

De acordo com a Política de consentimento de usuários da União Europeia do Google, você precisa garantir que algumas divulgações sejam fornecidas aos usuários no Espaço Econômico Europeu (EEE) e que eles tenham o consentimento deles em relação ao uso de identificadores de dispositivos 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 solicitar o consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode coletar, receber ou usar dados pessoais, além de fornecer informações sobre o uso de cada rede. No momento, o Google não pode transmitir a opção de consentimento do usuário a essas redes automaticamente.

Desde a versão 7.0.0 do plug-in de mediação de anúncios para dispositivos móveis do Google, com a AppLovin, é possível ler a string de consentimento das preferências compartilhadas e definir o status de consentimento adequadamente.

Se vocênão usa o plug-in de mediação de anúncios para dispositivos móveis do Google para Applovin versão 7.0.0+ ounão utiliza uma CMP que grava a string de consentimento nas preferências compartilhadas, use os métodos AppLovin.SetHasUserConsent(),AppLovin.SetIsAgeRestrictedUser() . O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK do AppLovin. Essas opções precisam ser definidas antes da inicialização do SDK dos anúncios para dispositivos móveis do Google para garantir que elas sejam encaminhadas corretamente para o SDK do 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, também será possível definir a sinalização abaixo como true.

AppLovin.SetIsAgeRestrictedUser(true);

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

Leis Estaduais de Privacidade dos EUA

As Leis Estaduais de Privacidade dos EUA exigem que os usuários escolham não autorizar a "venda" das próprias "informações pessoais" (conforme a definição desses termos) usando um link em destaque "Não vender minhas informações pessoais" na página inicial do "vendedor". O Guia de conformidade com as leis de privacidade dos estados dos EUA permite ativar o processamento 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, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode 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 de anúncios para dispositivos móveis do Google para o AppLovin versão 6.3.1 inclui o método AppLovin.SetDoNotSell() . O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK do AppLovin. Essas opções precisam ser definidas antes da inicialização do SDK dos anúncios para dispositivos móveis do Google para garantir que elas sejam encaminhadas corretamente para o SDK do AppLovin.

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

AppLovin.SetDoNotSell(true);

Consulte a documentação de privacidade da AppLovin (em inglês) para mais informações.

Etapa 5: adicionar o código obrigatório

Android

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

iOS

Integração com a SKAdNetwork

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

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste em Ad Manager e ative o modo de teste na AppLovin interface.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste do AppLovin, ative os testes de uma única origem no Ad Inspector usando as AppLovin (Bidding) and AppLovin (Waterfall) origens de anúncios.

Etapas opcionais

Otimizações

Adicionar uma chamada para AppLovin.Initialize() à sua atividade de inicialização oferece à AppLovin a capacidade de rastrear 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 classes abaixo:

Android

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

iOS

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

Veja a seguir os códigos e as mensagens correspondentes gerados pelo adaptador AppLovin quando um anúncio não é carregado:

Android

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

iOS

Código do erro Motivo
-1009 a -1, 204 O SDK do AppLovin retornou um erro. Consulte a documentação da AppLovin (em inglês) para mais detalhes.
101 O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com a AppLovin.
102 Os parâmetros do servidor AppLovin configurados na interface Ad Manager estão ausentes/inválidos.
103 Falha ao mostrar o anúncio da AppLovin.
104 Vários anúncios solicitados para a mesma zona. A AppLovin só consegue carregar um anúncio por vez por zona.
105 A chave do SDK do AppLovin não foi encontrada.
107 O token de lance está vazio.
108 O adaptador AppLovin não é compatível com o formato de anúncio solicitado.
110 A AppLovin enviou um callback de carregamento bem-sucedido, mas não carregou nenhum anúncio.

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

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 o adaptador AppLovin Android versão 9.4.2.0.
  • Compatível com o adaptador AppLovin para iOS versão 6.6.1.0.

Versão 4.1.0

  • O plug-in foi atualizado para oferecer compatibilidade com a nova API Premiada em versão Beta aberta.
  • Compatível com o adaptador AppLovin Android versão 9.2.1.1.
  • Compatível com o adaptador AppLovin para iOS versão 6.3.0.0.

Versão 4.0.0

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

Versão 3.1.2

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

Versão 3.1.1

  • Oferece suporte ao adaptador AppLovin Android versão 8.1.0.0.
  • Compatível com o adaptador AppLovin para iOS versão 5.1.1.0.

Versão 3.1.0

  • Oferece suporte ao adaptador AppLovin Android versão 8.1.0.0.
  • Compatível com o adaptador AppLovin para iOS versão 5.1.0.0.

Versão 3.0.3

  • Oferece suporte ao adaptador AppLovin Android versão 8.0.2.1.
  • Compatível com o adaptador AppLovin para iOS versão 5.0.2.0.

Versão 3.0.2

  • Oferece suporte ao SDK do AppLovin para Android versão 8.0.1.
  • Compatível com o SDK do AppLovin para iOS versão 5.0.1.

Versão 3.0.1

  • Oferece suporte ao SDK do AppLovin para Android versão 8.0.0.
  • Compatível com o SDK do AppLovin para iOS versão 5.0.1.
  • O método AppLovin.SetIsAgeRestrictedUser() foi adicionado para indicar se o usuário está em uma categoria com restrição de idade.

Versão 3.0.0

  • Oferece suporte ao SDK do AppLovin para Android versão 8.0.0.
  • Compatível com o SDK do AppLovin para iOS versão 5.0.1.
  • Adição do método AppLovin.SetHasUserConsent() para encaminhar a sinalização de consentimento do usuário ao SDK do AppLovin.

Versão 2.0.0

  • Oferece suporte ao SDK do AppLovin para Android versão 7.8.6.
  • Compatível com o SDK do AppLovin para iOS versão 5.0.1.

Versão 1.2.1

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

Versão 1.2.0

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

Versão 1.1.0

  • Oferece suporte ao SDK do AppLovin para Android versão 7.7.0.
  • Compatível com o SDK do AppLovin para iOS versão 4.7.0.

Versão 1.0.0

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