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
Lo más reciente de Google Mobile Ads SDK
Completar la guía de introducción a la mediació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.
Completa el formulario y haz clic en registro.
Toma nota del ID de la app.
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.
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.
Toma nota del ID de espacio.
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.
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.
Completa el formulario y haz clic en Guardar.
Toma nota de tu ID de clave de API y tu secreto de clave de API.
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:
En Xcode, navega a File > Add Package Dependencies….
En la instrucción que aparece, busca la siguiente URL del paquete:
https://github.com/googleads/googleads-mobile-ios-mediation-line.gitEn Dependency Rule, selecciona Branch.
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-updateIntegración manual
- Descarga la versión más reciente del SDK de LY Ads Network y vincula
FiveAd.frameworken 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.frameworken 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
ageRestrictedTreatmentdel 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.hno era un encabezado público. - Se habilitaron los parámetros
-fobjc-arcy-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.testModepara 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ó
CFBundleShortVersionStringpara 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.plisten los frameworks dentro deLineAdapter.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
GADMediationAdapterLineExtrasen 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ó
GADMediationAdapterLineAudioStatepara 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