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 as 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 da AdMob para AppLovin tem os seguintes recursos:

¹ 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 em 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 do Flutter configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
• Concluir o Guia para iniciantes 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

Criar uma zona

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 da AppLovin na interface da AdMob

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

Adição da 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 adaptador do Applovin 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 dos anúncios para dispositivos móveis do Google para Applovin, extraia o arquivo baixado 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

Consentimento da UE e GDPR

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.

Se você não estiver usando uma CMP que grava a string de consentimento nas preferências compartilhadas, use os métodos GmaMediationApplovin.setHasUserConsent() e GmaMediationApplovin.setIsAgeRestrictedUser(). 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 lei define esses termos), com a opção de recusa oferecida por um link "Não vender minhas informações pessoais" 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 sua 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 método GmaMediationApplovin.setDoNotSell(). 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

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 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 é 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:

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

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

Confira os códigos e as mensagens exibidas pelo adaptador da AppLovin quando um anúncio não é carregado:

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