Este guia mostra como usar Google Mobile Ads SDK (Legacy) para carregar e exibir anúncios do SDK Verve HyBid usando a Mediação da AdMob, que inclui integrações de lances. Ele explica como adicionar o SDK HyBid da Verve à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador HyBid da Verve a um app Android.
Integrações e formatos de anúncio aceitos
O adaptador de mediação do SDK Verve HyBid tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | 1 |
| Cascata | |
| Formatos | |
| Banner | |
| Intersticial | |
| Intersticial premiado | |
| Premiado | |
| Nativo | |
1 A integração de lances está na versão Alfa. Entre em contato com seu gerente de contas para solicitar acesso.
Pré-requisitos
Antes de continuar, verifique o seguinte:
- Nível da API Android 23 ou mais recente.
A versão mais recente do Google Mobile Ads SDK (Legacy).
Etapa 1: definir as configurações na interface do SDK HyBid da Verve
Para configurar, entre em contato com a Verve.
Etapa 2: configurar a demanda do SDK HyBid da Verve na interface da AdMob
Definir as configurações de mediação do bloco de anúncios
Adicione o SDK do Verve HyBid à configuração de mediação do seu bloco de anúncios.
Primeiro, faça login na sua conta da AdMob. Navegue até a guia Mediação. Se você tiver um grupo de mediação que quer modificar, clique no nome dele para editar e pule para Adicionar o SDK HyBid da Verve como uma origem de anúncios.
Para criar um grupo de mediação, selecione Criar grupo de mediação.
Insira o formato e a plataforma do anúncio, depois clique em Continuar.
Dê um nome ao grupo de mediação e selecione os locais de segmentação. Em seguida, defina o status do grupo de mediação como Ativado e clique em Adicionar blocos de anúncios.
Associe esse grupo de mediação a um ou mais dos seus blocos de anúncios da AdMob. Em seguida, clique em Concluído.
O card "Blocos de anúncios" vai aparecer com os blocos selecionados:
Adicionar o SDK HyBid da Verve como uma origem de anúncios
Na seção Origens de anúncios, encontre o card Lances e selecione Adicionar origem de anúncios. Em seguida, selecione SDK do Verve HyBid.
Clique em Como assinar um contrato de parceria e configure uma parceria de lances com o SDK do Verve HyBid.
Clique em Confirmar e concordar e em Continuar.
Se você já tiver um mapeamento para o SDK do Verve HyBid, selecione-o. Caso contrário, clique em Adicionar mapeamento.
Em seguida, insira o ID da zona e o AppToken obtidos na seção anterior. Em seguida, clique em Concluído.
Adicionar o Verve Group à 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 o Verve Group à 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 do Verve HyBid
Integração com o Android Studio (recomendada)
No arquivo settings.gradle.kts do projeto, adicione os seguintes repositórios:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://verve.jfrog.io/artifactory/verve-gradle-release")
}
}
}
Em seguida, no arquivo build.gradle.kts do app, adicione as seguintes dependências e configurações de implementação. Use as versões mais recentes do SDK e do adaptador do Verve HyBid:
dependencies {
implementation("com.google.android.gms:play-services-ads:25.4.0")
implementation("com.google.ads.mediation:verve:3.9.2.0")
}
Etapa 4: implementar configurações de privacidade no SDK da Verve
Consentimento da UE e GDPR
Para cumprir a Política de consentimento de usuários da UE do Google, você precisa fazer algumas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de obter o consentimento deles para o uso de cookies ou outro armazenamento local 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 SDK HyBid da Verve lê automaticamente o consentimento do GDPR definido por plataformas de gestão de consentimento, incluindo o SDK da UMP. Para mais informações, consulte Compliance com a TCF do GDPR.
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 SDK HyBid da Verve oferece suporte a configurações de privacidade por um método. O exemplo de código a seguir transmite essas informações de consentimento para o SDK HyBid da Verve. Se você transmitir informações de consentimento para o SDK Verve HyBid manualmente, recomendamos chamar o exemplo antes de solicitar anúncios usando Google Mobile Ads SDK (Legacy).
Java
Kotlin
Substitua US_PRIVACY_STRING pela sua string de privacidade dos EUA.
Para mais detalhes, consulte a documentação de privacidade do SDK HyBid da Verve em Conformidade com a CCPA.
Etapa 5: adicionar o código necessário
Nenhum código adicional é necessário para a integração do SDK HyBid da Verve.
Etapa 6: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste na AdMob.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do SDK Verve HyBid, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Verve (lances).
Siga a documentação do SDK HyBid da Verve para mais configurações.
Códigos de erro
Se o adaptador não receber um anúncio do SDK HyBid da Verve, os editores poderão
verificar o erro subjacente na resposta do anúncio usando
ResponseInfo.getAdapterResponses()
nas seguintes classes:
net.pubnative.lite.sdk
com.google.ads.mediation.verve
Confira os códigos e as mensagens geradas pelo adaptador do SDK HyBid da Verve quando um anúncio não é carregado:
| Código do erro | Domínio | Motivo |
|---|---|---|
| 101 | O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível com o SDK HyBid da Verve. | |
| 102 | net.pubnative.lite.sdk | Erro do Verve HyBid: não foi possível carregar o anúncio. |
| 103 | com.google.ads.mediation.verve | Tentativa de mostrar um anúncio em tela cheia nulo. |
| 104 | com.google.ads.mediation.verve | MobileAds.getRequestConfiguration() indica que o usuário é uma criança. A Verve será descontinuada. |
Registro de alterações do adaptador de mediação da Verve para Android
Versão 3.9.2.0
- Fixe a dependência Kotlin do adaptador em 1.9.0 (a versão mínima do Kotlin compatível com o SDK do GMA Next-Gen).
- Compatibilidade verificada com a versão 3.9.2 do SDK HyBid da Verve.
Criado e testado com:
- Versão 25.4.0 do SDK dos anúncios para dispositivos móveis do Google.
- Versão 1.4.0 do SDK Next-Gen do Google Mobile Ads.
- Versão 3.9.2 do SDK HyBid da Verve.
Versão 3.9.1.0
- Compatibilidade verificada com a versão 3.9.1 do SDK HyBid da Verve.
Criado e testado com:
- Versão 25.4.0 do SDK dos anúncios para dispositivos móveis do Google.
- Versão 1.3.1 do SDK Next-Gen do Google Mobile Ads.
- Versão 3.9.1 do SDK HyBid da Verve.
Versão 3.9.0.0
- Filtra solicitações com restrição de idade para o SDK da Verve quando o novo
AgeRestrictedTreatmenté definido comoCHILD. - Compatibilidade verificada com a versão 3.9.0 do SDK HyBid da Verve.
Criado e testado com:
- Versão 25.4.0 do SDK dos anúncios para dispositivos móveis do Google.
- Versão 1.2.1 do SDK Next-Gen do Google Mobile Ads.
- Versão 3.9.0 do SDK HyBid da Verve.
Versão 3.8.2.0
- Compatibilidade verificada com a versão 3.8.2 do SDK HyBid da Verve.
Criado e testado com:
- Versão 25.3.0 do SDK dos anúncios para dispositivos móveis do Google.
- Versão 1.2.1 do SDK Next-Gen do Google Mobile Ads.
- Versão 3.8.2 do SDK HyBid da Verve.
Versão 3.8.1.1
- Filtra visualizações clicáveis para diferenciar o clique nas informações de conteúdo do clique no anúncio normal para VerveNativeAd.
Criado e testado com:
- Versão 25.2.0 do SDK dos anúncios para dispositivos móveis do Google.
- Versão 1.0.1 do SDK Next-Gen do Google Mobile Ads.
- Versão 3.8.1 do SDK HyBid da Verve.
Versão 3.8.1.0
- Adicionada propriedade para criar o adaptador com dependência do SDK do GMA Next-Gen.
- Compatibilidade verificada com a versão 3.8.1 do SDK HyBid da Verve.
Criado e testado com:
- Versão 25.1.0 do SDK do Google Mobile Ads.
- Versão 3.8.1 do SDK HyBid da Verve.
Versão 3.7.1.1
- Removemos a verificação do tamanho do banner do adaptador da Verve para resolver falhas na coleta de indicadores.
Criado e testado com:
- Versão 25.0.0 do SDK dos anúncios para dispositivos móveis do Google.
- Versão 3.7.1 do SDK HyBid da Verve.
Versão 3.7.1.0
- Versão inicial.
- Compatibilidade verificada com a versão 3.7.1 do SDK HyBid da Verve.
Criado e testado com:
- Versão 24.8.0 do SDK do Google Mobile Ads.
- Versão 3.7.1 do SDK HyBid da Verve.