Integrar a Liftoff Monetize com a Mediação da AdMob

Este guia mostra como usar o Google Mobile Ads SDK for React Native 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 React Native.

Integrações e formatos de anúncio aceitos

Integração
Lances
Cascata
Formatos
Abertura do aplicativo
Banner
Intersticial
Premiado
Intersticial premiado
Nativo

Pré-requisitos

Antes de continuar, verifique o seguinte:

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.

Android

iOS

Depois que o app for criado, selecione-o no painel de aplicativos da Liftoff Monetize.

Android

iOS

Anote o ID do app.

Android

iOS

Adicionar novas posições

Para criar um novo canal a ser usado com a Mediação da AdMob, 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:

Abertura do aplicativo

Selecione Intersticial e insira um Nome do canal. Em seguida, selecione Sim para Pular e preencha o restante do formulário. [Somente lances] Em Monetização, ative a opção Lances no app. Clique no botão Continuar na parte de baixo da página para criar o posicionamento.

Selecione Banner, insira um Nome do canal e preencha o restante do formulário. [Somente lances] Em Monetização, ative a opção Lances no app . Clique no botão Continuar na parte de baixo da página para criar o posicionamento.

Banner de 300 x 250

Selecione MREC, insira um Nome do canal e preencha o restante do formulário. [Somente lances] Em Monetização, ative a opção Lances no app . Clique no botão Continuar na parte de baixo da página para criar o posicionamento.

Intersticial

Selecione Intersticial, insira um Nome do canal e preencha o restante do formulário. [Somente lances] Em Monetização, ative a opção Lances no app. Clique no botão Continuar na parte de baixo da página para criar o posicionamento.

Premiado

Selecione Premiado, insira um Nome do canal e preencha o restante do formulário. [Somente lances] Em Monetização, ative a opção Lances no app . Clique no botão Continuar na parte de baixo da página para criar o posicionamento.

Intersticial premiado

Selecione Premiado. Insira um Nome do canal, ative a opção Pulável e preencha o restante do formulário. [Somente lances] Em Monetização, ative a opção Lances no app. Clique no botão Continuar na parte de baixo da página para criar o posicionamento.

Nativo

Selecione Nativo, insira um Nome do canal e preencha o restante do formulário. [Somente lances] Em Monetização, ative a opção Lances no app . Clique no botão Continuar na parte de baixo da página para criar o posicionamento.

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

Abertura do aplicativo

Banner de 300 x 250

Intersticial

Premiado

Intersticial premiado

Nativo

Localizar sua chave de API Reporting

Lances

Essa 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 de API Reporting da Liftoff Monetize para configurar o ID do bloco de anúncios da AdMob. Acesse o painel de relatórios da Liftoff Monetize e clique no botão chave de API de relatórios para conferir sua chave de API de relatórios.

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, configure um arquivo app-ads.txt para seu app.

Para implementar o app-ads.txt na 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.

Android

iOS

Etapa 2: configurar a demanda da Liftoff Monetize na interface da AdMob

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

Android

Para ver as instruções, consulte a etapa 2 no guia para Android.

iOS

Para instruções, consulte a etapa 2 no guia para iOS.

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 da AdMob.

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

No diretório raiz do projeto, instale o adaptador de mediação Google Mobile Ads SDK for React Native para a Liftoff Monetize. Preencha os campos:

  1. Copie o arquivo tar do adaptador Google Mobile Ads SDK for React Native do diretório gma-sdk-react-native/adapters/liftoff-monetize/ para o diretório local_packages/ do projeto. Se você não tiver a pasta adapters, consulte Pré-requisitos.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/liftoff-monetize/gma-mediation-liftoffmonetize-0.1.0.tgz local_packages/

    Substitua EXTRACT_DIR pelo caminho para o diretório em que você extraiu o arquivo.

  2. Instale o pacote do adaptador usando o gerenciador de pacotes de sua preferência:

    npm

    npm install ./local_packages/gma-mediation-liftoffmonetize-0.1.0.tgz

    novelo

    yarn add ./local_packages/gma-mediation-liftoffmonetize-0.1.0.tgz

