Integrar a AppLovin à mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios do AppLovin usando a mediação, abrangendo integrações de lances e hierarquia. Ele mostra 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 AdMob para AppLovin tem os seguintes recursos:

¹ Os anúncios de banner (exceto banners MREC) são compatíveis somente 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
• Flutter 3.7.0 ou 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 Flutter em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte o artigo Começar para ver mais detalhes.
• Leia o Guia explicativo de mediação.

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

Criar uma zona

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

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

Integração pelo pub.dev

Adicione a dependência abaixo com as versões mais recentes do AppLovin SDK e do adaptador 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 salvo e adicione a pasta do plug-in extraída (e o conteúdo dela) ao seu projeto do Flutter. Em seguida, faça referência ao plug-in no seu 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 do AppLovin

Consentimento da UE e GDPR

De acordo com a Política de consentimento de usuários da União Europeia do Google, você precisa garantir que algumas divulgações sejam fornecidas aos usuários no Espaço Econômico Europeu (EEE) e que eles tenham o consentimento 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 o consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode coletar, receber ou usar dados pessoais, além de fornecer informações sobre o uso de cada rede. No momento, o Google não pode transmitir a opção de consentimento do usuário a essas redes automaticamente.

Se vocênão utiliza uma CMP que grava a string de consentimento nas preferências compartilhadas, use os métodos GmaMediationApplovin.setHasUserConsent(),GmaMediationApplovin.setIsAgeRestrictedUser() . O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK do AppLovin. Essas opções precisam ser definidas antes da inicialização do SDK dos anúncios para dispositivos móveis do Google para garantir que elas sejam encaminhadas corretamente para o SDK do AppLovin.

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

GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.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 escolham não autorizar a "venda" das próprias "informações pessoais" (conforme a definição desses termos) usando um link em destaque "Não vender minhas informações pessoais" na página inicial do "vendedor". O Guia de conformidade com as leis de privacidade dos estados dos EUA permite ativar o processamento 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, 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 o AppLovin inclui o método GmaMediationApplovin.setDoNotSell() . O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK do AppLovin. Essas opções precisam ser definidas antes da inicialização do SDK dos anúncios para dispositivos móveis do Google para garantir que elas sejam encaminhadas corretamente para o SDK do AppLovin.

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

GmaMediationApplovin.setDoNotSell(true);

Consulte a documentação de privacidade da AppLovin (em inglês) para mais informações.

Etapa 5: adicionar o código obrigatório

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

Parâmetros específicos de rede

O adaptador AppLovin é compatível com a transmissão de um objeto AppLovinMediationExtras à solicitação de anúncio para definir parâmetros específicos da rede. O exemplo de código a seguir mostra como desativar o áudio nos 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 oferece à AppLovin a capacidade de rastrear 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 abaixo:

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

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

Veja a seguir os códigos e as mensagens correspondentes gerados pelo adaptador AppLovin quando um anúncio não é carregado:

Registro de alterações do adaptador de mediação do Flutter para AppLovin

1.1.0

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

1.0.0

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