Leading Consent Management Platform

Compliant with GDPR, CCPA, COPPA, LGPD, PECR, PDPA, PIPEDA, and more.

UniConsent CMP SDK für iOS in mobile Apps integrieren

UniConsent CMP ist ein Paket zur Handhabung der DSGVO IAB TCF 2.4-Einwilligungsverwaltung unter iOS. Eine Demo-App mit integriertem UniConsent CMP finden Sie im Verzeichnis "UniConsentDemo".

Voraussetzungen

  • UniConsent CMP-Tarif mit Unterstützung für mobile Apps
  • iOS >= 15.0
  • UniConsent CMP SDK-Paket (beim Support anfragen)

Erste Schritte

Fügen Sie UniConsent.xcframework in Ihr Projekt ein. Setzen Sie unter General > Frameworks, Libraries, and Embedded Content Ihres Targets UniConsent.xcframework auf Embed & Sign.

Einwilligungs-UI anpassen

Bevor Sie das SDK integrieren, passen Sie das Erscheinungsbild des Einwilligungsbanners im UniConsent Dashboard an Ihre Marke an, um die Einwilligungsrate zu optimieren.

Schritt 1: Markengestaltung im Dashboard

Gehen Sie zu Projects → Projekt auswählen → Settings → Step 5: UI & Style Settings, um Folgendes zu konfigurieren:

  • Main Button Colour -- Legen Sie die Farbe der primären Aktionsschaltfläche passend zu Ihrer Marke fest
  • Main Button Text Colour -- Passen Sie die Textfarbe auf der primären Schaltfläche für bessere Lesbarkeit an
  • Background Colour -- Legen Sie die Hintergrundfarbe des Banners fest, damit es zu Ihrer App passt
  • Text Colour -- Stellen Sie sicher, dass der Fließtext einen angemessenen Kontrast aufweist

Schritt 2: Erweiterte Gestaltung mit benutzerdefiniertem CSS (optional)

Für eine präzisere Steuerung fügen Sie benutzerdefiniertes CSS im Feld CSS Content unter Schritt 5 hinzu. Dies wird empfohlen, damit das Banner nativ in Ihrer App wirkt und die beste Einwilligungsrate erzielt wird:

/* Example: Style the accept button to match your brand */
.unic-btn-accept {
  background-color: #4CAF50;
  border-radius: 8px;
  font-weight: 600;
}

/* Example: Adjust banner font */
.unic-banner {
  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
}

/* Example: Make the reject button less prominent */
.unic-btn-reject {
  background-color: transparent;
  border: 1px solid #ccc;
  color: #666;
}

Tipp: Eine gut gebrandete Einwilligungs-UI, die nativ in Ihrer App wirkt, erzielt in der Regel höhere Einwilligungsraten. Nutzer reagieren eher positiv auf ein Banner, das dem erwarteten Look and Feel entspricht.

Verwendung

Um UniConsent CMP in Ihrer App zu verwenden, folgen Sie diesen Schritten:

Initialisieren Sie die CMP mit einer App-ID von Ihrem Account-Manager:

import UniConsent

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // Init CMP with appId
    // initialize() loads the location, config and vendor list over the network: keep it off the main thread
    DispatchQueue.global(qos: .userInitiated).async {
        UniConsentCMP.shared.initialize(apiId: "YOUR_APP_ID_CHANGE_THIS")
    }
    return true
}

CMP-UI anzeigen:

// Display CMP as full-screen modal (default)
UniConsentCMP.shared.setUIStage(.GDPRFirstScreen)
UniConsentCMP.shared.launchCMP(rootVC: self)

// Display CMP as a modal bottom sheet
UniConsentCMP.shared.launchCMP(rootVC: self, displayMode: .modalSheet)

// Display CMP as a modal bottom sheet at 60% of the available height
UniConsentCMP.shared.launchCMP(rootVC: self, displayMode: .modalSheet, heightRatio: 0.6)

