En esta guía, se muestra cómo usar el SDK de anuncios de Google para dispositivos móviles para cargar y mostrar anuncios de i-mobile usando mediación, que abarcan integraciones en cascada. Abarca cómo agregar i-mobile a la interfaz de usuario de una unidad de anuncios configuración de mediación y cómo integrar el SDK de i-mobile y el adaptador a una iOS app.
La interfaz del panel de i-mobile usa texto en japonés para las etiquetas. botones y descripciones. Las capturas de pantalla en esta guía no se traducido. Sin embargo, en las descripciones e instrucciones de esta guía, las etiquetas y botones se traducen con sus equivalentes en inglés entre paréntesis.
Integraciones y formatos de anuncios admitidos
El adaptador de mediación para i-mobile tiene las siguientes funciones:
Integración | |
---|---|
Ofertas | |
Cascada | |
Formatos | |
Banner | |
Intersticial | |
Recompensado | |
Nativo |
Requisitos
- Objetivo de implementación de iOS 12.0 o superior
SDK de anuncios de Google para dispositivos móviles más reciente
Cómo completar la mediación Guía de introducción
Paso 1: Establece la configuración en la IU de i-mobile
Sign up or log in to your i-mobile account.
Add your app to the i-mobile dashboard by clicking the サイト/アプリ管理 (Site/Application Management) tab and the button for your app's platform.
Fill out the form and click the 新規登録 (Sign up) button.
To create a new Advertising Spot, select your app under the サイト/アプリ管理 (Site/Application Management) tab.
Navigate to the 広告スポット管理 (Ad Spot Management) tab and click the 新規広告スポット (New Ad Spot) button.
Next, fill out the form by providing the 広告スポット名 (Ad Spot name), 広告スポットサイズ (Ad Spot size) and other details. Then, click the 新規登録 (Sign up) button.
Your new Ad spot is ready. To view its integration details, click the アプリ設定取得 (Get App settings) button.
Take note of the パブリッシャーID (Publisher ID), メディアID (Media ID), and スポットID (Spot ID). You'll need these parameters later when configuring i-mobile for mediation in the Ad Manager UI.
Paso 2: Configura la demanda de i-mobile 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 parai-mobile, puedes seleccionarlo. De lo contrario, selecciona Crear un socio de rendimiento nuevo.
Selecciona i-mobile 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 Login name and API Password
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 elPublisher ID, Media ID and Spot ID obtenido en la sección anterior. Luego, ingresa un valor de CPM predeterminado.
Haz clic en Guardar en la parte inferior de la página cuando termines.
Paso 3: Importa el SDK y el adaptador de i-mobile
Usando CocoaPods (recomendado)
Agrega la siguiente línea al Podfile de tu proyecto:
pod 'GoogleMobileAdsMediationIMobile'
Desde la línea de comandos, ejecuta lo siguiente:
pod install --repo-update
Integración manual
- Descarga la última versión de la i-mobile
SDK y el vínculo
ImobileSdkAds.framework
en tu proyecto. - Descarga la versión más reciente del adaptador i-mobile desde el enlace de descarga en
Registro de cambios y
vincula
IMobileAdapter.framework
en tu proyecto.
Paso 4: Agrega el código requerido
Integración de SKAdNetwork
Sigue la documentación de i-mobile.
para agregar los identificadores de SKAdNetwork al archivo Info.plist
de tu proyecto.
Paso 5: Prueba tu implementación
Habilitar anuncios de prueba
Asegúrate de registrar tu dispositivo de prueba en Ad Manager. i-mobile proporciona los IDs de Spot, Media ID y publicador de prueba para realizar pruebas. Puedes encontrarlos aquí.
Cómo verificar los anuncios de prueba
Para verificar que recibes anuncios de prueba dei-mobile, habilita las pruebas de fuentes de anuncios individuales en el inspector de anuncios mediante la i-mobile (Waterfall) fuente de anuncios.
Pasos opcionales
Cómo usar anuncios nativos
Renderización de anuncios
El adaptador i-mobile completa la siguiente información
campos
durante un
GADNativeAd
Campo | Los recursos siempre se incluyen en el adaptador de i-mobile. |
---|---|
Título | |
Imagen | |
Cuerpo | |
Ícono de la aplicación | 1 |
Llamado a la acción | |
Calificación por estrellas | |
Tienda | |
Precio |
1 En el caso de los anuncios nativos, el SDK de i-mobile no proporciona un recurso de ícono de la aplicación. En cambio, el adaptador de i-mobile completa el icono de la aplicación con una imagen transparente.
Códigos de error
Si el adaptador no recibe un anuncio de i-mobile,
los publicadores pueden verificar el error subyacente de la respuesta del anuncio
GADResponseInfo.adNetworkInfoArray
en las siguientes clases:
Formato | Nombre de clase |
---|---|
Banner | IMobileAdapter |
Intersticial | IMobileAdapter |
Nativo | GADMediationAdapterIMobile |
Estos son los códigos y los mensajes adjuntos que arroja el adaptador de i-mobile. Cuando un anuncio no se carga:
Código de error | Motivo |
---|---|
0-99 | El SDK de i-mobile mostró un error. Ver código para obtener más información. |
101 | i-mobile requiere un contexto Activity para cargar anuncios. |
102 | Faltan los parámetros del servidor de i-mobile en la IU de Ad Manager o no son válidos. |
103 | El tamaño de anuncio solicitado no coincide con un tamaño de banner compatible con i-mobile. |
104 | La devolución de llamada de éxito de carga de anuncios nativos de i-mobile mostró una lista de anuncios nativos vacía. |
0-10 | El SDK de i-mobile mostró un error. Ver código para obtener más información. |
101 | Faltan los parámetros del servidor de i-mobile en la IU de Ad Manager o no son válidos. |
102 | El tamaño de anuncio solicitado no coincide con un tamaño de banner compatible con i-mobile. |
103 | i-mobile no pudo presentar un anuncio. |
104 | i-mobile mostró un array de anuncios nativos vacío. |
105 | i-mobile no pudo descargar los elementos del anuncio nativo. |
106 | i-mobile no permite solicitar varios anuncios intersticiales con el mismo ID de Spot. |
Registro de cambios del adaptador de mediación de iOS para i-mobile
Versión 2.3.4.0
- Compatibilidad verificada con el SDK de i-mobile 2.3.4
- Se agregó compatibilidad para mostrar la versión del SDK de i-mobile en
adSDKVersion
.
Compilado y probado con lo siguiente:
- Versión 11.2.0 del SDK de anuncios de Google para dispositivos móviles
- SDK de i-mobile versión 2.3.4.
Versión 2.3.3.0
- Compatibilidad verificada con el SDK de i-mobile 2.3.3
Compilado y probado con lo siguiente:
- Versión 11.1.0 del SDK de anuncios de Google para dispositivos móviles
- SDK de i-mobile versión 2.3.3.
Versión 2.3.2.1
- Se quitó el método delegado
willBackgroundApplication
obsoleto de las implementaciones de anuncios banner, intersticiales y nativos. - Ahora se requiere una versión mínima de iOS 12.0.
- Ahora 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 deIMobileAdapter.xcframework
.
Compilado y probado con lo siguiente:
- Versión 11.0.1 del SDK de anuncios de Google para dispositivos móviles
- SDK de i-mobile versión 2.3.2.
Versión 2.3.2.0
- Compatibilidad verificada con el SDK de i-mobile 2.3.2
- Se quitó la compatibilidad con la arquitectura
armv7
. - Ahora se requiere una versión mínima de iOS 11.0.
- Ahora se requiere la versión 10.4.0 o una 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
- SDK de i-mobile versión 2.3.2.
Versión 2.3.1.0
- Compatibilidad verificada con el SDK de i-mobile 2.3.1
Compilado y probado con lo siguiente:
- Versión 10.3.0 del SDK de anuncios de Google para dispositivos móviles
- SDK de i-mobile versión 2.3.1.
Versión 2.3.0.1
- Ahora se requiere la versión 10.0.0 o una posterior del SDK de anuncios de Google para dispositivos móviles.
Compilado y probado con lo siguiente:
- Versión 10.0.0 del SDK de anuncios de Google para dispositivos móviles
- SDK de i-mobile versión 2.3.0.
Versión 2.3.0.0
- Compatibilidad verificada con el SDK de i-mobile 2.3.0
- Ahora se requiere la versión 9.8.0 o una posterior del SDK de anuncios de Google para dispositivos móviles.
Compilado y probado con lo siguiente:
- Versión 9.13.0 del SDK de anuncios de Google para dispositivos móviles
- SDK de i-mobile versión 2.3.0.
Versión 2.2.0.1
- Ahora se requiere la versión 9.0.0 o una 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
- SDK de i-mobile versión 2.2.0.
Versión 2.2.0.0
- Compatibilidad verificada con el SDK de i-mobile versión 2.2.0.
Compilado y probado con
- Versión 8.13.0 del SDK de anuncios de Google para dispositivos móviles
- SDK de i-mobile versión 2.2.0.
Versión 2.1.0.1
- Se relajó la dependencia a 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.4.0 del SDK de anuncios de Google para dispositivos móviles
- SDK de i-mobile versión 2.1.0.
Versión 2.1.0.0
- Compatibilidad verificada con la versión 2.1.0 del SDK de i-mobile
- Ahora se requiere la versión 8.1.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
- Se actualizó el adaptador para usar el formato
.xcframework
.
Compilado y probado con
- Versión 8.1.0 del SDK de anuncios de Google para dispositivos móviles
- SDK de i-mobile versión 2.1.0.
Versión 2.0.33.1
- Se agregaron mensajes y códigos de error estandarizados del adaptador.
- El adaptador ahora limita las solicitudes de varios anuncios intersticiales con el mismo ID de Spot de i-mobile.
- El adaptador ahora reenvía la devolución de llamada
-nativeAdWillLeaveApplication:
cuando se presionan los anuncios nativos - 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
- SDK de i-mobile versión 2.0.33.
Versión 2.0.33.0
- Compatibilidad verificada con la versión 2.0.33 del SDK de i-mobile.
- Ahora se requiere la versión 7.65.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
- Ahora requiere una versión mínima de iOS de 9.0.
Compilado y probado con
- Versión 7.65.0 del SDK de anuncios de Google para dispositivos móviles
- SDK de i-mobile versión 2.0.33.
Versión 2.0.32.0
- Compatibilidad verificada con la versión 2.0.32 del SDK de i-mobile.
- Ahora se requiere la versión 7.60.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
- Se agregó compatibilidad para escalar anuncios de 320 x 50 y 320 x 100 a fin de que se adapten mejor a los tamaños de solicitudes de banners adaptables.
- Se quitó la compatibilidad con la arquitectura i386.
Compilado y probado con
- Versión 7.60.0 del SDK de anuncios de Google para dispositivos móviles.
- SDK de i-mobile versión 2.0.32.
Versión 2.0.31.0
- Se verificó la compatibilidad con la versión 2.0.31 del SDK de i-mobile.
Compilado y probado con
- Versión 7.53.1 del SDK de anuncios de Google para dispositivos móviles
- SDK de i-mobile versión 2.0.31.
Versión 2.0.29.0
- Versión inicial
- Se agregó compatibilidad con anuncios de banner, intersticiales y nativos.
Compilado y probado con
- Versión 7.52.0 del SDK de anuncios de Google para dispositivos móviles
- SDK de i-mobile versión 2.0.29.