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:

Integración
Ofertas
Cascada
Formatos
Banner
Intersticial
Recompensado
Nativo

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

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

Selecciona i-mobile y habilita el interruptor Optimizar. Ingresa el Login name and API Passwordque obtuviste en la sección anterior para configurar la optimización de la fuente del anuncio parai-mobile. Luego, ingresa un valor de eCPM para i-mobile y haz clic en Continuar.

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

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.

Campo Recursos que siempre incluye el adaptador 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 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:

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

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

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 de i-mobile en la IU de AdMob 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.

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.