En esta guía, se muestra cómo usar el SDK de Google Mobile Ads para cargar y mostrar anuncios de Line con mediación, lo que abarca las integraciones en cascada. En ella, se explica cómo agregar Line a la configuración de mediación de una unidad de anuncios y cómo integrar el SDK y el adaptador de Line en una app para Unity.
Integraciones y formatos de anuncios admitidos
El adaptador de mediación de AdMob para Line tiene las siguientes capacidades:
Integración | |
---|---|
Ofertas | |
Cascada | 1 |
Formatos | |
Banner | |
Intersticial | |
Recompensado |
1 La integración en cascada está en versión beta abierta.
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 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 línea en la IU de AdMob
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 Line
OpenUPM-CLI
Si tienes instalado OpenUPM-CLI, puedes instalar el complemento de mediación de líneas 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 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 Line desde el vínculo de descarga en el registro de cambios y extrae 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 código adicional para la integración de Line.
iOS
Integración de SKAdNetwork
Sigue la documentación 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.
Sigue las instrucciones de la documentación de Line para Android y iOS sobre cómo habilitar los anuncios de prueba de Line.
Verifica los anuncios de prueba
Para verificar que recibes anuncios de prueba de Line, habilita la prueba de fuente del anuncio individual en el inspector de anuncios con las fuentes de anuncios de Line (cascada).
Pasos opcionales
Parámetros específicos de la red
El complemento de mediación de Line Unity 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 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 línea cuando no se carga un anuncio:
Android
Código de error | Dominio | Motivo |
---|---|---|
1-10 | com.five_corp.ad | El SDK de Line mostró un error específico del SDK. Consulta la documentación 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 de anuncio solicitado no coincide con un tamaño de anuncio de banner compatible con 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 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 | Enviado por el SDK de Line | El SDK de Line mostró un error específico del SDK. Consulta la documentación 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 de anuncio solicitado no coincide con un tamaño de anuncio de banner compatible con 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.