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.
• Flutter framework versão 3.7.0 ou mais recente.
• 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 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 Adicionar aplicativo.

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 que será usado com a mediação, navegue até o painel "Canais do Liftoff Monetize", clique no botão Adicionar canal 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 Tudo certo.

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 na Liftoff Monetize, faça o download e adicione as entradas app-ads.txt da Liftoff Monetize ao arquivo app-ads.txt atual. 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é Aplicativos.

Selecione o app em que você quer ativar os anúncios de teste na seção ID de referência de posição do app. Para ativar os anúncios de teste, selecione Modo de teste e 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 adaptador do Liftoff Monetize no arquivo pubspec.yaml do pacote:

dependencies:
  gma_mediation_liftoffmonetize: ^1.5.5

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 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 algumas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de pedir o consentimento deles para usar cookies ou outro 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 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 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 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 subjacente 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.5

• Compatível com a versão 7.7.8.1 do adaptador da Liftoff Monetize para Android.
• Compatibilidade com a versão 7.7.7.0 do adaptador do iOS do Liftoff Monetize.
• 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 Android da Liftoff Monetize.
• 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 para oferecer suporte à versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google 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 iOS da Liftoff Monetize.
• 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 Android da Liftoff Monetize.
• Compatível com a versão 7.7.4.0 do adaptador iOS da Liftoff Monetize.
• 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.
• Suporte à versão 7.7.2.0 do adaptador Android da Liftoff Monetize.
• Compatível com a versão 7.7.1.0 do adaptador do iOS do Liftoff Monetize.
• Criado e testado com a versão 8.0.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.4.3

• Suporte à versão 7.6.3.1 do adaptador do Android do Liftoff Monetize.
• 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

• Atualização da versão mínima do Flutter para 3.35.1
• Atualização para oferecer suporte à versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google 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 iOS da Liftoff Monetize.
• Criado e testado com a versão 7.0.0 do plug-in do Google Mobile Ads para Flutter.

Versão 1.4.1

• Suporte à versão 7.6.1.0 do adaptador do Android do Liftoff Monetize.
• 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.
• Compatibilidade com a versão 7.5.1.0 do adaptador do iOS do Liftoff Monetize.
• 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 iOS da Liftoff Monetize.
• 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 iOS da Liftoff Monetize.
• 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.
• Suporte à versão 7.4.3.0 do adaptador Android da Liftoff Monetize.
• Compatível com a versão 7.4.4.0 do adaptador da Liftoff Monetize para iOS.
• Criado e testado com a versão 5.3.1 do plug-in do Google Mobile Ads para Flutter.

Versão 1.0.0

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