Esta página foi traduzida pela API Cloud Translation.

Integrar a Liftoff Monetize com a mediação

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, que abrange integrações de lances e hierarquia. 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 Flutter app.

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

Integração
Lances
Cascata
Formatos
Abertura do aplicativo	^{1, 3}
Banner	²
Intersticial
Premiado
Intersticial premiado	²

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

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

³ A integração de hierarquia 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:
- Meta de implantação do iOS 12.0 ou mais recente
Um projeto Flutter em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
Concluir o Guia explicativo sobre mediação

Etapa 1: definir 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 AdMob, 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:

Abertura do aplicativo

Selecione Intersticial e insira um Nome de posição. Em seguida, selecione Sim para Pulável 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 veiculação.

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.

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.

Abertura do aplicativo

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 AdMob 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 de monetização da Liftoff 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 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 AdMob 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 as configurações de privacidade no SDK da Liftoff Monetize

Consentimento da 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 determinadas divulgações sejam fornecidas aos usuários no Espaço Econômico Europeu (EEE) e recebam os consentimentos 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 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 uma delas. No momento, o Google não pode transmitir automaticamente a escolha de consentimento do usuário a essas redes.

O plug-in de mediação de anúncios para dispositivos móveis do Google para a 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, é recomendável chamá-lo 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 se quiser 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 desses termos) com um link "Não vender minhas informações pessoais" destacado na página inicial do vendedor. O guia de conformidade com as leis de privacidade dos EUA oferece a capacidade de ativar o processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não pode 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 a 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, é recomendável chamá-lo 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 se quiser mais detalhes e os valores que podem ser fornecidos no método.

Etapa 5: adicionar o código necessário

Android

A integração com a Liftoff Monetize não é necessária.

iOS

Integração da SKAdNetwork

Siga a documentação da Liftoff Monetize (link em inglês) para adicionar os identificadores da 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 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 verificar o erro subjacente da resposta do anúncio usando ResponseInfo nas seguintes classes:

iOS

Formato	Nome da classe
Banner	GADMAdapterVungleInterstitial
Intersticial	GADMAdapterVungleInterstitial
Premiado	Anúncio em vídeo GADMAdapterVungle RewardsBasedVideo

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

iOS

Código do erro	Motivo
1-100	O SDK do Vungle retornou um erro. Confira o código para mais detalhes.
101	Os parâmetros do servidor da Liftoff Monetize configurados na interface AdMob 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 de 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 só permite o carregamento de 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 com geração de receita da Liftoff

Versão 1.0.0

Versão inicial.
Compatibilidade verificada com o adaptador para Android Liftoff Monetize versão 7.3.1.0
Compatibilidade verificada com o adaptador para iOS da 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.