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 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 Flutter .

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 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
  • Flutter 3.7.0 ou 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 Flutter funcional 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: 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 é criada, o ID dela pode 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 do AppLovin na Ad Manager interface

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

Android

Para 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 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

Integração pelo pub.dev

Adicione a dependência abaixo com as versões mais recentes do SDK e do adaptadorAppLovin no arquivo pubspec.yaml do pacote:

dependencies:
  gma_mediation_applovin: ^1.0.0

Integração manual

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, extraia o arquivo transferido e adicione a pasta do plug-in extraído (e o conteúdo dela) ao seu projeto do Flutter. Em seguida, faça referência ao plug-in no arquivo pubspec.yaml adicionando a seguinte dependência:

dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

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.

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 uma CMP que grava a string de consentimento nas preferências compartilhadas, use GmaMediationApplovin.setHasUserConsent() e GmaMediationApplovin.setIsAgeRestrictedUser() métodos. 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.

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.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 definição legal desses termos). Essa opção é disponibilizada por um link com a mensagem "Não vender minhas informações pessoais" mostrado 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 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 AppLovin inclui o GmaMediationApplovin.setDoNotSell() método. 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.

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.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

Parâmetros específicos da rede

O adaptador do AppLovin oferece suporte à transmissão de um objeto AppLovinMediationExtras para a solicitação de anúncio para definir parâmetros específicos da rede. O exemplo de código abaixo mostra como desativar o áudio em anúncios em vídeo usando o parâmetro isMuted:

AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [applovinExtras],
);

Otimizações

Adicionar uma chamada para GmaMediationApplovin.initializeSdk('sdkKey') à sua atividade de inicialização permite que o AppLovin rastreie eventos assim que o app for 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 do 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 do 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 AppLovin configurados na interface Ad Manager estão ausentes ou são 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 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 adaptador de mediação do Flutter do AppLovin

Próxima versão

  • Criado e testado com a versão 5.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

1.2.0

  • Compatibilidade verificada com a versão 12.6.1.0 do adaptador Android da AppLovin.
  • Compatibilidade verificada com o adaptador iOS AppLovin versão 12.6.1.0.
  • Criado e testado com a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

1.1.0

  • A API para o GmaMediationApplovin não é mais estática.
  • Compatibilidade verificada com a versão 12.4.3.0 do adaptador Android do AppLovin.
  • Compatibilidade verificada com a versão 12.4.2.0 do adaptador iOS da AppLovin.
  • Criado e testado com a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

1.0.0

  • Versão inicial.
  • Compatibilidade verificada com a versão 12.3.0.0 do adaptador Android do AppLovin
  • Compatibilidade verificada com o adaptador iOS da AppLovin versão 12.2.1.0
  • Criado e testado com o plug-in de anúncios para dispositivos móveis do Google para Flutter versão 5.0.0.