Integra i-mobile con la mediación

Selecciona la plataforma: Android (beta) Android iOS Unity Flutter

En esta guía, se explica cómo usar GMA Next-Gen SDK para cargar y mostrar anuncios de i-mobile con la Mediación de AdMob, lo que incluye las integraciones en cascada. Además, indica 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 Android.

La interfaz del panel de i-mobile usa texto en japonés para sus etiquetas, botones y descripciones. Las capturas de pantalla de esta guía no están traducidas. Sin embargo, en las descripciones y las instrucciones de esta guía, las etiquetas y los botones se incluyen junto con su traducción en español entre paréntesis.

Integraciones y formatos de anuncios admitidos

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

Requisitos

• Nivel de API 24 o posterior de Android

• La versión más reciente GMA Next-Gen SDK

• Completar la guía de introducción de la mediación Get started guide

Paso 1: Configura los parámetros en 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 サイト／アプリ管理 (Administración de sitios o aplicaciones) 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 espacio publicitario nuevo, selecciona tu app en la pestaña サイト／アプリ管理 (Administración de sitios o aplicaciones).

Navega a la pestaña 広告スポット管理 (Administración de espacios publicitarios) y haz clic en el botón 新規広告スポット (Nuevo espacio publicitario).

A continuación, completa el formulario con el nombre del espacio publicitario (Ad Spot name), tamaño del espacio publicitario (Ad Spot size) y otros detalles. Luego, haz clic en el botón 新規登録 (Registrarse).

Tu nuevo espacio publicitario está listo. Para ver los detalles de la integración, haz clic en el botón アプリ設定取得 (Obtener la configuración de la app).

Toma nota del ID de publicador (Publisher ID), el ID de medio (Media ID), y el ID de espacio (Spot ID). Necesitarás estos parámetros más adelante cuando configures i-mobile para la mediación en la IU de AdMob.

Actualiza tu archivo app-ads.txt

El archivo app-ads.txt de Authorized Sellers for Apps es una iniciativa de IAB Tech Lab que ayuda a garantizar que tu inventario de anuncios de aplicación solo se venda a través de los canales que identificaste como autorizados. Para evitar pérdidas significativas en los ingresos publicitarios, deberás implementar un archivo app-ads.txt. Si todavía no lo hiciste, configura un archivo app-ads.txt para tu app.

Para implementar app-ads.txt para i-mobile, consulta sus Preguntas frecuentes.

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

Configura los parámetros de la mediación para tu unidad de anuncios

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

En primer lugar, accede a tu cuenta de AdMob. A continuación, navega a la pestaña Mediación. Si tienes un grupo de mediación existente que deseas modificar, haz clic en su nombre para editarlo y pasa directamente a la sección Agrega i-mobile como una fuente de anuncios.

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

Ingresa el formato de anuncios y la plataforma. Luego, haz clic en Continuar.

Asigna un nombre a tu grupo de mediación y selecciona las ubicaciones de segmentación. A continuación, establece el estado del grupo de mediación como Habilitado y haz clic en Agregar unidades de anuncios.

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

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

Agrega i-mobile como una fuente de anuncios

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

Integración de Android Studio (recomendada)

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

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

En el archivo gradle a nivel de la app, agrega las dependencias de implementación y las configuraciones que se indican a continuación:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:imobile:2.3.2.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:imobile:2.3.2.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integración manual

1. Descarga la última versión del SDK de i-mobile y extrae el android-ad-sdk.aar de la carpeta sdk y agrégalo a tu proyecto.

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

Paso 4: Agrega el código requerido

Carga el anuncio con el contexto de actividad

Pasa el contexto de Activity cuando cargues los formatos de anuncios de banner, intersticial, recompensado y nativo.Sin el contexto de actividad, la carga del anuncio fallará.

Paso 5: Prueba tu implementación

Habilita los anuncios de prueba

Asegúrate de registrar tu dispositivo de prueba para AdMob. i-mobile proporciona el ID de espacio, el ID de medio, y el ID 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 una única fuente de anuncios seleccionando i-mobile (cascada) en el inspector de anuncios.

Pasos opcionales

Uso de anuncios nativos

Renderización de anuncios

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

¹ En el caso de los anuncios nativos, el SDK de i-mobile no proporciona un recurso de ícono de la app, sino que lo completa 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 en la respuesta de solicitud de anuncio con ResponseInfo.getAdSourceResponses() en las siguientes clases:

A continuación, se indican los códigos y los mensajes correspondientes que arroja el adaptador de i-mobile cuando no se carga un anuncio: