Integrar a Liftoff Monetize com a mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google a fim de carregar e exibir anúncios da Liftoff Monetize usando mediação, abrangendo lances e integrações em hierarquia. Ele aborda como adicionar a Liftoff Monetize a um bloco de anúncios configuração de mediação e como integrar o SDK e o adaptador do Vungle a um Unity .

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

Integração
Lances
Cascata
Formatos
Abertura do aplicativo 1, 3
Banner 2
Intersticial
Premiado
Intersticial premiado 2

1 Lances para esse formato está na versão Beta fechada.

2 Lances para esse formato está na versão Beta aberta.

3 Cascata para esse formato está na versão Beta fechada.

Requisitos

  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Unity 4 ou mais recente
  • (Para lances): plug-in de mediação de anúncios para dispositivos móveis do Google para Liftoff Monetize 3.8.2 ou superior (recomendamos a versão mais recente)
  • Para implantar no Android
    • Android API de nível 21 ou mais recente
  • Para implantar no iOS
    • Destino de implantação do iOS de 12.0 ou mais recente
  • Um projeto Unity em funcionamento configurado com SDK dos anúncios para dispositivos móveis do Google. Consulte Acesse Primeiros passos para ver mais detalhes.
  • Concluir a mediação Guia explicativo

Etapa 1: definir as 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.

Banner de 300 x 250

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 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 da Liftoff Monetize 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 ao GDPR e à lista de parceiros de publicidade 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

Faça o download da versão mais recente do plug-in de mediação de anúncios para dispositivos móveis do Google para a Liftoff Gerar receita a partir do link de download na log de mudanças e extraia o GoogleMobileAdsVungleMediation.unitypackage do arquivo ZIP.

No editor de projetos do Unity, selecione Assets > Importar pacote > Pacote personalizado e localize o arquivo GoogleMobileAdsVungleMediation.unitypackage que você fez o download. Verifique se todos os arquivos estão selecionados e clique em Import.

Em seguida, selecione Recursos > Resolvedor do Play Services > Resolvedor do Android > Forçar resolução. A biblioteca Unity Play Services Resolver a resolução das dependências do zero e copiar as dependências declaradas no Assets/Plugins/Android do seu app Unity.

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

De acordo com o Consentimento dos usuários da UE do Google política, você precisa garantir que determinadas divulgações sejam fornecidas e consentimentos de usuários no Espaço Econômico Europeu (EEE) em relação a: o uso de identificadores de dispositivos e dados pessoais. Essa política reflete requisitos da Diretiva de privacidade eletrônica da UE e da Lei Geral de Proteção de Dados (GDPR). Ao solicitar consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que podem coletar, receber ou usar dados pessoais. que oferecem informações sobre o uso de cada rede. No momento, o Google não pode repassar a opção de consentimento do usuário a essas redes automaticamente.

O plug-in de mediação de anúncios para dispositivos móveis do Google para Liftoff Monetize inclui métodos para transmitir informações de consentimento ao SDK do Vungle. O exemplo de código a seguir mostra como para transmitir informações de consentimento ao SDK do Vungle. Se você optar por chamá-lo recomendamos que você faça isso antes de solicitar anúncios por meio do SDK dos anúncios para dispositivos móveis do Google.

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetGDPRStatus(true, "v1.0.0");
#if UNITY_IPHONE
LiftoffMonetize.SetGDPRMessageVersion("v1.0.0");
#endif

Confira as instruções de implementação recomendadas do GDPR para Para mais detalhes, acesse Android e iOS. e os valores que podem ser fornecidos no método.

Leis Estaduais de Privacidade dos EUA

Estados Unidos leis estaduais de privacidade exigem que os usuários tenham para desativar a "promoção" das suas "informações pessoais" (como a lei define esses termos), com a opção de desativação oferecida por um aviso "Não vender meus dados pessoais" Informações" na página "vendas" da página inicial de seu grupo. O Estados Unidos define a privacidade guia de conformidade com as leis, permite ativar processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não consegue aplicar essa configuração a cada anúncio rede na sua cadeia de mediação. Portanto, você deve identificar cada rede de anúncios na sua cadeia de mediação que possam participar da venda de e seguir as orientações de cada uma dessas redes para garantir compliance.

O plug-in de mediação de anúncios para dispositivos móveis do Google para Liftoff Monetize inclui métodos para transmitir informações de consentimento ao SDK do Vungle. O exemplo de código a seguir mostra como para transmitir informações de consentimento ao SDK do Vungle. Se você optar por chamá-lo recomendamos que você faça isso antes de solicitar anúncios por meio do SDK dos anúncios para dispositivos móveis do Google.

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetCCPAStatus(true);

Confira as instruções de implementação recomendadas pela CCPA para Android e iOS para mais detalhes. os valores que podem ser fornecidos no método.

Etapa 5: adicionar o código obrigatório

Android

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

iOS

Integração com a SKAdNetwork

Siga a Liftoff Monetize's documentação para adicionar os identificadores SKAdNetwork ao arquivo Info.plist do 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 verifique o erro subjacente na resposta do anúncio usando ResponseInfo nas seguintes classes:

iOS

Formato Nome da classe
Banner GADMAdapterVungleInterstitial
Intersticial GADMAdapterVungleInterstitial
Premiado GADMAdapterVungleRecompensa baseada em vídeo

