Integra el SDK de Verve HyBid con la licitación

Selecciona la plataforma: Android iOS Android (heredada)

En esta guía, se muestra cómo usar Google Mobile Ads SDK para cargar y mostrar anuncios del SDK de Verve HyBid con la mediación, lo que incluye la integración de ofertas. Además, indica cómo agregar el SDK de Verve HyBid a la configuración de mediación de una unidad de anuncios y cómo integrar el SDK y el adaptador de Verve HyBid en una app para iOS.

Integraciones y formatos de anuncios admitidos

El adaptador de mediación de Verve HyBid SDK tiene las siguientes capacidades:

Integración
Ofertas  1
Cascada
Formatos
Banner
Intersticial
Intersticial recompensado
Recompensado
Nativo

1 La integración de ofertas está en versión alfa. Comunícate con tu administrador de cuentas para solicitar acceso.

Requisitos previos

Antes de continuar, verifica lo siguiente:

  • Objetivo de implementación de iOS 13.0 o posterior

Paso 1: Establece los parámetros de configuración en la IU del SDK de Verve HyBid

Para configurar los parámetros, comunícate con Verve.

Paso 2: Configura la demanda del SDK de Verve HyBid en la IU de Ad Manager

Accede a tu cuenta de Ad Manager.

Habilitar el uso compartido de indicadores seguros

Navega a Administrador > Configuración global. Ve a la pestaña Configuración de la cuenta de Ad Exchange , revisa la opción Uso compartido de indicadores seguros y actívala. Haz clic en Guardar.

Comparte indicadores seguros en las solicitudes de oferta

Navega a Inventario > Indicadores seguros. En Indicadores seguros, busca SDK de Verve HyBid y activa Habilitar integración para apps.

Haz clic en Guardar.

Permite el uso compartido de indicadores seguros para la Licitación mediante SDK

Navega a Publicación > Configuración del canal de demanda. En la pestaña Configuración predeterminada, activa Permitir el uso compartido de indicadores seguros para Licitación mediante SDK.

Haz clic en Guardar.

Configura la licitación del SDK de Verve HyBid

Navega a Publicación > Ofertantes y haz clic en Ir a la Licitación mediante SDK.

Haz clic en Nuevo ofertante.

Selecciona Verve Group como el ofertante.

Haz clic en Continuar para habilitar la Licitación mediante SDK para este ofertante.

Haz clic en Listo.

Configura la asignación de unidades de anuncios

Navega a Publicación > Ofertantes y haz clic en Ir a la Licitación mediante SDK.

Selecciona la empresa para el SDK de Verve HyBid.

Ve a la pestaña Asignación de unidades de anuncios y haz clic en Nueva asignación de unidad de anuncios.

Elige Unidad de anuncios específica. Selecciona una unidad de anuncios y un formato, Aplicación para dispositivos móviles como el Tipo de inventario y tu Aplicación para dispositivos móviles. Luego, ingresa el ID de zona y el AppToken que obtuviste en la sección anterior.

Si configuras la asignación de unidades de anuncios para un anuncio intersticial recompensado en la IU de Ad Manager, elige el formato Recompensado y usa el ID de posición intersticial recompensado.

Por último, haz clic en Guardar.

Agrega Verve Group a la lista de socios publicitarios que cumplen con el RGPD y las reglamentaciones estatales de EE.UU.

Sigue los pasos que se indican en Configuración conforme a los reglamentos europeos y Configuración de las reglamentaciones estatales de EE.UU. para agregar Verve Group a la lista de socios publicitarios que cumplen con los reglamentos europeos y las reglamentaciones estatales de EE.UU. en la IU de Ad Manager.

Paso 3: Importa el SDK y el adaptador de Verve HyBid

Usa Swift Package Manager

Antes de continuar, debes tener la versión mínima compatible del adaptador, que es la 3.8.0.0.

Para agregar una dependencia de paquete a tu proyecto, sigue estos pasos:

  1. En Xcode, navega a File > Add Package Dependencies….

  2. En el mensaje que aparece, busca la siguiente URL del paquete:

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

  3. En Dependency Rule, selecciona Branch.

  4. En el campo de texto, ingresa main.

Usar CocoaPods

  • Agrega la siguiente línea al archivo Podfile de tu proyecto:

    pod 'GoogleMobileAdsMediationVerve'

  • Desde la línea de comandos, ejecuta lo siguiente:

    pod install --repo-update

Integración manual

  • Descarga la versión más reciente del SDK de Verve para iOS y vincula VerveSDK.framework en tu proyecto.

  • Descarga la versión más reciente del adaptador de Verve desde el vínculo de descarga en el registro de cambios y vincula VerveAdapter.framework en tu proyecto.

  • Agrega los siguientes frameworks a tu proyecto:

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

Paso 4: Implementa la configuración de privacidad en el SDK de Verve

Para cumplir con la Política de Consentimiento de los Usuarios de la UE de Google, debes divulgar cierta información a tus usuarios del Espacio Económico Europeo (EEE), el Reino Unido y Suiza, y obtener su consentimiento para el uso de cookies o cualquier otro almacenamiento local cuando sea obligatorio por ley, y para la recopilación, el uso y el intercambio de datos personales para la personalización de anuncios. Esta política refleja los requisitos de la Directiva de Privacidad Electrónica y del Reglamento General de Protección de Datos (RGPD) de la UE. Tú eres responsable de verificar que el consentimiento se propague a cada fuente de anuncios de tu cadena de mediación. Google no puede pasar automáticamente a esas redes las selecciones de consentimiento de los usuarios.

El SDK de Verve HyBid lee automáticamente el consentimiento según el RGPD establecido por las plataformas de administración del consentimiento , incluido el SDK de UMP. Para obtener más información, consulta Cumplimiento del TCF del RGPD.