Etapa 4: implementar configurações de privacidade no SDK da Liftoff Monetize

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 versão N/A e mais recentes do adaptador do React Native da Liftoff Monetize aceitam a transmissão de indicadores de consentimento do GDPR de plataformas de gestão de consentimento que se integram à Estrutura de Transparência e Consentimento (TCF) do IAB para o SDK da Liftoff Monetize. 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 exemplo de código a seguir demonstra como transmitir manualmente informações de consentimento para o adaptador da Liftoff Monetize:

import { LiftoffMonetizeMediation } from '@google/gma-mediation-liftoffmonetize';
// ...

LiftoffMonetizeMediation.setCCPAStatus({ optedIn: 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

Android

Não é necessário nenhum código adicional para a integração da Liftoff Monetize.

iOS

Integração da SKAdNetwork

Siga a documentação da Liftoff Monetize (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

Não se esqueça de registrar seu dispositivo de teste na AdMob 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:

Android

Formato Nome da classe
Abertura do app (lances) com.google.ads.mediation.vungle.VungleMediationAdapter
Abertura do app (hierarquia) com.google.ads.mediation.vungle.VungleMediationAdapter
Banner (lances) com.google.ads.mediation.vungle.VungleMediationAdapter
Banner (hierarquia) com.vungle.mediation.VungleInterstitialAdapter
Intersticial (lances) com.google.ads.mediation.vungle.VungleMediationAdapter
Intersticial (hierarquia) com.vungle.mediation.VungleInterstitialAdapter
Premiado (lances) com.google.ads.mediation.vungle.VungleMediationAdapter
Premiado (hierarquia) com.vungle.mediation.VungleAdapter
Intersticial premiado (lances) com.google.ads.mediation.vungle.VungleMediationAdapter
Intersticial premiado (hierarquia) com.google.ads.mediation.vungle.VungleMediationAdapter

iOS

Formato Nome da classe
Abertura do app (lances) GADMediationAdapterVungle
Abertura do app (hierarquia) GADMediationAdapterVungle
Banner (lances) GADMediationAdapterVungle
Banner (hierarquia) GADMAdapterVungleInterstitial
Intersticial (lances) GADMediationAdapterVungle
Intersticial (hierarquia) GADMAdapterVungleInterstitial
Premiado (lances) GADMediationAdapterVungle
Premiado (hierarquia) GADMAdapterVungleRewardBasedVideoAd
Intersticial premiado (lances) GADMediationAdapterVungle
Intersticial premiado (hierarquia) GADMediationAdapterVungle

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

Android

Código do erro Motivo
101 Parâmetros de servidor inválidos (por exemplo, ID do app ou do canal).
102 O tamanho de banner solicitado não corresponde a um tamanho de anúncio válido da Liftoff Monetize.
103 A Liftoff Monetize exige um contexto Activity para solicitar anúncios.
104 O SDK da Vungle não pode carregar vários anúncios para o mesmo ID de posição.
105 Falha ao inicializar o SDK da Vungle.
106 O SDK da Vungle retornou um callback de carregamento bem-sucedido, mas Banners.getBanner() ou Vungle.getNativeAd() retornou nulo.
107 O SDK da Vungle não está pronto para mostrar o anúncio.
108 O SDK da Vungle retornou um token de lance inválido.

iOS

Código do erro Motivo
101 Parâmetros de servidor inválidos (por exemplo, ID do app ou do canal).
102 Um anúncio já foi carregado para essa configuração de rede. O SDK da 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 da Vungle não conseguiu renderizar o anúncio de banner.
105 O SDK da Vungle só permite carregar um anúncio de banner por vez, independentemente do ID de posição.
106 O SDK da Vungle enviou um callback informando que o anúncio não pode ser reproduzido.
107 O SDK da Vungle não está pronto para mostrar o anúncio.

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

Versão 0.1.0

  • Versão inicial.