Integrar o SDK HyBid da Verve com a mediação

Selecione a plataforma: Android iOS Android (legada)

Este guia mostra como usar Google Mobile Ads SDK (Legacy) para carregar e exibir anúncios do SDK do Verve HyBid usando Mediação da AdMob cobrindo integrações de lances. Ele explica como adicionar o SDK do Verve HyBid à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do Verve HyBid a um app Android.

Integrações e formatos de anúncio aceitos

O adaptador de mediação do SDK do 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á em versão Alfa. Entre em contato com seu gerente de contas para pedir acesso.

Pré-requisitos

Antes de continuar, verifique o seguinte:

  • API Android nível 24 ou mais recente.

Etapa 1: definir as configurações na interface do SDK do Verve HyBid

Para a configuração, entre em contato com a Verve.

Etapa 2: configurar a demanda do SDK do Verve HyBid 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.

Faça login na sua conta do 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 do Verve HyBid como uma origem de anúncios.

Para criar um novo 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 do Verve HyBid 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 AppToken vistos 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 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

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.5.0")
    implementation("com.google.ads.mediation:verve:3.9.3.0")
}

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

Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer determinadas declarações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de receber o consentimento deles para o uso de cookies ou outros armazenamentos locais quando exigido por lei e para a coleta, o compartilhamento e o uso de dados pessoais para a 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 do Verve HyBid lê automaticamente o consentimento do GDPR definido por plataformas de gestão de consentimento incluindo o SDK da UMP. Para mais informações, consulte Conformidade com o 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 na sua cadeia de mediação que possa participar da venda de informações pessoais e siga as orientações de cada uma dessas redes para garantir a conformidade.

O SDK do Verve HyBid 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 do Verve HyBid. Se você transmitir informações de consentimento para o SDK do Verve HyBid manualmente, recomendamos que chame o exemplo antes de solicitar anúncios pelo Google Mobile Ads SDK (Legacy).

Java

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING);

Kotlin

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING)

Substitua US_PRIVACY_STRING pela sua string de privacidade dos EUA.

Para mais detalhes, consulte a documentação de privacidade do SDK do Verve HyBid sobre a conformidade com a CCPA.

Etapa 5: adicionar o código necessário

Nenhum código extra é necessário para a integração do SDK do Verve HyBid.

Etapa 6: testar a implementação

Ativar anúncios de teste

Certifique-se de registrar seu dispositivo de teste na AdMob.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste do SDK do 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 do Verve HyBid para mais configurações.

Códigos do erro

Se o adaptador não receber um anúncio do SDK do Verve HyBid, 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 do Verve HyBid 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 aceito pelo SDK do Verve HyBid.
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á descartada.

Registro de alterações do adaptador de mediação da Verve para Android

Versão 3.9.3.0

  • Compatibilidade verificada com a versão 3.9.3 do SDK do Verve HyBid.

Criado e testado com:

  • Versão 25.5.0 do SDK do Google Mobile Ads.
  • Versão 1.5.0 do SDK Next-Gen do Google Mobile Ads.
  • Versão 3.9.3 do SDK do Verve HyBid.

Versão 3.9.2.0

  • Fixe a dependência do Kotlin do adaptador na versão 1.9.0 (a versão mínima do Kotlin aceita pelo SDK Next-Gen do GMA).
  • Compatibilidade verificada com a versão 3.9.2 do SDK do Verve HyBid.

Criado e testado com:

  • Versão 25.4.0 do SDK do Google Mobile Ads.
  • Versão 1.4.0 do SDK Next-Gen do Google Mobile Ads.
  • Versão 3.9.2 do SDK do Verve HyBid.

Versão 3.9.1.0

  • Compatibilidade verificada com a versão 3.9.1 do SDK do Verve HyBid.

Criado e testado com:

  • Versão 25.4.0 do SDK do Google Mobile Ads.
  • Versão 1.3.1 do SDK Next-Gen do Google Mobile Ads.
  • Versão 3.9.1 do SDK do Verve HyBid.

Versão 3.9.0.0

  • Filtre solicitações com restrição de idade para o SDK da Verve quando o novo AgeRestrictedTreatment estiver definido como CHILD.
  • Compatibilidade verificada com a versão 3.9.0 do SDK do Verve HyBid.

Criado e testado com:

  • Versão 25.4.0 do SDK do Google Mobile Ads.
  • Versão 1.2.1 do SDK Next-Gen do Google Mobile Ads.
  • Versão 3.9.0 do SDK do Verve HyBid.

Versão 3.8.2.0

  • Compatibilidade verificada com a versão 3.8.2 do SDK do Verve HyBid.

Criado e testado com:

  • Versão 25.3.0 do SDK do Google Mobile Ads.
  • Versão 1.2.1 do SDK Next-Gen do Google Mobile Ads.
  • Versão 3.8.2 do SDK do Verve HyBid.

Versão 3.8.1.1

  • Filtre visualizações clicáveis para diferenciar o clique de informações de conteúdo do clique no anúncio normal para VerveNativeAd.

Criado e testado com:

  • Versão 25.2.0 do SDK do Google Mobile Ads.
  • Versão 1.0.1 do SDK Next-Gen do Google Mobile Ads.
  • Versão 3.8.1 do SDK do Verve HyBid.

Versão 3.8.1.0

  • Adicionamos uma propriedade para criar o adaptador com a dependência do SDK Next-Gen do GMA.
  • Compatibilidade verificada com a versão 3.8.1 do SDK do Verve HyBid.

Criado e testado com:

  • Versão 25.1.0 do SDK do Google Mobile Ads.
  • Versão 3.8.1 do SDK do Verve HyBid.

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 do Google Mobile Ads.
  • Versão 3.7.1 do SDK do Verve HyBid.

Versão 3.7.1.0

  • Versão inicial.
  • Compatibilidade verificada com a versão 3.7.1 do SDK do Verve HyBid.

Criado e testado com:

  • Versão 24.8.0 do SDK do Google Mobile Ads.
  • Versão 3.7.1 do SDK do Verve HyBid.