// Display CMP as a center dialog
UniConsentCMP.shared.launchCMP(rootVC: self, displayMode: .dialog)

// Display CMP as a center dialog at 80% width and 60% height
UniConsentCMP.shared.launchCMP(rootVC: self, displayMode: .dialog, widthRatio: 0.8, heightRatio: 0.6)

Verfügbare Anzeigemodi (CMPDisplayMode):

  • .fullScreen -- Vollbild-Modal-Darstellung (Standard)
  • .modalSheet -- Bottom Sheet mit Drag-Handle (iOS 15+)
  • .dialog -- Zentrierter Dialog mit abgedunkeltem Hintergrund

Benutzerdefinierte Größe (optional)

Verfügbar ab SDK-Version 26.8.0.

Beide Ratios sind optional -- jeder Anzeigemodus funktioniert auch ohne sie. Übergeben Sie ein Ratio (ein Bruchteil des Bildschirms, begrenzt auf 0.1...1.0) nur, um die Standardgröße zu überschreiben:

ParameterGilt fürStandard, wenn nicht angegeben
heightRatio.modalSheet, .dialogSheet: 90 % der verfügbaren Höhe. Dialog: 70 % des Bildschirms
widthRationur .dialog90 % der Bildschirmbreite, maximal 500pt

Ratios, die für den gewählten Anzeigemodus nicht relevant sind, werden ignoriert (.fullScreen ignoriert beide). Ab iOS 16 verwendet das Sheet exakt das angegebene heightRatio; unter iOS 15 fällt es auf das System-Detent medium (Ratio ≤ 0.5) bzw. large (Ratio > 0.5) zurück.

Event-Handler

Überwachen Sie SDK-Lebenszyklusereignisse mit CMPEventHandler. Dies ist die empfohlene Methode, um zu erfahren, wann das SDK die Initialisierung abgeschlossen hat, wann die UI angezeigt wird und wann sie geschlossen wird.

Verfügbare Ereignisse (CMPEventType):

  • .sdkInit -- SDK-Initialisierung gestartet
  • .ready -- SDK-Initialisierung abgeschlossen (GEO, Konfiguration und Anbieter geladen)
  • .uiDisplay -- Einwilligungs-UI wird angezeigt
  • .uiClose -- Einwilligungs-UI wird geschlossen

Abonnieren Sie Ereignisse vor dem Aufruf von initialize(), um alle Ereignisse zu empfangen:

import UniConsent

@main
class AppDelegate: UIResponder, UIApplicationDelegate, CMPEventHandler {

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        UniConsentCMP.shared.subscribe(self)
        DispatchQueue.global(qos: .userInitiated).async {
            UniConsentCMP.shared.initialize(apiId: "YOUR_APP_ID")
        }
        return true
    }

    func handle(event: CMPEvent) {
        switch event.type {
        case .ready:
            // SDK is ready — check consent and launch CMP if needed
            // events arrive on the thread that called initialize(): show UI on the main thread
            DispatchQueue.main.async {
                if let rootVC = UIApplication.shared.connectedScenes
                    .compactMap({ ($0 as? UIWindowScene)?.keyWindow?.rootViewController }).first {
                    UniConsentCMP.shared.launchCMPIfNeeded(rootVC: rootVC)
                }
            }
        case .uiClose:
            // User finished interacting with consent UI
            print("TC String:", UniConsentCMP.shared.getTCString())
        default:
            break
        }
    }
}

Sie können auch von einem View Controller aus abonnieren:

class ViewController: UIViewController, CMPEventHandler {

    override func viewDidLoad() {
        super.viewDidLoad()
        UniConsentCMP.shared.subscribe(self)
    }

    func handle(event: CMPEvent) {
        switch event.type {
        case .uiDisplay:
            print("CMP UI is now visible")
        case .uiClose:
            print("Consent given, vendor 1 allowed:", UniConsentCMP.shared.isAllowVendorById(vendorId: 1))
        default:
            break
        }
    }
}

