Communitygithub.com

unity-technologies/levelplay-unity-integration

Integriert das LevelPlay Mediation SDK über das Ads Mediation UPM-Paket. Verwenden Sie dies, wenn ein Entwickler nach dem Hinzufügen von Werbung zu einem Unity-Spiel, der Implementierung von belohnter, Interstitial- oder Bannerwerbung, der Einrichtung von Ad Mediation, der Konfiguration von Werbenetzwerken, der Installation oder Aktualisierung des Ads Mediation-Pakets, der Fehlerbehebung bei LevelPlay-Namespace-Fehlern, der Lösung von Android Gradle- oder iOS CocoaPods-Abhängigkeitsproblemen für Werbung, der Konfiguration von ATT- oder Datenschutzeinstellungen für Werbekonformität, der Verfolgung von Impression-Level-Revenue (ILRD), der Initialisierung des LevelPlay SDKs oder der Einrichtung von Anzeigeneinheiten-IDs fragt.

Was ist levelplay-unity-integration?

Dieses Skill konzentriert sich auf die vollständige Integration des LevelPlay-Werbe-Mediations-SDKs in Unity-Spiele mithilfe des Ads Mediation UPM-Pakets (Paket-ID `com.unity.services.levelplay`). Es führt den Benutzer schrittweise durch den gesamten Arbeitsablauf, einschließlich Installation, Plattform-spezifischer Einrichtung für Android und iOS, Initialisierung des SDKs und Implementierung verschiedener Anzeigenformate (belohnt, Interstitial und Banner). Das Skill prüft die tatsächlichen Projektdateien (z. B. `Packages/packages-lock.json`), um den Installationsstatus zu überprüfen, anstatt sich auf Annahmen oder Benutzereingaben zu verlassen. Es behandelt auch Migrationspfade von älteren SDK-Versionen oder Unity Ads sowie die Fehlerbehebung bei häufigen Problemen wie Gradle-Build-Fehlern oder Namespace-Konflikten. Das Skill ist als Arbeitsablauf-Spine strukturiert, mit Verweisen auf detaillierte Referenzmaterialien für komplexere Themen wie die Aktualisierung des SDKs oder die Behandlung von Datenschutzeinstellungen. Es ist für Entwickler gedacht, die entweder eine neue Integration beginnen, von einem anderen SDK migrieren oder Unterstützung bei der Fehlerbehebung oder Erweiterung einer bestehenden LevelPlay-Einrichtung benötigen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/unity-technologies/skills/tree/main/skills/levelplay-unity-integration

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

LevelPlay Unity-Paket/SDK-Integration

Basis-Editor-seitige Prüfungen sollten auf dem tatsächlichen Projekt basieren, nicht auf Annahmen – lesen Sie die Projektdateien oder bitten Sie den Benutzer, im Editor zu bestätigen. Die in diesem Skill generierten C#-Skripte sind MonoBehaviour-Dateien, die der Benutzer in seinem Projekt speichern soll, nicht für die Inline-Ausführung.

Dieses Skill behandelt ausschließlich den LevelPlay-Integrationspfad; es deckt keine anderen Mediations-SDKs ab. Wenn der Benutzer explizit nach Alternativen fragt, bestätigen Sie, dass Alternativen existieren, und verweisen Sie auf die entsprechende Dokumentation der Anbieter – beschreiben, charakterisieren oder treffen Sie keine Aussagen über Produkte von Wettbewerbern.

Befolgen Sie die Schritte und geben Sie nur die in diesem Skill beschriebenen Dateien und Konfigurationen an. Fügen Sie keine Schritte proaktiv hinzu, erstellen Sie keine Dateien oder geben Sie keine Empfehlungen auf der Grundlage allgemeinen Wissens. Wenn der Benutzer eine Frage außerhalb des Rahmens dieses Skills stellt, überprüfen Sie zuerst das Skill und die Referenzdateien, um zu bestätigen, dass es nicht abgedeckt ist. Wenn nicht, verwenden Sie allgemeines Wissen, um zu antworten, aber integrieren Sie keine zusätzlichen Schritte oder Dateien in den Integrationsarbeitsablauf.

Folgen Sie dem Integrationsarbeitsablauf sequenziell, einen Schritt nach dem anderen. Stellen Sie nur Fragen zum aktuellen Schritt – sammeln Sie keine Informationen für zukünftige Schritte im Voraus. Warten Sie an jedem Kontrollpunkt auf die Antwort des Benutzers, bevor Sie fortfahren.

