Integra Chartboost con Mediation

En esta guía, se muestra cómo usar el SDK de anuncios de Google para dispositivos móviles a fin de cargar y mostrar anuncios de Chartboost con la mediación, que abarca las integraciones en cascada. Se explica cómo agregar Chartboost a la configuración de mediación de una unidad de anuncios y cómo integrar el SDK y el adaptador de Chartboost en una app. iOS .

Integraciones y formatos de anuncios admitidos

El adaptador de mediación Ad Manager para Chartboost tiene las siguientes capacidades:

Integración
Ofertas
Cascada
Formatos
Banner
Intersticial
Recompensado
Nativo

Requisitos

  • Objetivo de implementación de iOS 12.0 o posterior
  • Versión más reciente del SDK de anuncios de Google para dispositivos móviles

  • Completa la guía de introducción de la mediación.

Paso 1: Establece parámetros de configuración en la IU de Chartboost

Regístrate para obtener una cuenta de Chartboost y accede a ella una vez que se verifique. A continuación, navega a la pestaña Administración de apps.

Panel de apps de Chartboost

Haz clic en el botón Add new app para crear tu app.

Administración de apps

Completa el resto del formulario y haz clic en el botón Add App para finalizar la app.

Nuevo formulario de aplicación

Una vez creada la app, se te dirigirá al panel. Anota el ID y la firma de tu app.

Configuración de aplicación

Ad Manager requiere el ID de usuario y la firma del usuario de Chartboost para configurar el Ad Manager ID de tu unidad de anuncios. Para encontrar estos parámetros, haz clic en Mediación de Chartboost en la IU de Chartboost.

Panel de mediación de Chartboost

Ve a la pestaña Recursos > Explorador de API y toma nota del ID de usuario y la Firma del usuario que se encuentran en la sección Autenticación.

Explorador de APIs de Chartboost

Activar el modo de prueba

Para habilitar el modo de prueba en tu app, navega a la pestaña Administración de apps desde la IU de Chartboost, selecciona tu app de la lista y haz clic en Editar configuración de la app.

Edita la configuración de la app

En la configuración de la app, puedes activar o desactivar el Modo de prueba.

Modo de prueba de Chartboost

Una vez que se habilita el modo de prueba, puedes solicitar anuncios con el ID de la unidad de anuncios creado antes y recibir un anuncio de prueba de Chartboost.

Una vez que puedas recibir anuncios de prueba de Chartboost, tu app se colocará en la Revisión de apps del publicador de Chartboost. Para que funcione la monetización en Chartboost, Chartboost debe aprobar la revisión de la app del publicador.

Paso 2: Configura la demanda de Chartboost en la Ad Manager IU

Cómo configurar la mediación para tu unidad de anuncios

Accede a tu cuenta de Ad Manager.

Navega a Publicación > Grupos de rendimiento y haz clic en el botón Nuevo grupo de rendimiento.

Ingresa un Nombre único para tu grupo de rendimiento, establece el Estado en Activo, selecciona el Formato del anuncio y establece el Tipo de inventario en Aplicación para dispositivos móviles. En la sección Segmentación > Inventario, selecciona la unidad de anuncios en Inventario y Aplicación para dispositivos móviles a la que deseas agregar la mediación.

Luego, haz clic en el botón Agregar socio de rendimiento.

Si ya tienes un socio de rendimiento paraChartboost, puedes seleccionarlo. De lo contrario, selecciona Crear un socio de rendimiento nuevo.

Selecciona Chartboost como la Red de publicidad, ingresa un Nombre único y habilita la Mediación.

Activa Recopilación de datos automática y, luego, ingresa el User ID and User Signature obtenido en la sección anterior.

Una vez que hayas seleccionado el Socio de rendimiento, elige Mediación del SDK para dispositivos móviles como el Tipo de integración, iOS como la Plataforma y Activo como el Estado. Ingresa elApp ID, App Signature and Ad Location obtenido en la sección anterior. Luego, ingresa un valor de CPM predeterminado.

Las ubicaciones de anuncios de Chartboost (ubicaciones con nombre) son nombres simples que representan un lugar de tu app en el que quieres mostrar un anuncio.Ad Manager envía solicitudes a la ubicación especificada en la configuración. Una vez que se envíen las solicitudes, Chartboost agregará la ubicación a su IU para generar informes.

