[Unity] 1. Integration des Consentmanager-SDK

1. Übersicht

Das ConsentManager SDK ist eine umfassende Lösung zur Verwaltung der Einwilligung von Nutzern in mobilen Anwendungen. Dieses SDK wurde entwickelt, um die Einhaltung der DSGVO, die Datenschutzpräferenzen der Nutzer und die Transparenz beim Ad-Tracking zu gewährleisten, und bietet eine nahtlose Integration für iOS- und Android-Plattformen. Darüber hinaus bietet es Wrapper-Plugins/Bridges für React Native, Flutter und Unity, wodurch es in verschiedenen Entwicklungsumgebungen vielseitig einsetzbar ist.

Dieses Dokument behandelt die Installationsprozedur und die Funktionen, die Kunden zur Verfügung stehen, die Apps mit Unity entwickeln, um über die Unity C# Native Bridge auf unser CMP-SDK für das Einwilligungsmanagement zuzugreifen. Weitere Details zu den zugrunde liegenden nativen SDKs finden Sie auf unseren Seiten zur iOS- und Android-API-Dokumentation.

Das Unity-Paket enthält eine Demo-Szene (ConsentManagerDemo) mit einer einfachen Implementierung, die die gängigsten Anwendungsfälle der Einwilligungsverwaltung in einer mobilen Unity-App veranschaulicht.

2. Installation

2.1 Schritte – Allgemeine Beschreibung

  1. Integration und Konfiguration: Integrieren Sie das SDK in Ihre mobile App und konfigurieren Sie anschließend die SDK-Einstellungen entsprechend Ihren Anforderungen.
  2. Erstellen Sie eine Instanz und zeigen Sie die Einwilligungsschicht an: Erstellen Sie beim Start der App eine Instanz der CMPManager Klasse. Diese Instanz verwaltet den Einwilligungsprozess. Das SDK zeigt den Einwilligungsbildschirm bei Bedarf automatisch an.
  3. Verarbeitung von Daten zur Einwilligung der Nutzer: Sobald Einwilligungen erfasst wurden, werden die Informationen gespeichert und können über verschiedene Eigenschaften und Methoden, die vom SDK bereitgestellt werden, abgefragt werden. Du erhältst Informationen über abgelehnte oder akzeptierte Einwilligungen, Anbieter und Zwecke.

2.2 Kompatibilität

  • Unity 20XX.X.X oder höher (Hinweis: In früheren Unity-Versionen sind Sicherheitslücken bekannt)
  • iOS (über DllImport)
  • Android (über JNI)

2.3 Importieren des SDK-Pakets

Stelle sicher, dass deine `build.gradle`-Datei im Android-Ordner deines Projekts die richtige Abhängigkeit angibt. Da es sich um eine Unity C# Native Bridge handelt, müssen beide Abhängigkeiten synchron sein. Das Gleiche gilt für iOS: Stelle sicher, dass deine `podspec`-Datei die richtige Abhängigkeit enthält, wie unten gezeigt.

  1. Laden Sie die neueste Version des Plugins herunter.
  2. Importiere das Paket über „Assets“ › „Import Package“ › „Custom Package“ in dein Unity-Projekt.
  3. Du findest den ConsentManagerSDK Ordner in der Assets Ordner in der Projektstruktur im Unity Editor.
  4. Wechseln Sie zu Ihrer gewählten Plattform, erstellen Sie die Lösung und öffnen Sie das generierte Projekt in der jeweiligen IDE Ihrer Wahl.

2.4 Plattformspezifische Einrichtung

iOS

  • Richte das XCFramework als Abhängigkeit ein, entweder mit CocoaPods oder SPM.
  • Füge cm-sdk-ios-v3 die Ziele „Unity-iPhone“ und „UnityFramework“ im Abschnitt „Frameworks und Bibliotheken“ von Xcode hinzu.

Android

  • Lege das Android SDK als Abhängigkeit in der build.gradle Datei auf der :unityLibrary Modul-Ebene fest:
implementation 'net.consentmanager.sdkv3:cmsdkv3:3.6.0'

We do our best to keep this purely informative documentation up to date. However, if you notice that any of these guides need a little touch-up, let us know!