Integrar a AppLovin com a mediação

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

Este guia mostra como usar o Google Mobile Ads Unity Plugin para carregar e exibir anúncios da AppLovin usando a mediação, incluindo integrações de lances e em hierarquia. 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 do Unity.

Integrações e formatos de anúncio aceitos

O adaptador de mediação do Ad Manager para AppLovin tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Abertura do aplicativo  1
Banner  2
Intersticial
Premiado

1 A integração em hierarquia está em versão Beta fechada.

A hierarquia só aceita os tamanhos de banner 320 x 50 e 728 x 90. Os lances não são compatíveis com anúncios de banner.

Pré-requisitos

Antes de continuar, verifique o seguinte:

  • Versão mais recente do Google Mobile Ads Unity Plugin.
  • Unity Editor versão 5.6 ou mais recente.
  • [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o plug-in de mediação dos anúncios para dispositivos móveis do Google para a AppLovin 4.2.0 ou mais recente (recomendamos usar a última versão).
  • Para implantar no Android
    • API Android nível 24 ou mais recente.
  • Para implantar no iOS
    • Destino de implantação do iOS 13.0 ou mais recente.
  • Um projeto do Unity em funcionamento configurado com Google Mobile Ads Unity Plugin. Consulte Configurar o Google Mobile Ads Unity Plugin para mais detalhes.
  • Configure a 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ê vai precisar da chave do SDK e da chave de relatório da AppLovin. Para encontrá-los, acesse a interface da AppLovin > Account > Keys para ver 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

    Lances

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

    Cascata

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

    Criar uma zona

    Lances

    Essa 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á 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 os Preços da zona selecionando CPM fixo ou Otimizado pela AppLovin. Os CPMs podem ser configurados por país para a opção CPM fixo. Clique em Salvar.

    Android

    iOS

    Depois que a zona é criada, o ID dela pode ser encontrado na coluna ID da zona.

    Android

    iOS

    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

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

    Android

    Para ver as 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. à 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

    OpenUPM-CLI

    Se você tiver a OpenUPM-CLI instalada, poderá instalar o plug-in de mediação da AppLovin dos anúncios para dispositivos móveis do Google para Unity no seu projeto executando o seguinte comando no diretório raiz do projeto:

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

    OpenUPM

    No editor do projeto do Unity, selecione Edit > Configurações do projeto > Package Manager para abrir as Configurações do gerenciador de pacotes do Unity.

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

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

    Detalhes do OpenUPM

    Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.

    Registros do Unity

    Selecione o pacote Mediação do Google Mobile Ads Applovin e clique em Instalar.

    Instalar pelo OpenUPM

    Pacote do Unity

    Baixe a versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para a AppLovin no link de download do registro de alterações 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ê salvou. Verifique se todos os arquivos estão selecionados e clique em Importar.

    Importar do Unity

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

    Forçar resolução

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

    Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer algumas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de pedir o consentimento deles para usar cookies ou outro armazenamento local quando exigido por lei e para coletar, compartilhar e usar dados pessoais para 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.

    A versão 7.0.0 e mais recentes do adaptador da AppLovin para Unity aceitam a transmissão de indicadores de consentimento do GDPR do SDK da UMP e de plataformas de gestão de consentimento que se integram à especificação de consentimento adicional do Google.

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

    Declarar usuários menores de idade

    A AppLovin não oferece suporte à inicialização do SDK da AppLovin em conexão com uma criança. 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" para Android ou iOS.

    O plug-in de mediação dos anúncios para dispositivos móveis do Google para Unity da AppLovin (versão 11.3.0 ou mais recente) desativa automaticamente a mediação para a AppLovin em apps que declaram um usuário menor de idade usando qualquer uma das seguintes configurações:

    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.

    A versão 6.3.1 do plug-in de mediação dos anúncios para dispositivos móveis do Google para a AppLovin inclui o método AppLovin.SetDoNotSell(). O exemplo de código a seguir 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 e assim garantir que elas sejam encaminhadas corretamente ao SDK da AppLovin.

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

AppLovin.SetDoNotSell(true);

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

    Etapa 5: adicionar o código necessário

    Android

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

    iOS

    Integração da SKAdNetwork

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

    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

    Otimizações

    Adicionar uma chamada a AppLovin.Initialize() na 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 da AppLovin, os publishers poderão verificar o erro na 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 correspondentes gerados pelo adaptador da AppLovin quando um anúncio não é carregado:

    Android

    Código do erro Motivo
    -1009 a -1, 204 O SDK da AppLovin retornou um erro. Consulte a documentação da AppLovin para mais detalhes.
    101 O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela AppLovin.
    103 O contexto é nulo.
    104 O token de bid da AppLovin está vazio.
    105 Solicitou vários anúncios para a mesma zona. A AppLovin só pode carregar um anúncio por vez em cada zona.
    106 O anúncio não está pronto para ser veiculado.
    108 O adaptador da AppLovin não é compatível com o formato de anúncio solicitado.
    109 O contexto não é uma instância de atividade.
    110 A chave do SDK está ausente.
    112 O usuário é uma criança.
    113 O ID do bloco de anúncios está ausente.

    iOS

    Código do erro Motivo
    -1009 a -1, 204 O SDK da AppLovin retornou um erro. Consulte a documentação da AppLovin para mais detalhes.
    101 O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela AppLovin.
    102 Os parâmetros do servidor da AppLovin configurados na interface do Ad Manager estão ausentes ou são inválidos.
    103 Não foi possível mostrar o anúncio da AppLovin.
    104 Vários anúncios foram solicitados para a mesma zona. A AppLovin só pode carregar um anúncio por vez em cada zona.
    105 A chave do SDK da AppLovin não foi encontrada.
    107 O token de lance está vazio.
    108 O adaptador da 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.
    111 Não foi possível recuperar a instância do SDK da AppLovin.
    112 O usuário é uma criança.
    113 A instância compartilhada do SDK da AppLovin não foi inicializada.
    114 O SDK da AppLovin não retorna o token de lance.
    115 O ID do bloco de anúncios está ausente. Não é possível carregar o anúncio.
    116 O anúncio não está pronto. Não é possível mostrar o anúncio.

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

    Versão 8.7.7

    Versão 8.7.6

    Versão 8.7.5

    Versão 8.7.4

    Versão 8.7.3

    Versão 8.7.2

    Versão 8.7.1

    Versão 8.7.0

    Versão 8.6.0

    Versão 8.5.2

    Versão 8.5.1

    Versão 8.5.0

    Versão 8.4.1

    Versão 8.4.0

    Versão 8.3.2

    Versão 8.3.1

    Versão 8.3.0

    Versão 8.2.1

    Versão 8.2.0

    Versão 8.1.1

    Versão 8.1.0

    Versão 8.0.4

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

    Versão 4.1.0

    • Atualizamos o plug-in para oferecer suporte à nova API Rewarded em versão Beta aberta.
    • Compatível com a versão 9.2.1.1 do adaptador do AppLovin para Android.
    • Compatível com a versão 6.3.0.0 do adaptador da AppLovin para iOS.

    Versão 4.0.0

    • Compatibilidade com a versão 9.2.1.0 do adaptador do Android da AppLovin.
    • Compatibilidade com a versão 6.2.0.0 do adaptador do iOS da AppLovin.

    Versão 3.1.2

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

    Versão 3.1.1

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

    Versão 3.1.0

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

    Versão 3.0.3

    • Compatibilidade 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 do AppLovin para iOS.

    Versão 3.0.2

    • Compatível com a versão 8.0.1 do SDK do Android da AppLovin.
    • Compatível com a versão 5.0.1 do SDK da AppLovin para iOS.

    Versão 3.0.1

    • Compatível com a versão 8.0.0 do SDK do AppLovin para Android.
    • Compatível com a versão 5.0.1 do SDK da AppLovin para iOS.
    • 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

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

    Versão 2.0.0

    • Compatível com a versão 7.8.6 do SDK do Android da AppLovin.
    • Compatibilidade com a versão 5.0.1 do SDK do iOS da AppLovin.

    Versão 1.2.1

    • Compatível com a versão 7.8.6 do SDK do Android da AppLovin.
    • Compatibilidade com a versão 4.8.3 do SDK do iOS da AppLovin.

    Versão 1.2.0

    • Compatível com a versão 7.8.5 do SDK do AppLovin para Android.
    • Compatível com a versão 4.8.3 do SDK da AppLovin para iOS.

    Versão 1.1.0

    • Compatível com a versão 7.7.0 do SDK do AppLovin para Android.
    • Compatível com a versão 4.7.0 do SDK da AppLovin para iOS.

    Versão 1.0.0

    • Primeira versão!
    • Suporte à versão 7.4.1 do SDK do Android da AppLovin.
    • Compatível com a versão 4.4.1 do SDK da AppLovin para iOS.