Integra LY Ads Network con la mediación

Selecciona la plataforma: Android Nuevo Android iOS Unity Flutter

En esta guía, se explica cómo usar Google Mobile Ads Flutter Plugin para cargar y mostrar anuncios de LY Ads Network con la mediación, lo que incluye las integraciones en cascada. Además, indica cómo agregar LY Ads Network a la configuración de mediación de una unidad de anuncios y cómo integrar el SDK y el adaptador de LY Ads Network en una app para Flutter.

Integraciones y formatos de anuncios admitidos

El adaptador de mediación de Ad Manager para LY Ads Network ofrece las siguientes funciones:

Integración
Ofertas
Cascada
Formatos
Banner
Intersticial
Recompensado
Nativo

Requisitos

  • La versión más reciente Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 o una versión posterior
  • Para implementar en Android, se requiere lo siguiente:
    • API de Android nivel 23 o superior
  • Para implementar en iOS, se requiere lo siguiente:
    • Objetivo de implementación de iOS 13.3 o posterior
  • Un proyecto de Flutter en funcionamiento configurado con Google Mobile Ads Flutter Plugin (consulta Configura Google Mobile Ads Flutter Plugin para obtener más detalles)
  • Configurar la mediación.

Paso 1: Establece la configuración en la IU de LY Ads Network

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

Agrega una app nueva

Navega a la pestaña App y haz clic en el botón New registration.

Nuevo registro

Completa el formulario y haz clic en registration.

Formulario de registro nuevo

Toma nota del ID de app.

Android

Detalles de registro

iOS

Detalles de registro

Crea un espacio publicitario

En la pestaña App, selecciona tu app para ver sus detalles. En la sección Slot, haz clic en Add.

Agregar espacio

Completa el formulario con los detalles del espacio. En Bidding Type (Tipo de ofertas), selecciona Standard (Estándar) para configurar este espacio para la mediación en cascada o Google SDK Bidding (Licitación mediante SDK de Google) para configurarlo para la licitación. Haz clic en Create (Crear) una vez que completes el formulario.

Formulario para agregar espacio

Toma nota del ID de espacio.

Detalles de la ranura

Después de crear tu primer espacio, haz clic en Review (Revisar) en la página de detalles de tu app para obtener la aprobación de LY Ads Network. Esto puede tardar un poco. Si tienes alguna pregunta, comunícate con tu representante de LY Ads Network.

Solicitar revisión

Crea una clave de API de informes

Navega a la pestaña Managing reporting API keys (Administración de claves de API de informes) y haz clic en el botón Create API key (Crear clave de API).

Pestaña Clave de API de Reporting

Completa el formulario y haz clic en Save.

Formulario de clave de API de informes

Toma nota de tu ID de clave de API y el secreto de la clave de API.

Formulario de clave de API de informes

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 aún no lo hiciste, crea un archivo app-ads.txt para Ad Manager.

Para implementar app-ads.txt en LY Ads Network, consulta la información sobre app-ads.txt.

Paso 2: Configura la demanda de LY Ads Network en la IU de Ad Manager

Configura los parámetros de la 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 LY Ads Network

Integración a través de pub.dev

Agrega la siguiente dependencia con las versiones más recientes del SDK y el adaptador de LY Ads Network en el archivo pubspec.yaml de tu paquete:

dependencies:
  gma_mediation_line: ^2.1.0

Integración manual

Descarga la versión más reciente del complemento de mediación de anuncios de Google para dispositivos móviles para LY Ads Network, extrae el archivo descargado y agrega la carpeta del complemento extraído (y su contenido) a tu proyecto de Flutter. Luego, haz referencia al complemento en tu archivo pubspec.yaml agregando la siguiente dependencia:

dependencies:
  gma_mediation_line:
    path: path/to/local/package

Paso 4: Agrega el código requerido

Android

No se requiere ningún código adicional para la integración de LY Ads Network.

iOS

Integración de SKAdNetwork

Sigue la documentación de LY Ads Network 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.

Verifica los anuncios de prueba

Para verificar que recibes anuncios de prueba de LY Ads Network, habilita la prueba de una única fuente de anuncios seleccionando LY Ads Network en el inspector de anuncios.