LevelPlay ist die Werbe-Mediationsplattform von Unity: Sie verbindet Ihr Spiel mit mehreren Werbenetzwerken gleichzeitig und führt eine einheitliche Auktion über mehrere Werbenetzwerke und Bieter durch, um den Wettbewerb für jede Impression zu maximieren. Diese Anleitung führt Sie durch die vollständige Integration: Installation des SDKs, Konfiguration von Abhängigkeiten für Android und iOS, Initialisierung von LevelPlay in Ihrem Projekt und Implementierung von belohnter, Interstitial- und Bannerwerbung. Wenn Sie bereits einen Teil davon eingerichtet haben, können Sie direkt zum relevanten Schritt springen.

Diese SKILL.md ist das Arbeitsablauf-Spine. Sie enthält die Entscheidungen, Kontrollpunkte und exakten Fragen; längere Codeblöcke, vollständige API-Details und Randfälle befinden sich in references/ und sind vom entsprechenden Schritt aus verlinkt. Lesen Sie die verlinkte Referenz, wenn Sie diesen Schritt erreichen – beantworten Sie nicht stattdessen aus allgemeinem Wissen.

Integrations-Arbeitsablauf

0. Neue Integration oder Migration?

Fragen Sie: "Starten Sie eine neue LevelPlay-Integration, migrieren Sie eine bestehende (von einer älteren SDK-Version oder von Unity Ads) oder beheben Sie ein Problem in einem bestehenden Setup?"

  • Neue Integration: Fahren Sie mit Schritt 1 fort.
  • Migration (SDK-Upgrade, Ersetzen von IronSource.Agent-APIs, Migration von Unity Ads oder Beheben eines Maven Central Android-Build-Fehlers): Lesen Sie references/migration-sdk-9.md. Fragen Sie, welches der fünf Szenarien zutrifft – A = SDK-Upgrade, B = init-API-Migration, C = Ad-Unit-API-Migration, D = Maven Central Build-Fehler, E = Unity Ads Migration – und folgen Sie dann dem passenden Szenario. Nachdem Sie alle Codeänderungen angewendet haben, arbeiten Sie die Migrations-Vollständigkeits-Checkliste (Abschnitt C5 der Referenz) durch – sie erfasst Anforderungen, die eine zeilenweise Übersetzung übersehen würde, weil der Legacy-Code keine entsprechende Zeile hatte. Bitten Sie den Benutzer dann, die Unity-Konsole auf Kompilierungsfehler zu überprüfen, und beheben Sie alle auftretenden Fehler, bevor Sie die Ergebnisse präsentieren. Blockieren oder wiederholen Sie nicht, wenn Sie die Konsole nicht sehen können: Listen Sie die geänderten Dateien auf, sagen Sie, wonach gesucht werden soll, und fahren Sie fort.
  • Fehlerbehebung oder Hinzufügen zu einem bestehenden Setup (ATT, GDPR, ILRD, Test Suite, Build-Fehler bei einer neuen Integration oder Hinzufügen einer Funktion zu einer bereits funktionierenden Integration): Identifizieren Sie, was der Benutzer benötigt, und gehen Sie direkt zum relevanten Schritt oder zur Referenz aus "Wann detaillierte Referenzen zu lesen sind".

1. Unity-Umgebung überprüfen

Stellen Sie sicher, dass der Benutzer in einem Unity-Projekt arbeitet, indem Sie überprüfen, ob die Verzeichnisse Assets/ und ProjectSettings/ existieren. Wenn kein Unity-Projekt vorhanden ist, weisen Sie den Benutzer an, zu seinem Unity-Projektverzeichnis zu navigieren. Wenn diese Verzeichnisse nicht gefunden werden, der Benutzer aber glaubt, am richtigen Ort zu sein, fragen Sie: "Es scheint, als ob Sie sich möglicherweise nicht im Projektstammverzeichnis befinden – können Sie zum Hauptordner Ihres Unity-Projekts navigieren und bestätigen, dass Sie dort Assets/ und ProjectSettings/ sehen?"

2. Geschäftsziele verstehen

Bevor Sie Anzeigeneinheiten implementieren, ermitteln Sie die Optimierungsprioritäten des Benutzers, um die geeignete Anzeigeneinheiten-Strategie zu empfehlen. Fragen Sie:

