Integrar a Liftoff Monetize com a mediação

Este guia mostra como usar o Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da Liftoff Monetize usando a mediação, incluindo integrações de lances e em hierarquia. Ele explica como adicionar a Liftoff Monetize à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da Liftoff Monetize a um app do Flutter.

Integrações e formatos de anúncio aceitos

Pré-requisitos

Antes de continuar, verifique o seguinte:

• Versão mais recente do Google Mobile Ads Flutter Plugin.
• Versão 3.7.0 ou mais recente do framework do Flutter.
• Para implantar no Android
  • API Android nível 24 ou mais recente.
• Para implantar no iOS
  • Destino de implantação do iOS 13.0 ou mais recente.
• Um projeto do Flutter em funcionamento configurado com Google Mobile Ads Flutter Plugin. Consulte Configurar o Google Mobile Ads Flutter Plugin para mais detalhes.

Etapa 1: definir as configurações na interface da Liftoff Monetize

Inscreva-se ou faça login na sua conta da Liftoff Monetize.

Adicione seu app ao painel da Liftoff Monetize 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 aplicativos da Liftoff Monetize.

Anote o ID do app.

Adicionar novas posições

Para criar um novo canal a ser usado com a mediação, acesse o painel de canais da Liftoff Monetize, clique no botão Add Placement e selecione seu app na lista suspensa.

Confira abaixo os detalhes para adicionar novas posições:

Anote o ID de referência e clique em Entendi.

Localizar sua chave de API Reporting

Atualizar o app-ads.txt

Vendedores autorizados do inventário de anúncios de apps (app-ads.txt) é uma iniciativa do IAB Tech Lab que ajuda a garantir que o inventário de anúncios do seu aplicativo seja vendido apenas por canais autorizados. Para evitar uma perda significativa na receita de publicidade, implemente um arquivo app-ads.txt. Se ainda não fez isso, crie um arquivo app-ads.txt para o Ad Manager.

Para implementar app-ads.txt para a Liftoff Monetize, faça o download e adicione as entradas app-ads.txt da Liftoff Monetize ao seu arquivo app-ads.txt. Para mais informações, consulte app-ads.txt.

Ativar o modo de teste

Para ativar os anúncios de teste, acesse o painel da Liftoff Monetize e navegue até Applications.

Selecione o app em que você quer ativar os anúncios de teste na seção ID de referência do canal. Para ativar os anúncios de teste, selecione Modo de teste para Mostrar somente anúncios de teste na seção Status.

Etapa 2: configurar a demanda da Liftoff Monetize na interface do Ad Manager

Definir 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 das regulamentações europeias e Configurações das regulamentações estaduais dos EUA para adicionar a Liftoff à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface do Ad Manager.

Etapa 3: importar o SDK e o adaptador da Liftoff Monetize

Integração pelo pub.dev

Adicione a seguinte dependência com as versões mais recentes do SDK e do adaptador da Liftoff Monetize no arquivo pubspec.yaml do seu pacote:

dependencies:
  gma_mediation_liftoffmonetize: ^1.5.5

Integração manual

Baixe a versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para a 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 configurações de privacidade no SDK da Liftoff Monetize

Consentimento para a UE e o GDPR

Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer certas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, e obter o consentimento deles para usar cookies ou outra forma de armazenamento local, quando exigido por lei, e para coletar, compartilhar e usar dados pessoais para personalização de anúncios. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Você é responsável por verificar se o consentimento é propagado para cada origem de anúncios na sua cadeia de mediação.

A partir da versão 1.1.0 do plug-in do Flutter da Liftoff Monetize, a Liftoff Monetize lê automaticamente o consentimento do GDPR definido por plataformas de gestão de consentimento que aceitam a especificação de consentimento adicional do Google, incluindo o SDK da UMP. Para mais informações, consulte as instruções de implementação recomendadas do GDPR para Android e iOS.

Leis Estaduais de Privacidade dos EUA

As leis de privacidade dos estados 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 na lei). Essa opção é disponibilizada por um link com a mensagem "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O guia de conformidade com as leis estaduais de privacidade dos EUA oferece a opção de ativar o tratamento 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, identifique cada rede de publicidade que possa participar da venda de informações pessoais e siga as orientações de cada uma delas 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 a seguir mostra como transmitir informações de consentimento para o SDK da Liftoff Monetize. Se você optar por chamar esse método, recomendamos fazer isso antes de solicitar anúncios pelo Google Mobile Ads Flutter Plugin.

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

Não se esqueça de registrar seu dispositivo de teste no Ad Manager e ativar 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 (lances) e Liftoff Monetize (hierarquia).

Códigos de erro

Se o adaptador não receber um anúncio da Liftoff Monetize, os publishers poderão verificar o erro na resposta do anúncio usando ResponseInfo nas seguintes classes:

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

Para erros do SDK da Vungle, consulte Códigos de erro: SDK da Vungle para iOS e Android.

Registro de alterações do adaptador de mediação da Liftoff Monetize para Flutter