Leyes de privacidad estatales de EE.UU.

Las leyes de privacidad estatales de EE.UU. exigen otorgar a los usuarios el derecho a inhabilitar la "venta" de su "información personal" (según la definición de esos términos en la ley), con la opción de hacerlo a través de un vínculo destacado que indique que no desean que se venda su información personal en la página principal del "vendedor". La guía de cumplimiento de las leyes de privacidad estatales de EE.UU. ofrece la posibilidad de habilitar el tratamiento de datos restringido para la publicación de anuncios de Google, pero Google no puede aplicar este parámetro de configuración a cada red de publicidad de tu cadena de mediación. Por lo tanto, debes identificar cada red de publicidad en tu cadena de mediación que pueda participar en la venta de información personal y seguir las instrucciones de cada una de esas redes para garantizar el cumplimiento.

El SDK de Verve HyBid admite la configuración de privacidad a través de un método. El siguiente código de muestra pasa esta información de consentimiento al SDK de Verve HyBid. Si pasas la información de consentimiento al SDK de Verve HyBid de forma manual, te recomendamos que llames al ejemplo antes de solicitar anuncios a través de Google Mobile Ads SDK.

Swift

HyBidUserDataManager.sharedInstance().setIABUSPrivacyString(usPrivacyString)

Reemplaza usPrivacyString por tu cadena de privacidad de EE.UU.

Objective-C

[[HyBidUserDataManager sharedInstance] setIABUSPrivacyString:kUSPrivacyString];

Reemplaza kUSPrivacyString por tu cadena de privacidad de EE.UU.

Para obtener más información, consulta la documentación de privacidad del SDK de Verve HyBid sobre el cumplimiento de la CCPA.

Paso 5: Agrega el código requerido

Implementa SKAdNetwork

Sigue la documentación del SDK de Verve HyBid para agregar los identificadores de SKAdNetwork al archivo Info.plist de tu proyecto.

Paso 6: Prueba tu implementación

Habilita los anuncios de prueba

Asegúrate de registrar tu dispositivo de prueba para Ad Manager.

Verifica los anuncios de prueba

Para verificar que recibes anuncios de prueba del SDK de Verve HyBid, habilita la prueba de fuentes de anuncios individuales en el inspector de anuncios con las fuentes de anuncios de Verve (Licitación).

Consulta la documentación del SDK de Verve HyBid para obtener información sobre la configuración adicional.

Códigos de error

Si el adaptador no recibe un anuncio del SDK de Verve HyBid, los publicadores pueden verificar el error subyacente en la respuesta de solicitud de anuncio con GADResponseInfo.adNetworkInfoArray en las siguientes clases:

GADMAdapterVerve
GADMAdapterVerveRewardBasedVideoAd
GADMediationAdapterVerve

A continuación, se indican los códigos y los correspondientes mensajes que arroja el adaptador del SDK de Verve HyBid cuando se produce un error al cargar un anuncio:

Código de error Motivo
100 a 106 El SDK de Verve HyBid mostró un error.
101 Falta el token de la app.
102 El usuario es un niño.
103 No se pudo inicializar el SDK de Verve HyBid.
104 La configuración del anuncio no es válida.
105 El tamaño del banner no es compatible.
106 El anuncio de pantalla completa no está listo para mostrarse.
115 Falta el ID de la unidad de anuncios. No se puede cargar el anuncio.
116 El anuncio no está listo. No se puede mostrar el anuncio.

Registro de cambios del adaptador de mediación de Verve para iOS

Versión 3.9.0.0

  • Se actualizó la versión mínima del SDK de anuncios de Google para iOS a 13.3 para relajar y permitir versiones secundarias.
  • Se verificó la compatibilidad con la versión 3.9.0 del SDK de HyBid.

Se compiló y probó con lo siguiente:

  • Versión 13.6.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 3.9.0 del SDK de HyBid

Versión 3.8.1.1

  • Filtra las solicitudes restringidas por edad para el SDK de Verve cuando el nuevo ageRestrictedTreatment se establece en GADAgeRestrictedTreatmentChild.

Se compiló y probó con lo siguiente:

  • Versión 13.4.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 3.8.1 del SDK de HyBid

Versión 3.8.1.0

  • Se verificó la compatibilidad con la versión 3.8.1 del SDK de HyBid.

Se compiló y probó con lo siguiente:

  • Versión 13.4.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 3.8.1 del SDK de HyBid

Versión 3.8.0.0

  • Se quitó la verificación del tamaño del banner del adaptador para resolver las fallas de recopilación de indicadores y las fallas de carga de anuncios.
  • Se verificó la compatibilidad con la versión 3.8.0 del SDK de HyBid.

Se compiló y probó con lo siguiente:

  • Versión 13.2.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 3.8.0 del SDK de HyBid

Versión 3.7.1.3

  • Se actualizó la dependencia del SDK de anuncios de Google para dispositivos móviles a la versión 13.0.0.

Se compiló y probó con lo siguiente:

  • Versión 13.0.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 3.7.1 del SDK de HyBid

Versión 3.7.1.2

  • Se actualizó la versión mínima de iOS de CocoaPods a 13.0.

Se compiló y probó con lo siguiente:

  • Versión 13.0.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 3.7.1 del SDK de HyBid

Versión 3.7.1.1

  • Esta es la versión inicial.
  • Admite los formatos de anuncios de banner, intersticiales, recompensados, intersticiales recompensados y nativos.
  • Se verificó la compatibilidad con la versión 3.7.1 del SDK de HyBid.

Se compiló y probó con lo siguiente:

  • Versión 12.13.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 3.7.1 del SDK de HyBid