Integrar a AppLovin à mediação

Neste guia, mostramos 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, abrangendo integrações de lances e 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 da AppLovin a um app Unity.

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

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

Integração
Lances
Cascata
Formatos
Banner  1
Intersticial
Premiado

Os anúncios de banner (exceto banners MREC) são compatíveis apenas 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
  • [Para lances]: plug-in de mediação de anúncios para dispositivos móveis do Google para o 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:
    • Meta de implantação do iOS 12.0 ou mais recente
  • Um projeto Unity em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • Concluir o Guia explicativo de mediação

Etapa 1: definir 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.

Adiciona 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

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 usando o link de download no Registro de mudanças (link em inglês) 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ê fez o download. 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 Play Services do Unity executará a resolução de dependências do zero e copiará as dependências declaradas para o diretório Assets/Plugins/Android do seu app 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 determinadas divulgações sejam fornecidas aos usuários no Espaço Econômico Europeu (EEE) e recebam os consentimentos 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 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 uma delas. No momento, o Google não pode transmitir automaticamente a escolha de consentimento do usuário a essas redes.

Com a versão 7.0.0 do plug-in de mediação dos anúncios para dispositivos móveis do Google, a AppLovin aceita a leitura da string de consentimento das preferências compartilhadas e a configuração do status de consentimento.

Se você não usa o plug-in de mediação dos anúncios para dispositivos móveis do Google para o Applovin versão 7.0.0 ou mais recente ou não usa uma CMP que grava a string de consentimento nas preferências compartilhadas, utilize os métodos AppLovin.SetHasUserConsent() e AppLovin.SetIsAgeRestrictedUser() . O exemplo de código abaixo mostra como transmitir informações de consentimento para o 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 ao 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, defina 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

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 definição desses termos) com um link "Não vender minhas informações pessoais" destacado na página inicial do vendedor. O guia de conformidade com as leis de privacidade dos EUA oferece a capacidade de ativar o processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não pode 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 AppLovin versão 6.3.1 inclui o método AppLovin.SetDoNotSell() . O exemplo de código abaixo mostra como transmitir as informações de consentimento para o SDK do AppLovin. Defina essas opções 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.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 SKAdNetwork ao arquivo Info.plist` do seu 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

Adicionar uma chamada a AppLovin.Initialize() à sua atividade de inicialização permite que a 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 classes a seguir:

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 associadas gerados pelo adaptador da 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 do AppLovin 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 do AppLovin está vazio.
105 Foram solicitados vários anúncios para a mesma zona. A AppLovin só pode carregar um anúncio por vez e por zona.
106 O anúncio não está pronto para ser exibido.
108 O AppLovin Adapter 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 do AppLovin 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 do AppLovin configurados na AdMob interface estão ausentes/inválidos.
103 Falha ao exibir o anúncio da AppLovin.
104 Foram solicitados vários anúncios para a mesma zona. A AppLovin só pode carregar um anúncio por vez e por zona.
105 A chave do SDK do AppLovin não foi encontrada.
107 O token de lance está vazio.
108 O AppLovin Adapter 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 para Unity do AppLovin

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

  • Oferece suporte ao adaptador para Android AppLovin versão 9.4.2.0.
  • Oferece suporte ao adaptador para iOS do AppLovin versão 6.6.1.0.

Versão 4.1.0

  • Atualização do plug-in para oferecer suporte à nova API Premiada em versão Beta aberta.
  • Oferece suporte ao adaptador para Android AppLovin versão 9.2.1.1.
  • Oferece suporte ao adaptador para iOS do AppLovin versão 6.3.0.0.

Versão 4.0.0

  • Oferece suporte ao adaptador para Android AppLovin versão 9.2.1.0.
  • Oferece suporte ao adaptador para iOS do AppLovin versão 6.2.0.0.

Versão 3.1.2

  • Oferece suporte ao adaptador para Android AppLovin versão 8.1.4.0.
  • Oferece suporte ao adaptador para iOS do AppLovin versão 5.1.2.0.

Versão 3.1.1

  • Oferece suporte ao adaptador para Android AppLovin versão 8.1.0.0.
  • Oferece suporte ao adaptador para iOS do AppLovin versão 5.1.1.0.

Versão 3.1.0

  • Oferece suporte ao adaptador para Android AppLovin versão 8.1.0.0.
  • Oferece suporte ao adaptador para iOS da AppLovin versão 5.1.0.0.

Versão 3.0.3

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

Versão 3.0.2

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

Versão 3.0.1

  • Oferece suporte ao SDK do AppLovin para Android versão 8.0.0.
  • Oferece suporte à versão 5.0.1 do SDK do AppLovin para iOS.
  • 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.
  • Oferece suporte à versão 5.0.1 do SDK do AppLovin para iOS.
  • 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.
  • Oferece suporte à versão 5.0.1 do SDK do AppLovin para iOS.

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 ao SDK do AppLovin para Android versão 7.4.1.
  • Oferece suporte ao SDK do AppLovin para iOS versão 4.4.1.