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.
Haz clic en el botón Add new app para crear tu app.
Completa el resto del formulario y haz clic en el botón Add App para finalizar la app.
Una vez creada la app, se te dirigirá al panel. Anota el ID y la firma de tu app.
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.
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.
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.
En la configuración de la app, puedes activar o desactivar el Modo de prueba.
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
Usa 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 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
Consentimiento de la UE y GDPR
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 deChartboostAdapter.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
porGADMobileAds.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 encabezadoChartboostAdapter
. - 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 establecerAllow Non-modular Includes in Framework Modules
enYES
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.