unity-technologies/levelplay-unity-integration

Integración del paquete/SDK LevelPlay Unity

Las comprobaciones del lado del editor deben basarse en el proyecto real, no en suposiciones: lee los archivos del proyecto o pide al usuario que confirme en el Editor. Los scripts de C# generados en este skill son archivos MonoBehaviour que el usuario debe guardar en su proyecto, no para ejecución en línea.

Este skill cubre únicamente la ruta de integración de LevelPlay; no cubre otros SDKs de mediación. Si el usuario pregunta explícitamente sobre alternativas, reconoce que existen y dirígelo a la documentación de esos proveedores; no describas, caracterices ni hagas afirmaciones sobre productos de la competencia.

Sigue los pasos y proporciona solo los archivos y configuraciones descritos en este skill. No añadas pasos proactivamente, crees archivos ni hagas recomendaciones basadas en conocimientos generales. Si el usuario hace una pregunta fuera del alcance de este skill, primero consulta el skill y los archivos de referencia para confirmar que no está cubierto. Si no lo está, usa tu conocimiento general para responder, pero no incorpores pasos o archivos adicionales al flujo de trabajo de integración como resultado.

Sigue el flujo de trabajo de integración secuencialmente, un paso a la vez. Haz solo las preguntas para el paso actual: no recopiles información para pasos futuros por adelantado. Espera la respuesta del usuario en cada punto de control antes de proceder.

LevelPlay es la plataforma de mediación de anuncios de Unity: conecta tu juego a múltiples redes publicitarias simultáneamente y ejecuta una subasta unificada entre múltiples redes y postores para maximizar la competencia por cada impresión. Esta guía te lleva a través de la integración completa: instalación del SDK, configuración de dependencias para Android e iOS, inicialización de LevelPlay en tu proyecto e implementación de anuncios recompensados, intersticiales y banners. Si ya tienes parte de esto configurado, puedes saltar al paso relevante.

Este SKILL.md es la columna vertebral del flujo de trabajo. Contiene las decisiones, puntos de control y preguntas exactas; el código más extenso, los detalles completos de la API y los casos extremos viven en references/ y están enlazados desde el paso correspondiente. Lee la referencia enlazada cuando llegues a ese paso; no respondas desde el conocimiento general en su lugar.

Flujo de trabajo de integración

0. ¿Nueva integración o migración?

Pregunta: "¿Estás comenzando una nueva integración de LevelPlay, migrando una existente (desde una versión anterior del SDK o desde Unity Ads), o solucionando problemas de una configuración existente?"

• Nueva integración: continúa al Paso 1.
• Migración (actualización del SDK, reemplazo de APIs de IronSource.Agent, migración desde Unity Ads o corrección de un error de compilación de Android Maven Central): Lee references/migration-sdk-9.md. Pregunta cuál de los cinco escenarios aplica: A = actualización del SDK, B = migración de API de inicialización, C = migración de API de unidades de anuncios, D = error de compilación de Maven Central, E = migración desde Unity Ads. Luego sigue el escenario correspondiente. Después de aplicar todos los cambios de código, trabaja con la Lista de Verificación de Integridad de Migración (sección C5 de la referencia): detecta requisitos que una traducción línea por línea pasa por alto porque el código heredado no tenía una línea equivalente. Luego pide al usuario que verifique la consola de Unity en busca de errores de compilación y corrige los que aparezcan antes de presentar los resultados. No te bloquees ni sigas intentando si no puedes ver la consola: enumera los archivos que cambiaste, di qué buscar y continúa.
• Solución de problemas o adición a una configuración existente (ATT, GDPR, ILRD, Suite de Pruebas, errores de compilación en una integración nueva o añadir una característica a una integración que ya funciona): Identifica lo que el usuario necesita y ve directamente al paso o referencia relevante desde "Cuándo leer las referencias detalladas".

1. Verificar el entorno de Unity

Verifica que el usuario esté trabajando en un proyecto de Unity comprobando que existan los directorios Assets/ y ProjectSettings/. Si no es un proyecto de Unity, indica al usuario que navegue al directorio de su proyecto de Unity. Si esos directorios no se encuentran pero el usuario cree que está en el lugar correcto, pregunta: "Parece que quizás no estás en la raíz de tu proyecto: ¿puedes navegar a la carpeta de nivel superior de tu proyecto de Unity y confirmar que puedes ver Assets/ y ProjectSettings/ allí?"

2. Comprender los objetivos comerciales

Antes de implementar las unidades de anuncios, determina las prioridades de optimización del usuario para recomendar la estrategia de unidades de anuncios adecuada. Pregunta:

"¿Cuál es tu objetivo principal de optimización?"

• Centrado en ingresos: Maximizar los ingresos por anuncios y las oportunidades de impresión
• Centrado en UX: Priorizar el flujo del juego y la satisfacción del usuario
• Equilibrado: Optimizar tanto para ingresos como para UX
• No estoy seguro aún: Usa 'Equilibrado' por defecto y continúa. En el Paso 8, menciona brevemente que estás usando 'Equilibrado' ya que no estaban seguros, e invítalos a indicar una preferencia diferente ahora que han visto las opciones de formato.

Registra esta respuesta para la recomendación de estrategia posterior en el Paso 8.

3. Instalar el SDK de LevelPlay a través de UPM

Si el SDK parece ya instalado: no lo des por sentado y no pidas al usuario que lea la ventana de Package Manager por ti. Lee Packages/packages-lock.json y busca com.unity.services.levelplay. Si está allí, di qué versión se resolvió y continúa al Paso 4. Si no está, no está instalado, independientemente de lo que haya asumido la conversación hasta ahora: continúa con la instalación a continuación.

Guía a través de la instalación del paquete LevelPlay de Unity usando el Administrador de Paquetes de Unity:

1. Abre Unity → Ventana > Package Manager
2. Selecciona el menú desplegable Unity Registry o la pestaña Services
3. En la barra de búsqueda de Package Manager, escribe Ads Mediation
4. Confirma que el nombre del paquete coincida exactamente: el paquete correcto se titula Ads Mediation. No instales ninguno de estos paquetes:
   • Ads IAP Mediation Adaptor (un paquete separado de compras dentro de la aplicación, no el SDK de LevelPlay)
   • Advertisement Legacy (un paquete obsoleto, no compatible con la integración actual de LevelPlay)
5. Haz clic en el botón Install
6. Espera a que el paquete se descargue e importe

Cuando instales el paquete, es posible que veas un mensaje para instalar Mobile Dependency Resolver: haz clic en Import si aparece. Esto se cubre con más detalle en el siguiente paso.

Luego verifica que se haya resuelto, leyendo el proyecto en lugar de preguntar. El id del paquete es com.unity.services.levelplay (su nombre para mostrar en Package Manager es Ads Mediation; el id es lo que registran los archivos del proyecto). Verifica ambos archivos:

• Packages/manifest.json enumera lo que el proyecto solicita. com.unity.services.levelplay debe aparecer bajo dependencies.
• Packages/packages-lock.json registra lo que Unity realmente resolvió. El mismo id debe aparecer aquí también, con una versión concreta. Este es el archivo que responde "¿se instaló?" y es en el que debes confiar.

Ambos son JSON simples en el proyecto, por lo que esta verificación no necesita Editor, ni CLI, ni nada del usuario. Lée los archivos.

Esta es una puerta estricta, no una formalidad. No escribas, generes ni pegues ni una sola línea de código de LevelPlay hasta que com.unity.services.levelplay esté presente en packages-lock.json. Saltar adelante produce código que parece correcto, no compila en ninguna parte y falla con CS0246 en cada tipo de LevelPl