Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios da Liftoff Monetize usando mediação, cobrindo lances e integrações em cascata. 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, 2 |
Banner | 1 |
Intersticial | |
Premiado | |
Intersticial premiado | 1 |
1 A integração de lances para esse formato está na versão Beta aberta.
2 A integração de hierarquia para esse formato está na versão Beta aberta.
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 mais recente (recomenda-se a versão mais recente)
- Para implantar no Android
- API do Android de nível 21 ou mais recente
- Para implantar no iOS
- Destino de implantação do iOS 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: configurar a interface do Liftoff Monetize
Inscreva-se ou faça login na Liftoff Gerar receita com a conta.
Adicionar seu app ao painel de monetização da Liftoff clicando no botão Add Application.
Preencha o formulário com todos os detalhes necessários.
Android
iOS
Depois que seu aplicativo for criado, selecione-o no Painel de aplicativos da Liftoff Monetize Applications (em inglês).
Android
iOS
Anote o ID do app.
Android
iOS
Adicionar novos canais
Criar uma nova posição para usar com a AdMob de mediação, navegue até Painel de canais da Liftoff Monetize Clique no botão Add Placement e selecione seu app na lista suspensa. lista.
Confira abaixo os detalhes para adicionar novas posições:
Abertura do aplicativo
Selecione Intersticial e insira um nome de canal. Em seguida, selecione Sim para Pode ser ignorado e preencha o restante do formulário. [Somente lances] Abaixo de Monetização, mude a opção Lances no app para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.
Banner
Selecione Banner, insira um Nome da veiculação e preencha o restante forma [Somente lances] Em Monetização, ative a opção Lances no app. mude para Ativado. Clique no botão Continuar na parte de baixo do para criar o canal.
Banner de 300 x 250
Selecione MREC, insira um nome de veiculação e preencha o restante do forma [Somente lances] Em Monetização, ative a opção Lances no app. mude para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.
Intersticial
Selecione Intersticial, insira um nome de posicionamento e preencha o restante do formulário. [Somente lances] Em Monetização, alterne o Mude a opção Lances no app para Ativado. Clique no botão Continuar na parte inferior da página para criar a veiculação.
Premiado
Selecione Recompensado, insira um nome de posição e preencha o restante do formulário. [Somente lances] Em Monetização, ative a opção Lances no app. mude para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.
Intersticial premiado
Selecione Prêmio. Insira um nome de canal, ative a opção Skippável e preencha o restante do formulário. [Somente lances] Em Monetização, ative a opção. Mude o Lances no app para Ativado. Clique no botão Continuar na parte de baixo da página para criar a posição.
Nativo
Selecione Nativo, insira um nome de posição e preencha o restante do formulário. [Somente lances] Em Monetização, ative a opção Lances no app. mude para Ativado. Clique no botão Continuar na parte de baixo do para criar o canal.
Anote o ID de referência e clique em Parece bom.
Abertura do aplicativo
Banner
Banner de 300 x 250
Intersticial
Premiado
Intersticial premiado
Nativo
Localizar 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 do Liftoff Monetize para configurar o ID do bloco de anúncios da AdMob. Navegue até o painel de relatórios do Liftoff Monetize e clique no botão Chave da API Reporting para conferir sua Chave da API Reporting.
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 para o qual você quer ativar anúncios de teste na a seção ID de referência do canal do seu app. Os anúncios de teste podem ser ativados selecionando Modo de teste como Mostrar somente anúncios de teste na seção Status.
Android
iOS
Etapa 2: configurar a demanda de monetização do Liftoff na interface AdMob
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
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 Liftoff
Monetize no link de download no
Changelog e extraia o
GoogleMobileAdsVungleMediation.unitypackage
do arquivo zip.
No editor do projeto do Unity, selecione Assets > Import Package >
Custom Package e encontre o arquivo GoogleMobileAdsVungleMediation.unitypackage
que você transferiu por download. Verifique se todos os arquivos estão selecionados e clique em Import.
Em seguida, selecione Assets > Resolvedor do Play Services > Resolvedor do Android >
Force Resolve. A biblioteca Unity Play Services Resolver vai realizar
a resolução de dependências do zero e copiar as dependências declaradas para o
diretório Assets/Plugins/Android
do seu app Unity.
Etapa 4: implementar configurações de privacidade no SDK Liftoff Monetize
Consentimento da UE e GDPR
De acordo com a Política de consentimento para usuários da União Europeia do Google, é necessário garantir que algumas informações sejam fornecidas e que o consentimento seja obtido dos usuários no Espaço Econômico Europeu (EEE) sobre o uso de identificadores de dispositivo 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 dos anúncios para dispositivos móveis do Google para a monetização do Liftoff inclui métodos para transmitir informações de consentimento ao SDK da Vungle. O exemplo de código abaixo mostra como transmitir informações de consentimento para o 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
Consulte as instruções de implementação recomendadas do GDPR para Android e iOS para mais detalhes e os valores que podem ser fornecidos no método.
Leis Estaduais de Privacidade dos EUA
Leis estaduais de privacidade 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" mostrado em destaque na página inicial do terceiro. O guia de compliance com as leis de privacidade dos estados dos EUA oferece a capacidade de ativar o processamento de dados restrito para veiculação de anúncios do Google, mas o Google não pode aplicar essa configuração a cada rede de anúncios 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 dos anúncios para dispositivos móveis do Google para a monetização do Liftoff inclui métodos para transmitir informações de consentimento ao SDK da Vungle. O exemplo de código abaixo mostra como transmitir informações de consentimento para o SDK do Vungle. Se você optar por chamar esse método, recomendamos que o faça antes de solicitar anúncios pelo 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 necessá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:
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 (cascata) | com.vungle.mediation.VungleInterstitialAdapter |
Intersticial (lances) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Intersticial (cascata) | com.vungle.mediation.VungleInterstitialAdapter |
Premiada (lances) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Premiado (Cascata) | com.vungle.mediation.VungleAdapter |
Intersticial premiado (lances) | com.google.ads.mediation.vungle.VungleMediationAdapter |
Intersticial premiado (cascata) | com.google.ads.mediation.vungle.VungleMediationAdapter |
iOS
Formato | Nome da classe |
---|---|
Abertura do app (lances) | GADMediationAdapterVungle |
Abertura do app (Cascata) | GADMediationAdapterVungle |
Banner (lances) | GADMediationAdapterVungle |
Banner (cascata) | GADMAdapterVungleInterstitial |
Intersticial (lances) | GADMediationAdapterVungle |
Intersticial (cascata) | GADMAdapterVungleInterstitial |
Premiado (lances) | GADMediationAdapterVungle |
Premiado (cascata) | GADMAdapterVungleRewardBasedVideoAd |
Intersticial premiado (lances) | GADMediationAdapterVungle |
Intersticial premiado (cascata) | GADMediationAdapterVungle |
Aqui estão os códigos e as mensagens de acompanhamento gerados pela Liftoff Monetize quando um anúncio não for carregado:
Android
Código do erro | Motivo |
---|---|
101 | Parâmetros de servidor inválidos (por exemplo, ID do app ou da posição). |
102 | O tamanho do banner solicitado não está associado a um anúncio da Liftoff Monetize válido. tamanho. |
103 | A Liftoff Monetize exige um contexto Activity para solicitar
anúncios. |
104 | O SDK do Vungle não pode carregar vários anúncios para a mesma posição. ID. |
105 | Falha ao inicializar o SDK do Vungle. |
106 | O SDK do Vungle retornou um callback de carregamento bem-sucedido, mas Banners.getBanner() ou Vungle.getNativeAd() retornou nulo. |
107 | O SDK do Vungle não está pronto para exibir o anúncio. |
108 | O SDK 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 da posição). |
102 | Um anúncio já foi carregado para essa configuração de rede. SDK do Vungle não é possível 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 só permite carregar um anúncio de banner por vez, ID da posição. |
106 | O SDK do Vungle enviou um callback informando que o anúncio não pode ser reproduzido. |
107 | O SDK do Vungle não está pronto para reproduzir o anúncio. |
Para erros que vêm do SDK do Vungle, consulte Códigos de erro: SDK do Vungle para iOS e Android.
Registro de alterações do plug-in de mediação do Unity da Liftoff Monetize
Versão 5.2.1
DummyClient
foi renomeado comoPlaceholderClient
- Oferece suporte ao adaptador Liftoff Monetize do Android versão 7.4.0.1.
- Suporte à versão 7.4.0.1 do adaptador Liftoff Monetize para iOS.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.2.0.
Versão 5.2.0
- Suporte para a versão 7.4.0.0 do adaptador Liftoff Monetize para Android.
- Oferece suporte ao adaptador Liftoff Monetize do iOS versão 7.4.0.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.1.
Versão 5.1.1
- Oferece suporte ao adaptador Liftoff Monetize do Android versão 7.3.2.0.
- Suporte à versão 7.3.2.0 do adaptador Liftoff Monetize para iOS.
- Criado e testado com a versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
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()
eUpdateCCPAStatus()
foram removidos. - Os tipos enumerados
VungleConsentStatus
eVungleCCPAStatus
foram removidos. - O método
SetGDPRStatus(bool)
foi atualizado paraSetGDPRStatus(bool, String)
.
- Os métodos
- Os seguintes métodos foram removidos da classe
LiftoffMonetizeMediationExtras
:SetAllPlacements(String[])
SetSoundEnabled(bool)
- Suporte à versão 7.3.1.0 do adaptador Liftoff Monetize para Android.
- Suporte à versão 7.3.1.0 do Adaptador Liftoff Monetize para iOS.
- Criado e testado com a versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 5.0.0
- Correção de um aviso de definição duplicada para
MediationExtras
. - Oferece suporte ao adaptador Liftoff Monetize do Android versão 7.1.0.0.
- Suporte à versão 7.2.1.1 do adaptador do iOS do Liftoff Monetize.
- Criado e testado com a versão 8.7.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
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)
- Suporte à versão 6.12.1.1 do adaptador do Liftoff Monetize para Android.
- 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
- A classe
Vungle
foi atualizada:- O método
UpdateCCPAStatus(VungleCCPAStatus)
foi adicionado - O método
GetCurrentConsentStatus()
foi removido. - O método
GetCurrentConsentMessageVersion()
foi removido.
- O método
- Suporte à versão 6.12.1.0 do adaptador Vungle para Android.
- Suporte ao adaptador iOS do Vungle versão 6.12.2.0.
- Criado e testado com a versão 7.4.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.9.1
- Suporte à versão 6.12.1.0 do adaptador Vungle para Android.
- Suporte ao adaptador iOS Vungle versão 6.12.1.1.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.4.0.
Versão 3.9.0
- Suporte à versão 6.12.0.0 do adaptador Vungle Android.
- Suporte ao adaptador iOS do Vungle versão 6.12.0.0.
- Criado e testado com a versão 7.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.8.2
- Suporte à versão 6.11.0.2 do adaptador Vungle Android.
- Compatível com o adaptador para iOS da Vungle versão 6.11.0.1.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.1.0.
Versão 3.8.1
- Suporte à versão 6.11.0.1 do adaptador Vungle Android.
- Compatível com o adaptador para iOS da Vungle versão 6.11.0.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.0.2.
Versão 3.8.0
- Suporte à versão 6.11.0.0 do adaptador Vungle Android.
- Suporte ao adaptador iOS da Vungle versão 6.11.0.0.
- Criado e testado com a versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 3.7.5
- Suporte à versão 6.10.5.0 do adaptador Vungle para Android.
- Compatível com o adaptador para iOS da Vungle versão 6.10.6.1.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.0.0.
Versão 3.7.4
- Oferece suporte ao adaptador para Android da Vungle versão 6.10.4.0.
- Compatível com o adaptador para iOS da Vungle versão 6.10.6.1.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.0.0.
Versão 3.7.3
- Suporte à versão 6.10.3.0 do adaptador Vungle Android.
- Suporte à versão 6.10.5.1 do adaptador iOS do Vungle.
Versão 3.7.2
- Suporte à versão 6.10.2.1 do adaptador Vungle Android.
- Suporte à versão 6.10.5.1 do adaptador iOS do Vungle.
Versão 3.7.1
- Oferece suporte ao Adaptador para Android da Vungle versão 6.10.2.0.
- Compatível com o adaptador para iOS da Vungle versão 6.10.4.0.
Versão 3.7.0
- Oferece suporte ao Adaptador para Android da Vungle versão 6.10.2.0.
- Suporte ao adaptador iOS Vungle versão 6.10.3.0.
Versão 3.6.0
- Oferece suporte ao adaptador para Android da Vungle versão 6.9.1.1.
- Suporte à versão 6.9.2.0 do adaptador Vungle para iOS.
Versão 3.5.1
- Oferece suporte ao adaptador para Android da Vungle versão 6.8.1.0.
- Compatível com o adaptador para iOS da Vungle versão 6.8.1.0.
Versão 3.5.0
- Suporte à versão 6.8.0.0 do adaptador Vungle Android.
- Suporte ao adaptador para iOS da Vungle versão 6.8.0.0.
Versão 3.4.1
- Oferece suporte ao adaptador para Android da Vungle versão 6.7.1.0.
- Suporte à versão 6.7.1.0 do adaptador iOS do Vungle.
Versão 3.4.0
- Oferece suporte ao adaptador para Android da Vungle versão 6.7.0.0.
- Compatível com o adaptador para iOS da Vungle versão 6.7.0.0.
Versão 3.3.1
vungle-extras-library.jar
foi reempacotado emvungle-unity-android-library.aar
, usando um build.aar
para oferecer suporte ao Unity 2020- Ao fazer upgrade para esta versão, remova
vungle-extras-library.jar
do seu projeto.
- Ao fazer upgrade para esta versão, remova
- Oferece suporte ao adaptador para Android da Vungle versão 6.5.3.0.
- Suporte ao adaptador iOS da Vungle versão 6.5.3.0.
Versão 3.3.0
- Suporte à versão 6.5.3.0 do adaptador Android do Vungle.
- Suporte ao adaptador iOS da Vungle versão 6.5.3.0.
Versão 3.2.0
- Suporte à versão 6.4.11.1 do adaptador Vungle Android.
- Suporte para a versão 6.4.6.0 do adaptador iOS do Vungle.
Versão 3.1.4
- Suporte para a versão 6.3.24.1 do adaptador 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 suporte à nova API Premiada em versão Beta aberta.
- Suporte para a versão 6.3.24.1 do adaptador Android.
- Suporte à versão 6.3.2.1 do adaptador do iOS.
Versão 3.1.1
- Compatível com a versão 6.3.24.0 do adaptador Android.
- Oferece suporte à versão 6.3.2.0 do adaptador para iOS.
- O método
Vungle.UpdateConsentStatus()
foi atualizado para tornar o parâmetroconsentMessageVersion
opcional. O valor deconsentMessageVersion
agora é ignorado para iOS. - O uso de
Vungle.GetCurrentConsentMessageVersion()
para iOS foi descontinuado.
Versão 3.1.0
- Compatível com a versão 6.3.17.0 do adaptador Android.
- Suporte à versão 6.3.0.0 do adaptador iOS.
- O método
Vungle.UpdateConsentStatus()
foi atualizado para usar outro parâmetroString
na versão da mensagem de consentimento fornecida pelo editor. - O método
Vungle.GetCurrentConsentMessageVersion()
foi adicionado para receber a versão da mensagem de consentimento fornecida pelo editor.
Versão 3.0.1
- Compatível com a versão 6.2.5.1 do adaptador Android.
- Compatível com a versão 6.2.0.3 do adaptador para iOS.
Versão 3.0.0
- Suporte à versão 6.2.5.0 do adaptador Android.
- Oferece suporte à versão 6.2.0.2 do adaptador para iOS.
- Os seguintes métodos foram adicionados:
- Método
Vungle.UpdateConsentStatus()
para definir o status de consentimento que será registrado no SDK do Vungle. - método
Vungle.GetCurrentConsentStatus()
para receber o status de consentimento atual do usuário.
- Método
Versão 2.0.0
- Oferece suporte ao adaptador do Android versão 5.3.2.1.
- Compatível com a versão 6.2.0.0 do adaptador para iOS.
Versão 1.1.0
- Compatível com a versão 5.3.2.1 do adaptador Android.
- Suporte à versão 5.4.0.0 do adaptador para iOS.
Versão 1.0.0
- Primeira versão!
- Suporte à versão 5.3.0.0 do adaptador Android.
- Suporte à versão 5.3.0.0 do adaptador para iOS.