Pasos opcionales

Parámetros específicos de la red

El complemento de mediación de Flutter de LY Ads Network admite el siguiente parámetro de solicitud adicional que se puede pasar al adaptador a través de la clase LineMediationExtras:

  • enableAdSound : Especifica 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 esos parámetros:

LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [lineExtras],
);

Códigos de error

Si el adaptador no recibe un anuncio de LY Ads Network, los publicadores pueden verificar el error subyacente en la respuesta de solicitud de anuncio con ResponseInfo en las siguientes clases:

Android

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

iOS

GADMediationAdapterLine

A continuación, se indican los códigos y los correspondientes mensajes que arroja el adaptador de LY Ads Network cuando se produce un error al cargar un anuncio:

Android

Código de error Dominio Motivo
1-10 com.five_corp.ad El SDK de LY Ads Network devolvió un error específico del SDK. Consulta la documentación de LY Ads Network para obtener más detalles.
101 com.google.ads.mediation.line Falta el ID de aplicación o no es válido.
102 com.google.ads.mediation.line Falta el ID de espacio 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 LY Ads Network.
104 com.google.ads.mediation.line No se pudo cargar un anuncio intersticial o recompensado debido a un contexto de actividad faltante.
105 com.google.ads.mediation.line El SDK de LY 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 recursos faltantes.

iOS

Código de error Dominio Motivo
1-10 Enviado por el SDK de LY Ads Network El SDK de LY Ads Network devolvió un error específico del SDK. Consulta la documentación de LY Ads Network para obtener más detalles.
101 com.google.ads.mediation.line Parámetros del servidor no válidos (p.ej., falta el ID de aplicación o el ID de espacio).
102 com.google.ads.mediation.line El tamaño de anuncio solicitado no coincide con un tamaño de anuncio de banner admitido por LY Ads Network.
103 com.google.ads.mediation.line No se pudo cargar un recurso de imagen de ícono de información en un anuncio nativo.

Registro de cambios del adaptador de mediación de Line para Flutter

Versión 2.1.1 (en curso)

Versión 2.1.0

  • Se actualizó la versión mínima de Flutter a 3.38.1.
  • Se actualizó para admitir la versión 8.0.0 del Complemento de Flutter para anuncios de Google para dispositivos móviles.
  • Se admite la versión 3.1.0.0 del adaptador de Line para Android.
  • Se admite la versión 3.0.1.0 del adaptador de Line para iOS .
  • Se compiló y probó con la versión 8.0.0 del complemento de anuncios de Google para dispositivos móviles para Flutter.

Versión 2.0.0

  • Se actualizó la versión mínima de Flutter a 3.35.1.
  • Se actualizó para admitir la versión 7.0.0 del Complemento de Flutter para anuncios de Google para dispositivos móviles.
  • Se admite la versión 3.0.1.0 del adaptador de Line para Android.
  • Se admite la versión 3.0.0.0 del adaptador de Line para iOS.
  • Se compiló y probó con la versión 7.0.0 del Complemento de Flutter para anuncios de Google para dispositivos móviles.

Versión 1.0.6

Versión 1.0.5

Versión 1.0.4

  • Se admite la versión 2.9.20250718.0 del adaptador de Line para Android.
  • Se admite la versión 2.9.20250512.0 del adaptador de Line para iOS .
  • Se compiló y probó con la versión 6.0.0 del Complemento de Flutter para anuncios de Google para dispositivos móviles.

Versión 1.0.3

  • Se admite la versión 2.9.20250519.0 del adaptador de Line para Android.
  • Se admite la versión 2.9.20250512.0 del adaptador de Line para iOS .
  • Se compiló y probó con la versión 6.0.0 del Complemento de Flutter para anuncios de Google para dispositivos móviles.

Versión 1.0.2

Versión 1.0.1

Versión 1.0.0

  • Versión inicial
  • Se admite la versión 2.9.20250110.0 del adaptador de Line para Android.
  • Se admite la versión 2.9.20241106.1 del adaptador de Line para iOS.
  • Se compiló y probó con la versión 5.3.1 del Complemento de Flutter para anuncios de Google para dispositivos móviles.