Cómo integrar la red de publicidad de LINE con la mediación

En esta guía, se muestra cómo usar el SDK de anuncios de Google Mobile Ads para cargar y mostrar anuncios de LINE Ads Network con la Mediación de AdMob, y se abarcan las integraciones en cascada. En este documento, se explica cómo agregar LINE Ads Network a la configuración de mediación de un bloque de anuncios y cómo integrar el SDK y el adaptador de LINE Ads Network en una app para Android.

La interfaz del panel de LINE Ads Network 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 LINE Ads Network tiene las siguientes capacidades:

Integración
Ofertas  1
Cascada
Formatos
Banner
Intersticial
Recompensado
Nativo

1 La integración de ofertas está en versión beta cerrada. Comunícate con tu administrador de cuentas para solicitar acceso.

Requisitos

  • Nivel de API de Android 23 o posterior
  • SDK de anuncios de Google para dispositivos móviles más reciente

  • Completa la guía de introducción de la mediación.

Paso 1: Configura los parámetros en la IU de LINE Ads Network

Regístrate y accede a tu cuenta de LINE Ads Network.

Cómo agregar una aplicación nueva

Haz clic en 広告枠管理 (Administración de espacios publicitarios) > メディア (Medios). Luego, haz clic en 新規作成 (Crear nuevo).

Completa el formulario y haz clic en 登録 (Registrar).

Toma nota del ID de la aplicación.

Crea una posición de anuncios

Haz clic en el ID de la aplicación a la que deseas agregar una posición del anuncio. Luego, selecciona 詳細 (Detalle).

Haz clic en スロット 追加 (Add Slot).

Completa el formulario para obtener detalles sobre el horario. En Tipo de licitación, selecciona Estándar para configurar este espacio para la mediación en cascada o Licitación mediante el SDK de Google para configurar este espacio para la Licitación. Haz clic en 登録 (Registrar) una vez que completes el formulario.

Toma nota del ID de ranura.

Actualiza tu archivo app-ads.txt

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

Para implementar app-ads.txt en LINE Ads Network, consulta Acerca de app-ads.txt.

Paso 2: Configura la demanda de la Red de anuncios de LINE en la IU de AdMob

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

Debes agregar LINE Ads Network a la configuración de mediación de tu bloque de anuncios.

Primero, 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 avanza a Cómo agregar LINE Ads Network como fuente de anuncios.

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

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

Asigna un nombre a tu grupo de mediación y selecciona las ubicaciones a las que deseas segmentar tus anuncios. A continuación, establece el estado del grupo de mediación como Habilitado y, luego, haz clic en Agregar bloques 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 LINE Ads Network como fuente del anuncio

Ofertas

En la tarjeta Ofertas de la sección Fuentes de anuncios, selecciona Agregar fuente de anuncios. Luego, selecciona LINE Ads Network.

Haz clic en Cómo firmar un acuerdo de asociación y configura una asociación de licitación con LINE Ads Network.



Haz clic en Aceptar y continuar y, luego, en Continuar.



Si ya tienes una asignación para LINE Ads Network, puedes seleccionarla. De lo contrario, haz clic en Agregar asignación.



A continuación, ingresa el ID de la aplicación y el ID de la ranura que obtuviste en la sección anterior. Luego, haz clic en Listo.



Cascada


En la tarjeta Cascada de la sección Fuentes de anuncios, selecciona Agregar fuente de anuncios.

Selecciona LINE Ads Network y habilita el interruptor Optimizar. Ingresa el Nombre de acceso y la Contraseña que obtuviste en la sección anterior para configurar la optimización de la fuente de anuncios para LINE Ads Network. Luego, ingresa un valor de eCPM para la red de LINE Ads y haz clic en Continuar.



Si ya tienes una asignación para la red de LINE Ads, puedes seleccionarla. De lo contrario, haz clic en Agregar asignación.

A continuación, ingresa el ID de la aplicación y el ID de la ranura que obtuviste en la sección anterior. Luego, haz clic en Listo.


Paso 3: Importa el SDK y el adaptador de LINE Ads Network

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 LINE Ads Network:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.4.0")
    implementation("com.google.ads.mediation:line:2.9.20250519.0")
}

Integración manual

  1. Descarga la versión más reciente del archivo .aar del SDK de la red de anuncios de LINE y agrégalo a tu proyecto.

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

Paso 4: Agrega el código requerido

No se requiere código adicional para la integración de LINE Ads Network.

Paso 5: Prueba tu implementación

Habilita los anuncios de prueba

Asegúrate de registrar tu dispositivo de prueba en AdMob.

Verifica los anuncios de prueba

Para verificar que recibes anuncios de prueba de la red de LINE Ads, habilita la prueba de fuente del anuncio individual en el inspector de anuncios con las fuentes del anuncio de LINE Ads Network (cascada).

Pasos opcionales

Parámetros específicos de la red

El adaptador de LINE Ads Network admite un parámetro de solicitud adicional que se puede pasar al adaptador con la clase LineExtras. El constructor de esta clase incluye los siguientes parámetros:

enableAdSound
Un boolean para especificar el estado de inicio de sonido predeterminado de los anuncios de banner, intersticiales y recompensados.

A continuación, se muestra un ejemplo de código para crear una solicitud de anuncio que establezca estos parámetros:

Java

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

AdRequest request = new AdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter.class, extras)
   .build();

Kotlin

val lineExtras = LineExtras(true)
val extras = lineExtras.build()

val request = AdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
   .build()

Cómo usar anuncios nativos

Renderización de anuncios

