Cómo integrar i-mobile con Mediation

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.

create_ad_spot

Next, fill out the form by providing the 広告スポット名 (Ad Spot name), 広告スポットサイズ (Ad Spot size) and other details. Then, click the 新規登録 (Sign up) button.

new_ad_spot_form

Your new Ad spot is ready. To view its integration details, click the アプリ設定取得 (Get App settings) button.

ad_spot_list

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

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 de IMobileAdapter.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.