Cómo integrar i-mobile con la mediación

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 con mediación, que abarca las integraciones de cascada. En ella, se explica cómo agregar i-mobile a la configuración de mediación de una unidad de anuncios y cómo integrar el SDK y el adaptador de i-mobile en una app para Unity.

La interfaz del panel para i-mobile usa texto en japonés para sus etiquetas, botones y descripciones. Las capturas de pantalla de esta guía no se tradujeron. Sin embargo, en las descripciones y las instrucciones de esta guía, las etiquetas y los botones se traducen con sus equivalentes en inglés entre paréntesis.

Integraciones y formatos de anuncios admitidos

El adaptador de mediación de Ad Manager para i-mobile tiene las siguientes capacidades:

Integración
Ofertas
Cascada
Formatos
Banner
Intersticial
Recompensado

Requisitos

  • Unity 5.6 o una versión posterior
  • SDK de anuncios de Google para dispositivos móviles más reciente
  • Para implementar en Android, haz lo siguiente:
    • Android con nivel de API 21 o superior
  • Para implementar en iOS:
    • Objetivo de implementación de iOS 12.0 o una versión posterior
  • Un proyecto de Unity en funcionamiento configurado con el SDK de anuncios de Google para dispositivos móviles Consulta Cómo comenzar para obtener más información.
  • Completa la guía de introducción de mediación.

Paso 1: Configura la IU de i-mobile

Regístrate o accede a tu cuenta de i-mobile.

Para agregar tu app al panel de i-mobile, haz clic en la pestaña サイト／アプリ管理 (Site/Application Management) y en el botón de la plataforma de tu app.

Android

iOS

Completa el formulario y haz clic en el botón 新規登録 (Registrarse).

Android

iOS

Para crear un nuevo lugar de publicidad, selecciona tu app en la pestaña サイト／アプリ管理 (Site/Application Management).

Android

iOS

Navega a la pestaña 広告スポット管理 (Ad Spot Management) y haz clic en el botón 新規広告スポット (New Ad Spot).

create_ad_spot

A continuación, completa el formulario con el 広告スポット名 (nombre del grupo de anuncios), 広告スポットサイズ (tamaño del grupo de anuncios) y otros detalles. Luego, haz clic en el botón 新規登録 (Registrarse).

new_ad_spot_form

Tu nuevo lugar para anuncios está listo. Para ver los detalles de la integración, haz clic en el botón アプリ設定取得 (Get App settings).

ad_spot_list

Anota los valores de パブリッシャーID (ID del publicador), メディアID (ID de medios) y スポットID (ID del spot). Necesitarás estos parámetros más adelante cuando configures i-mobile para la mediación en la IU de Ad Manager.

Android

iOS

Paso 2: Configura la demanda de i-mobile en la IU de Ad Manager

Configura la configuración de mediación para tu unidad de anuncios

Android

Para obtener instrucciones, consulta el paso 2 de la guía para Android.

iOS

Para obtener instrucciones, consulta el paso 2 de la guía para iOS.

Paso 3: Importa el SDK y el adaptador de i-mobile

OpenUPM-CLI

Si tienes instalado OpenUPM-CLI, puedes instalar el complemento de mediación de i-mobile de Google Mobile Ads para Unity en tu proyecto. Para ello, ejecuta el siguiente comando desde el directorio raíz de tu proyecto:

openupm add com.google.ads.mobile.mediation.imobile

OpenUPM

En el editor de tu proyecto de Unity, selecciona Edit > Project Settings > Package Manager para abrir la configuración del Administrador de paquetes de Unity.

En la pestaña Registros con alcance, agrega OpenUPM como un registro con alcance con los siguientes detalles:

  • Nombre: OpenUPM
  • URL: https://package.openupm.com
  • Permisos: com.google

Detalles de OpenUPM

Luego, navega a Window > Package Manager para abrir el Unity Package Manager y selecciona My Registries en el menú desplegable.

Registros de Unity

Selecciona el paquete Google Mobile Ads i-mobile Mediation y haz clic en Install.

Cómo instalar desde OpenUPM

Paquete de Unity

Descarga la versión más reciente del complemento de mediación de Google Mobile Ads para i-mobile desde el vínculo de descarga en el registro de cambios y extrae GoogleMobileAdsIMobileMediation.unitypackage del archivo ZIP.

En el editor de tu proyecto de Unity, selecciona Assets > Import Package > Custom Package y busca el archivo GoogleMobileAdsIMobileMediation.unitypackage que descargaste. Asegúrate de que todos los archivos estén seleccionados y haz clic en Importar.

Importa desde Unity

Luego, selecciona Assets > External Dependency Manager > Android Resolver > Force Resolve. La biblioteca de External Dependency Manager realizará la resolución de dependencias desde cero y copiará las dependencias declaradas en el directorio Assets/Plugins/Android de tu app para Unity.

Forzar resolución

Paso 4: Se requiere código adicional

Android

No se requiere código adicional para la integración de i-mobile.

iOS

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

Habilita los anuncios de prueba

Asegúrate de registrar tu dispositivo de prueba para Ad Manager. i-mobile proporciona IDs de ubicación, IDs de contenido multimedia y IDs de publicador de prueba para las pruebas. Puedes encontrarlos aquí.

Verifica los anuncios de prueba

Para verificar que recibes anuncios de prueba de i-mobile, habilita la prueba de fuente del anuncio individual en el inspector de anuncios con las fuentes de anuncios i-mobile (cascada).

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 con ResponseInfo en las siguientes clases:

Android

Formato Nombre de clase
Banner com.google.ads.mediation.imobile.IMobileAdapter
Intersticial com.google.ads.mediation.imobile.IMobileAdapter
Nativo com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

Formato Nombre de clase
Banner IMobileAdapter
Intersticial IMobileAdapter
Nativo GADMediationAdapterIMobile

Estos son los códigos y los mensajes adjuntos que arroja el adaptador i-mobile cuando no se puede cargar un anuncio:

Android

Código de error Motivo
0-99 El SDK de i-mobile mostró un error. Consulta el código para obtener más detalles.
101 i-mobile requiere un contexto Activity para cargar anuncios.
102 Faltan los parámetros del servidor i-mobile configurados en la IU de Ad Manager o no son válidos.
103 El tamaño del anuncio solicitado no coincide con un tamaño de banner compatible con i-mobile.
104 La devolución de llamada de carga de anuncios nativos de i-mobile mostró una lista de anuncios nativos vacía.

iOS

Código de error Motivo
0-10 El SDK de i-mobile mostró un error. Consulta el código para obtener más detalles.
101 Faltan los parámetros del servidor i-mobile configurados en la IU de Ad Manager o no son válidos.
102 El tamaño del 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 recursos de anuncios nativos.
106 i-mobile no admite la solicitud de varios anuncios intersticiales con el mismo ID de Spot.

Registro de cambios del complemento de mediación de Unity de i-mobile

Versión 1.3.6

Versión 1.3.5

Versión 1.3.4

Versión 1.3.3

Versión 1.3.2

Versión 1.3.1

Versión 1.3.0

Versión 1.2.2

Versión 1.2.1

Versión 1.2.0

Versión 1.1.0

Versión 1.0.2

Versión 1.0.1

Versión 1.0.0