Integra el SDK de Verve HyBid con la Mediación de AdMob

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 de AdMob, 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 AdMob

Configura los parámetros de la mediación para tu unidad de anuncios

Debes agregar el SDK de Verve HyBid a la configuración de la mediación para tu unidad de anuncios.

En primer lugar, accede a tu cuenta de AdMob. A continuación, navega a la pestaña Mediación. Si tienes un grupo de mediación existente que deseas modificar, haz clic en su nombre para editarlo y pasa directamente a la sección Agrega el SDK de Verve HyBid como fuente de anuncios.

Para crear un grupo de mediación nuevo, selecciona Crear grupo de mediación.

Ingresa el formato de anuncios y la plataforma. Luego, haz clic en Continuar.

Asigna un nombre a tu grupo de mediación y selecciona las ubicaciones de segmentación. A continuación, establece el estado del grupo de mediación como Habilitado y haz clic en Agregar unidades de anuncios.

Asocia este grupo de mediación a una o más de tus unidades de anuncios de AdMob existentes. Luego, haz clic en Listo.

Ahora deberías ver la tarjeta de unidades de anuncios completada con las unidades de anuncios que seleccionaste:

Agrega el SDK de Verve HyBid como fuente de anuncios


En la tarjeta Licitación de la sección Fuentes de anuncios, selecciona Agregar fuente de anuncios. Luego, selecciona SDK de Verve HyBid.

Haz clic en Cómo firmar un acuerdo de asociación y configura una asociación de licitación con el SDK de Verve HyBid.



Haz clic en Reconocer y aceptar y, luego, en Continuar.



Si ya tienes una asignación para el SDK de Verve HyBid, puedes seleccionarla. De lo contrario, haz clic en Agregar asignación.



A continuación, ingresa el ID de zona y el AppToken que obtuviste en la sección anterior. Luego, haz clic en Listo.

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

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 última versión del SDK de Verve para iOS y vincula VerveSDK.framework en tu proyecto.

  • Descarga la última versión 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 en AdMob.

Verifica los anuncios de prueba

Para verificar que recibes anuncios de prueba del SDK de Verve HyBid, habilita la prueba de una única fuente de anuncios seleccionando las opciones de Verve (ofertas) en el inspector de anuncios.

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 devolvió 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 de anuncios 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 en la recopilación de señales y las fallas en la 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