"Was ist Ihr primäres Optimierungsziel?"

  • Umsatzorientiert: Maximierung der Werbeeinnahmen und Impression-Chancen
  • UX-orientiert: Priorisierung des Spielablaufs und der Benutzerzufriedenheit
  • Ausgeglichen: Optimierung sowohl für Umsatz als auch für UX
  • Noch nicht sicher: Standardmäßig auf Ausgeglichen setzen und fortfahren. In Schritt 8 kurz darauf hinweisen, dass Sie Ausgeglichen verwenden, da der Benutzer unsicher war, und ihn einladen, eine andere Präferenz anzugeben, da er jetzt die Formatoptionen gesehen hat.

Notieren Sie diese Antwort für die spätere Strategieempfehlung in Schritt 8.

3. LevelPlay SDK über UPM installieren

Wenn das SDK bereits installiert aussieht: Verlassen Sie sich nicht darauf und bitten Sie den Benutzer nicht, das Package Manager-Fenster für Sie zu lesen. Lesen Sie Packages/packages-lock.json und suchen Sie nach com.unity.services.levelplay. Wenn es vorhanden ist, geben Sie an, welche Version aufgelöst wurde, und fahren Sie mit Schritt 4 fort. Wenn nicht, ist es nicht installiert, unabhängig davon, was die bisherige Konversation angenommen hat: Fahren Sie mit der Installation unten fort.

Führen Sie durch die Installation des LevelPlay Unity-Pakets mit dem Unity Package Manager:

  1. Öffnen Sie Unity → Fenster > Package Manager
  2. Wählen Sie das Dropdown-Menü "Unity Registry" oder die Registerkarte "Services"
  3. Geben Sie in der Suchleiste des Package Managers Ads Mediation ein
  4. Bestätigen Sie, dass der Paketname exakt übereinstimmt: Das korrekte Paket heißt Ads Mediation. Installieren Sie keines dieser Pakete:
    • Ads IAP Mediation Adaptor (ein separates In-App-Kauf-Paket, nicht das LevelPlay SDK)
    • Advertisement Legacy (ein veraltetes Paket, nicht kompatibel mit der aktuellen LevelPlay-Integration)
  5. Klicken Sie auf die Schaltfläche "Installieren"
  6. Warten Sie, bis das Paket heruntergeladen und importiert wurde

Wenn Sie das Paket installieren, wird möglicherweise eine Aufforderung zur Installation des Mobile Dependency Resolver angezeigt – klicken Sie auf Importieren, wenn sie erscheint. Dies wird im nächsten Schritt detaillierter behandelt.

Überprüfen Sie dann, ob es aufgelöst wurde, indem Sie das Projekt lesen, anstatt zu fragen. Die Paket-ID ist com.unity.services.levelplay (der Anzeigename im Package Manager ist Ads Mediation; die ID ist das, was die Projektdateien aufzeichnen). Überprüfen Sie beide Dateien:

  • Packages/manifest.json listet auf, was das Projekt anfordert. com.unity.services.levelplay muss unter dependencies erscheinen.
  • Packages/packages-lock.json zeichnet auf, was Unity tatsächlich aufgelöst hat. Dieselbe ID muss auch hier erscheinen, mit einer konkreten Version. Diese Datei beantwortet die Frage "Wurde es installiert?", und ihr ist zu vertrauen.

Beides sind einfache JSON-Dateien im Projekt, daher benötigt diese Überprüfung keinen Editor, kein CLI und nichts vom Benutzer. Lesen Sie sie.

Dies ist eine harte Sperre, keine Formsache. Schreiben, generieren oder fügen Sie keine einzige Zeile LevelPlay-Code ein, bis com.unity.services.levelplay in packages-lock.json vorhanden ist. Wenn Sie vorausspringen, produzieren Sie Code, der korrekt aussieht, aber nirgendwo kompiliert und bei jedem LevelPlay-Namespace mit CS0246 fehlschlägt.

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

unity-technologies/2d-pixel-perfect

Sets up, diagnoses, and fixes pixel perfect 2D rendering in Unity projects. Use when working on any retro-style or pixel art 2D game.

unity-technologies/audio-setup-mixers

Scans the scene and audio assets to appropriately route Audio Sources into existing Audio Mixer Groups, classifying each source by what it plays. Use when the user asks about cleaning up mixer assignments, routing audio through a mixer, or which group a sound belongs in. Creating mixers and groups, and setting volumes, are not automated — the skill inventories what exists and asks the user to add anything missing.