Zum Abbestellen:

UniConsentCMP.shared.unsubscribe(self)

CMPUIDelegate (Legacy)

Sie können auch über CMPUIDelegate auf das Schließen der Einwilligungsoberfläche reagieren:

class ViewController: UIViewController, CMPUIDelegate {

    func showCMP() {
        UniConsentCMP.shared.view.delegate = self
        UniConsentCMP.shared.setUIStage(.GDPRFirstScreen)
        UniConsentCMP.shared.launchCMP(rootVC: self, displayMode: .modalSheet)
    }

    func onDismiss() {
        // Called when the user closes the consent UI
        print("TC String:", UniConsentCMP.shared.getTCString())
    }
}

Automatisch prüfen, ob die Einwilligung abgelaufen ist, wenn die vendorList aktualisiert wird:

// Automatic check if consent is expired when vendorList updates
if UniConsentCMP.shared.shouldRequestConsent() {
    UniConsentCMP.shared.launchCMP(rootVC: self)
}

Den tcString bei Bedarf abrufen:

// Get tcString if required
UniConsentCMP.shared.getTCString()

Den Einwilligungsstatus auslesen:

// Check consent for a specific IAB purpose
UniConsentCMP.shared.isAllowPurposeById(purposeId: 1)

// Check consent for a specific IAB vendor
UniConsentCMP.shared.isAllowVendorById(vendorId: 1)

// Get all allowed purpose/vendor IDs
UniConsentCMP.shared.getAllowedPurposeIds()
UniConsentCMP.shared.getAllowedVendorIds()

// Check if GDPR applies
UniConsentCMP.shared.gdprApplies

// Check if any consent has been given
UniConsentCMP.shared.isConsentGiven()

Einwilligungsstatus bei Bedarf zurücksetzen:

// Reset consent status if required
UniConsentCMP.shared.clearConsentData()

Benutzerdefinierter First Layer (Alle akzeptieren / Alle ablehnen)

Verfügbar ab SDK-Version 26.7.0. Wenn Sie Ihre eigene First-Layer-Einwilligungsoberfläche erstellen, anstatt die CMP-Webview anzuzeigen, können Sie die Einwilligung direkt speichern:

// Grant consent for all purposes, special features and vendors
let saved = UniConsentCMP.shared.agreeAll()

// Reject all purposes, special features and vendors
let saved = UniConsentCMP.shared.rejectAll()

Beide APIs speichern dieselben Einwilligungswerte wie der CMP-UI-Flow (IAB-TCF-Schlüssel, Additional Consent und Consent-Mode-Signale) und lösen dasselbe .uiClose-Event für Abonnenten aus.

Für Nutzer in den USA und Kanada speichern beide APIs zusätzlich die jeweils geltende Entscheidung für CCPA, US State Privacy und IAB TCF Kanada, nach denselben Regeln wie die CMP Oberfläche, und schreiben die IAB GPP und US Privacy Schlüssel. Aktivieren Sie die API-Only Modi in den Projekteinstellungen des UniConsent Dashboards, damit das CMP Banner für diese Regionen nicht angezeigt wird.

Außerdem speichern sie die Entscheidung zu den Cookie-Kategorien, wo ein Cookie-Kategorien-Banner gilt (alle Kategorien oder nur „Unbedingt erforderlich“), sowie die benutzerdefinierten Zwecke und benutzerdefinierten Anbieter des Projekts.

Um zu wissen, welchen First Layer Sie anzeigen sollen, rufen Sie getPolicy() auf (ab SDK Version 26.10.0). Es gibt die für den Nutzer geltende Richtlinie zurück, nach denselben Regeln wie die CMP: gdpr (IAB TCF), tcfca (IAB TCF Kanada), uss (US State Privacy), ccpa, categories (siehe Cookie-Kategorien unten) oder none.

