Integra LY Ads Network con la mediación

Selecciona la plataforma: Android iOS Unity Flutter Android (heredada)

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

Integraciones y formatos de anuncios admitidos

El adaptador de mediación de Ad Manager para LY Ads Network tiene las siguientes capacidades:

Integración
Ofertas
Cascada
Formatos
Banner
Intersticial
Recompensado

Requisitos previos

Antes de continuar, verifica lo siguiente:

  • Es la versión más reciente de Google Mobile Ads Unity Plugin.
  • Unity Editor versión 4 o posterior
  • [Para la licitación]: Usar el complemento de mediación de Google Mobile Ads para la red de publicidad de LY Ads 1.5.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
  • Para realizar la implementación en Android:
    • Nivel de API 24 o posterior de Android
  • Para realizar la implementación en iOS:
    • Objetivo de implementación de iOS 13.0 o posterior
  • Un proyecto de Unity en funcionamiento configurado con Google Mobile Ads Unity Plugin. Consulta Configura Google Mobile Ads Unity Plugin para obtener más detalles
  • Configurar 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.

    Nuevo registro

    Completa el formulario y haz clic en registration.

    Nuevo formulario de registro

    Toma nota del ID de la app.

    Android

    Detalles de registro

    iOS

    Detalles de registro

    Cómo crear un espacio publicitario

    En la pestaña App, selecciona tu app para ver sus detalles. En la sección Espacio, 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 un 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 LY Ads Network.

    Solicitar revisión

    Crea una clave de 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 informes

    Completa el formulario y haz clic en Guardar.

    Formulario de clave de API de Reporting

    Toma nota de tu ID de clave de API y del secreto de clave de API.

    Formulario de clave de API de Reporting

    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 la red de publicidad de LY

    OpenUPM-CLI

    Si tienes instalada la CLI de OpenUPM, puedes instalar el complemento de mediación de redes de publicidad de LY Ads de Google Mobile Ads para Unity en tu proyecto ejecutando el siguiente comando desde el directorio raíz del proyecto:

    openupm add com.google.ads.mobile.mediation.line

    OpenUPM

    En el editor de proyectos de Unity, selecciona Edit > Configuración del proyecto > Package Manager para abrir la configuración del Administrador de paquetes de Unity.

    En la pestaña Scoped Registries, agrega OpenUPM como un registro con permisos con los siguientes detalles:

    • Nombre: OpenUPM
    • URL: https://package.openupm.com
    • Permisos: com.google

    Detalles de OpenUPM

    Luego, navega a Window > Package Manager para abrir el Administrador de paquetes de Unity y selecciona My Registries en el menú desplegable.

    Registros de Unity

    Selecciona el paquete Google Mobile Ads Line Mediation y haz clic en Install.

    Cómo instalar el paquete desde OpenUPM

    Paquete de Unity

    Descarga la versión más reciente del complemento de mediación de anuncios de Google para dispositivos móviles para LY Ads Network desde el vínculo de descarga que se encuentra en el registro de cambios y extrae el archivo GoogleMobileAdsLineMediation.unitypackage del archivo ZIP.

    En el editor de proyectos de Unity, selecciona Assets > Import Package > Custom Package y busca el archivo GoogleMobileAdsLineMediation.unitypackage que descargaste. Asegúrate de que todos los archivos estén seleccionados y haz clic en Importar.

    Importar desde Unity

    Luego, selecciona Assets > External Dependency Manager > Android Resolver > Force Resolve. La biblioteca de External Dependency Manager realizará la resolución de dependencias desde cero y copiará las dependencias declaradas en el directorio Assets/Plugins/Android de tu app de Unity.

    Forzar resolución

    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 la red de publicidad 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.

    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 Unity para LY Ads Network admite el siguiente parámetro de solicitud adicional que se puede pasar al adaptador a través de la clase LineMediationExtras:

    • SetEnableAdSound(boolean) : 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:

    using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...

var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(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 la red de publicidad de LY 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 la red de publicidad de LY.
    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.
    107 com.google.ads.mediation.line El SDK de FiveAd devolvió un cargador de anuncios nulo.

    iOS

    Código de error Dominio Motivo
    1-10 Enviado por el SDK de la red de publicidad de LY El SDK de la red de publicidad de LY 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 el anuncio nativo.
    104 com.google.ads.mediation.line No se pudieron recopilar los indicadores para la licitación.
    105 com.google.ads.mediation.line No se pudo inicializar el cargador de anuncios del SDK de LINE Ads.

    Registro de cambios del complemento de mediación de Line para Unity

    Versión 2.2.1

    Versión 2.2.0

    Versión 2.1.1

    Versión 2.1.0

    Versión 2.0.2

    Versión 2.0.1

    Versión 2.0.0

    Versión 1.5.10

    Versión 1.5.9

    Versión 1.5.8

    Versión 1.5.7

    Versión 1.5.6

    Versión 1.5.5

    • Se solucionó un problema por el que la instalación a través de OpenUPM causaba que el complemento no importara los paquetes correctamente.

    Versión 1.5.4

    Versión 1.5.3

    Versión 1.5.2

    Versión 1.5.1

    Versión 1.5.0

    Versión 1.4.0

    Versión 1.3.1

    Versión 1.3.0

    Versión 1.2.0

    Versión 1.1.2

    Versión 1.1.1

    Versión 1.1.0

    Versión 1.0.0