Integrar a AppLovin à mediação

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

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

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

Integração
Lances
Cascata
Formatos
Banner  1
Intersticial
Premiado

Anúncios de banner (exceto MREC banners) são suportados somente na mediação. Os lances não são compatíveis com nenhum tipo de anúncios de banner.

Requisitos

  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Unity 5.6 ou mais recente
  • [Para lances]: plug-in de mediação de anúncios para dispositivos móveis do Google para AppLovin 4.2.0 ou mais alta (recomendamos a versão mais recente)
  • 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 Google SDK de anúncios para dispositivos móveis. Consulte Acesse Primeiros passos para ver mais detalhes.
  • Concluir a mediação Guia explicativo

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

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

Para configurar seu AdMob 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 AdMob 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 AdMob IU.

Etapa 3: importar o SDK e o adaptador do AppLovin

OpenUPM-CLI

Se você tiver a OpenUPM-CLI instalado, instale o AppLovin dos anúncios para dispositivos móveis do Google Plug-in de mediação para Unity no seu projeto executando o seguinte: no diretório raiz do seu projeto:

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

OpenUPM

No editor de projetos do Unity, selecione Editar > Configurações do projeto > Package Manager para abrir o Configurações do Unity Package Manager.

Na guia Registros com escopo, adicione o OpenUPM como um registro com escopo usando o os seguintes detalhes:

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

Detalhes do OpenUPM

Em seguida, navegue até Janela > Package Manager para abrir o O Unity Package Manager e selecione Meus registros no menu suspenso.

Registros do Unity

Selecione a opção Google Mobile Ads AppLovin Mediation for Unity e clique em Instalar.

Instalar pelo OpenUPM

Pacote do Unity

Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para: AppLovin no link de download Registro de alterações e extrair o GoogleMobileAdsAppLovinMediation.unitypackage do arquivo ZIP.

No editor de projetos do Unity, selecione Assets > Importar pacote > Pacote personalizado e encontre a GoogleMobileAdsAppLovinMediation.unitypackage que você transferiu por download. Verifique se todos os arquivos estão selecionados e clique em Importação.

Importar do Unity

Em seguida, selecione Recursos > Resolvedor do Play Services > Resolvedor do Android > Forçar resolução. O resolvedor do Unity Play Services vai realizar a resolução das dependências do zero e copiar a suas dependências declaradas no diretório Assets/Plugins/Android App Unity

Forçar resolução

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

De acordo com o Consentimento dos usuários da UE do Google política, você precisa garantir que determinadas divulgações sejam fornecidas e consentimentos de usuários no Espaço Econômico Europeu (EEE) em relação a: o uso de identificadores de dispositivos e dados pessoais. Essa política reflete requisitos da Diretiva de privacidade eletrônica da UE e da Lei Geral de Proteção de Dados (GDPR). Ao solicitar consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que podem coletar, receber ou usar dados pessoais. que oferecem informações sobre o uso de cada rede. No momento, o Google não pode repassar a opção de consentimento do usuário a essas redes automaticamente.

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

Se você for Não usa o plug-in de mediação de anúncios para dispositivos móveis do Google para o Applovin versão 7.0.0+ ou Se você não usa uma CMP que grava a string de consentimento no arquivo preferências, você pode usar AppLovin.SetHasUserConsent() e AppLovin.SetIsAgeRestrictedUser() métodos. O exemplo de código a seguir mostra como para transmitir informações de consentimento ao SDK do AppLovin. Essas opções precisam ser definidas antes de inicializar o 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, você poderá também defina a flag abaixo como true.

AppLovin.SetIsAgeRestrictedUser(true);

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

Leis Estaduais de Privacidade dos EUA

Estados Unidos leis estaduais de privacidade exigem que os usuários tenham para desativar a "promoção" das suas "informações pessoais" (como a lei define esses termos), com a opção de desativação oferecida por um aviso "Não vender meus dados pessoais" Informações" na página "vendas" na página inicial de seu grupo. A Estados Unidos define a privacidade guia de conformidade com as leis, permite ativar processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não consegue aplicar essa configuração a cada anúncio rede na sua cadeia de mediação. Portanto, você deve identificar cada rede de anúncios na sua cadeia de mediação que possam participar da venda de e seguir as orientações de cada uma dessas redes para garantir compliance.

Plug-in de mediação de anúncios para dispositivos móveis do Google para o AppLovin Versão 6.3.1 inclui o AppLovin.SetDoNotSell() . O exemplo de código a seguir mostra como transmitir informações de consentimento ao SDK do AppLovin. Essas opções precisam ser definidas inicializar os anúncios para celular do Google SDK para garantir que elas sejam encaminhadas corretamente para o SDK do AppLovin.

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

AppLovin.SetDoNotSell(true);

Consulte a página de privacidade da AppLovin documentação 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 AdMob 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

Adicionando uma chamada a AppLovin.Initialize() à atividade de inicialização oferece A AppLovin pode acompanhar eventos assim que o app é iniciado.

Códigos de erro

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

Android

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

iOS

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

Estes são os códigos e as mensagens correspondentes gerados pelo adaptador AppLovin quando ocorre uma falha no carregamento de um anúncio:

Android

Código do erro Motivo
-1009 a -1, 204 O SDK do AppLovin retornou um erro. Consulte 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.
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 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 AdMob 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.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 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

  • Compatível com o 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.