Neste guia, mostramos 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, que abrange integrações de lances e hierarquia. Ele aborda como adicionar o Liftoff Monetize à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do Vungle a um app Unity.
Integrações e formatos de anúncio compatíveis
Integração | |
---|---|
Lances | |
Cascata | |
Formatos | |
Banner | 1 |
Intersticial | |
Premiado | |
Intersticial premiado | 1, 2 |
1 A integração de lances com esse formato está na versão Beta aberta.
2 A configuração do intersticial premiado
precisa de ajuda. Entre em contato com seu gerente de contas
da Liftoff Monetize ou monetize@liftoff.io
.
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 a Liftoff Monetize 3.8.2 ou mais recente (última versão recomendada)
- Para implantar no Android
- Android API de nível 21 ou mais recente
- Para implantar no iOS:
- Meta de implantação do iOS 12.0 ou mais recente
- Um projeto Unity em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
- Concluir o Guia explicativo sobre mediação
Etapa 1: definir 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:
Banner
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.
Banner
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 de monetização da Liftoff 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 à lista de parceiros de publicidade do GDPR e 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 o Liftoff.
Gere receita no link de download no
Registro de mudanças e extraia o
GoogleMobileAdsVungleMediation.unitypackage
do arquivo ZIP.
No editor de projetos 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 > Play Services Resolver > Android Resolver >
Force Resolve. A biblioteca do resolvedor do Play Services do Unity vai realizar
a resolução de dependência do zero e copiar as dependências declaradas para o
diretório Assets/Plugins/Android
do seu app Unity.
Etapa 4: implementar as configurações de privacidade no SDK da Liftoff Monetize
Consentimento da UE e o GDPR
De acordo com a Política de consentimento de usuários da União Europeia do Google, você precisa garantir que determinadas divulgações sejam fornecidas aos usuários no Espaço Econômico Europeu (EEE) e recebam os consentimentos deles em relação ao uso de identificadores de dispositivos e dados pessoais. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Ao solicitar consentimento, você precisa identificar cada rede de publicidade na cadeia de mediação que pode coletar, receber ou usar dados pessoais e fornecer informações sobre o uso de cada uma delas. No momento, o Google não pode transmitir automaticamente a escolha de consentimento do usuário a essas redes.
O plug-in de mediação de anúncios para dispositivos móveis do Google para a versão 4.0.0 da Liftoff Monetize contém métodos para transmitir informações de consentimento ao SDK do Vungle.
Android
Há dois valores possíveis que você pode indicar ao atualizar o status de consentimento:
VungleConsentStatus.OPTED_IN
VungleConsentStatus.OPTED_OUT
O exemplo de código a seguir atualiza o status de consentimento para VungleConsentStatus.OPTED_IN
. Se você optar por chamar esse método, é recomendável fazer isso antes de solicitar anúncios usando o SDK dos anúncios para dispositivos móveis do Google.
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.UpdateConsentStatus(VungleConsentStatus.OPTED_IN, "1.0.0");
Consulte as instruções de implementação recomendadas do GDPR para mais detalhes e os valores que podem ser fornecidos no método.
iOS
O exemplo de código a seguir encaminha as informações de consentimento para o SDK do Vungle para iOS. Se você optar por chamar esse método, é recomendável fazer isso antes de solicitar anúncios usando o SDK dos anúncios para dispositivos móveis do Google.
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.SetGDPRStatus(true);
LiftoffMonetize.SetGDPRMessageVersion("1.0.0");
Consulte as instruções de implementação recomendadas do GDPR 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) com um link "Não vender minhas informações pessoais" destacado na página inicial do vendedor. O guia de conformidade com as leis de privacidade dos EUA oferece a capacidade de ativar o processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não pode aplicar essa configuração a cada rede de publicidade na sua cadeia de mediação. Portanto, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode participar da venda de informações pessoais e seguir as orientações de cada uma dessas redes para garantir a conformidade.
O plug-in de mediação de anúncios para dispositivos móveis do Google para a versão 4.0.0 da Liftoff Monetize contém métodos para transmitir informações de consentimento ao SDK do Vungle.
Android
Há dois valores possíveis que você pode indicar ao atualizar o status de consentimento:
VungleCCPAStatus.OPTED_IN
VungleCCPAStatus.OPTED_OUT
O exemplo de código a seguir atualiza o status de consentimento para VungleCCPAStatus.OPTED_IN
. Se você optar por chamar esse método, é recomendável fazer isso antes de solicitar anúncios usando o SDK dos anúncios para dispositivos móveis do Google.
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.UpdateCCPAStatus(VungleCCPAStatus.OPTED_IN);
Consulte as instruções de implementação recomendadas da CCPA para mais detalhes e os valores que podem ser fornecidos no método.
iOS
O exemplo de código a seguir encaminha as informações de consentimento para o SDK do Vungle para iOS. Se você optar por chamar esse método, é recomendável fazer isso antes de solicitar anúncios usando o SDK dos anúncios para dispositivos móveis do Google.
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.SetCCPAStatus(true);
Consulte as instruções de implementação recomendadas da CCPA para mais detalhes e os valores que podem ser fornecidos no método.
Etapa 5: adicionar o código necessário
Android
A integração com a Liftoff Monetize não é necessária.
iOS
Integração da SKAdNetwork
Siga a documentação da Liftoff Monetize (link 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
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
verificar o erro subjacente da resposta do anúncio usando
ResponseInfo
nas seguintes classes:
iOS
Formato | Nome da classe |
---|---|
Banner | GADMAdapterVungleInterstitial |
Intersticial | GADMAdapterVungleInterstitial |
Premiado | Anúncio em vídeo GADMAdapterVungle RewardsBasedVideo |
Confira os códigos e as mensagens que o acompanham geram pelo adaptador da Liftoff Monetize quando um anúncio não é carregado:
iOS
Código do erro | Motivo |
---|---|
1-100 | O SDK do Vungle retornou um erro. Confira o código para mais detalhes. |
101 | Os parâmetros do servidor da 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 de 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 o carregamento de 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. |
Registros de alterações do plug-in de mediação do Unity para gerar receita com Liftoff
Versão 5.1.0
- Correção de um
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)
- Compatível com o Adaptador para Android Liftoff Monetize versão 7.3.1.0.
- Compatível com o Adaptador para iOS do Liftoff Monetize 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
- Correção de um aviso de definição duplicada para
MediationExtras
- Compatível com o Adaptador para Android Liftoff Monetize versão 7.1.0.0.
- Compatível com o adaptador Leftoff Monetize para iOS versão 7.2.1.1.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.7.0.
Versão 4.0.0
- O plug-in de mediação do Unity foi renomeado, 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)
- Compatível com o Adaptador para Android Liftoff Monetize versão 6.12.1.1.
- Compatível com o adaptador Leftoff Monetize para 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 - Remoção do método
GetCurrentConsentStatus()
. - Remoção do método
GetCurrentConsentMessageVersion()
.
- O método
- Oferece suporte ao adaptador Vungle para Android versão 6.12.1.0.
- Compatível com o adaptador Vungle para iOS versão 6.12.2.0.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.4.1.
Versão 3.9.1
- Oferece suporte ao adaptador Vungle para Android versão 6.12.1.0.
- Compatível com o adaptador Vungle para iOS 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
- Oferece suporte ao adaptador Vungle para Android versão 6.12.0.0.
- Compatível com o adaptador Vungle para iOS versão 6.12.0.0.
- Criado e testado com o Plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.2.0.
Versão 3.8.2
- Oferece suporte ao adaptador Vungle para Android versão 6.11.0.2.
- Compatível com o adaptador Vungle para iOS 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
- Compatível com a versão 6.11.0.1 do adaptador Android Vungle.
- Compatível com o adaptador Vungle para iOS 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
- Oferece suporte ao adaptador Vungle para Android versão 6.11.0.0.
- Compatível com o adaptador Vungle para iOS 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.0.
Versão 3.7.5
- Oferece suporte ao adaptador Vungle para Android versão 6.10.5.0.
- Compatível com o adaptador Vungle para iOS 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 Vungle para Android versão 6.10.4.0.
- Compatível com o adaptador Vungle para iOS 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
- Oferece suporte ao adaptador Vungle para Android versão 6.10.3.0.
- Compatível com o adaptador Vungle para iOS versão 6.10.5.1.
Versão 3.7.2
- Oferece suporte ao adaptador Vungle para Android versão 6.10.2.1.
- Compatível com o adaptador Vungle para iOS versão 6.10.5.1.
Versão 3.7.1
- Oferece suporte ao adaptador Vungle para Android versão 6.10.2.0.
- Compatível com o adaptador Vungle para iOS versão 6.10.4.0.
Versão 3.7.0
- Oferece suporte ao adaptador Vungle para Android versão 6.10.2.0.
- Compatível com o adaptador Vungle para iOS versão 6.10.3.0.
Versão 3.6.0
- Oferece suporte ao adaptador Vungle para Android versão 6.9.1.1.
- Compatível com o adaptador Vungle para iOS versão 6.9.2.0.
Versão 3.5.1
- Oferece suporte ao adaptador Vungle para Android versão 6.8.1.0.
- Compatível com o adaptador Vungle para iOS versão 6.8.1.0.
Versão 3.5.0
- Oferece suporte ao adaptador Vungle para Android versão 6.8.0.0.
- Compatível com o adaptador Vungle para iOS versão 6.8.0.0.
Versão 3.4.1
- Oferece suporte ao adaptador Vungle para Android versão 6.7.1.0.
- Compatível com o adaptador Vungle para iOS versão 6.7.1.0.
Versão 3.4.0
- Oferece suporte ao adaptador Vungle para Android versão 6.7.0.0.
- Compatível com o adaptador Vungle para iOS versão 6.7.0.0.
Versão 3.3.1
- Reempacotamento de
vungle-extras-library.jar
paravungle-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 Vungle para Android versão 6.5.3.0.
- Compatível com o adaptador Vungle para iOS versão 6.5.3.0.
Versão 3.3.0
- Oferece suporte ao adaptador Vungle para Android versão 6.5.3.0.
- Compatível com o adaptador Vungle para iOS versão 6.5.3.0.
Versão 3.2.0
- Oferece suporte ao adaptador Vungle para Android versão 6.4.11.1.
- Compatível com o adaptador Vungle para iOS versão 6.4.6.0.
Versão 3.1.4
- Compatível com o adaptador do Android versão 6.3.24.1.
- Compatível com o adaptador para iOS versão 6.3.2.3.
Versão 3.1.3
- Compatível com o adaptador do Android versão 6.3.24.1.
- Compatível com o adaptador para iOS versão 6.3.2.2.
Versão 3.1.2
- Atualização do plug-in para oferecer suporte à nova API Premiada em versão Beta aberta.
- Compatível com o adaptador do Android versão 6.3.24.1.
- Compatível com o adaptador para iOS versão 6.3.2.1.
Versão 3.1.1
- Compatível com o adaptador do Android versão 6.3.24.0.
- Compatível com o adaptador para iOS versão 6.3.2.0.
- 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
- Oferece suporte ao adaptador para Android versão 6.3.17.0.
- Compatível com o adaptador para iOS versão 6.3.0.0.
- O método
Vungle.UpdateConsentStatus()
foi atualizado para usar um parâmetroString
adicional 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
- Oferece suporte ao adaptador para Android versão 6.2.5.1.
- Compatível com o adaptador para iOS versão 6.2.0.3.
Versão 3.0.0
- Oferece suporte ao adaptador para Android versão 6.2.5.0.
- Compatível com o adaptador para iOS versão 6.2.0.2.
- Os seguintes métodos foram adicionados:
Vungle.UpdateConsentStatus()
para definir o status de consentimento que será registrado no SDK do Vungle.Vungle.GetCurrentConsentStatus()
para saber o status de consentimento atual do usuário.
Versão 2.0.0
- Oferece suporte ao adaptador para 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 para Android versão 5.3.2.1.
- Compatível com o adaptador para iOS versão 5.4.0.0.
Versão 1.0.0
- Primeira versão!
- Compatível com o adaptador do Android versão 5.3.0.0.
- Compatível com o adaptador para iOS versão 5.3.0.0.