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 Liftoff Monetize usando mediação, que abrange lances e integrações em hierarquia. Ele aborda como adicionar a Liftoff Monetize a um bloco de anúncios configuração de mediação e como integrar o SDK e o adaptador do Vungle a um Flutter .
Integrações e formatos de anúncio compatíveis
| Integração | |
|---|---|
| Lances | |
| Cascata | |
| Formatos | |
| Abertura do aplicativo | 1, 3 |
| Banner | 2 |
| Intersticial | |
| Premiado | |
| Intersticial premiado | 2 |
1 Lances para esse formato está na versão Beta fechada.
2 Lances para esse formato está na versão Beta aberta.
3 Cascata para esse formato está na versão Beta fechada.
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 SDK dos anúncios para dispositivos móveis do Google. Consulte Acesse Primeiros passos para ver mais detalhes.
- Concluir a mediação Guia explicativo
Etapa 1: definir as configurações na interface do Liftoff Monetize
Etapa 2: configurar a demanda da Liftoff Monetize 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 Liftoff à lista de parceiros de publicidade do GDPR e dos regulamentos estaduais dos EUA
Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar Liftoff à lista de parceiros de anúncios do GDPR e das regulamentações estaduais dos EUA na AdMob IU.
Etapa 3: importar o SDK do Vungle e o adaptador Liftoff Monetize
Integração pelo pub.dev
Adicione a dependência a seguir com as versões mais recentes da
Liftoff Monetize O SDK e o adaptador na
Arquivo pubspec.yaml:
dependencies:
gma_mediation_liftoffmonetize: ^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:
Liftoff Monetize,
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_liftoffmonetize:
path: path/to/local/package
Etapa 4: implementar configurações de privacidade no SDK Liftoff Monetize
Consentimento para a UE e o 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 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 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.
O plug-in de mediação de anúncios para dispositivos móveis do Google para Liftoff Monetize inclui os
GmaMediationLiftoffmonetize.setGDPRStatus(). O exemplo de código a seguir
mostra como transmitir informações de consentimento ao SDK do Vungle. Se você escolher
chamar esse método, é recomendável chamá-lo antes de solicitar anúncios por meio de
SDK dos anúncios para dispositivos móveis do Google.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");
Confira as instruções de implementação recomendadas do GDPR para Para mais detalhes, acesse Android e iOS. e os valores que podem ser fornecidos no método.
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. O 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ê precisa identificar cada rede de publicidade na sua 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 de anúncios para dispositivos móveis do Google para Liftoff Monetize inclui os
GmaMediationLiftoffmonetize.setCCPAStatus(). O exemplo de código abaixo
mostra como transmitir informações de consentimento para o SDK do Vungle. Se você optar por
chamar esse método, é recomendável que ele seja chamado antes de solicitar anúncios pelo
SDK dos anúncios para dispositivos móveis do Google.
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setCCPAStatus(true);
Confira as instruções de implementação recomendadas pela CCPA para Android e iOS para mais detalhes. os valores que podem ser fornecidos no método.
Etapa 5: adicionar o código obrigatório
Android
Nenhum código adicional é necessário para a integração da Liftoff Monetize.
iOS
Integração com a SKAdNetwork
Siga a Liftoff Monetize's
documentação
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 Liftoff Monetize interface.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do Liftoff Monetize, ative os testes de uma única origem no Ad Inspector usando as Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) origens de anúncios.
Códigos de erro
Se o adaptador não receber um anúncio da Liftoff Monetize, os editores poderão
verifique o erro subjacente na resposta do anúncio usando
ResponseInfo nas seguintes classes:
Android
| Formato | Nome da classe |
|---|---|
| Abertura do app (lances) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Abertura do app (Cascata) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Banner (lances) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Banner (Cascata) | com.vungle.mediation.VungleInterstitialAdapter |
| Intersticial (lances) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Intersticial (cascata) | com.vungle.mediation.VungleInterstitialAdapter |
| Premiado (lances) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Premiado (Cascata) | com.vungle.mediation.VungleAdapter |
| Intersticial premiado (lances) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Intersticial premiado (cascata) | com.google.ads.mediation.vungle.VungleMediationAdapter |
iOS
| Formato | Nome da classe |
|---|---|
| Abertura do app (lances) | GADMediationAdapterVungle |
| Abertura do app (Cascata) | GADMediationAdapterVungle |
| Banner (lances) | GADMediationAdapterVungle |
| Banner (Cascata) | GADMAdapterVungleInterstitial |
| Intersticial (lances) | GADMediationAdapterVungle |
| Intersticial (hierarquia) | GADMAdapterVungleInterstitial |
| Premiado (lances) | GADMediationAdapterVungle |
| Premiado (Cascata) | GADMAdapterVungleRewardBasedVideoAd |
| Intersticial premiado (lances) | GADMediationAdapterVungle |
| Intersticial premiado (cascata) | GADMediationAdapterVungle |
Aqui estão os códigos e as mensagens de acompanhamento gerados pela Liftoff Monetize quando um anúncio não for carregado:
Android
| Código do erro | Motivo |
|---|---|
| 101 | Parâmetros de servidor inválidos (por exemplo, ID do app ou da posição). |
| 102 | O tamanho do banner solicitado não está associado a um anúncio da Liftoff Monetize válido. tamanho. |
| 103 | A Liftoff Monetize precisa de um contexto Activity para fazer a solicitação.
anúncios. |
| 104 | O SDK do Vungle não pode carregar vários anúncios para a mesma posição. ID. |
| 105 | Falha ao inicializar o SDK do Vungle. |
| 106 | O SDK do Vungle retornou um callback de carregamento bem-sucedido, mas Banners.getBanner() ou Vungle.getNativeAd() retornaram nulo. |
| 107 | O SDK do Vungle não está pronto para reproduzir o anúncio. |
| 108 | O SDK do Vungle retornou um token de lances inválido. |
iOS
| Código do erro | Motivo |
|---|---|
| 101 | Parâmetros de servidor inválidos (por exemplo, ID do app ou da posição). |
| 102 | Um anúncio já foi carregado para esta configuração de rede. SDK do Vungle não é possível carregar um segundo anúncio para o mesmo ID de posição. |
| 103 | O tamanho do anúncio solicitado não corresponde a uma Liftoff Monetize compatível. tamanho do banner. |
| 104 | O SDK do Vungle não conseguiu renderizar o anúncio de banner. |
| 105 | O SDK do Vungle só permite carregar um anúncio de banner por vez, ID da posição. |
| 106 | O SDK Vungle enviou um callback informando que o anúncio não pode ser reproduzido. |
| 107 | O SDK do Vungle não está pronto para reproduzir o anúncio. |
Para erros provenientes do SDK do Vungle, consulte Códigos de erro: SDK do Vungle para iOS e Android (em inglês).
Registro de alterações do adaptador de mediação do Flutter para geração de receita da Liftoff
Versão 1.0.0
- Versão inicial.
- Compatibilidade verificada com o adaptador do Android Liftoff Monetize versão 7.3.1.0
- Compatibilidade verificada com a versão 7.3.2.0 do adaptador iOS do LiftoffMonetize.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 5.1.0.