Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google a fim de carregar e exibir anúncios da AppLovin usando mediação, cobrindo integrações de lances e hierarquia. Nele, explicamos como adicionar o AppLovin à configuração de mediação de um bloco de anúncios e como integrar o SDK do AppLovin e adaptador em um Flutter app.
Integrações e formatos de anúncio compatíveis
O AdMob adaptador de mediação para AppLovin tem a seguintes recursos:
Integração | |
---|---|
Lances | |
Cascata | |
Formatos | |
Banner | 1 |
Intersticial | |
Premiado |
Anúncios de banner (exceto MREC banners) são suportados somente na mediação. Os lances não são compatíveis com nenhum tipo de anúncios 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 Google SDK de anúncios para dispositivos móveis. Consulte Acesse Primeiros passos para ver mais detalhes.
- Concluir a mediação Guia explicativo
Etapa 1: definir as configurações na interface do AppLovin
Inscreva-se ou faça login à sua conta da AppLovin.
Para configurar seu bloco de anúncios da AdMob, você precisa do seu SDK Key e Report Key do AppLovin. Para encontrá-las, acesse IU AppLovin > Conta > Chaves para ver os dois valores.
Se você planeja apenas integrar os lances, prossiga para defina suas configurações de mediação.
Selecionar aplicativo 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 Monetização para acessar seus apps registrados. Selecione o app 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 Zones em Monetização. para chegar aos IDs de zona registrados. Se você já criou para as zonas obrigatórias do app, avance para a Etapa 2. Para criar um novo ID de zona, clique em Criar zona.
Digite o nome do ID da zona, selecione Android como a Plataforma. Escolha o Tipo de anúncio.
Configure Preços para a zona selecionando CPM fixo ou Otimizado pela 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 for criada, você encontrará o ID dela em ID da zona. .
Android
iOS
Ativar modo de teste
Siga as instruções Modo de teste MÁXIMO guia sobre como ativar os 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.
Adicionar a AppLovin Corp. ao GDPR e à lista de parceiros de publicidade das regulamentações estaduais dos EUA
Etapa 3: importar o SDK e o adaptador do AppLovin
Integração pelo pub.dev
Adicione a dependência a seguir com as versões mais recentes da
AppLovin O SDK e o adaptador na
Arquivo pubspec.yaml
:
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,
extrair o arquivo baixado e adicionar a pasta do plug-in extraído
(e o conteúdo dela) ao seu projeto Flutter. Em seguida, consulte o plug-in
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 o Consentimento dos usuários da UE do Google política, você precisa garantir que determinadas divulgações sejam fornecidas e consentimentos de usuários no Espaço Econômico Europeu (EEE) em relação a: o uso de identificadores de dispositivos e dados pessoais. Essa política reflete requisitos da Diretiva de privacidade eletrônica da UE e da Lei Geral de Proteção de Dados (GDPR). Ao solicitar consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que podem coletar, receber ou usar dados pessoais. que oferecem informações sobre o uso de cada rede. No momento, o Google não pode repassar a opção de consentimento do usuário a essas redes automaticamente.
Com o AppLovin, é possível ler a string de consentimento das configurações e preferências compartilhadas o status de consentimento.Se você for
Se você não usa uma CMP que grava a string de consentimento no arquivo
preferências, você pode usar
GmaMediationApplovin.setHasUserConsent()
e
GmaMediationApplovin.setIsAgeRestrictedUser()
métodos. O exemplo de código a seguir mostra como
para transmitir informações de consentimento ao 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 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
Estados Unidos leis estaduais de privacidade exigem que os usuários tenham para desativar a "promoção" das suas "informações pessoais" (como a lei define esses termos), com a opção de desativação oferecida por um aviso "Não vender meus dados pessoais" Informações" na página "vendas" da página inicial de seu grupo. A Estados Unidos define a privacidade guia de conformidade com as leis, permite ativar processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não consegue aplicar essa configuração a cada anúncio rede na sua cadeia de mediação. Portanto, você deve identificar cada rede de anúncios na sua cadeia de mediação que possam participar da venda de e seguir as orientações de cada uma dessas redes para garantir compliance.
Plug-in de mediação de anúncios para dispositivos móveis do Google para o AppLovin
inclui o
GmaMediationApplovin.setDoNotSell()
. O exemplo de código a seguir mostra como transmitir
informações de consentimento ao SDK do AppLovin. Essas opções precisam ser definidas
inicializar os anúncios para celular do Google
SDK
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 página de privacidade da AppLovin documentação para mais informações.
Etapa 5: adicionar o código obrigatório
Android
Nenhum código adicional é necessário para a integração com o AppLovin.
iOS
Integração com a SKAdNetwork
Siga a documentação da AppLovin. para adicionar os identificadores SKAdNetwork ao arquivo Info.plist do 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.
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
para o
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
Adicionando uma chamada a
GmaMediationApplovin.initializeSdk('sdkKey')
à atividade de inicialização oferece
A AppLovin pode acompanhar eventos assim que o app é iniciado.
Códigos de erro
Se o adaptador não receber um anúncio da AppLovin,
os editores podem verificar o erro subjacente a partir da resposta do anúncio usando
ResponseInfo
no
seguintes classes:
Android
com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter
iOS
GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin
Estes são os códigos e as mensagens correspondentes gerados pelo adaptador AppLovin quando ocorre uma falha no carregamento de um anúncio:
Android
Código do erro | Motivo |
---|---|
-1009 a -1, 204 | O SDK do AppLovin retornou um erro. Consulte Documentação da AppLovin (em inglês) para mais detalhes. |
101 | O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com a AppLovin. |
103 | O contexto é nulo. |
104 | O token de lance da AppLovin está vazio. |
105 | Vários anúncios solicitados para a mesma zona. A AppLovin só consegue carregar um anúncio por vez por zona. |
106 | O anúncio não está pronto para ser exibido. |
108 | O adaptador AppLovin 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 da AppLovin para mais detalhes. |
101 | O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com a AppLovin. |
102 | Os parâmetros do servidor AppLovin configurados na interface AdMob estão ausentes/inválidos. |
103 | Falha ao mostrar o anúncio da AppLovin. |
104 | Vários anúncios solicitados para a mesma zona. A AppLovin só consegue carregar um anúncio por vez por zona. |
105 | A chave do SDK do AppLovin não foi encontrada. |
107 | O token de lance está vazio. |
108 | O adaptador AppLovin 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 para AppLovin
1.2.0
- Compatibilidade verificada com o adaptador para Android AppLovin versão 12.6.1.0.
- Foi verificada a compatibilidade com o adaptador AppLovin para iOS versão 12.6.1.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.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.