let cmp = UniConsentCMP.shared
if cmp.shouldRequestConsent() {
    // der Nutzer muss eine Entscheidung treffen: Ihren First Layer für diese Richtlinie anzeigen
    let policy = cmp.getPolicy() // gdpr, tcfca oder categories
}

Hinweis: Diese APIs laden die Vendor-Liste und die Projektkonfiguration synchron über das Netzwerk und geben false zurück, wenn die Einwilligung nicht gespeichert werden konnte (z. B. offline). Rufen Sie sie nach initialize() und nicht auf dem Main Thread auf.

Wichtig: Ihr benutzerdefinierter First Layer muss weiterhin die IAB-TCF-Anforderungen erfüllen (Zwecke und Anbieter offenlegen sowie Akzeptieren und Ablehnen gleichwertig anbieten). Nutzer sollten weiterhin die vollständige CMP-Oberfläche (launchCMP()) öffnen können, um granulare Entscheidungen zu treffen.

Einwilligung an WebView synchronisieren

Wenn Ihre App eine WKWebView öffnet, die eine Webseite mit dem UniConsent CMP-Tag lädt, können Sie den nativen Einwilligungsstatus übergeben, damit der CMP-Tag die bestehende Einwilligung erkennt und das Banner nicht erneut anzeigt.

Rufen Sie syncConsent(to:) vor dem Laden der Webseite auf:

import WebKit
import UniConsent

let webView = WKWebView(frame: .zero, configuration: WKWebViewConfiguration())

// Inject native consent before page load
UniConsentCMP.shared.syncConsent(to: webView)

// Then load your web page
webView.load(URLRequest(url: URL(string: "https://example.com")!))

Objective-C

// Initialize with event handler
@interface AppDelegate () <CMPEventHandler>
@end

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [[UniConsentCMP shared] subscribe:self];
    // initialize loads the location, config and vendor list over the network: keep it off the main thread
    dispatch_async(dispatch_get_global_queue(QOS_CLASS_USER_INITIATED, 0), ^{
        [[UniConsentCMP shared] initializeWithApiId:@"YOUR_APP_ID"];
    });
    return YES;
}

- (void)handleWithEvent:(CMPEvent *)event {
    switch (event.type) {
        case CMPEventTypeReady:
            NSLog(@"CMP ready");
            break;
        case CMPEventTypeUiClose:
            NSLog(@"TC String: %@", [[UniConsentCMP shared] getTCString]);
            break;
        default:
            break;
    }
}

@end

// Display CMP (full screen by default)
[UniConsentCMP.shared launchCMPWithRootVC:self];

// Display CMP with a specific display mode
// Use CMPDisplayModeFullScreen, CMPDisplayModeModalSheet, or CMPDisplayModeDialog
[UniConsentCMP.shared launchCMPWithRootVC:self displayMode:CMPDisplayModeModalSheet];

Bestimmten Bildschirm öffnen und weitere Optionen

Öffnen Sie die CMP auf einem bestimmten Bildschirm, zum Beispiel über einen Link „Datenschutzeinstellungen“ in Ihrer App. Der angeforderte Bildschirm wird immer geöffnet. Für Nutzer in den USA öffnen die Einstellungsbildschirme die für sie geltenden CCPA- oder US-State-Privacy-Einstellungen. Nutzer in Kanada sehen die IAB-TCF-Canada-Version der IAB-TCF-Bildschirme.

BildschirmZeigt
.GDPRFirstScreenErste Ebene (Banner)
.GDPRSecondScreenEinstellungen (Zwecke)
.GDPRVendorsScreenAnbieter
.CCPAFirstScreenErste Ebene CCPA
.CCPASecondScreenCCPA-Einstellungen
.USStateFirstScreenErste Ebene US State Privacy
.USStateSecondScreenUS-State-Privacy-Einstellungen
.CategoriesFirstScreenErste Ebene der Cookie-Kategorien (Banner)
.CategoriesSecondScreenEinstellungen der Cookie-Kategorien
let cmp = UniConsentCMP.shared

