Integrar o SDK HyBid da Verve à Mediação da AdMob

Selecione a plataforma: Android iOS Android (legada)

Este guia mostra como usar Google Mobile Ads SDK 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 iOS.

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:

  • Destino de implantação do iOS 13.0 ou mais recente.

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

Usar o Swift Package Manager

Antes de continuar, você precisa ter a versão mínima compatível do adaptador 3.8.0.0.

Para adicionar uma dependência de pacote ao seu projeto, siga estas etapas:

  1. No Xcode, navegue até Arquivo > Adicionar dependências do pacote….

  2. No comando que aparece, pesquise o seguinte URL do pacote:

    https://github.com/googleads/googleads-mobile-ios-mediation-verve.git

  3. Em Regra de dependência, selecione Ramificação.

  4. No campo de texto, digite main.

Usar o CocoaPods

  • Adicione a seguinte linha ao Podfile do seu projeto:

    pod 'GoogleMobileAdsMediationVerve'

  • Na linha de comando, execute:

    pod install --repo-update

Integração manual

  • Faça o download da versão mais recente do SDK da Verve para iOS e vincule VerveSDK.framework no seu projeto.

  • Faça o download da versão mais recente do adaptador da Verve no link de download do Changelog e vincule VerveAdapter.framework no seu projeto.

  • Adicione os seguintes frameworks ao projeto:

    • AdSupport
    • AVFoundation
    • CoreGraphics
    • CoreMedia
    • CoreTelephony
    • StoreKit
    • SystemConfiguration
    • UIKit
    • WebKit
    • libz.tbd

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 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.

Swift

HyBidUserDataManager.sharedInstance().setIABUSPrivacyString(usPrivacyString)

Substitua usPrivacyString pela sua string de privacidade dos EUA.

Objective-C

[[HyBidUserDataManager sharedInstance] setIABUSPrivacyString:kUSPrivacyString];

Substitua kUSPrivacyString 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

Implementar a SKAdNetwork

Siga a documentação do SDK HyBid da Verve para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do projeto.

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 GADResponseInfo.adNetworkInfoArray nas seguintes classes:

GADMAdapterVerve
GADMAdapterVerveRewardBasedVideoAd
GADMediationAdapterVerve

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
100 a 106 O SDK HyBid da Verve retornou um erro.
101 com.google.mediation.verve A configuração do servidor não tem um token de app obrigatório.
102 O usuário é uma criança.
103 com.google.mediation.verve O SDK do Verve HyBid não é inicializado.
104 com.google.mediation.verve Configuração de anúncio inválida para carregar um anúncio.
105 com.google.mediation.verve Tamanho de banner incompatível.
106 com.google.mediation.verve O anúncio em tela cheia não está pronto para apresentação.
115 com.google.mediation.verve O ID do bloco de anúncios está ausente. Não é possível carregar o anúncio.

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

Versão 3.9.2.0

  • Compatibilidade verificada com a versão 3.9.2 do SDK da HyBid.

Criado e testado com:

  • Versão 13.9.0 do SDK do Google Mobile Ads.
  • Versão 3.9.2 do SDK do HyBid.

Versão 3.9.1.0

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

Criado e testado com:

  • Versão 13.8.0 do SDK do Google Mobile Ads.
  • Versão 3.9.1 do SDK da HyBid.

Versão 3.9.0.0

  • Atualizamos a versão mínima do SDK dos anúncios para dispositivos móveis do Google para iOS para 13.3, permitindo versões secundárias.
  • Compatibilidade verificada com a versão 3.9.0 do SDK da HyBid.

Criado e testado com:

  • Versão 13.6.0 do SDK do Google Mobile Ads.
  • Versão 3.9.0 do SDK da HyBid.

Versão 3.8.1.1

  • Filtra solicitações com restrição de idade para o SDK da Verve quando o novo ageRestrictedTreatment é definido como GADAgeRestrictedTreatmentChild.

Criado e testado com:

  • Versão 13.4.0 do SDK do Google Mobile Ads.
  • Versão 3.8.1 do SDK da HyBid.

Versão 3.8.1.0

  • Compatibilidade verificada com a versão 3.8.1 do SDK da HyBid.

Criado e testado com:

  • Versão 13.4.0 do SDK do Google Mobile Ads.
  • Versão 3.8.1 do SDK da HyBid.

Versão 3.8.0.0

  • Removemos a verificação do tamanho do banner do adaptador para resolver falhas na coleta de indicadores e no carregamento de anúncios.
  • Compatibilidade verificada com a versão 3.8.0 do SDK da HyBid.

Criado e testado com:

  • Versão 13.2.0 do SDK do Google Mobile Ads.
  • Versão 3.8.0 do SDK da HyBid.

Versão 3.7.1.3

  • Atualizamos a dependência do SDK do Google Mobile Ads para a versão 13.0.0.

Criado e testado com:

  • Versão 13.0.0 do SDK do Google Mobile Ads.
  • Versão 3.7.1 do SDK da HyBid.

Versão 3.7.1.2

  • Atualizamos a versão mínima do iOS do CocoaPods para 13.0.

Criado e testado com:

  • Versão 13.0.0 do SDK do Google Mobile Ads.
  • Versão 3.7.1 do SDK da HyBid.

Versão 3.7.1.1

  • Versão inicial!
  • Aceita formatos de anúncio de banner, intersticial, premiado, intersticial premiado e nativo.
  • Compatibilidade verificada com a versão 3.7.1 do SDK da HyBid.

Criado e testado com:

  • Versão 12.13.0 do SDK do Google Mobile Ads.
  • Versão 3.7.1 do SDK da HyBid.