Aqui estão os códigos e as mensagens de acompanhamento gerados pela Liftoff Monetize quando um anúncio não for carregado:

iOS

Código do erro Motivo
1-100 O SDK do Vungle retornou um erro. Veja o código para mais detalhes.
101 Os parâmetros do servidor 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 do 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 aceita o carregamento de apenas 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 plug-in de mediação do Unity da Liftoff Monetize

Versão 5.2.0

Versão 5.1.1

Versão 5.1.0

  • Correção de uma NullPointerException que causava uma falha de build ao exportar como um projeto Android.
  • Atualização das APIs de privacidade:
    • Os métodos UpdateConsentStatus() e UpdateCCPAStatus() foram removidos.
    • Os tipos enumerados VungleConsentStatus e VungleCCPAStatus foram removidos.
    • O método SetGDPRStatus(bool) foi atualizado para SetGDPRStatus(bool, String).
  • Os seguintes métodos foram removidos da classe LiftoffMonetizeMediationExtras:
    • SetAllPlacements(String[])
    • SetSoundEnabled(bool)
  • Oferece suporte ao adaptador Liftoff Monetize do Android versão 7.3.1.0.
  • Oferece suporte ao adaptador Liftoff Monetize do iOS versão 7.3.1.0.
  • Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.0.

Versão 5.0.0

Versão 4.0.0

  • Plug-in de mediação do Unity reformulado, de Vungle para Liftoff Monetize.
  • O conteúdo do adaptador foi movido para GoogleMobileAds/Mediation/LiftoffMonetize/.
  • O namespace do adaptador foi refatorado para usar GoogleMobileAds.Mediation.LiftoffMonetize.
  • Os seguintes métodos foram adicionados à classe LiftoffMonetize:
    • SetGDPRStatus(bool)
    • SetGDPRMessageVersion(String)
    • SetCCPAStatus(bool)
  • Oferece suporte ao adaptador Liftoff Monetize do Android versão 6.12.1.1.
  • Oferece suporte ao adaptador Liftoff Monetize do iOS versão 7.0.1.0.
  • Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.4.1.

Versão 3.9.2

Versão 3.9.1

Versão 3.9.0

Versão 3.8.2

Versão 3.8.1

Versão 3.8.0

Versão 3.7.5

Versão 3.7.4

Versão 3.7.3

Versão 3.7.2

Versão 3.7.1

Versão 3.7.0

Versão 3.6.0

Versão 3.5.1

Versão 3.5.0

Versão 3.4.1

Versão 3.4.0

Versão 3.3.1

Versão 3.3.0

Versão 3.2.0

Versão 3.1.4

  • Oferece suporte à versão 6.3.24.1 do adaptador do Android.
  • Compatível com a versão 6.3.2.3 do adaptador para iOS.

Versão 3.1.3

  • Oferece suporte à versão 6.3.24.1 do adaptador do Android.
  • Compatível com a versão 6.3.2.2 do adaptador para iOS.

Versão 3.1.2

  • O plug-in foi atualizado para oferecer compatibilidade com a nova API Premiada em versão Beta aberta.
  • Oferece suporte à versão 6.3.24.1 do adaptador do Android.
  • Oferece suporte à versão 6.3.2.1 do adaptador para iOS.

Versão 3.1.1

  • Oferece suporte à versão 6.3.24.0 do adaptador do Android.
  • Oferece suporte à versão 6.3.2.0 do adaptador para iOS.
  • O método Vungle.UpdateConsentStatus() foi atualizado para tornar o parâmetro consentMessageVersion opcional. O valor de consentMessageVersion agora é ignorado para iOS.
  • O uso de Vungle.GetCurrentConsentMessageVersion() para iOS foi descontinuado.

Versão 3.1.0

  • Oferece suporte ao adaptador do Android versão 6.3.17.0.
  • Oferece suporte à versão 6.3.0.0 do adaptador para iOS.
  • O método Vungle.UpdateConsentStatus() foi atualizado para usar outro parâmetro String na versão da mensagem de consentimento fornecida pelo editor.
  • O método Vungle.GetCurrentConsentMessageVersion() foi adicionado para acessar a versão da mensagem de consentimento fornecida pelo editor.

Versão 3.0.1

  • Oferece suporte à versão 6.2.5.1 do adaptador do Android.
  • Compatível com a versão 6.2.0.3 do adaptador para iOS.

Versão 3.0.0

  • Oferece suporte ao adaptador do Android versão 6.2.5.0.
  • Oferece suporte à versão 6.2.0.2 do adaptador para iOS.
  • Os seguintes métodos foram adicionados:
    • Vungle.UpdateConsentStatus() para definir o status de consentimento que será registrado no SDK do Vungle.
    • Método Vungle.GetCurrentConsentStatus() para saber o status de consentimento atual do usuário.

Versão 2.0.0

  • Oferece suporte ao adaptador do Android versão 5.3.2.1.
  • Compatível com o adaptador para iOS versão 6.2.0.0.

Versão 1.1.0

  • Oferece suporte ao adaptador do Android versão 5.3.2.1.
  • Oferece suporte à versão 5.4.0.0 do adaptador para iOS.

Versão 1.0.0

  • Primeira versão!
  • Oferece suporte ao adaptador do Android versão 5.3.0.0.
  • Oferece suporte ao adaptador para iOS versão 5.3.0.0.