Integrar a AppLovin à mediação

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

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

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

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