Integra LY Ads Network con la mediación

Selecciona la plataforma: Android Nuevo Android iOS Unity Flutter

En esta guía, se muestra cómo usar Google Mobile Ads SDK 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 iOS.

Integraciones y formatos de anuncios admitidos

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

Integración
Ofertas
Cascada
Formatos
Banner
Intersticial
Recompensado
Nativo

Requisitos

  • Objetivo de implementación de iOS 13.3 o posterior

  • [Para la licitación]: Usar el adaptador de LY Ads Network 2.8.20240827.0 o una versión posterior (se recomienda la versión más reciente) para integrar todos los formatos de anuncios admitidos en la licitación

Paso 1: Establece los parámetros de configuración en la IU de LY Ads Network

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

Agrega una aplicación 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 registro.

Formulario de registro nuevo

Toma nota del ID de la app.

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

Agregar espacio

Completa el formulario con los detalles del espacio. En Bidding Type, selecciona Standard para configurar este espacio para la mediación en cascada o Google SDK Bidding para configurarlo para la licitación mediante SDK. Una vez que completes el formulario, haz clic en Crear.

Formulario para agregar espacio

Toma nota del ID de espacio.

Detalles de la ranura

Después de crear tu primer espacio, haz clic en 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 la red de LY Ads.

Solicitar revisión

Crea una clave de la API de Reporting

Navega a la pestaña Administrar claves de API de informes y haz clic en el botón Crear clave de API.

Pestaña Clave de API de Reporting

Completa el formulario y haz clic en Guardar.

Formulario de clave de API de informes

Toma nota de tu ID de clave de API y tu secreto de 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

Accede a tu cuenta de Ad Manager.

Agrega LY Ads Network en Empresas

Ofertas

Este paso no se requiere para las integraciones de la licitación.

Cascada

Navega a Admin > Companies y, luego, haz clic en el botón New company en la pestaña All companies. Selecciona Red de publicidad.

Selecciona LY Ads Network como la Red de publicidad, ingresa un Nombre único y habilita la Mediación. Activa la recopilación automática de datos y, luego, ingresa el ID de la clave de API y el secreto de la clave de API que obtuviste en la sección anterior.

No es necesario que ingreses un nombre de usuario ni una contraseña. Cuando termines, haz clic en Guardar.

Habilita el uso compartido de indicadores seguros

Ofertas

Navega a Administrador > Configuración global. Ve a la pestaña Configuración de la cuenta de Ad Exchange, revisa la opción Uso compartido de indicadores seguros y actívala. Haz clic en Guardar.

Cascada

Este paso no es obligatorio para las integraciones en cascada.

Comparte indicadores seguros en las solicitudes de oferta

Ofertas

Navega a Inventario > Indicadores seguros. En Indicadores seguros, busca LY Ads Network y activa Habilitar integración para apps.

Haz clic en Guardar.

Cascada

Este paso no es obligatorio para las integraciones en cascada.

Permite el uso compartido de indicadores seguros para la Licitación mediante SDK

Ofertas

Navega a Publicación > Configuración del canal de demanda. En la pestaña Configuración predeterminada, activa Permitir el uso compartido de indicadores seguros para Licitación mediante SDK.

Haz clic en Guardar.

Cascada

Este paso no es obligatorio para las integraciones en cascada.

Configura las ofertas de LY Ads Network

Ofertas

Navega a Publicación > Ofertantes y haz clic en Ir a la Licitación mediante SDK.

Haz clic en Nuevo ofertante.

Selecciona LY Ads Network como ofertante.

Haz clic en Continuar para habilitar la Licitación mediante SDK para este ofertante.

Haz clic en Listo.

Cascada

Este paso no es obligatorio para las integraciones en cascada.

Configura la asignación de unidades de anuncios

Ofertas

Navega a Publicación > Ofertantes y haz clic en Ir a la Licitación mediante SDK.

Selecciona la empresa para LY Ads Network.

Ve a la pestaña Asignación de unidades de anuncios y haz clic en Nueva asignación de unidad de anuncios.

Elige Unidad de anuncios específica. Selecciona una unidad de anuncios y un formato, Aplicación para dispositivos móviles como el Tipo de inventario y tu Aplicación para dispositivos móviles. Luego, ingresa el ID de aplicación y el ID de espacio que obtuviste en la sección anterior.

Por último, haz clic en Guardar.

Cascada

Navega a Publicación > Grupos de rendimiento y haz clic en el botón Nuevo grupo de rendimiento. Selecciona tu Inventario y tu App.

Desplázate hacia abajo y haz clic en Agregar socio de mediación.

Selecciona la empresa que creaste para LY Ads Network en la sección anterior. Elige Mediación del SDK para dispositivos móviles como el Tipo de integración, iOS como la Plataforma y Activo como el Estado.

