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

Selecione a plataforma: Android iOS Android (legado)

Este guia mostra como usar GMA Next-Gen SDK para carregar e exibir anúncios do SDK do Verve HyBid usando a Mediação da AdMob incluindo 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úncios compatíveis

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á na versão Alfa. Entre em contato com seu gerente de contas para solicitar 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. Em seguida, acesse 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 do anúncio e a plataforma e 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.

Agora, o card de blocos de anúncios vai mostrar os blocos selecionados:

Adicionar o SDK do Verve HyBid como uma origem de anúncios


No card Lances da seção Origens de anúncios, 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 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

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.libraries.ads.mobile.sdk:ads-mobile-sdk:1.3.1")
    implementation("com.google.ads.mediation:verve:3.9.1.0")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

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 Google não consegue transmitir automaticamente a escolha de consentimento do usuário para essas redes.

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 GMA Next-Gen SDK.

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 de 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.getAdSourceResponses() 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 Motivo
100 a 103 O SDK do Verve HyBid retornou um erro.
101 O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível com o SDK do Verve HyBid.
102 Token do app ausente ou vazio.
103 O contexto é nulo.

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

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

Versão 3.8.1.0

  • Adicionamos a propriedade para criar o adaptador com a dependência do SDK do GMA Next-Gen.
  • 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.