Integrar a Liftoff Monetize com a mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar 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 app do Flutter.

Integrações e formatos de anúncio compatíveis

¹ A integração de lances para esse formato está na versão Beta aberta.

² 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 lances]: para integrar todos os formatos de anúncio com suporte nos lances, use o plug-in de mediação de anúncios para dispositivos móveis do Google para AppLovin 5.1.0 ou mais recente (recomenda-se a versão 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 do Flutter configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
• Concluir o Guia para iniciantes 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.

Depois que o app for criado, selecione-o no Painel de apps da Liftoff Monetize.

Anote o ID do app.

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:

Anote o ID de referência e clique em Tudo certo.

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

Etapa 2: configurar a demanda da Monetização Liftoff na interface da AdMob

Configurar as configurações de mediação do bloco de anúncios

Adicionar a Liftoff à lista de parceiros de publicidade do GDPR e das regulamentações 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 adaptador do Liftoff 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 dos anúncios para dispositivos móveis do Google para Liftoff Monetize, extraia o arquivo baixado 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 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 lei define esses termos), com a opção de recusa oferecida por um link "Não vender minhas informações pessoais" 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 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 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

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:

Confira os códigos e as mensagens exibidas pelo adaptador Liftoff Monetize quando um anúncio não é carregado:

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 o adaptador iOS LiftoffMonetize versão 7.3.2.0
• Criado e testado com a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.