Ingresa el ID de aplicación y el ID de espacio que obtuviste en la sección anterior, así como el valor del CPM predeterminado. Haz clic en Guardar.

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

Usa Swift Package Manager

Antes de continuar, debes tener la versión mínima compatible del adaptador 2.9.20251119.

Para agregar una dependencia de paquete a tu proyecto, sigue estos pasos:

  1. En Xcode, navega a File > Add Package Dependencies….

  2. En la instrucción que aparece, busca la siguiente URL del paquete:

    https://github.com/googleads/googleads-mobile-ios-mediation-line.git
    
  3. En Dependency Rule, selecciona Branch.

  4. En el campo de texto, ingresa main.

Usar CocoaPods

Agrega la siguiente línea al archivo Podfile de tu proyecto:

pod 'GoogleMobileAdsMediationLine'

Desde la línea de comandos, ejecuta lo siguiente:

pod install --repo-update

Integración manual

  • Descarga la versión más reciente del SDK de LY Ads Network y vincula FiveAd.framework en tu proyecto.
  • Descarga la versión más reciente del adaptador de LY Ads Network desde el vínculo de descarga en el registro de cambios y vincula LineAdapter.framework en tu proyecto.

Paso 4: Agrega el código requerido

Implementa 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 en Ad Manager.

El adaptador de LY Ads Network contiene un método de ayuda para habilitar el modo de prueba de LY Ads Network. Debes configurar esta opción antes de inicializar Google Mobile Ads SDK para garantizar que se reenvíen correctamente al SDK de LY Ads Network.

Swift

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

Objective-C

#import <LineAdapter/LineAdapter.h>
// ...

GADMediationAdapterLine.testMode = YES;

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 adaptador de LY Ads Network admite un parámetro de solicitud adicional que se puede pasar al adaptador con la clase GADMediationAdapterLineExtras. Esta clase incluye las siguientes propiedades:

adAudio
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:

Swift

import LineAdapter
// ...

let request = GAMRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

Objective-C

#import <LineAdapter/LineAdapter.h>
// ...