En la IU de Chartboost, las ubicaciones de tus anuncios se pueden mostrar en la página Configuración básica si haces clic en Configuración avanzada. Consulta la guía Ubicaciones con nombre de Chartboost para obtener más detalles.

Haz clic en Guardar en la parte inferior de la página cuando termines.

Agregar Chartboost a la lista de socios publicitarios del GDPR y las reglamentaciones estatales de EE.UU.

Sigue los pasos que se indican en Configuración del GDPR y Configuración de las reglamentaciones estatales de EE.UU. para agregar Chartboost a la lista de socios publicitarios de las reglamentaciones estatales de EE.UU. y el GDPR en la Ad Manager IU.

Paso 3: Importa el SDK y el adaptador de Chartboost

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

    pod 'GoogleMobileAdsMediationChartboost'
    
  • 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 Chartboost y vincula Chartboost.framework y CHAMoatMobileAppKit.framework en tu proyecto.

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

  • Agrega los siguientes frameworks a tu proyecto:

    • StoreKit
    • Foundation
    • CoreGraphics
    • WebKit
    • AVFoundation
    • UIKit

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

Según la Política de Consentimiento de Usuarios de la UE de Google, debes asegurarte de que se proporcionen ciertas divulgaciones a los usuarios del Espacio Económico Europeo (EEE) y el consentimiento de estos respecto del uso de datos personales y identificadores de dispositivos. Esta política refleja los requisitos de la Directiva de Privacidad Electrónica y el Reglamento General de Protección de Datos (GDPR) de la UE. Cuando solicites el consentimiento, debes identificar cada red de publicidad en tu cadena de mediación que pueda recopilar, recibir o usar datos personales y proporcionar información sobre el uso de cada red. Por el momento, Google no puede pasar automáticamente la elección de consentimiento del usuario a esas redes.

En la versión 8.2.0 del SDK, Chartboost agregó el método addDataUseConsent. En los siguientes datos de conjuntos de códigos de muestra, se usa el consentimiento para CHBGDPRConsentNonBehavioral. Si decides llamar a este método, te recomendamos que lo hagas antes de solicitar anuncios a través del SDK de anuncios de Google para dispositivos móviles.

Swift

let dataUseConsent = CHBDataUseConsent.GDPR(CHBDataUseConsent.GDPR.Consent.nonBehavioral)
Chartboost.addDataUseConsent(dataUseConsent)

Objective‑C

CHBGDPRDataUseConsent *dataUseConsent = [CHBGDPRDataUseConsent gdprConsent:CHBGDPRConsentNonBehavioral];
[Chartboost addDataUseConsent:dataUseConsent];

Consulta el artículo del GDPR de Chartboost y su Métodos de privacidad de iOS para obtener más detalles y los valores que se pueden proporcionar en cada método.

Leyes de privacidad estatales de EE.UU.

Las leyes de privacidad estatales de EE.UU. exigen otorgar a los usuarios el derecho a rechazar la "venta" de su "información personal" (según la definición de esos términos en la ley), con un vínculo destacado "No vender mi 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 capacidad de habilitar el procesamiento de datos restringido para la publicación de anuncios de Google, pero Google no puede aplicar esta configuración a cada red de publicidad de la 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.

En la versión 8.2.0 del SDK, Chartboost agregó el método addDataUseConsent. En los siguientes datos de conjuntos de códigos de muestra, se usa el consentimiento para CHBCCPAConsentOptInSale. Si decides llamar a este método, te recomendamos que lo hagas antes de solicitar anuncios a través del SDK de anuncios de Google para dispositivos móviles.

Swift

let dataUseConsent = CHBDataUseConsent.CCPA(CHBDataUseConsent.CCPA.Consent.optInSale)
Chartboost.addDataUseConsent(dataUseConsent)

Objective‑C

CHBCCPADataUseConsent *dataUseConsent = [CHBCCPADataUseConsent ccpaConsent:CHBCCPAConsentOptInSale];
[Chartboost addDataUseConsent:dataUseConsent];

Consulta el artículo de la CCPA de Chartboost y su Métodos de privacidad de iOS para obtener más detalles y los valores que se pueden proporcionar en cada método.

Códigos de error

Si el adaptador no recibe un anuncio de Chartboost, puedes verificar el error subyacente de la respuesta del anuncio con GADResponseInfo.adNetworkInfoArray en las siguientes clases:

GADMAdapterChartboost
GADMediationAdapterChartboost

