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 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 Vungle a um app Flutter.

Integrações e formatos de anúncio aceitos

Requisitos

• SDK dos anúncios para dispositivos móveis do Google mais recente
• Flutter 3.7.0 ou versão mais recente
• [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o plug-in de mediação de anúncios para dispositivos móveis do Google para AppLovin 5.1.0 ou uma versão mais recente (recomendamos usar a última versão).
• Para implantar no Android:
  • API Android nível 23 ou mais recente.
• Para implantar no iOS:
  • Destino de implantação do iOS 12.0 ou mais recente.
• Um projeto do Flutter em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
• Leia todo o guia para iniciantes da mediação.

Etapa 1: definir as configurações na interface do 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 novos canais

Para criar um novo canal que será usado com a mediação do Ad Manager, acesse o painel "Canais de monetização da Liftoff", 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 da 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 o 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. 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 da Vungle 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: ^

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 Vungle

Consentimento da UE e GDPR

Para cumprir a Política de consentimento de usuários da UE do Google, você precisa fazer determinadas declarações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de receber o consentimento deles para o uso de cookies ou outros armazenamentos locais quando exigido por lei e para a coleta, o compartilhamento e o uso de 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. O Google não consegue transmitir automaticamente a escolha de consentimento do usuário para essas redes.

A partir da versão 1.1.0 do plug-in do Flutter do 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 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 Vungle. Se você optar por chamar esse método, recomendamos fazer isso 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

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 editores poderão verificar o erro subjacente na resposta do anúncio usando ResponseInfo nas seguintes classes:

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

Para erros que vêm 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 do Flutter da Liftoff Monetize

Versão 1.2.3

• Suporte à versão 7.5.1.0 do adaptador do Android do Liftoff Monetize.
• Compatível com a versão 7.5.3.0 do adaptador iOS da Liftoff Monetize.
• Criado e testado com a versão 6.0.0 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.

Versão 1.2.2

• Suporte à versão 7.5.0.1 do adaptador do Android do Liftoff Monetize.
• Compatível com a versão 7.5.2.0 do adaptador iOS da Liftoff Monetize.
• Criado e testado com a versão 6.0.0 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.

Versão 1.2.1

• Suporte à versão 7.5.0.0 do adaptador Android da Liftoff Monetize.
• Compatível 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 Flutter dos anúncios para dispositivos móveis do Google.

Versão 1.2.0

• Suporte à versão 7.5.0.0 do adaptador Android da Liftoff Monetize.
• 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 Flutter dos anúncios para dispositivos móveis do Google.

Versão 1.1.1

• Compatibilidade com a versão 7.4.3.1 do adaptador do Android do Liftoff Monetize.
• Compatível com a versão 7.4.5.0 do adaptador do iOS do Liftoff Monetize.
• Criado e testado com a versão 6.0.0 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.

Versão 1.1.0

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

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 Flutter dos anúncios para dispositivos móveis do Google.