Cómo integrar Chartboost con la mediación

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 mediante la mediación, que abarca las integraciones en cascada. Se explica cómo agregar Chartboost a la configuración de mediación de un bloque de anuncios y cómo integrar el SDK y el adaptador de Chartboost en una app de iOS .

Integraciones admitidas y formatos de anuncios

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

Integración
Ofertas
Cascada
Formatos
Banner
Intersticial
Recompensado
Código nativo

Requisitos

• Objetivo de implementación para iOS 10.0 o versiones posteriores

• SDK de anuncios de Google para dispositivos móviles más reciente

Paso 1: Configura Chartboost

Regístrate para obtener una cuenta de Chartboost y accede una vez que se haya verificado. Haz clic en el botón + APP en la barra lateral izquierda. Llena el formulario y haz clic en Guardar para agregar tu app a Chartboost.

A continuación, en el panel de Chartboost de tu app, navega a Configuración de la app > Configuración básica para ubicar tu ID de app y Firma de la app.

AdMob requiere el ID de usuario y la firma del usuario de Chartboost para configurar tuAdMob ID del bloque de anuncios. Puedes encontrar estos parámetros en el panel de Chartboost si navegas a Tools > API Explorer (Herramientas > Explorador de API). Tu ID de usuario y Firma del usuario se encuentran en la sección Autenticación.

Paso 2: Establezca la configuración de mediación en su AdMob bloque de anuncios

Debe agregar Chartboost a la configuración de mediación para su bloque de anuncios. Primero, acceda a su cuenta de AdMob.

A continuación, navegue a la pestaña Mediación. Si tienes un grupo de mediación existente que deseas modificar, haz clic en el nombre de ese grupo de mediación para editarlo y continúa con la sección Agrega Chartboost como una fuente del anuncio.

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

Ingrese el formato del anuncio y la plataforma y, luego, haga clic en Continuar.

Asigne un nombre a su grupo de mediación y seleccione las ubicaciones de segmentación. A continuación, establezca el estado del grupo de mediación en Habilitado. Luego, haz clic en Agregar bloques de anuncios para abrir la superposición de selección de bloques de anuncios.

Asocie este grupo de mediación con su bloque de anuncios de AdMob existente. Luego, haga clic en Listo.

Ahora deberías ver la tarjeta de bloques de anuncios propagada con los bloques de anuncios que seleccionaste.

Cómo agregar Chartboost como una fuente del anuncio

En la tarjeta Fuentes del anuncio, seleccione Agregar red publicitaria. Luego, selecciona Chartboost.

Habilite la opción Optimizar. Ingresa tu ID de usuario y la Firma del usuario que obtuviste en la sección anterior a fin de configurar la optimización de la fuente del anuncio para Chartboost. Luego, ingrese un valor de eCPM para Chartboost y haga clic en Continue.

Nota: Solo debe configurar la optimización de la fuente del anuncio una vez por red.

Luego, ingresa el ID de la app y la firma de la app que obtuviste en la sección anterior. Además, ingresa una ubicación del anuncio (p.ej., "Game Over Screen") que identifique esta posición de manera única en tu app.

Las ubicaciones del anuncio de Chartboos (Ubicaciones con nombre) son nombres simples que representan un lugar en tu aplicación donde deseas mostrar un anuncio. AdMob 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 panel para generar informes.

Nota: AdMob puede calcular los CPM de las tres ubicaciones de anuncios principales en tu app de Chartboost. Todas las demás ubicaciones se representarán con un CPM combinado.

En el panel de Chartboost, tus ubicaciones del anuncio se pueden revelar en la página de configuración básica haciendo clic en Configuración avanzada. Consulta la guía de ubicaciones con nombre de Chartboost para obtener más detalles.

Por último, haz clic en Listo para agregar Chartboost como una fuente del anuncio y, luego, haz clic en Guardar.

Nota: La optimización de la fuente del anuncio tarda unos días en recopilar datos a fin de calcular de manera precisa el eCPM para una red de mediación. Mientras tanto, el estado de optimización de la fuente del anuncio será PENDIENTE, por lo que debes establecer un valor de eCPM de forma manual para la red. Una vez que se puede calcular el eCPM, la optimización de la fuente del anuncio comenzará a actualizar el eCPM automáticamente en su nombre.

Cómo usar anuncios recompensados

En la configuración de tu bloque de anuncios recompensados, proporciona valores para el importe y el tipo de recompensa. Luego, para asegurarte de proporcionar la misma recompensa al usuario, sin importar qué red de publicidad se publique, marca la casilla Apply to all networks in Mediation groups.

Si no aplicas esta configuración, el adaptador de Chartboost devuelve la recompensa especificada en la IU de Chartboost.

