En esta guía, se muestra cómo usar el SDK de Google Mobile Ads para cargar y mostrar anuncios de la red de anuncios de LINE mediante mediación, lo que abarca las integraciones en cascada. En él, se explica cómo agregar LINE Ads Network a la configuración de mediación de una unidad de anuncios y cómo integrar el SDK y el adaptador de LINE Ads Network en una app para Unity.
Integraciones y formatos de anuncios admitidos
El adaptador de mediación Ad Manager para la red de anuncios de LINE tiene las siguientes funciones:
Integración | |
---|---|
Ofertas | |
Cascada | 1 |
Formatos | |
Banner | |
Intersticial | |
Recompensado |
1 La integración en cascada está en versión beta cerrada. Comunícate con tu administrador de cuentas para solicitar acceso.
Requisitos
- Unity 4 o versiones posteriores
- SDK de anuncios de Google para dispositivos móviles más reciente
- Para implementar en Android, haz lo siguiente:
- Android con nivel de API 21 o superior
- Para implementar en iOS:
- Objetivo de implementación de iOS 12.0 o una versión posterior
- Un proyecto de Unity en funcionamiento configurado con el SDK de anuncios de Google para dispositivos móviles Consulta Cómo comenzar para obtener más información.
- Completa la guía de introducción de mediación.
Paso 1: Configura la IU de Line
Accede a tu cuenta de la red de publicidad de LINE.
Agrega una nueva aplicación
Haz clic en 広告枠管理 (Ad Slot Management) > メディア (Media). Luego, haz clic en 新規作成 (Crear nuevo).
Completa el formulario y haz clic en 登録 (Registrar).
Toma nota del ID de 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 de anuncios. Luego, selecciona 詳細 (Detalle).
Haz clic en スロット 追加 (Add Slot).
Completa el formulario y, cuando termines, haz clic en (登録) Registrar.
Anota el ID del espacio.
Paso 2: Configura la demanda de la red de anuncios de LINE en la IU de Ad Manager
Configura la configuración de 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 LINE
OpenUPM-CLI
Si tienes instalado OpenUPM-CLI, puedes instalar el complemento de mediación de redes de anuncios de LINE de Google Mobile Ads para Unity en tu proyecto. Para ello, ejecuta el siguiente comando desde el directorio raíz de tu proyecto:
openupm add com.google.ads.mobile.mediation.line
OpenUPM
En el editor de tu proyecto de Unity, selecciona Edit > Project Settings > Package Manager para abrir la configuración del Administrador de paquetes de Unity.
En la pestaña Registros con alcance, agrega OpenUPM como un registro con alcance con los siguientes detalles:
- Nombre:
OpenUPM
- URL:
https://package.openupm.com
- Permisos:
com.google
Luego, navega a Window > Package Manager para abrir el Unity Package Manager y selecciona My Registries en el menú desplegable.
Selecciona el paquete Google Mobile Ads LINE Ads Network Mediation y haz clic en Install.
Paquete de Unity
Descarga la versión más reciente del complemento de mediación de Google Mobile Ads para la red de anuncios de LINE desde el vínculo de descarga en el registro de cambios y extrae el GoogleMobileAdsLineMediation.unitypackage
del archivo ZIP.
En el editor de tu proyecto 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.
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 para Unity.
Paso 4: Agrega el código obligatorio
Android
No se requiere ningún código adicional para la integración de la red de anuncios de LINE.
iOS
Integración de SKAdNetwork
Sigue la documentación de la red de anuncios de LINE 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 AdMob.
Verifica los anuncios de prueba
Para verificar que recibes anuncios de prueba de la red de anuncios de LINE, habilita la prueba de fuente del anuncio individual en el inspector de anuncios con las fuentes de anuncios de la red de anuncios de LINE (cascada).
Pasos opcionales
Parámetros específicos de la red
El complemento de mediación de Unity de la red de anuncios de LINE 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 estos 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 la red de anuncios de LINE, los publicadores pueden verificar el error subyacente de la respuesta del anuncio con ResponseInfo
en las siguientes clases:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
Estos son los códigos y los mensajes que genera el adaptador de la red de anuncios de LINE cuando no se carga un anuncio:
Android
Código de error | Dominio | Motivo |
---|---|---|
1-10 | com.five_corp.ad | El SDK de LINE Ads Network mostró 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 aplicación o no es válido. |
102 | com.google.ads.mediation.line | Falta el ID del espacio o no es válido. |
103 | com.google.ads.mediation.line | El tamaño del anuncio solicitado no coincide con un tamaño de anuncio de banner compatible con la red de anuncios de LINE. |
104 | com.google.ads.mediation.line | No se pudo cargar un anuncio intersticial o recompensado debido a que falta el contexto de 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. |
iOS
Código de error | Dominio | Motivo |
---|---|---|
1-10 | Se envía mediante el SDK de LINE Ads Network | El SDK de LINE Ads Network mostró 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 | Parámetros de servidor no válidos (p. ej., falta el ID de la aplicación o el ID del espacio) |
102 | com.google.ads.mediation.line | El tamaño del anuncio solicitado no coincide con un tamaño de anuncio de banner compatible con la red de anuncios de LINE. |
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 complemento de mediación de Unity de Line
Versión 1.4.0
- Admite la versión 2.8.20240827.0 del adaptador para Android de Line.
- Es compatible con la versión 2.9.20241106.1 del adaptador de Line para iOS.
- Se compiló y probó con la versión 9.4.0 del complemento Google Mobile Ads para Unity.
Versión 1.3.1
- Es compatible con la versión 2.8.20240808.0 del adaptador para Android de Line.
- Compatible con la versión 2.8.20240612.0 del adaptador para iOS de Line.
- Se compiló y probó con la versión 9.2.0 del complemento Google Mobile Ads para Unity.
Versión 1.3.0
- Admite la versión 2.8.20240722.0 del adaptador para Android de Line.
- Compatible con la versión 2.8.20240612.0 del adaptador para iOS de Line.
- Se compiló y probó con la versión 9.2.0 del complemento Google Mobile Ads para Unity.
Versión 1.2.0
- Admite la versión 2.7.20240515.0 del adaptador para Android de Line.
- Compatible con la versión 2.8.20240612.0 del adaptador para iOS de Line.
- Se compiló y probó con la versión 9.1.1 del complemento Google Mobile Ads para Unity.
Versión 1.1.2
- Admite la versión 2.7.20240515.0 del adaptador para Android de Line.
- Compatible con la versión 2.7.20240411.0 del adaptador para iOS de Line.
- Se compiló y probó con la versión 9.1.0 del complemento Google Mobile Ads para Unity.
Versión 1.1.1
- Es compatible con la versión 2.7.20240214.1 del adaptador para Android de Line.
- Compatible con la versión 2.7.20240411.0 del adaptador para iOS de Line.
- Se compiló y probó con la versión 9.1.0 del complemento Google Mobile Ads para Unity.
Versión 1.1.0
- Se agregó la clase
LineMediationExtras
con los siguientes métodos para admitir el paso de extras de mediación.SetEnabledAdSound(bool)
- Es compatible con la versión 2.7.20240214.1 del adaptador para Android de Line.
- Compatible con la versión 2.7.20240318.0 del adaptador para iOS de Line.
- Se compiló y probó con la versión 9.0.0 del complemento Google Mobile Ads para Unity.
Versión 1.0.0
- Versión inicial.
- Admite la versión 2.6.20230607.0 del adaptador para Android de Line.
- Admite la versión 2.6.20230609.0 del adaptador de Line para iOS.
- Se compiló y probó con la versión 8.5.1 del complemento Google Mobile Ads para Unity.