Neste guia, mostramos como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios da Liftoff Monetize usando a mediação, abrangendo integrações de lances e hierarquia. Ele aborda como adicionar a 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
1 A integração de lances está na versão Beta aberta.
2 Os intersticiais
premiados precisam de assistência para serem configurados. Entre em contato com seu gerente de contas na Liftoff Monetize ou monetize@liftoff.io.
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 SDK dos anúncios para dispositivos móveis do Google. Consulte o artigo Começar para ver mais detalhes.
- Conclua a mediação Guia explicativo
Etapa 1: definir as configurações na interface do Liftoff Monetize
Inscreva-se ou faça login na sua conta da Liftoff Monet.
Adicione seu app ao painel da Liftoff Monetize clicando no botão Add Application (Adicionar aplicativo).
Preencha o formulário com todos os detalhes necessários.
Android
iOS
Depois que seu app for criado, selecione-o no painel Liftoff Monetize Applications (link em inglês).
Android
iOS
Anote o ID do app.
Android
iOS
Adicionar novos canais
Para criar uma nova posição a ser usada com a mediação Ad Manager, acesse o painel de posições "Liftoff Monetize respectivo", clique no botão Adicionar posição e selecione seu app na lista suspensa.
Confira abaixo os detalhes para adicionar novos canais:
Banner
Selecione Banner, insira um Nome de posição e preencha o restante do formulário. [Somente lances] Em Monetização, alterne a chave Lances no app para Ativado. Clique no botão Continuar na parte inferior da página para criar a posição.
Banner de 300 x 250
Selecione MREC, insira um nome da posição e preencha o restante do formulário. [Somente lances] Em Monetização, alterne a chave Lances no app para Ativado. Clique no botão Continuar na parte inferior da página para criar a posição.
Intersticial
Selecione Intersticial, insira um Nome de posição e preencha o restante do formulário. [Somente lances] Em Monetização, alterne a chave Lances no app para Ativado. Clique no botão Continuar na parte inferior da página para criar a posição.
Premiado
Selecione Premiado, insira um Nome da posição e preencha o restante do formulário. [Somente lances] Em Monetização, alterne a chave Lances no app para Ativado. Clique no botão Continuar na parte inferior da página para criar a posição.
Intersticial premiado
Selecione Premiado. Insira o Nome da posição, ative a opção Pulável e preencha o restante do formulário. [Somente lances] Em Monetização, mude a opção Lances no app para Ativado. Clique no botão Continuar na parte inferior da página para criar a colocação.
Nativo
Selecione Nativo, insira um nome de posição e preencha o restante do formulário. [Somente lances] Em Monetização, alterne a chave Lances no app para Ativado. Clique no botão Continuar na parte inferior da página para criar a posição.
Anote o ID de referência e clique em Tudo certo.
Banner
Banner de 300 x 250
Intersticial
Premiado
Intersticial premiado
Nativo
Localize 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 da Liftoff Monetize para configurar o Ad Manager ID do bloco de anúncios. Acesse o painel de relatórios do Liftoff Monetize e clique no botão Chave da API Reporting para visualizar a chave da API Reporting.
Ativar modo de teste
Para ativar anúncios de teste, acesse o painel da Liftoff Monetize e acesse Aplicativos.
Selecione o aplicativo para o qual você quer ativar os anúncios de teste na seção ID de referência da posição do seu aplicativo. Para ativar os anúncios de teste, selecione Modo de teste como Exibir somente anúncios de teste na seção Status.
Android
iOS
Etapa 2: configurar a demanda da Liftoff Monetize na Ad Manager 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 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 Liftoff à lista de parceiros de anúncios do GDPR e das regulamentações estaduais dos EUA na Ad Manager IU.
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
Liftoff Monetize SDK e do adaptador 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 dos anúncios para dispositivos móveis do Google para Liftoff Monetize, 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_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 a Política de consentimento de usuários da União Europeia do Google, você precisa garantir que algumas divulgações sejam fornecidas aos usuários no Espaço Econômico Europeu (EEE) e que eles tenham o consentimento 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 o consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode coletar, receber ou usar dados pessoais, além de fornecer informações sobre o uso de cada rede. No momento, o Google não pode transmitir 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 o método GmaMediationLiftoffmonetize.setGDPRStatus(). O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK do Vungle. Se você optar por chamar esse método, recomendamos fazer isso antes de solicitar anúncios por meio do 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
As Leis Estaduais de Privacidade dos EUA exigem que os usuários escolham não autorizar a "venda" das próprias "informações pessoais" (conforme a definição desses termos) usando um link em destaque "Não vender minhas informações pessoais" na página inicial do "vendedor". O Guia de conformidade com as leis de privacidade dos estados dos EUA permite ativar o processamento de dados restrito para a veiculação de anúncios do Google, mas não é possível 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 Liftoff Monetize inclui o método GmaMediationLiftoffmonetize.setCCPAStatus(). O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK do Vungle. Se você optar por chamar esse método, recomendamos fazer isso antes de solicitar anúncios por meio do 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 obrigatório
Android
Nenhum código adicional é necessário para a integração da Liftoff Monetize.
iOS
Integração com a SKAdNetwork
Siga a documentação da Liftoff Monetize (em inglês) 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 Ad Manager 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 vão poder
verificar o erro subjacente da resposta do anúncio usando
ResponseInfo nas classes abaixo:
iOS
| Formato | Nome da classe |
|---|---|
| Banner | GADMAdapterVungleInterstitial |
| Intersticial | GADMAdapterVungleInterstitial |
| Premiado | GADMAdapterVungleRecompensa baseada em vídeo |
Estes são os códigos e as mensagens associadas geradas pelo adaptador Liftoff Monetize quando um anúncio não é carregado:
iOS
| Código do erro | Motivo |
|---|---|
| 1-100 | O SDK do Vungle retornou um erro. Consulte o código para mais detalhes. |
| 101 | Os parâmetros do servidor Liftoff Monetize configurados na interface Ad Manager estão ausentes/inválidos. |
| 102 | Um anúncio já foi carregado para esta 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 compatível com a Liftoff Monetize. |
| 104 | O SDK do Vungle não conseguiu renderizar o anúncio de banner. |
| 105 | O SDK do Vungle aceita o carregamento de apenas um anúncio de banner por vez, independentemente do ID da posição. |
| 106 | O SDK do Vungle enviou um callback informando que o anúncio não pode ser reproduzido. |
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 o adaptador iOS LiftoffMonetize versão 7.3.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.