Si quieres obtener más información para establecer valores de recompensa para los bloques de anuncios de AdMob, consulta Cómo crear un bloque de anuncios.

Paso 3: Importa el SDK y el adaptador de Chartboost

Uso de CocoaPods (recomendado)

• 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 Changelog y vincula ChartboostAdapter.framework en tu proyecto.

• Agrega los siguientes marcos de trabajo a tu proyecto:

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

Paso 4: Se requiere un código adicional

Configuración de proyecto

Establece Permitir inclusiones no modulares en los módulos del marco de trabajo en YES en Configuración de compilación de tu destino.

Agrega valor -ObjC en Otras marcas de vinculadores en la configuración de compilación de tu proyecto para Debug y Release.

Paso 5: Pruebe su implementación

Los anuncios de prueba se pueden habilitar en tu app desde el panel de Chartboost en Configuración de la app > Configuración básica como se muestra a continuación.

Una vez que el modo de prueba esté habilitado, puedes solicitar anuncios con el ID del bloque de anuncios que creaste anteriormente y recibir un anuncio de prueba de Chartboost.

Paso 6: Prepara la app para la producción

Una vez que puedas recibir anuncios de prueba de Chartboost, tu app se ubicará en la Revisión de la app del publicador. Una vez que se apruebe la app, podrás crear tu campaña de publicación a fin de configurarla para los anuncios de Chartboost publicados.

Navega hasta Monetización > Campañas de publicación en el menú lateral izquierdo y haz clic en Agregar una campaña (o + Agregar campaña en la esquina superior derecha de tu panel si ya tienes otras campañas) y elige Publicación de redes cuando se te solicite.

Ingresa un Nombre para tu campaña de publicación, selecciona el Tipo de posición y, luego, iOS como la Plataforma. Si Chartboost aprobó tu app, podrás seleccionarla y aplicarla a esta campaña. Llena el resto del formulario y haz clic en Guardar para terminar de agregar la campaña.

Listo. Ahora tiene una integración de mediación activa con Chartboost.

Pasos opcionales

Importante: Verifique que tenga el permiso de Administración de cuentas a fin de completar la configuración del Consentimiento de la UE y el GDPR, la CCPA y la Plataforma de mensajería para usuarios. Para obtener más información, consulta el siguiente artículo sobre las funciones de usuario nuevas.

Consentimiento de la UE y GDPR

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

En la versión 8.2.0 del SDK, Chartboost agregó el método addDataUseConsent. En el siguiente código de muestra, se establece el consentimiento de uso de datos en CHBGDPRConsentNonBehavioral. Si decides llamar a este método, se recomienda que lo hagas antes de solicitar anuncios a través del SDK de Google Mobile Ads.

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.

Agregar Chartboost a la lista de socios publicitarios del GDPR

Sigue los pasos que se indican en Configuración del GDPR para agregar Chartoost a la lista de socios de anuncios del GDPR en la AdMob IU.

CCPA

Ley de Privacidad del Consumidor de California (CCPA) requiere que los residentes del estado de California tengan el derecho de rechazar la “venta” de su “información personal” (según la definición de esas condiciones), con la opción de no participar mediante el vínculo destacado “No vender mi información personal” en la página principal del “vendedor”. La guía de preparación de la CCPA ofrece la posibilidad 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 en 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 la orientación de cada una de esas redes para garantizar el cumplimiento de la CCPA.

En la versión 8.2.0 del SDK, Chartboost agregó el método addDataUseConsent. En el siguiente código de muestra, se establece el consentimiento de uso de datos en CHBCCPAConsentOptInSale. Si decides llamar a este método, se recomienda que lo hagas antes de solicitar los anuncios a través del SDK de Google Mobile Ads.

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 suMé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 mediante GADResponseInfo.adNetworkInfoArray en las siguientes clases:

GADMAdapterChartboost
GADMediationAdapterChartboost

A continuación, se incluyen los códigos y mensajes adjuntos que muestra el adaptador de Chartboost cuando un anuncio no se carga:

Código de error	Razón
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.
103	Faltan parámetros de servidor de Chartboost configurados en la IU de AdMob .
104	Los anuncios intersticiales o recompensados de Chartboost no están listos para mostrarse.
101	Faltan parámetros de servidor de Chartboost configurados en la IU de AdMob .
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 mostrarse.
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 mínima requerida por el 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 del SDK de Chartboost Consulta el código para obtener más detalles.

Recursos adicionales

Cómo iniciar una campaña de publicación brinda detalles adicionales sobre cómo configurar las campañas de publicación de Chartboost.

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

Versión 9.2.0.0

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

Compilado y probado con:

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

Versión 9.1.0.0

• Compatibilidad verificada con la versión 9.1.0 del SDK de Chartboost

Compilado y probado con:

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

Versión 9.0.0.0