Estos son los códigos y los mensajes correspondientes que arroja el adaptador de Chartboost cuando un anuncio no se carga:

Código de error Motivo
0-99 El SDK de Chartboost mostró un error. Consulta la documentación de Chartboost para obtener más detalles.
101 El tamaño de anuncio solicitado no coincide con un tamaño de banner compatible con Chartboost.
102 Chartboost solo puede cargar 1 anuncio por ubicación a la vez.
103 Faltan los parámetros del servidor de Chartboost configurados en la Ad Manager IU o no son válidos.
104 El anuncio intersticial o recompensado de Chartboost no está listo para mostrarse.
101 Faltan los parámetros del servidor de Chartboost configurados en la Ad Manager IU o no son válidos.
102 El SDK de Chartboost mostró un error de inicialización.
103 El anuncio de Chartboost no se almacena en caché en el momento de la visualización.
104 El tamaño de anuncio solicitado no coincide con un tamaño de banner compatible con Chartboost.
105 La versión del SO del dispositivo es inferior a la versión mínima del SO compatible del SDK de Chartboost.
200-299 Errores de caché del SDK de Chartboost. Consulta el código para obtener más detalles.
300-399 El SDK de Chartboost muestra errores. Consulta el código para obtener más detalles.
400-499 Errores de clic en el SDK de Chartboost. Consulta el código para obtener más detalles.

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

Versión 9.6.0.1

  • Ahora requiere, como mínimo, la versión 12.0 de iOS.
  • Ahora se requiere la versión 11.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
  • Se incluyó Info.plist en los frameworks, dentro de ChartboostAdapter.xcframework.

Compilado y probado con lo siguiente:

  • Versión 11.0.1 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 9.6.0 del SDK de Chartboost.

Versión 9.6.0.0

  • Se verificó la compatibilidad con la versión 9.6.0 del SDK de Chartboost.
  • Se reemplazó el método obsoleto GADMobileAds.sharedInstance.sdkVersion por GADMobileAds.sharedInstance.versionNumber.
  • Se agregó la implementación de GADMediationInterstitialAd.

Compilado y probado con lo siguiente:

  • Versión 10.14.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 9.6.0 del SDK de Chartboost.

Versión 9.5.1.0

  • Se verificó la compatibilidad con la versión 9.5.1 del SDK de Chartboost.

Compilado y probado con lo siguiente:

  • Versión 10.12.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 9.5.1 del SDK de Chartboost.

Versión 9.4.0.0

  • Se verificó la compatibilidad con la versión 9.4.0 del SDK de Chartboost.

Compilado y probado con lo siguiente:

  • Versión 10.7.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 9.4.0 del SDK de Chartboost.

Versión 9.3.1.0

  • Se verificó la compatibilidad con la versión 9.3.1 del SDK de Chartboost.

Compilado y probado con lo siguiente:

  • Versión 10.7.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 9.3.1 del SDK de Chartboost.

Versión 9.3.0.0

  • Se verificó la compatibilidad con la versión 9.3.0 del SDK de Chartboost.
  • Ahora requiere, como mínimo, la versión 11.0 de iOS.
  • Ahora se requiere la versión 10.4.0 o posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con lo siguiente:

  • Versión 10.4.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 9.3.0 del SDK de Chartboost.

Versión 9.2.0.0

  • Se quitó la importación de GADMChartboostExtras en el archivo de encabezado ChartboostAdapter.
  • Se verificó la compatibilidad con la versión 9.2.0 del SDK de Chartboost.
  • Ahora se requiere la versión 10.0.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
  • Se quitó la compatibilidad con la arquitectura armv7.
  • Ahora requiere la versión mínima de iOS, que es 11.0.

Compilado y probado con lo siguiente:

  • Versión 10.0.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 9.2.0 del SDK de Chartboost.

Versión 9.1.0.0

  • Se verificó la compatibilidad con la versión 9.1.0 del SDK de Chartboost.

Compilado y probado con lo siguiente:

  • Versión 9.11.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 9.1.0 del SDK de Chartboost.

Versión 9.0.0.0

  • Se verificó la compatibilidad con la versión 9.0.0 del SDK de Chartboost.
  • Se verificó la compatibilidad con la versión 9.10.0 del SDK de anuncios de Google para dispositivos móviles.
  • Se actualizó el adaptador para usar la API de didRewardUser.
  • Ahora se requiere la versión 9.8.0 o posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con lo siguiente:

  • Versión 9.10.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 9.0.0 del SDK de Chartboost.

