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 la Mediación de AdMob, y abarca las integraciones en 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 Android app.

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 para i-mobile tiene las siguientes funciones:

Requisitos

• Nivel de API 21 o versiones posteriores de Android

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

• 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.

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

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

Navega a la pestaña 広告ポルト管理 (Ad Spot Management) y haz clic en el botón Navigate規広告郝ット (New 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).

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

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 AdMob.

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

Cómo configurar la mediación para tu unidad de anuncios

Debes agregar i-mobile a la configuración de mediación para tu unidad de anuncios.

Primero, accede a tu cuenta de AdMob. A continuación, ve 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 para editarlo y ve a Agregar i-mobile como fuente del anuncio.

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

Ingresa el formato del anuncio y la plataforma y, luego, haz clic en Continuar.

Asígnale un nombre a tu grupo de mediación y selecciona las ubicaciones para la que deseas segmentar tus anuncios. A continuación, establece el estado del grupo de mediación en Habilitado y haz clic en Agregar bloques de anuncios.

Asocia este grupo de mediación a una o más de tusAdMob unidades de anuncios existentes. Luego, haga clic en Listo.

Ahora deberías ver la tarjeta Bloques de anuncios propagada con las unidades de anuncios que seleccionaste:

Agregar i-mobile como fuente del anuncio

En la tarjeta Waterfall de la sección Fuentes del anuncio, selecciona Agregar fuente del anuncio. Luego, selecciona i-mobile.

Si ya tienes una asignación para i-mobile, puedes seleccionarla. De lo contrario, haz clic en Agregar asignación.

A continuación, ingresa el Publisher ID, Media ID and Spot IDobtenido en la sección anterior. Luego, haga clic en Listo.

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

Integración de Android Studio (recomendado)

En el archivo settings.gradle.kts de nivel de proyecto, agrega los siguientes repositorios:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile.github.io/adnw-sdk-android")
    }
  }
}

Luego, en el archivo build.gradle.kts a nivel de la app, agrega las siguientes dependencias y configuraciones de implementación. Usa las versiones más recientes del SDK y el adaptador de i-mobile:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.0")
}

Integración manual

1. Descarga la versión más reciente del SDK de i-mobile, extrae el android-ad-sdk.aar de la carpeta sdk y agrégalo a tu proyecto.

2. Navega a los artefactos del adaptador i-mobile en el repositorio de Maven de Google. Selecciona la versión más reciente, descarga el archivo .aar del adaptador i-mobile y agrégalo a tu proyecto.

Paso 4: Agrega el código obligatorio

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

Paso 5: Prueba tu implementación

Habilita los anuncios de prueba

Asegúrate de registrar tu dispositivo de prueba para AdMob. 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 de anuncios individuales en el inspector de anuncios con las fuentes de anuncios i-mobile (cascada).

Pasos opcionales

Cómo usar anuncios nativos

Renderización de anuncios

El adaptador de i-mobile propaga los siguientes campos de descripciones de campos avanzados de anuncios nativos para un NativeAd.

¹ En el caso de los anuncios nativos, el SDK de i-mobile no proporciona un recurso de ícono de aplicación. En su lugar, el adaptador i-mobile propaga el ícono de la app 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 conResponseInfo.getAdapterResponses()en las siguientes clases:

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

Registro de cambios del adaptador de mediación de Android de i-mobile

Versión 2.3.2.0

• Se verificó la compatibilidad con el SDK de i-mobile v2.3.2.

Compilado y probado con lo siguiente:

• Versión 23.1.0 del SDK de anuncios de Google para dispositivos móviles
• Versión 2.3.2 del SDK de IMobile

Versión 2.3.1.2

• Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 23.0.0.
• Se verificó la compatibilidad con el SDK de i-mobile v2.3.1.

Se compiló y probó con lo siguiente:

• Versión 23.0.0 del SDK de anuncios de Google para dispositivos móviles
• SDK de IMobile versión 2.3.1

Versión 2.3.1.1

• Se actualizó el adaptador para usar la nueva clase VersionInfo.
• Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 22.0.0.

Compilado y probado con lo siguiente:

• Versión 22.0.0 del SDK de anuncios de Google para dispositivos móviles
• Versión 2.3.1 del SDK de IMobile

Versión 2.3.1.0

• Compatibilidad verificada con el SDK de i-mobile v2.3.1
• Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 21.5.0.

Se compiló y probó con lo siguiente:

• Versión 21.5.0 del SDK de anuncios de Google para dispositivos móviles
• Versión 2.3.1 del SDK de IMobile

Versión 2.3.0.0

• Se verificó la compatibilidad con el SDK de i-mobile v2.3.0.
• Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 21.3.0.

Compilado y probado con lo siguiente:

• Versión 21.3.0 del SDK de anuncios de Google para dispositivos móviles
• Versión 2.3.0 del SDK de IMobile

Versión 2.0.23.1

• Se actualizaron compileSdkVersion y targetSdkVersion a la API 31.
• Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 21.0.0.
• Se actualizó el nivel mínimo de API de Android requerido a 19.

Compilado y probado con lo siguiente:

• Versión 21.0.0 del SDK de anuncios de Google para dispositivos móviles
• Versión 2.0.23 del SDK de IMobile

Versión 2.0.23.0

• Se verificó la compatibilidad con el SDK de i-mobile v2.0.23.
• Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 20.5.0.

Se compiló y probó con

• Versión 20.5.0 del SDK de anuncios de Google para dispositivos móviles
• Versión 2.0.23 del SDK de IMobile

Versión 2.0.22.2

• Se agregaron códigos de error y mensajes estandarizados del adaptador.
• Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 20.1.0.

Se compiló y probó con

• Versión 20.1.0 del SDK de anuncios de Google para dispositivos móviles
• Versión 2.0.22 del SDK de IMobile

Versión 2.0.22.1

• Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 20.0.0.

Compilado y probado con

• Versión 20.0.0 del SDK de anuncios de Google para dispositivos móviles
• Versión 2.0.22 del SDK de IMobile

Versión 2.0.22.0

• Se verificó la compatibilidad con el SDK de i-mobile v2.0.22.
• Se actualizó el adaptador para admitir solicitudes de banners adaptables intercalados.

Se compiló y probó con

• Versión 19.1.0 del SDK de anuncios de Google para dispositivos móviles
• Versión 2.0.22 del SDK de IMobile

Versión 2.0.21.0

• Se verificó la compatibilidad con el SDK de i-mobile v2.0.21.
• Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 19.1.0.
• Se agregó compatibilidad con el escalamiento de anuncios de banner adaptable.

Se compiló y probó con

• Versión 19.1.0 del SDK de anuncios de Google para dispositivos móviles
• Versión 2.0.21 del SDK de IMobile

Versión 2.0.20.2

• Se agregó compatibilidad con tamaños de anuncios de banner flexibles.
• Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 18.3.0.

Se compiló y probó con

• Versión 18.3.0 del SDK de anuncios de Google para dispositivos móviles
• SDK de IMobile versión 2.0.20.

Versión 2.0.20.1

• El adaptador ahora muestra una relación de aspecto mediaContent distinta de cero.

Se compiló y probó con

• Versión 18.2.0 del SDK de anuncios de Google para dispositivos móviles
• Versión 2.0.20 del SDK de IMobile

Versión 2.0.20.0

• Versión inicial
• Se agregó compatibilidad con anuncios intersticiales, nativos y de banner.