unity-technologies/build-live-game

Build and operate a live game using Unity Services. Use when the user needs to implement, connect, or debug backend-driven features — battle passes, achievements, player progression, cloud saves, leaderboards, matchmaking, virtual economies, server-authoritative logic, anti-cheat, player accounts and authentication, remote configuration, feature flags, A/B testing, analytics, or cloud resource deployment. Triggers on live-ops, live service, backend, server authority, cloud code, cloud save, remote config, player data, retention, monetization loop, season pass, ranking, multiplayer sessions, lobbies, or any Unity Services integration.

unity-technologies/generate-editor-search-query

Generates Unity Search / Quick Search queries and opens the Unity Search window for read-only Unity Editor asset or scene-object lookup requests. Always use when the user asks to find, search, show, locate, filter, look up, query, or list concrete assets or scene objects in the current project or scene, even if Unity Search is not named. Covers materials, textures, prefabs, scenes, scripts, shaders, GameObjects, components, Lights, Cameras, UI objects, labels, paths, references, selected or named assets, and asset types. Also use when the user explicitly mentions Unity Search, Quick Search, Search window, open Search, or asks what Unity Search query to use. Do not use for general project overview, project structure, folder-purpose summaries, gameplay/system explanations, how-to programming questions, web search, repository text search, build logs, package installation, menu or settings search, modifying results, or non-Unity filesystem search unless the user explicitly asks to use Unity Search.

unity-technologies/implement-in-app-purchases

Implement, configure, and debug Unity In-App Purchases (IAP) — store connection, product catalog, consumable/non-consumable/subscription purchases, two-step pending-confirm flow, receipt validation, entitlement checking, restore transactions, Apple extensions (promotional purchases, Ask-to-Buy, code redemption), and Google Play extensions (subscription upgrade/downgrade), D2C Capabilities(direct to customer), 3rd party payment provider (Stripe/Coda) via Unity IAP/Unity Cloud. Use when the user needs to add, modify, debug, or migrate from native Android/iOS billing, 3rd party packages(RevenueCat/Adapty/Essential Kit/Unipay supported) to IAP. Triggers on microtransactions (MTX), monetization, real-money purchases, store purchases, buying items, support D2C, purchase via Stripe/Coda, migrate from native billing(Google's BillingClient or Apple's StoreKit/SKPaymentQueue/SKProduct)/RevenueCat/Adapty/EssentialKit/Unipay.

unity-technologies/initialize-ai-navigation

Sets up and configures the Unity AI Navigation system — NavMesh surfaces, NavMesh agents, obstacles, links, modifiers, areas and costs. Use when creating walkable navigation meshes, adding pathfinding agents, setting up patrol routes, configuring obstacle avoidance and carving, connecting separate NavMeshes with links, coupling navigation with animation, or troubleshooting navigation issues.

unity-technologies/localization

Sets up and configures Unity Localization, including locales, String/Asset Tables, CJK font support, and Addressables workflows. Use when the user wants to add languages to a project, translate UI text, support Asian (CJK) languages with TMP fonts, or mentions i18n, l10n, multilingual support, or making a game support multiple languages.

unity-technologies/manage-sprite-atlas

Manage SpriteAtlas using prebuild pipeline with IPreprocessBuildWithReport (DEFAULT approach). Use it to configure master atlases, variant atlases, texture settings, packing settings, and platform-specific configurations. Use when the user asks about creating sprite atlases, optimizing sprites, configuring atlas settings, adding sprites to atlases, creating variant atlases, implementing automated atlas generation, or runtime sprite atlas access. Always use prebuild approach unless user explicitly requests manual authoring.

unity-technologies/migrate-birp-to-urp

Plans, executes, and troubleshoots Unity projects moving from the Built-in Render Pipeline (BiRP/BIRP/Built-in RP) to the Universal Render Pipeline (URP). Use when the user asks to upgrade, convert, switch, or migrate a project, scene, material, or shader to URP/Universal Render Pipeline; fix pink or magenta materials after URP; convert Built-in materials/shaders; move a 2D project to URP 2D; review lighting, quality, post-processing, baked lightmaps, or reflection probes after URP; or diagnose visual problems after a render-pipeline migration.

Verwandte Skills