Leading Consent Management Platform

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

Einrichtung für App-Publisher: Werbe- und Analyse-SDKs nach Region

Dieser Leitfaden richtet sich an Publisher mobiler Apps. Er richtet das UniConsent-App-SDK mit den Werbe-, Analyse- und Attributions-SDKs ein, die die meisten Apps verwenden, damit jedes SDK in Europa und in Ihren anderen Nutzerregionen das benötigte Einwilligungssignal erhält.

Zeitaufwand: etwa 1 bis 2 Stunden: etwa 10 Minuten für Schritt 1, 20 bis 30 Minuten für das SDK in Schritt 2, 5 bis 15 Minuten für jedes SDK in Schritt 4 und etwa 30 Minuten zum Testen und Prüfen in den Schritten 6 und 7. Im Dashboard veröffentlichte Änderungen erreichen die App, wenn sie den Einwilligungsbildschirm das nächste Mal lädt.

Wer macht was: Die Schritte 1 und 3 erledigen Sie im UniConsent-Dashboard. Die Schritte 2, 4 und 5 ändern den Code Ihrer App, das übernimmt Ihr App-Entwickler. Die Schritte 6 und 7 erfolgen auf einem Testgerät.

Schritt 1: Ihr App-Projekt erstellen

Erstellen Sie im Dashboard ein App-Projekt und kopieren Sie seine App ID. Das App-Projekt verwendet in Europa IAB TCF: Google verlangt für Anzeigen im EWR, im Vereinigten Königreich und in der Schweiz eine von Google zertifizierte CMP, die IAB TCF verwendet, und UniConsent ist eine von Google zertifizierte CMP der Gold-Stufe.

Aktivieren Sie dann die Richtlinien für Ihre anderen Regionen: CCPA und US State Privacy für die USA sowie IAB TCF Canada für Kanada. Aktivieren Sie auch IAB GPP, damit Werbe-SDKs die Auswahlen aus den USA und Kanada erhalten.

Schritt 2: Das UniConsent-SDK hinzufügen

Fügen Sie das UniConsent-SDK für Ihre Plattform hinzu: Android, iOS, Flutter, React Native. Starten Sie es beim App-Start mit Ihrer App ID, vor Ihren Werbe- und Analyse-SDKs, und lassen Sie es den Einwilligungsbildschirm anzeigen, wenn eine Einwilligung nötig ist. Jede SDK-Anleitung zeigt, wie das geht.

Schritt 3: Was jede Region erhält

RegionWas Nutzer sehenWas Ihre SDKs erhalten
EuropaDen IAB TCF-Einwilligungsbildschirm beim ersten StartDie IAB TCF-Auswahl und Google Consent Mode für Firebase
KanadaDen IAB TCF Canada-Einwilligungsbildschirm beim ersten StartDen IAB GPP-Abschnitt für Kanada nach der Auswahl des Nutzers
USAKein Bildschirm beim Start: US-Datenschutz ist ein Widerspruchsmodell. Nutzer widersprechen in den Datenschutzeinstellungen Ihrer App (Schritt 5).Den US-Privacy-String und die IAB GPP-US-Abschnitte. Ist das Anzeigen-Tracking auf dem Gerät deaktiviert, gilt das als Widerspruch.
Überall sonstKein EinwilligungsbildschirmWerbung und Analyse laufen wie gewohnt

Europa umfasst die Europäische Union, Norwegen, Island und Liechtenstein, das Vereinigte Königreich, die Schweiz sowie Albanien, Andorra, Belarus, Bosnien und Herzegowina, Kosovo, Moldau, Monaco, Montenegro, Nordmazedonien, San Marino, Serbien und die Ukraine.

Im Vereinigten Königreich verlangen die UK GDPR und die Leitlinien des ICO eine Einwilligung vor nicht notwendiger Speicherung und Nachverfolgung, in Apps wie auf Websites. Behalten Sie das Vereinigte Königreich daher in Ihrer Region Europa.

Wenn Sie die Richtlinie für eine Region deaktivieren, werden Nutzer aus dieser Region so behandelt, als wäre keine CMP installiert: Es erscheint kein Einwilligungsbildschirm, und kein SDK wird zurückgehalten.

In den USA gilt in Kalifornien CCPA / CPRA, und in Virginia, Colorado, Utah, Connecticut, Florida, Montana, Oregon, Texas, Delaware, Iowa, Nebraska, New Hampshire, New Jersey, Tennessee, Minnesota, Maryland, Indiana, Kentucky und Rhode Island gilt US State Privacy. Nutzer können dem Verkauf und der Weitergabe ihrer Daten sowie gezielter Werbung widersprechen, und die Auswahl wird in IAB GPP und, für Kalifornien, im US-Privacy-String an Werbe-SDKs weitergegeben. Siehe US State Privacy einrichten.

Schritt 4: Ihre SDKs integrieren

Werbe-SDKs und Firebase lesen die Auswahl des Nutzers selbst aus den standardisierten IAB-Schlüsseln, die das UniConsent-SDK auf dem Gerät speichert. Sie müssen sie daher nicht selbst zurückhalten. Fordern Sie Anzeigen an, sobald die Auswahl des Nutzers bekannt ist.