GAMRequest *request = [GAMRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

Uso de anuncios nativos

Renderización de anuncios

El adaptador de LY Ads Network completa los siguientes campos para un GADNativeAd.

Campo Recursos que siempre incluye el adaptador de LY Ads Network
Título
Imagen
Cuerpo
Ícono de la app 1
Llamado a la acción
Calificación por estrellas
Tienda
Precio

1 En el caso de los anuncios nativos, el SDK de LY Ads Network 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 LY Ads Network, puedes verificar el error subyacente en la respuesta de solicitud de anuncio con GADResponseInfo.adNetworkInfoArray en las siguientes clases:

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:

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 del 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 el anuncio nativo.

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

Versión 3.0.1.2

  • Se actualizó la versión mínima de iOS para relajar la dependencia del SDK de anuncios de Google para dispositivos móviles y permitir versiones secundarias.
  • Se corrigió un problema por el que el ícono de AdChoices para los anuncios nativos era demasiado grande.

Se compiló y probó con lo siguiente:

  • Versión 13.4.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 3.0.1 del SDK de FiveAd

Versión 3.0.1.1

  • Ahora el adaptador reenvía el parámetro ageRestrictedTreatment del SDK de anuncios de Google para dispositivos móviles a la API de la COPPA del SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 13.3.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 3.0.1 del SDK de FiveAd

Versión 3.0.1.0

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

Se compiló y probó con lo siguiente:

  • Versión 13.1.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 3.0.1 del SDK de FiveAd

Versión 3.0.0.1

  • Se actualizó la dependencia del SDK de anuncios de Google para dispositivos móviles a la versión 13.0.0.

Se compiló y probó con lo siguiente:

  • Versión 13.0.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 3.0.0 del SDK de FiveAd

Versión 3.0.0.0

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

Se compiló y probó con lo siguiente:

  • Versión 12.14.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 3.0.0 del SDK de FiveAd

Versión 2.9.20251119.1

  • Se agregó compatibilidad para reenviar los parámetros tagForUnderAgeOfConsent del SDK de anuncios de Google para dispositivos móviles al SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 12.14.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.9.20251119 del SDK de FiveAd

Versión 2.9.20251119.0

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

Se compiló y probó con lo siguiente:

  • Versión 12.14.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.9.20251119 del SDK de FiveAd

Versión 2.9.20250930.0

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

Se compiló y probó con lo siguiente:

  • Versión 12.12.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.9.20250930 del SDK de FiveAd

Versión 2.9.20250912.0

  • Ahora el adaptador inicializa el SDK de FiveAd antes de cada solicitud de anuncio.
  • Se verificó la compatibilidad con la versión 2.9.20250912 del SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 12.11.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.9.20250912 del SDK de FiveAd

Versión 2.9.20250512.0

  • Ahora requiere la versión mínima de iOS 13.0.
  • Se verificó la compatibilidad con la versión 2.9.20250512 del SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 12.4.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.9.20250512 del SDK de FiveAd

Versión 2.9.20241106.3

  • Se corrigió un problema por el que GADMediationAdapterLine.h no era un encabezado público.
  • Se habilitaron los parámetros -fobjc-arc y -fstack-protector-all.
  • Se quitó la verificación del tamaño del anuncio de banner para las ofertas después de la carga correcta.
    • Los anuncios de banner en cascada seguirán verificando los tamaños de los anuncios de banner después de que se carguen correctamente.

Se compiló y probó con lo siguiente:

  • Versión 12.2.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.9.20241106 del SDK de FiveAd

Versión 2.9.20241106.2

  • Se agregó la propiedad GADMediationAdapterLine.testMode para indicar si el SDK de FiveAd se debe inicializar en modo de prueba. Este parámetro debe establecerse antes de inicializar el SDK de anuncios de Google para dispositivos móviles.
  • Se quitó la verificación del estado de inicialización del SDK de FiveAd antes de inicializarlo.
  • Se quitó la verificación del estado del anuncio nativo que dejó de estar disponible antes de descargar los recursos del anuncio nativo.
  • Ahora se requiere la versión 12.0.0 o una posterior del SDK de anuncios de Google para dispositivos móviles.

Se compiló y probó con lo siguiente:

  • Versión 12.0.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.9.20241106 del SDK de FiveAd

Versión 2.9.20241106.1

  • Se actualizó el adaptador para usar la API de carga de anuncios más reciente para los anuncios de banner de licitación.
  • Se corrigió un problema que impedía que los eventos de anuncios se reenvíen correctamente para las ofertas de anuncios intersticiales.

Se compiló y probó con lo siguiente:

  • Versión 11.12.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.9.20241106 del SDK de FiveAd

Versión 2.9.20241106.0

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

Se compiló y probó con lo siguiente:

  • Versión 11.12.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.9.20241106 del SDK de FiveAd

Versión 2.8.20240827.1

  • Se actualizó CFBundleShortVersionString para que tenga tres componentes en lugar de cuatro.

Se compiló y probó con lo siguiente:

  • Versión 11.10.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.8.20240827 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 agregó compatibilidad de la licitación con los formatos de anuncios de banner, intersticiales, recompensados y nativos.

Se compiló y probó con lo siguiente:

  • Versión 11.8.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.8.20240827 del SDK de FiveAd

Versión 2.8.20240612.0

  • Se agregó el control de audio para el anuncio nativo a través de GADVideoOptions.
  • Se verificó la compatibilidad con la versión 2.8.20240612 del SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 11.5.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.8.20240612 del SDK de FiveAd

Versión 2.7.20240411.0

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

Se compiló y probó con lo siguiente:

  • Versión 11.3.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.7.20240411 del SDK de FiveAd

Versión 2.7.20240318.0

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

Se compiló y probó con lo siguiente:

  • Versión 11.2.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.7.20240318 del SDK de FiveAd

Versión 2.7.20240214.1

  • Ahora se requiere la versión mínima de iOS 12.0.
  • Ahora se requiere la versión 11.0 o una posterior del SDK de anuncios de Google para dispositivos móviles.
  • Se incluye Info.plist en los frameworks dentro de LineAdapter.xcframework.

Se compiló y probó con lo siguiente:

  • Versión 11.0.1 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.7.20240214 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 11.0.1 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.7.20240214 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 actualizó la implementación del adaptador con los nuevos protocolos de delegado del SDK de FiveAd.

Se compiló y probó con lo siguiente:

  • Versión 10.14.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.7.20240126 del SDK de FiveAd

Versión 2.7.20231115.0

  • Se verificó la compatibilidad con la versión 2.7.20231115 del SDK de FiveAd.
  • Se incluye el encabezado GADMediationAdapterLineExtras en el archivo modulemap.

Se compiló y probó con lo siguiente:

  • Versión 10.14.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.7.20231115 del SDK de FiveAd

Versión 2.6.20230609.1

  • Se agregó GADMediationAdapterLineAudioState para administrar el estado de audio inicial del anuncio de banner, intersticial y recompensado cuando se muestra por primera vez.

Se compiló y probó con lo siguiente:

  • Versión 10.14.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.6.20230609 del SDK de FiveAd

Versión 2.6.20230609.0

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

Se compiló y probó con lo siguiente:

  • Versión 10.9.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 2.6.20230609 del SDK de FiveAd