Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios da Liftoff Monetize usando mediação, cobrindo lances e integrações em cascata. Ele aborda como adicionar o Liftoff Monetize à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do Vungle a um appFlutter .
Integrações e formatos de anúncio compatíveis
| Integração | |
|---|---|
| Lances | |
| Cascata | |
| Formatos | |
| Abertura do aplicativo | 1, 2 |
| Banner | 1 |
| Intersticial | |
| Premiado | |
| Intersticial premiado | 1 |
| Nativo | 1, 2 |
1 A integração de lances para esse formato está na versão Beta aberta.
2 A integração de hierarquia para esse formato está na versão Beta aberta.
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 Liftoff Monetize
Crie ou faça login na sua conta da Liftoff Monetize.
Adicione seu app ao Painel de monetização do Liftoff clicando no botão Add Application.
Preencha o formulário com todos os detalhes necessários.
Android
iOS
Depois que o app for criado, selecione-o no Painel de apps da Liftoff Monetize.
Android
iOS
Anote o ID do app.
Android
iOS
Adicionar novos canais
Para criar um novo canal a ser usado com a mediação da AdMob, acesse o Painel "Monetize Placements" do Liftoff, clique no botão Add Placement e selecione seu app na lista desejada.
Confira abaixo os detalhes para adicionar novas posições:
Abertura do aplicativo
Selecione Intersticial e insira um nome de canal. Em seguida, selecione Sim para Pode ser ignorado e preencha o restante do formulário. [Somente lances] Em Monetização, ative a chave Lances no app para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.
Banner
Selecione Banner, insira um nome de posição e preencha o restante do formulário. [Somente lances] Em Monetização, ative a chave Lances no app para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.
Banner de 300 x 250
Selecione MREC, insira um nome de posição e preencha o restante do formulário. [Somente lances] Em Monetização, ative a chave Lances no app para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.
Intersticial
Selecione Intersticial, insira um nome de posicionamento e preencha o restante do formulário. [Somente lances] Em Monetização, ative a chave Lances no app para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.
Premiado
Selecione Recompensado, insira um nome de posição e preencha o restante do formulário. [Somente lances] Em Monetização, ative a chave Lances no app para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.
Intersticial premiado
Selecione Prêmio. Insira um nome de canal, ative a opção Skippável e preencha o restante do formulário. [Somente lances] Em Monetização, mude a chave Lances no app para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.
Nativo
Selecione Nativo, insira um Nome da posição e preencha o restante do formulário. [Somente lances] Em Monetização, ative a chave Lances no app para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.
Anote o ID de referência e clique em Tudo certo.
Abertura do aplicativo
Banner
Banner de 300 x 250
Intersticial
Premiado
Intersticial premiado
Nativo
Localizar sua chave da API Reporting
Lances
Esta etapa não é necessária para integrações de lances.
Cascata
Além do ID do app e do ID de referência, você também vai precisar da chave da API Reporting do Liftoff Monetize para configurar o ID do bloco de anúncios da AdMob. Navegue até o painel de relatórios do Liftoff Monetize e clique no botão Chave da API Reporting para conferir sua Chave da API Reporting.
Ativar o modo de teste
Para ativar os anúncios de teste, acesse o painel da Liftoff Monetize e navegue até Aplicativos.
Selecione o app para o qual você quer ativar os anúncios de teste na seção ID de referência do posicionamento. Para ativar os anúncios de teste, selecione Modo de teste para Mostrar apenas anúncios de teste na seção Status.
Android
iOS
Etapa 2: configurar a demanda de monetização do Liftoff na AdMob interface
Configurar as configurações de mediação para o bloco de anúncios
Android
Para 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 de regulamentos estaduais dos EUA para adicionar a Liftoff à lista de parceiros de publicidade do GDPR e dos regulamentos estaduais dos EUA na interface da AdMob.
Etapa 3: importar o SDK do Vungle e o adaptador Liftoff Monetize
Integração pelo pub.dev
Adicione a dependência abaixo com as versões mais recentes do
SDK e do adaptadorLiftoff Monetize no arquivo
pubspec.yaml do pacote:
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 de anúncios para dispositivos móveis do Google para
Liftoff Monetize,
extraia o arquivo transferido e adicione a pasta do plug-in extraído
(e o conteúdo dela) ao seu projeto do Flutter. Em seguida, faça referência ao plug-in no arquivo
pubspec.yaml adicionando a seguinte dependência:
dependencies:
gma_mediation_liftoffmonetize:
path: path/to/local/package
Etapa 4: implementar as configurações de privacidade no SDK da Liftoff Monetize
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 plug-in de mediação dos anúncios para dispositivos móveis do Google para a Liftoff Monetize inclui o
método GmaMediationLiftoffmonetize.setGDPRStatus(). 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.setGDPRStatus(true, "1.0.0");
Consulte as instruções de implementação recomendadas do GDPR para Android e iOS para mais detalhes e os valores que podem ser fornecidos no método.
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 a Liftoff Monetize inclui o
método 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);
Consulte as instruções de implementação recomendadas da CCPA para Android e iOS para mais detalhes e os valores que podem ser fornecidos no método.
Etapa 5: adicionar o código necessário
Android
Nenhum código adicional é necessário para a integração da monetização do Liftoff.
iOS
Integração da SKAdNetwork
Siga a documentação da Liftoff Monetize
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 Liftoff Monetize.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste da Liftoff Monetize, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Liftoff Monetize (Bidding) e Liftoff Monetize (Waterfall).
Códigos de erro
Se o adaptador não receber um anúncio do Liftoff Monetize, os editores poderão
verificar o erro subjacente da 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 (hierarquia) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Banner (lances) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Banner (em hierarquia) | com.vungle.mediation.VungleInterstitialAdapter |
| Intersticial (lances) | com.google.ads.mediation.vungle.VungleMediationAdapter |
| Intersticial (cascata) | com.vungle.mediation.VungleInterstitialAdapter |
| Premiada (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 (hierarquia) | GADMediationAdapterVungle |
| Banner (lances) | GADMediationAdapterVungle |
| Banner (em hierarquia) | GADMAdapterVungleInterstitial |
| Intersticial (lances) | GADMediationAdapterVungle |
| Intersticial (cascata) | GADMAdapterVungleInterstitial |
| Premiada (lances) | GADMediationAdapterVungle |
| Premiado (cascata) | GADMAdapterVungleRewardBasedVideoAd |
| Intersticial premiado (lances) | GADMediationAdapterVungle |
| Intersticial premiado (cascata) | GADMediationAdapterVungle |
Confira os códigos e as mensagens exibidas pelo adaptador Liftoff Monetize quando um anúncio não é carregado:
Android
| Código do erro | Motivo |
|---|---|
| 101 | Parâmetros do servidor inválidos (por exemplo, ID do app ou ID da posição). |
| 102 | O tamanho do banner solicitado não é mapeado para um tamanho de anúncio válido do Liftoff Monetize. |
| 103 | A Liftoff Monetize exige um contexto Activity para solicitar
anúncios. |
| 104 | O SDK do Vungle não pode carregar vários anúncios para o mesmo ID de canal. |
| 105 | O SDK do Vungle não foi inicializado. |
| 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 exibir o anúncio. |
| 108 | O SDK Vungle retornou um token de lance inválido. |
iOS
| Código do erro | Motivo |
|---|---|
| 101 | Parâmetros do servidor inválidos (por exemplo, ID do app ou ID da posição). |
| 102 | Um anúncio já foi carregado para essa configuração de rede. O SDK do Vungle não pode carregar um segundo anúncio para o mesmo ID de posição. |
| 103 | O tamanho do anúncio solicitado não corresponde a um tamanho de banner aceito pela Liftoff Monetize. |
| 104 | O SDK Vungle não conseguiu renderizar o anúncio de banner. |
| 105 | O SDK do Vungle só oferece suporte ao carregamento de um anúncio de banner por vez, independente do ID da veiculaçã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 exibir o anúncio. |
Para erros que vêm do SDK do Vungle, consulte Códigos de erro: SDK do Vungle para iOS e Android.
Registro de alterações do adaptador de mediação do Flutter do Liftoff Monetize
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.
Versão 1.1.0
- Compatibilidade verificada com a versão 7.4.0.1 do adaptador do Android do Liftoff Monetize
- Compatibilidade verificada com a versão 7.4.0.1 do adaptador iOS do LiftoffMonetize
- Criado e testado com a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
Versão 1.0.0
- Versão inicial.
- Compatibilidade verificada com a versão 7.3.1.0 do adaptador do Android para a monetização do Liftoff
- Compatibilidade verificada com a versão 7.3.2.0 do adaptador iOS do LiftoffMonetize.
- Criado e testado com a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.