Integrar o SDK HyBid da Verve aos lances

Selecione a plataforma: Android iOS Android (legada)

Este guia mostra como usar Google Mobile Ads SDK para carregar e exibir anúncios do SDK do Verve HyBid usando mediação que abrange 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 iOS.

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á 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 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 do Ad Manager

Faça login na sua conta do Ad Manager.

Ativar o compartilhamento de indicador seguro

Acesse Administrador > Configurações globais. Acesse a guia Configurações da conta do Ad Exchange e ative a opção Compartilhamento de indicador seguro. Clique em Salvar.

Compartilhar indicadores seguros em solicitações de lance

Acesse Inventário > Indicadores seguros. Em Indicadores seguros, pesquise por SDK do Verve HyBid e ative a opção Ativar integração com o app.

Clique em Salvar.

Permitir o compartilhamento de indicadores seguros para Lances do SDK

Acesse Exibição > Configurações do canal de demanda. Na guia Configurações padrão, ative a opção Permitir o compartilhamento de indicadores seguros para Lances do SDK.

Clique em Salvar.

Configurar lances do SDK do Verve HyBid

Acesse Exibição > Bidders e clique em Acessar os Lances do SDK.

Clique em Novo bidder.

Selecione Verve Group como o bidder.

Clique em Continuar para ativar os Lances do SDK para esse bidder.

Clique em Concluído.

Configurar o mapeamento de blocos de anúncios

Acesse Exibição > Bidders e clique em Acessar os Lances do SDK.

Selecione a empresa para o SDK do Verve HyBid.

Acesse a guia Mapeamento de bloco de anúncios e clique em Novo mapeamento de bloco de anúncios.

Escolha Bloco de anúncios específico. Selecione um bloco e um formato de anúncios, App para dispositivos móveis como o Tipo de inventário e seu Aplicativo para dispositivos móveis. Em seguida, insira o ID da zona e o AppToken obtidos na seção anterior.

Se você estiver configurando o mapeamento de blocos de anúncios para um anúncio intersticial premiado na interface do Ad Manager, escolha o formato Premiado e use o ID de posição do intersticial premiado.

Por fim, clique em Salvar.

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 do Ad Manager.

Etapa 3: importar o SDK e o adaptador do Verve HyBid

Usar o Gerenciador de pacotes do Swift

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 de pacote….

  2. No prompt 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, insira 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 do Verve para iOS e vincule VerveSDK.framework ao seu projeto.

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

  • Adicione os seguintes frameworks ao seu 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 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 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 do Verve HyBid sobre a conformidade com a CCPA.

Etapa 5: adicionar o código necessário

Implementar o SKAdNetwork

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

Etapa 6: testar a implementação

Ativar anúncios de teste

Certifique-se de registrar seu dispositivo de teste para Ad Manager.

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 publishers 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 do Verve HyBid quando um anúncio não é carregado:

Código do erro Motivo
100 a 106 O SDK do Verve HyBid retornou um erro.
101 Token do app ausente.
102 Usuário é uma criança.
103 O SDK do Verve HyBid não foi inicializado.
104 Configuração de anúncio inválida.
105 Tamanho de banner sem suporte.
106 O anúncio em tela cheia não está pronto para apresentação.
115 O ID do bloco de anúncios está ausente. Não é possível carregar o anúncio.
116 O anúncio não está pronto. Não é possível exibir o anúncio.

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

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 para permitir versões secundárias.
  • Compatibilidade verificada com a versão 3.9.0 do SDK do HyBid.

Criado e testado com:

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

Versão 3.8.1.1

  • Filtramos 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 do HyBid.

Versão 3.8.1.0

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

Criado e testado com:

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

Criado e testado com:

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

Versão 3.7.1.1

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

Criado e testado com:

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