Versión 8.5.0.2

  • Se verificó la compatibilidad con la versión 9.0.0 del SDK de anuncios de Google para dispositivos móviles.
  • Ahora se requiere la versión 9.0.0 o posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con lo siguiente:

  • Versión 9.0.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 8.5.0 del SDK de Chartboost.

Versión 8.5.0.1.0

  • Se verificó la compatibilidad con el SDK de Chartboost 8.5.0 que hace referencia a la versión 8.5.0.1 en CocoaPods.

Compilado y probado con

  • Versión 8.13.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 8.5.0 del SDK de Chartboost.

Versión 8.5.0.0

  • Se verificó la compatibilidad con el SDK de Chartboost 8.5.0.

Compilado y probado con

  • Versión 8.12.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 8.5.0 del SDK de Chartboost.

Versión 8.4.2.0

  • Se verificó la compatibilidad con el SDK de Chartboost 8.4.2.

Compilado y probado con

  • Versión 8.6.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 8.4.2 del SDK de Chartboost.

Versión 8.4.1.1

  • Dependencia relajada del SDK de anuncios de Google para dispositivos móviles versión 8.0.0 o posterior.

Compilado y probado con

  • Versión 8.4.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 8.4.1 del SDK de Chartboost.

Versión 8.4.1.0

  • Se verificó la compatibilidad con el SDK de Chartboost 8.4.1.
  • Ahora se requiere la versión 8.1.0 o posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con

  • Versión 8.1.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 8.4.1 del SDK de Chartboost.

Versión 8.4.0.1

  • Se agregaron mensajes y códigos de error estandarizados del adaptador.
  • Se actualizó el adaptador para usar el formato .xcframework.
  • Ahora se requiere la versión 8.0.0 o posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con

  • Versión 8.0.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 8.4.0 del SDK de Chartboost.

Versión 8.4.0.0

  • Se verificó la compatibilidad con el SDK de Chartboost 8.4.0.
  • Ahora se requiere la versión 7.68.0 o posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con

  • Versión 7.68.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 8.4.0 del SDK de Chartboost.

Versión 8.3.1.0

  • Se verificó la compatibilidad con el SDK de Chartboost 8.3.1.
  • Ahora se requiere la versión 7.66.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
  • Ahora requiere la versión mínima de iOS 10.0.
  • Se actualizó el adaptador para admitir solicitudes de banners adaptables.

Compilado y probado con

  • Versión 7.66.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 8.3.1 del SDK de Chartboost.

Versión 8.2.1.0

  • Se verificó la compatibilidad con el SDK de Chartboost 8.2.1.
  • Ahora se requiere la versión 7.64.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
  • Ahora requiere la versión mínima de iOS, 9.0.

Compilado y probado con

  • Versión 7.64.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 8.2.1 del SDK de Chartboost.

Versión 8.2.0.0

  • Se verificó la compatibilidad con el SDK de Chartboost 8.2.0.
  • Ahora se requiere la versión 7.61.0 o posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con

  • Versión 7.61.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 8.2.0 del SDK de Chartboost.

Versión 8.1.0.1

  • Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a 7.60.0.
  • Se actualizó el adaptador para usar la nueva API de Chartboost y se quitaron las APIs obsoletas.
  • Adapter ahora admite la carga de varios anuncios del mismo formato con la misma ubicación en Chartboost.
  • Si la recompensa no se anula en la IU de AdMob o Ad Manager, el valor de la recompensa para los anuncios recompensados ahora será el valor especificado en la IU de Chartboost en lugar de 0.

Compilado y probado con

  • Versión 7.60.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 8.1.0 del SDK de Chartboost.

Versión 8.1.0.0

  • Se verificó la compatibilidad con el SDK de Chartboost 8.1.0.
  • Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a 7.59.0.
  • Se quitó la compatibilidad con la arquitectura i386.

Compilado y probado con

  • Versión 7.59.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 8.1.0 del SDK de Chartboost.

Versión 8.0.4.0

  • Se verificó la compatibilidad con el SDK de Chartboost 8.0.4.

Compilado y probado con

  • Versión 7.52.0 del SDK de anuncios de Google para dispositivos móviles.
  • Versión 8.0.4 del SDK de Chartboost.