// Einstellungsbildschirm öffnen
cmp.setUIStage(.GDPRSecondScreen)
cmp.launchCMP(rootVC: self)

// CMP nur öffnen, wenn eine Einwilligung nötig ist (EU und IAB TCF Kanada), gibt zurück, ob sie geöffnet wurde
let opened = cmp.launchCMPIfNeeded(rootVC: self)

// Debug-Logs von SDK und CMP-Seite, in Release-Builds .error (Standard) verwenden
cmp.setLogLevel(.debug)

// nur zum Testen: CMP wie für einen Nutzer in einer anderen Region anzeigen, "EU", "CA" (Kanada), "CAQC" (Quebec), "US" plus Bundesstaatscode wie "USCA" oder "USTX", "BR", "CN", "ZA", "VN" oder ein anderer Ländercode, oder "N" (außerhalb dieser Regionen). Gilt auch für getPolicy() und shouldRequestConsent(); in Release-Builds entfernen
cmp.setTestRegion("CA")

// CMP schließen, falls sie geöffnet ist
cmp.dismissCMP()

// der Nutzer hat eine Auswahl getroffen: IAB TCF, CCPA, US State Privacy oder IAB TCF Kanada
let given = cmp.isConsentGiven()

// Tage seit Erstellung der IAB-TCF-Einwilligung, 0 wenn keine vorliegt
let days = cmp.getConsentAge()

// Region des Nutzers und für die USA und Kanada der Code des Bundesstaats bzw. der Provinz (leer, wenn unbekannt)
let geo = cmp.getGEO()
let state = cmp.getGEOState()

IAB GPP und US Privacy

Die CMP speichert die IAB GPP Schlüssel und den US Privacy Schlüssel in den UserDefaults der App, wie in den IAB Spezifikationen definiert. Werbe-SDKs in Ihrer App lesen sie dort aus; Codeänderungen sind nicht nötig. Die GPP Schlüssel werden geschrieben, wenn GPP, US State Privacy oder IAB TCF Kanada in den Projekteinstellungen des UniConsent Dashboards aktiviert ist. Der US Privacy Schlüssel wird geschrieben, sobald CCPA aktiviert ist.

SchlüsselWert
IABGPP_HDR_VersionGPP Version (1)
IABGPP_HDR_SectionsAbschnitts-IDs im GPP String, getrennt durch _
IABGPP_HDR_GppStringDer vollständige GPP String
IABGPP_GppSIDFür den Nutzer geltende Abschnitts-IDs, getrennt durch _, oder -1, wenn keiner gilt
IABGPP_2_StringIAB TCF EU String, wenn die DSGVO gilt
IABGPP_5_StringIAB TCF Kanada String, wenn Kanada TCF gilt
IABGPP_6_StringUS Privacy String, wenn der CCPA gilt
IABGPP_7_StringUS National (usnat) String, wenn US State Privacy oder der CCPA gilt
IABGPP_8_String bis IABGPP_27_StringDer Abschnitt für den Bundesstaat des Nutzers (8 Kalifornien bis 27 Rhode Island), wenn US State Privacy gilt, oder Kalifornien unter dem CCPA, gemäß der Einstellung GPP Sections
IABUSPrivacy_StringUS Privacy String, sobald CCPA aktiviert ist: die Entscheidung des Nutzers in der CCPA Region, sonst 1---

Die Schlüssel werden bei jedem Laden der CMP und nach jeder Einwilligungsentscheidung aktualisiert. Welche Nutzer die IABGPP_ Schlüssel erhalten, richtet sich nach GPP Signals in den Projekteinstellungen: Nutzer in Kanada immer (IAB TCF Canada), Nutzer in den USA, wenn US aktiviert ist, und Nutzer in der EU, wenn EU aktiviert ist. Nutzer, für die keine Region gilt, erhalten die Schlüssel ohne Abschnitt, solange US oder EU aktiviert ist, sonst keine Schlüssel. So lesen Sie sie selbst aus:

let gppString = UserDefaults.standard.string(forKey: "IABGPP_HDR_GppString") ?? ""
let gppSid = UserDefaults.standard.string(forKey: "IABGPP_GppSID") ?? ""

USA und Kanada

Apps unterstützen dieselben Optionen für die USA und Kanada wie Websites: CCPA, US State Privacy (mit Bundesstaatenliste, GPP Sections und MSPA Einstellungen) und IAB TCF Kanada. shouldRequestConsent() gibt für Nutzer in Kanada, für die IAB TCF Kanada gilt, true zurück, bis sie eine Entscheidung treffen. US Datenschutz ist ein Opt-out, daher werden Nutzer in den USA nicht von selbst gefragt: Sie sehen das US Banner oder die US Einstellungen, wenn Ihre App die CMP öffnet, zum Beispiel über einen Link zu den Datenschutzeinstellungen. Bis dahin schreibt das SDK, wenn CCPA oder US State Privacy aktiviert ist, für Nutzer in den USA die Standardwerte der US Privacy und GPP Schlüssel, ohne etwas anzuzeigen: kein Widerspruch, oder Widerspruch, wenn auf dem Gerät das Werbe-Tracking deaktiviert ist. US State Privacy ist bei neuen Mobile App Projekten zunächst aus; aktivieren Sie es im Dashboard.

Widerspruch gegen Werbe-Tracking auf dem Gerät

Hat der Nutzer das Werbe-Tracking auf dem Gerät deaktiviert, behandelt die CMP dies als US Widerspruch gegen Verkauf, Weitergabe und zielgerichtete Werbung, so wie Global Privacy Control auf Websites. Unter iOS ist das nicht erlaubtes Tracking in App Tracking Transparency; unter Android eine gelöschte Werbe-ID oder eingeschränktes Werbe-Tracking, gelesen über die Google Play-Dienste, wenn Ihre App sie enthält. Eine Entscheidung, die der Nutzer danach im Banner speichert, hat Vorrang.

GPP und US Privacy Strings auslesen

Das SDK gibt die gespeicherten Strings auch direkt zurück:

let gppString = UniConsentCMP.shared.getGPPString()
let gppSid = UniConsentCMP.shared.getGPPSID()
let usPrivacy = UniConsentCMP.shared.getUSPrivacyString()

Verfügbar ab SDK Version 26.10.0. Wo eine Region Cookie-Kategorien statt IAB TCF oder der US Richtlinien verwendet, zeigt die CMP ein Banner mit vier Kategorien: Unbedingt erforderlich, Leistung, Funktionalität sowie Targeting oder Werbung. Das gilt für:

  • LGPD in Brasilien, PIPL in China, POPIA in Südafrika und PDPD in Vietnam, wenn in den Projekteinstellungen des UniConsent Dashboards aktiviert
  • Ihre Regeln für andere Länder: eine Regel für ein Land und eine Regel für alle übrigen Länder
  • ein Consent Categories Projekt, in seinen Regionen

Bei Opt-in Kategorien ist zunächst nur „Unbedingt erforderlich“ aktiv, und shouldRequestConsent() gibt true zurück, bis der Nutzer eine Entscheidung trifft, und erneut, nachdem Sie die Konfigurationsversion geändert haben. Bei Opt-out Kategorien sind zunächst alle Kategorien aktiv (Targeting aus, wenn auf dem Gerät in den USA das Werbe-Tracking deaktiviert ist), und die App fragt nicht von selbst: Nutzer ändern sie über Ihren Link zu den Datenschutzeinstellungen. Opt-out gilt für eine Opt-out Regel für andere Länder und, in Apps, für ein Consent Categories Projekt in den USA.

Öffnen Sie die Kategorie-Bildschirme mit .CategoriesFirstScreen (Banner) und .CategoriesSecondScreen (Einstellungen). setTestRegion() akzeptiert außerdem BR, CN, ZA, VN und andere Ländercodes, um diese Regionen zu testen.