• Compatibilidad verificada con la versión 9.0.0 del SDK de Chartboost
• Compatibilidad verificada 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 requiere la versión 9.8.0 o una posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con:

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

Versión 8.5.0.2

• Compatibilidad verificada con la versión 9.0.0 del SDK de anuncios de Google para dispositivos móviles
• Ahora requiere la versión 9.0.0 o una posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con:

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

Versión 8.5.0.1.0

• Compatibilidad verificada con el SDK 8.5.0 de Chartboost que hace referencia a la versión 8.5.0.1 en CocoaPods

Compilado y probado con

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

Versión 8.5.0.0

• Compatibilidad verificada con el SDK de Chartboost 8.5.0

Compilado y probado con

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

Versión 8.4.2.0

• Compatibilidad verificada con el SDK de Chartboost 8.4.2

Compilado y probado con

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

Versión 8.4.1.1

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

Compilado y probado con

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

Versión 8.4.1.0

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

Compilado y probado con

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

Versión 8.4.0.1

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

Compilado y probado con

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

Versión 8.4.0.0

• Compatibilidad verificada con el SDK de Chartboost 8.4.0
• Ahora, se requiere la versión 7.68.0 o una posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con

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

Versión 8.3.1.0

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

Compilado y probado con

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

Versión 8.2.1.0

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

Compilado y probado con

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

Versión 8.2.0.0

• Compatibilidad verificada con el SDK de Chartboost 8.2.0
• Ahora, se requiere la versión 7.61.0 o una posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con

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

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 API obsoletas.
• El adaptador ahora permite cargar varios anuncios del mismo formato con la misma ubicación de Chartboost
• Si no se anula la recompensa en la IU de AdMob o Ad Manager, el valor de recompensa para los anuncios recompensados ahora es el valor especificado en la IU de Chartboost en lugar de 0.

Compilado y probado con

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

Versión 8.1.0.0

• Compatibilidad verificada con el SDK de Chartboost 8.1.0
• Se actualizó la versión mínima requerida del SDK de Google Mobile Ads a 7.59.0.
• Se quitó la compatibilidad con la arquitectura i386.

Compilado y probado con

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

Versión 8.0.4.0

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

Compilado y probado con

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

Versión 8.0.1.1

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

Versión 8.0.1.0

• Compatibilidad verificada con el SDK de Chartboost 8.0.1
• Se agregó compatibilidad para solicitar 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

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

Versión 7.3.0.0

• Compatibilidad verificada 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

• Compatibilidad verificada con el SDK de Chartboost 7.2.0

Versión 7.1.2.0

• Compatibilidad verificada con el SDK de Chartboost 7.1.2

Versión 7.1.1.0

• Compatibilidad verificada con el SDK de Chartboost 7.1.1

Versión 7.1.0.0

• Compatibilidad verificada con el SDK de Chartboost 7.1.0

Versión 7.0.4.0

• Compatibilidad verificada con el SDK de Chartboost 7.0.4.

Versión 7.0.3.0

• Compatibilidad verificada con el SDK de Chartboost 7.0.3

Versión 7.0.2.0

• Compatibilidad verificada con el SDK de Chartboost 7.0.2
• Se agregó compatibilidad para dos códigos de error nuevos de Chartboost.

Versión 7.0.1.0

• Compatibilidad verificada con el SDK de Chartboost 7.0.1

Versión 7.0.0.0

• Compatibilidad verificada con el SDK de Chartboost 7.0.0.

Versión 6.6.3.0

• Compatibilidad verificada con el SDK de Chartboost 6.6.3
• Se quitó la compatibilidad con la arquitectura "armv7s".
• Se corrigió un error en el que los publicadores tenían problemas de compilación en Swift al importar ChartboostAdapter.framework como un módulo que importaba el SDK de bombo no modular.

Versión 6.6.2.0

• Compatibilidad verificada con el SDK de Chartboost 6.6.2

Versión 6.6.1.0

• Compatibilidad verificada con el SDK de Chartboost 6.6.1

Versión 6.6.0.0

• Compatibilidad verificada 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 Chartboost como marco de trabajo.
• Para importar ChartboostAdapter.framework en tu proyecto, asegúrate de configurar Allow Non-modular Includes in Framework Modules como YES en Configuración de compilación de tu destino.

Versión 6.5.2.0

• Se cambió el sistema de nombres de la versión a [Chartboost SDK version].[versión del adaptador].
• Se actualizó el SDK mínimo requerido de Chartboost a la versión 6.5.1.
• Se actualizó el SDK mínimo de Google Mobile Ads a la versión 7.10.1.
• Se corrigió un error para admitir varias ubicaciones de anuncios en Chartboost.
• Las apps ahora reciben 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 extras de Chartboost La ubicación del anuncio ahora se especifica 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.