Integrar a AppLovin à mediação

Neste guia, mostramos 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, abrangendo integrações de lances e 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 da AppLovin a um Flutter app.

Integrações e formatos de anúncio compatíveis

O AdMob adaptador de mediação para AppLovin tem os recursos abaixo:

Integração
Lances
Cascata
Formatos
Banner	^1
Intersticial
Premiado

¹ Os anúncios de banner (exceto banners MREC) são compatíveis apenas 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:
  • Meta de implantação do iOS 12.0 ou mais recente
• Um projeto Flutter em funcionamento 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: definir 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

Lances

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

Cascata

Na interface do AppLovin, selecione Aplicativos na seção Monetização para acessar seus apps registrados. Selecione o aplicativo que você quer usar com a mediação na lista de aplicativos disponíveis.

Criar uma zona

Lances

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

Cascata

Na interface do AppLovin, selecione Zonas na seção Monetização para acessar os IDs de zonas 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 Preços para a 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

Após a criação da zona, você encontra o ID dela na coluna ID da zona.

Android

iOS

Observação: é altamente recomendável criar uma zona AppLovin correspondente a cada AdMob bloco de anúncios para AdMob poder otimizar as origens de anúncios na mediação de maneira mais eficaz.

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

Android

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

iOS

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

Adiciona a AppLovin Corp. ao GDPR e à lista de parceiros de publicidade das regulamentações estaduais dos EUA

Importante: verifique se você tem permissão de gerenciamento de contas para concluir a configuração de consentimento da UE e GDPR, CPRA e 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 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

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

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 o GDPR

De acordo com a Política de consentimento de usuários da União Europeia do Google, você precisa garantir que determinadas divulgações sejam fornecidas aos usuários no Espaço Econômico Europeu (EEE) e recebam os consentimentos 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 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 uma delas. No momento, o Google não pode transmitir automaticamente a escolha de consentimento do usuário a essas redes.

a AppLovin aceita a leitura da string de consentimento das preferências compartilhadas e a configuração do status de consentimento.

Se você não usa uma CMP que grava a string de consentimento nas preferências compartilhadas, utilize os métodos GmaMediationApplovin.setHasUserConsent() e GmaMediationApplovin.setIsAgeRestrictedUser() . O exemplo de código abaixo mostra como transmitir informações de consentimento para o SDK do AppLovin. Essas opções precisam ser definidas antes de inicializar o SDK dos anúncios para dispositivos móveis do Google para garantir que elas sejam encaminhadas corretamente ao 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 tenham o direito de recusar a "venda" das próprias "informações pessoais" (conforme a definição desses termos) com um link "Não vender minhas informações pessoais" destacado na página inicial do vendedor. O guia de conformidade com as leis de privacidade dos EUA oferece a capacidade de ativar o processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não pode 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 AppLovin inclui o método GmaMediationApplovin.setDoNotSell() . O exemplo de código abaixo mostra como transmitir as informações de consentimento para o SDK do AppLovin. Defina essas opções antes de inicializar o 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 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 SKAdNetwork ao arquivo Info.plist` do seu projeto.

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.

Importante: desative o modo de teste para AdMob e 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 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 oferece suporte à 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 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 a GmaMediationApplovin.initializeSdk('sdkKey') à 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 do AppLovin, os editores poderão verificar o erro subjacente da resposta do anúncio usando ResponseInfo nas classes a seguir:

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 associadas gerados pelo adaptador da AppLovin quando um anúncio não é carregado:

Android

Código do erro	Motivo
-1009 a -1, 204	O SDK do 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.
103	O contexto é nulo.
104	O token de lance do AppLovin está vazio.
105	Foram solicitados vários anúncios para a mesma zona. A AppLovin só pode carregar um anúncio por vez e por zona.
106	O anúncio não está pronto para ser exibido.
108	O AppLovin Adapter não é compatível com o formato de anúncio solicitado.

iOS

Código do erro	Motivo
-1009 a -1, 204	O SDK do 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 do AppLovin configurados na AdMob interface estão ausentes/inválidos.
103	Falha ao exibir o anúncio da AppLovin.
104	Foram solicitados vários anúncios para a mesma zona. A AppLovin só pode carregar um anúncio por vez e por zona.
105	A chave do SDK do AppLovin não foi encontrada.
107	O token de lance está vazio.
108	O AppLovin Adapter 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.

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

1.1.0

• A API para o GmaMediationApplovin não é mais estática.
• Compatibilidade verificada com o adaptador para Android da AppLovin versão 12.4.3.0.
• Compatibilidade verificada com o adaptador para iOS da AppLovin 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 para Android da AppLovin versão 12.3.0.0
• Compatibilidade verificada com o adaptador para iOS da AppLovin 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.