Versión 8.0.1.1

  • Se solucionó un problema por el que la solicitud de anuncios de banner no mostraba rellenos.

Versión 8.0.1.0

  • Se verificó la compatibilidad con el SDK de Chartboost 8.0.1.
  • Se agregó compatibilidad con la solicitud de anuncios de banner.

Versión 7.5.0.1

  • Se agregó código para inicializar correctamente el SDK de Chartboost.

Versión 7.5.0.0

  • Se verificó la compatibilidad con el SDK de Chartboost 7.5.0.
  • Se actualizó el adaptador para usar la nueva API de anuncios recompensados.
  • Se actualizó el adaptador para controlar varias solicitudes intersticiales.
  • Ahora se requiere la versión 7.42.2 o posterior del SDK de anuncios de Google para dispositivos móviles.

Versión 7.3.0.0

  • Se verificó la compatibilidad con el SDK de Chartboost 7.3.0.

Versión 7.2.0.1

  • Se agregó la devolución de llamada adapterDidCompletePlayingRewardBasedVideoAd: al adaptador.

Versión 7.2.0.0

  • Se verificó la compatibilidad con el SDK de Chartboost 7.2.0.

Versión 7.1.2.0

  • Se verificó la compatibilidad con el SDK de Chartboost 7.1.2.

Versión 7.1.1.0

  • Se verificó la compatibilidad con el SDK de Chartboost 7.1.1.

Versión 7.1.0.0

  • Se verificó la compatibilidad con el SDK de Chartboost 7.1.0.

Versión 7.0.4.0

  • Se verificó la compatibilidad con el SDK de Chartboost 7.0.4.

Versión 7.0.3.0

  • Se verificó la compatibilidad con el SDK de Chartboost 7.0.3.

Versión 7.0.2.0

  • Se verificó la compatibilidad con el SDK de Chartboost 7.0.2.
  • Se agregó compatibilidad con dos códigos de error de Chartboost nuevos.

Versión 7.0.1.0

  • Se verificó la compatibilidad con el SDK de Chartboost 7.0.1.

Versión 7.0.0.0

  • Se verificó la compatibilidad con el SDK de Chartboost 7.0.0.

Versión 6.6.3.0

  • Se verificó la compatibilidad con el SDK de Chartboost 6.6.3.
  • Se quitó la compatibilidad con la arquitectura “armv7s”.
  • Se corrigió un error por el que los publicadores se enfrentaban a un problema de compilación en Swift cuando importaban ChartboostAdapter.framework como un módulo que importaba el SDK no modular de Chartboost.

Versión 6.6.2.0

  • Se verificó la compatibilidad con el SDK de Chartboost 6.6.2.

Versión 6.6.1.0

  • Se verificó la compatibilidad con el SDK de Chartboost 6.6.1.

Versión 6.6.0.0

  • Se verificó la compatibilidad con el SDK de Chartboost 6.6.0.

Versión 6.5.2.1

  • Se habilitó la compatibilidad con códigos de bits.
  • Ahora distribuye el adaptador de Chartboost como marco de trabajo.
  • Para importar ChartboostAdapter.framework en tu proyecto, asegúrate de establecer Allow Non-modular Includes in Framework Modules en YES en Configuración de compilación de tu destino.

Versión 6.5.2.0

  • Se cambió el sistema de nombres de versiones a [versión del SDK de Chartboost].[versión de parche del adaptador].
  • Se actualizó el SDK mínimo de Chartboost necesario a la versión 6.5.1.
  • Se actualizó el SDK mínimo de anuncios de Google para dispositivos móviles a la versión 7.10.1.
  • Se corrigió un error que brinda compatibilidad con varias ubicaciones de anuncios de Chartboost.
  • Las apps ahora obtienen la devolución de llamada interstitialWillDismissScreen: cuando el anuncio intersticial está a punto de descartarse.
  • Las apps ahora obtienen la devolución de llamada rewardBasedVideoAdDidOpen: cuando se abre un anuncio de video basado en recompensas.

Versión 1.1.0

  • Se quitó la ubicación del anuncio de Chartboost de los elementos adicionales de Chartboost. Ahora se especifica la ubicación del anuncio en la consola de AdMob cuando se configura Chartboost para la mediación.

Versión 1.0.0

  • Versión inicial Admite anuncios de video basados en recompensas y anuncios intersticiales.