El adaptador de la red de LINE Ads completa las siguientes descripciones de los campos avanzados de los anuncios nativos para un NativeAd.

Campo Recursos que siempre incluye el adaptador de LINE Ads Network
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 LINE Ads Network no proporciona un recurso de ícono de la app. En cambio, el adaptador de la red de LINE Ads completa el ícono de la app con una imagen transparente.

Códigos de error

Si el adaptador no recibe un anuncio de LINE Ads Network, puedes verificar el error subyacente en la respuesta del anuncio con ResponseInfo.getAdapterResponses() en las siguientes clases:

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

A continuación, se indican los códigos y los mensajes correspondientes que arroja el adaptador de la red de LINE Ads cuando no se carga un anuncio:

Código de error Dominio Motivo
1-10 com.five_corp.ad El SDK de la red de anuncios de LINE devolvió un error específico del SDK. Consulta la documentación de la Red de Anuncios de LINE para obtener más detalles.
101 com.google.ads.mediation.line Falta el ID de la aplicación o no es válido.
102 com.google.ads.mediation.line Falta el ID de ranura o no es válido.
103 com.google.ads.mediation.line El tamaño de anuncio solicitado no coincide con un tamaño de anuncio de banner admitido por la Red de LINE Ads.
104 com.google.ads.mediation.line No se pudo cargar un anuncio intersticial o recompensado debido a que falta el contexto de la actividad.
105 com.google.ads.mediation.line El SDK de LINE Ads Network no pudo mostrar un anuncio intersticial o recompensado.
106 com.google.ads.mediation.line No se pudo cargar un anuncio nativo debido a que faltan recursos.

Registro de cambios del adaptador de mediación de LINE para Android

Versión 2.9.20250718.0 (en curso)

Versión 2.9.20250519.0

  • Se verificó la compatibilidad con la versión 2.9.20250519 del SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 24.3.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.9.20250519.0 del SDK de FiveAd.

Versión 2.9.20250317.1

  • Se corrigieron las dimensiones de carga de los banners para los anuncios de ofertas con la nueva API de FiveAd

Se compiló y probó con lo siguiente:

  • Versión 24.1.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.9.20250317.0 del SDK de FiveAd

Versión 2.9.20250317.0

  • Se verificó la compatibilidad con la versión 2.9.20250317 del SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 24.1.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.9.20250317.0 del SDK de FiveAd

Versión 2.9.20250110.1

  • Se actualizó el nivel de API de Android mínimo requerido a 23.
  • Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 24.0.0.

Se compiló y probó con lo siguiente:

  • Versión 24.0.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.9.20250110.0 del SDK de FiveAd

Versión 2.9.20250110.0

  • Se quitó la clase UnifiedNativeAdMapper obsoleta y se reemplazó por NativeAdMapper.
  • Se corrigió el proceso de recopilación de indicadores.
  • Se corrigió el proceso de inicialización para los formatos de anuncios intersticiales y recompensados en cascada.
  • Se verificó la compatibilidad con la versión 2.9.20250110 del SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 23.6.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.9.20250110.0 del SDK de FiveAd

Versión 2.9.20241129.0

  • Se agregó compatibilidad con las ofertas para los formatos de anuncios de banner, intersticiales, recompensados y nativos.
  • Se verificó la compatibilidad con la versión 2.9.20241129 del SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 23.5.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.9.20241129.0 del SDK de FiveAd

Versión 2.8.20240827.0

  • Se verificó la compatibilidad con la versión 2.8.20240827 del SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 23.3.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.8.20240827.0 del SDK de FiveAd

Versión 2.8.20240808.0

  • Se verificó la compatibilidad con la versión 2.8.20240808 del SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 23.2.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.8.20240808.0 del SDK de FiveAd

Versión 2.8.20240722.0

  • Se verificó la compatibilidad con la versión 2.8.20240722 del SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 23.2.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.8.20240722.0 del SDK de FiveAd

Versión 2.7.20240515.0

  • Se verificó la compatibilidad con la versión 2.7.20240515 del SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 23.1.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.7.20240515.0 del SDK de FiveAd

Versión 2.7.20240214.1

  • 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 la versión 2.7.20240214 del SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 23.0.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.7.20240214.0 del SDK de FiveAd.

Versión 2.7.20240214.0

  • Se verificó la compatibilidad con la versión 2.7.20240214 del SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 22.6.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.7.20240214.0 del SDK de FiveAd.

Versión 2.7.20240126.0

  • Se verificó la compatibilidad con la versión 2.7.20240126 del SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 22.6.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.7.20240126.0 del SDK de FiveAd.

Versión 2.7.20240112.0

  • Se quitó FiveAdViewEventListener, que dejó de estar disponible, y se reemplazó por FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener y FiveAdNativeEventListener.
  • Se verificó la compatibilidad con la versión 2.7.20240112 del SDK de FiveAd.
  • Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 22.6.0.

Se compiló y probó con lo siguiente:

  • Versión 22.6.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.7.20240112 del SDK de FiveAd.

Versión 2.6.20230607.1

  • Se agregó la clase LineExtras para que los publicadores definan la configuración de sonido predeterminada para los formatos de anuncios de banner, intersticiales y recompensados.
  • Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 22.4.0.

Se compiló y probó con lo siguiente:

  • Versión 22.4.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.6.20230607 del SDK de FiveAd.

Versión 2.6.20230607.0

  • Versión inicial
  • Se agregó compatibilidad con los formatos de anuncios de banner, intersticiales, recompensados y nativos.
  • Se verificó la compatibilidad con la versión 2.6.20230607 del SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 22.1.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.6.20230607 del SDK de FiveAd.