SDKSo geht esAnleitung
Google Mobile Ads (AdMob, Ad Manager)Liest die IAB TCF- und IAB GPP-Schlüssel automatisch.Ihre Plattform-Anleitung: Android, iOS, Flutter, React Native
Mediation und andere Werbenetzwerke (zum Beispiel AppLovin MAX, Unity LevelPlay)Die meisten lesen die IAB-Schlüssel. Prüfen Sie die Dokumentation jedes Netzwerks: Manche benötigen die US-Auswahl zusätzlich über eine eigene Einstellung.
Firebase AnalyticsDas UniConsent-SDK sendet die Auswahl des Nutzers automatisch an Firebase. Setzen Sie die Standard-Einwilligung in Ihren App-Einstellungen auf aus, wie Ihre Plattform-Anleitung zeigt.Ihre Plattform-Anleitung
Attribution (Adjust, AppsFlyer, Branch, Airbridge)Das UniConsent-SDK gibt die Auswahl an unterstützte Attributions-SDKs weiter.App-Attributionspartner
App Tracking Transparency (iOS)Zeigen Sie die ATT-Abfrage nach der UniConsent-Auswahl. Ist Tracking nicht erlaubt, behandelt UniConsent das als US-Widerspruch.iOS mit ATT
Webseiten in Ihrer App (WebViews)Geben Sie die Auswahl des Nutzers an die Webseite weiter, damit die CMP der Website nicht erneut fragt.„Sync Consent to WebView“ in Ihrer Plattform-Anleitung

Schritt 5: Datenschutzeinstellungen in Ihre App aufnehmen

Nutzer müssen ihre Auswahl jederzeit ändern können, und Nutzer in den USA widersprechen hier. Fügen Sie dem Einstellungsbildschirm Ihrer App einen Eintrag Datenschutzeinstellungen hinzu, der den UniConsent-Bildschirm öffnet. Ihre Plattform-Anleitung zeigt, wie Sie einen bestimmten Bildschirm öffnen, zum Beispiel die Einstellungen: Android, iOS, Flutter, React Native.

Schritt 6: Jede Region testen

Setzen Sie in Ihrer App eine Testregion, um die Bildschirme einer anderen Region zu sehen, und wiederholen Sie dies mit CA (Kanada), CAQC (Quebec), USCA (Kalifornien), USTX (Texas) und N (außerhalb dieser Regionen):

// for testing only: remove it in release builds
UniConsent.getInstance().setTestRegion("EU");

Die UniConsent-Demo-Apps haben eine Auswahl für die Testregion. Entfernen Sie die Testregion, bevor Sie Ihre App veröffentlichen.

Schritt 7: Prüfen, ob Ihre SDKs der Auswahl folgen

Führen Sie jede Prüfung mit einer Neuinstallation oder nach dem Löschen der App-Daten durch, damit frühere Auswahlen nicht übernommen werden.

In Europa prüfen

  1. Öffnen Sie die App mit der Testregion EU. Der Einwilligungsbildschirm erscheint beim ersten Start, und Anzeigen laden erst nach der Auswahl.
  2. Alle akzeptieren. Schließen und öffnen Sie die App erneut: Der Einwilligungsbildschirm erscheint nicht mehr, und Anzeigen laden.
  3. Klicken Sie bei einer Neuinstallation auf Alle ablehnen. Anzeigen laden als nicht personalisierte oder eingeschränkte Anzeigen, sofern Ihre Werbepartner sie unterstützen.
  4. Öffnen Sie die Datenschutzeinstellungen in Ihrer App, ändern Sie Ihre Auswahl und prüfen Sie, ob sie nach dem erneuten Öffnen der App erhalten bleibt.

In den USA prüfen

  1. Öffnen Sie die App mit der Testregion USCA. Es erscheint kein Einwilligungsbildschirm, und Anzeigen laden.
  2. Öffnen Sie die Datenschutzeinstellungen, widersprechen Sie und öffnen Sie die App erneut: Der Widerspruch bleibt erhalten.

Für Ihren Entwickler

Das UniConsent-SDK speichert die Auswahl im Standardspeicher der App (SharedPreferences unter Android, NSUserDefaults unter iOS), wo Werbe-SDKs sie lesen. Ihr Entwickler kann diese Schlüssel prüfen oder sie mit den Methoden des SDK lesen, zum Beispiel getGPPString() und getUSPrivacyString():

IABTCF_TCString        IAB TCF choice (Europe)
IABGPP_HDR_GppString   IAB GPP string (US and Canada)
IABUSPrivacy_String    US Privacy string (California)

Häufige Fehler

  • Die CMP hinzufügen, ohne Ihre SDKs zu integrieren. Der Einwilligungsbildschirm erscheint, aber Werbe-, Analyse- oder Attributions-SDKs, die vor der Auswahl starten oder in ihren eigenen Einstellungen auf Einwilligung gesetzt sind, ignorieren ihn. Integrieren Sie jedes SDK wie in Schritt 4 und prüfen Sie es mit Schritt 7.
  • Die Berichte Ihrer Anbieter nach der Veröffentlichung nicht prüfen. Öffnen Sie einige Tage nach der Veröffentlichung die Berichte Ihrer SDKs, zum Beispiel AdMob oder Ad Manager, Ihre Mediationsplattform, Firebase und Ihren Attributionspartner, und vergleichen Sie sie mit den Tagen davor. Ein Rückgang im Umfang des Anteils der ablehnenden Nutzer ist zu erwarten. Ein deutlich größerer Rückgang oder ausbleibende Daten bedeuten meist, dass ein SDK vollständig zurückgehalten wird oder das Einwilligungssignal nicht erhält.

Noch Fragen?

Kontaktieren Sie uns: support@uniconsent.com