Versão 1.5.6 (em andamento)

Versão 1.5.5

• Compatível com a versão 7.7.8.1 do adaptador da Liftoff Monetize para Android.
• Compatível com a versão 7.7.7.0 do adaptador do Liftoff Monetize para iOS.
• Criado e testado com a versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.5.4

• Compatível com a versão 7.7.8.0 do adaptador da Liftoff Monetize para Android.
• Compatível com a versão 7.7.7.0 do adaptador do Liftoff Monetize para iOS.
• Criado e testado com a versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.5.3

• Atualizamos o adaptador para oferecer suporte à versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.
• Adicionamos suporte ao Gerenciador de Pacotes do Swift.
• Compatível com a versão 7.7.7.0 do adaptador da Liftoff Monetize para Android.
• Compatível com a versão 7.7.6.0 do adaptador do Liftoff Monetize para iOS.
• Criado e testado com a versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.5.2

• Compatível com a versão 7.7.7.0 do adaptador da Liftoff Monetize para Android.
• Compatível com a versão 7.7.6.0 do adaptador do Liftoff Monetize para iOS.
• Criado e testado com a versão 9.0.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.5.1

• Atualizamos para oferecer suporte à versão 9.0.0 do plug-in do Google Mobile Ads para Flutter.
• Compatível com a versão 7.7.4.2 do adaptador da Liftoff Monetize para Android.
• Compatível com a versão 7.7.4.0 do adaptador do Liftoff Monetize para iOS.
• Criado e testado com a versão 9.0.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.5.0

• Atualizamos a versão mínima do Flutter para 3.38.1.
• Atualizamos para oferecer suporte à versão 8.0.0 do plug-in do Google Mobile Ads para Flutter.
• Compatível com a versão 7.7.2.0 do adaptador da Liftoff Monetize para Android.
• Compatível com a versão 7.7.1.0 do adaptador da Liftoff Monetize para iOS.
• Criado e testado com a versão 8.0.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.4.3

• Compatível com a versão 7.6.3.1 do adaptador da Liftoff Monetize para Android.
• Compatível com a versão 7.6.3.1 do adaptador da Liftoff Monetize para iOS.
• Criado e testado com a versão 7.0.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.4.2

• Atualizamos a versão mínima do Flutter para 3.35.1.
• Atualizado para oferecer suporte à versão 7.0.0 do plug-in do Google Mobile Ads para Flutter.

• Compatível com a versão 7.6.2.0 do adaptador da Liftoff Monetize para Android.
• Compatível com a versão 7.6.3.0 do adaptador do Liftoff Monetize para iOS.
• Criado e testado com a versão 7.0.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.4.1

• Compatível com a versão 7.6.1.0 do adaptador da Liftoff Monetize para Android.
• Compatível com a versão 7.6.2.0 do adaptador do Liftoff Monetize para iOS.
• Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.4.0

• Compatível com a versão 7.6.0.0 do adaptador da Liftoff Monetize para Android.
• Compatível com a versão 7.6.1.0 do adaptador do Liftoff Monetize para iOS.
• Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.3.0

• Compatível com a versão 7.5.1.1 do adaptador da Liftoff Monetize para Android.
• Compatível com a versão 7.6.0.0 do adaptador do Liftoff Monetize para iOS.
• Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.2.3

• Compatível com a versão 7.5.1.0 do adaptador da Liftoff Monetize para Android.
• Compatível com a versão 7.5.3.0 do adaptador do Liftoff Monetize para iOS.
• Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.2.2

• Compatível com a versão 7.5.0.1 do adaptador da Liftoff Monetize para Android.
• Compatível com a versão 7.5.2.0 do adaptador do Liftoff Monetize para iOS.
• Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.2.1

• Compatível com a versão 7.5.0.0 do adaptador da Liftoff Monetize para Android.
• Compatível com a versão 7.5.1.0 do adaptador da Liftoff Monetize para iOS.
• Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.2.0

• Compatível com a versão 7.5.0.0 do adaptador da Liftoff Monetize para Android.
• Compatível com a versão 7.5.0.0 do adaptador do Liftoff Monetize para iOS.
• Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.1.1

• Compatível com a versão 7.4.3.1 do adaptador do Liftoff Monetize para Android.
• Compatível com a versão 7.4.5.0 do adaptador do Liftoff Monetize para iOS.
• Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.1.0

• O plug-in do iOS agora é um framework estático.
• Compatível com a versão 7.4.3.0 do adaptador da Liftoff Monetize para Android.
• Compatível com a versão 7.4.4.0 do adaptador do Liftoff Monetize para iOS.
• Criado e testado com a versão 5.3.1 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

Versão 1.0.0

• Versão inicial.
• Compatível com a versão 7.3.1.0 do adaptador da Liftoff Monetize para Android.
• Compatível com a versão 7.3.2.0 do adaptador do iOS da Liftoff Monetize.
• Criado e testado com a versão 5.1.0 do plug-in do Google Mobile Ads para Flutter.