Benutzerdefinierte Zwecke und benutzerdefinierte Anbieter

Verfügbar ab SDK Version 26.10.0. Die benutzerdefinierten Zwecke und benutzerdefinierten Anbieter, die Sie in den Projekteinstellungen des UniConsent Dashboards hinzufügen, erscheinen in den CMP Bildschirmen: die benutzerdefinierten Zwecke in der ersten Ebene und den Einstellungen von IAB TCF sowie in den Einstellungen der Cookie-Kategorien, die benutzerdefinierten Anbieter in der IAB TCF Anbieterliste. In den Einstellungen von CCPA und US State Privacy werden nur sensible benutzerdefinierte Zwecke aufgeführt. In den Einstellungen der Cookie-Kategorien folgen die benutzerdefinierten Anbieter der Kategorie Targeting oder Werbung. Wo IAB TCF nicht gilt (Cookie-Kategorien und die USA), werden die benutzerdefinierten Anbieter schreibgeschützt unter der Anbieterliste im Menü aufgeführt, und in den Einstellungen der Cookie-Kategorien unter Targeting oder Werbung.

Um Ihre eigenen SDKs danach zu starten oder zu stoppen, fragen Sie das SDK, ob die App einen benutzerdefinierten Zweck oder Anbieter jetzt verwenden darf. Die Antwort folgt der Richtlinie des Nutzers, nach denselben Regeln, die die CMP für Tags verwendet:

  • IAB TCF, IAB TCF Kanada und Opt-in Cookie-Kategorien: erst erlaubt, nachdem der Nutzer zustimmt
  • die USA und Opt-out Cookie-Kategorien: erlaubt, bis der Nutzer widerspricht; sensible benutzerdefinierte Zwecke brauchen die Zustimmung des Nutzers, und die benutzerdefinierten Anbieter sind aus, wenn auf dem Gerät in den USA das Werbe-Tracking deaktiviert ist
  • keine Richtlinie: erlaubt
let cmp = UniConsentCMP.shared
if cmp.isCustomPurposeConsented(1) {
    // das SDK starten, das Ihr benutzerdefinierter Zweck 1 abdeckt
}
let vendorAllowed = cmp.isCustomVendorConsented(2)
let all = cmp.getCustomConsents() // ["purposes": ["1": true], "vendors": ["2": false]]

Rufen Sie sie erneut auf, nachdem die CMP geschlossen wurde oder sich die Einwilligung geändert hat. IDs, die das Projekt nicht hat, und alle IDs, bevor das SDK bereit ist, ergeben false.

Offenlegung von SDKs von Drittanbietern

Die CMP kann die SDKs von Drittanbietern in Ihrer App (Werbenetzwerke, Analyse, Attribution und andere) mit ihrem Unternehmen, ihrem Verwendungszweck und ihrer Datenschutzerklärung auflisten. Nutzer sehen sie unter der Anbieterliste, in allen Regionen schreibgeschützt: Es gibt keine Schalter, und Ihre App schaltet jedes SDK weiterhin anhand der Auswahl des Nutzers für Zwecke oder Cookie-Kategorien ein oder aus.

Um die Liste festzulegen, aktivieren Sie in Step 4: Advanced Features Ihres App-Projekts die Option Enable Third-party SDKs, wählen Sie im Tab Third-party SDKs Ihre SDKs aus oder fügen Sie eigene hinzu, und speichern und veröffentlichen Sie anschließend. In Ihrer App ist dafür kein Code nötig.

Standard-Einwilligungsstatus-KV einrichten:

<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key> <false/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE</key> <false/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE</key> <false/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <false/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <false/>

Analytics basierend auf den Einwilligungs-Flags steuern:

// SDK Version <= 25.6.1
public func onDismiss() {

    if(UniConsentCMP.shared.isAllowPurposeById(purposeId: 1)) {
        Analytics.setConsent([
          .analyticsStorage: .granted,
          .adStorage: .granted,
          .adUserData: .granted,
          .adPersonalization: .granted,
        ])
        Analytics.setAnalyticsCollectionEnabled(true);
    } else {
        Analytics.setConsent([
          .analyticsStorage: .denied,
          .adStorage: .denied,
          .adUserData: .denied,
          .adPersonalization: .denied,
        ])
        Analytics.setAnalyticsCollectionEnabled(false);
    }

    // other logics such as send analytics events
}

Weitere Informationen finden Sie unter Consent Mode für Apps einrichten

Hinweise

  1. Nutzer sollten die Möglichkeit haben, über eine Schaltfläche oder einen Link "Datenschutzeinstellungen" im Einstellungsbereich Ihrer Anwendung auf die CMP-UI zuzugreifen.
  2. Sie können die Funktion shouldRequestConsent() verwenden, um zu prüfen, ob basierend auf dem Status eine neue Einwilligung angefordert werden sollte. Zeigen Sie die CMP-UI bei Bedarf an, wenn ein Nutzer die Anwendung öffnet.
  3. Ab SDK-Version 25.6.1 müssen Sie Einwilligungsoptionen für FirebaseAnalytics oder bestimmte unterstützte AAP-SDKs nicht mehr manuell senden -- diese werden automatisch vom SDK verarbeitet. Weitere Informationen finden Sie unter Was sind Google AAP und Google MMP für mobile Apps?.

Änderungsprotokoll

26.11.0

  • Neu: setCustomConsent() speichert die Auswahl zu einem benutzerdefinierten Zweck aus einem eigenen Bildschirm Ihrer App, etwa einer Checkbox für das Tracking von E-Mail-Öffnungen; isCustomPurposeConsented() akzeptiert auch die im Dashboard festgelegte ID des Zwecks
  • Eine email Nutzer-ID wird als email_hash (SHA-256) gesendet; die Adresse selbst wird weder gespeichert noch gesendet
  • Die IAB GPP Schlüssel folgen den GPP Signals Einstellungen im Dashboard

26.10.0

  • IAB GPP und US Privacy Schlüssel für Werbe-SDKs
  • US State Privacy und IAB TCF Kanada in Apps, auch mit benutzerdefiniertem First Layer
  • Neu: getGPPString(), getGPPSID() und getUSPrivacyString()
  • Einstellungen für US State Privacy mit .USStateSecondScreen öffnen; neu: launchCMPIfNeeded(), setLogLevel() und getGEOState()
  • Erste Ebene von CCPA und US State Privacy mit .CCPAFirstScreen und .USStateFirstScreen öffnen; neu: setTestRegion(), um die CMP wie für einen Nutzer in einer anderen Region zu testen, etwa Kanada
  • Cookie-Kategorien in Apps: LGPD (Brasilien), PIPL (China), POPIA (Südafrika), PDPD (Vietnam), Ihre Regeln für andere Länder und Consent Categories Projekte, mit .CategoriesFirstScreen und .CategoriesSecondScreen
  • Neu: getPolicy(); agreeAll() und rejectAll() speichern außerdem die Cookie-Kategorien, benutzerdefinierten Zwecke und benutzerdefinierten Anbieter
  • setTestRegion() akzeptiert außerdem BR, CN, ZA, VN und andere Ländercodes und gilt auch für getPolicy() und shouldRequestConsent()
  • Neu: isCustomPurposeConsented(), isCustomVendorConsented() und getCustomConsents(): die benutzerdefinierten Zwecke und Anbieter, die die App nach der Richtlinie des Nutzers jetzt verwenden darf

26.9.0

  • Unterstützung für IAB TCF 2.4

Beim Datenschutz immer einen Schritt voraus

Datenschutzgesetze, Einwilligung und Compliance, ein paar E-Mails im Monat.

Kein Spam, jederzeit abbestellbar. Datenschutz