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

Observação: recomendamos que você crie uma zona do AppLovin correspondente a cada bloco de anúncios da AdMob para que ela possa otimizar as origens de anúncios na mediação.

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 AdMob interface

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

Android

Para instruções, consulte a etapa 2 no guia para Android.

iOS

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

Importante: verifique se você tem a permissão Gerenciamento de conta para concluir a configuração do consentimento para usuários da UE e do GDPR, da CPRA e da plataforma de mensagens do usuário. Consulte Gerenciar o acesso do usuário à sua conta para mais detalhes.

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

Observação: a falha na integração das versões compatíveis do SDK dos anúncios para dispositivos móveis do Google e do AppLovin pode causar problemas de build.

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.

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

Importante: desative o modo de teste para a AdMob e a Applovin antes de lançar o app.

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 AppLovin retornou um erro. Consulte a documentação da 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 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 AppLovin configurados na interface AdMob 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.