Info
Inhalt
Bücher
CMP
Integration in Ihre ...
[Android] 0. Migration...

[Android] 0. Migrationsleitfaden

Dieser Leitfaden hilft Ihnen bei der Migration von der vorherigen Version des CMP SDK zur aktuellen Version. Wir behandeln die Änderungen bei Methodennamen, Parametern und neuen oder veralteten Funktionen. Beispiele für Demo-Apps finden Sie unter diesen Link. Es gibt zwei Ordner, einen mit einer Demo-App, die vollständig in Java entwickelt wurde, einschließlich eines Wrappers für Java namens JavaCMPManager ein anderes, das vollständig in Kotlin entwickelt wurde. 

Bitte beachten Sie, dass diese Version des CMP SDK von Grund auf neu erstellt wurde und daher eine Wichtige bahnbrechende Änderungen, da alle Methoden umbenannt wurden, ebenso wie die Signaturen, und jetzt auch Rückrufe für fast alle Methoden angeboten werden. Auf alle Fällemüssen Sie Ihren Code ändern und Ihre Abhängigkeiten aktualisieren, um sicherzustellen, dass Ihre mobile App wie erwartet funktioniert. Wir haben auch Ich rate Ihnen dringend, Ihre Benutzer aufzufordern, Ihre mobile App zu deinstallieren und neu zu installieren, um Probleme mit den auf dem Gerät gespeicherten Daten zu vermeiden.

Aufbewahrungsorte

Bitte beachten Sie, dass sich alle unsere Repositories für das Android SDK geändert haben. Befolgen Sie die nachstehenden Anweisungen, um herauszufinden, wohin Sie Ihren Abhängigkeitsmanager verweisen müssen. 

Maven

Ersetzen Sie in Ihrer Gradle-Datei die vorherige Zeile durch die folgende:

implementation("net.consentmanager.sdkv3:cmsdkv3:3.1.1")

Synchronisieren Sie Ihr Projekt nach der Änderung. 

Wichtige Migrationspunkte

  1. Delegiertenmuster: Anstelle einzelner Listener verwendet die neue Version ein einzelnes Delegate-Protokoll (CMPManagerDelegate) zur Behandlung von Ereignissen. Es enthält 4 Hauptereignisse:
    1. didReceiveConsent(consent: String, jsonObject: Map<String, Any>)
      Dies wird ausgelöst, wenn die Zustimmungsebene geschlossen wurde, nachdem der Benutzer seine Zustimmungen aktualisiert hatte, ODER wenn Methoden aufgerufen werden, die Änderungen an den Zustimmungen bewirken, wie „acceptAll“, „rejectAll“, „acceptVendors“, „rejectVendors“ usw. Dies bedeutet, dass der Benutzer einige oder alle Zustimmungen akzeptiert oder abgelehnt hat und dass diese korrekt auf dem Gerät gespeichert wurden.
    2. didShowConsentLayer
      Dies wird ausgelöst, wenn die Zustimmungsebene tatsächlich angezeigt wurde. Es bedeutet, dass auf dem Gerät keine gültige Zustimmung vorhanden war und daher eine neue eingeholt werden muss.
    3. didCloseConsentLayer
      Dies wird ausgelöst, wenn das SDK die Notwendigkeit einer Zustimmung überprüft hat, diese aber nicht erforderlich war und die Ebene nicht angezeigt wurde. Das bedeutet, dass bereits eine gültige Zustimmung im Gerät vorhanden ist, sodass keine neue Zustimmung erforderlich ist und die Zustimmungsebene nicht angezeigt wird.
    4. didReceiveError
      Dies wird ausgelöst, wenn der SDK-Vorgang einen Fehler verursacht hat.
  2. Vervollständigungshandler: Viele Methoden enthalten jetzt Abschlusshandler für asynchrone Vorgänge. Aktualisieren Sie Ihren Code, um diese Rückrufe entsprechend zu verarbeiten.
  3. Zustimmungszeichenfolge: Verwende exportCMPInfo() statt getConsentString() um die Einwilligungsinformationen abzurufen.
  4. Einwilligungen von Anbietern und Zwecken: Die Methoden zum Einholen von Anbieter- und Zweckzustimmungen geben jetzt ID-Arrays zurück. Möglicherweise müssen Sie Ihre Logik anpassen, um diese Arrays verarbeiten zu können.
  5. US-Datenschutzzeichenfolge: Das getUSPrivacyString() Methode ist veraltet. Wenn Sie dies zur Einhaltung des CCPA verwendet haben, beachten Sie bitte, dass diese Methode nicht mehr verfügbar ist.
  6. Einwilligungspflichtprüfung: Verwenden Sie das Neue checkAndOpen(completion:) Methode, um automatisch zu bestimmen, ob eine Zustimmung erforderlich ist, bevor die Zustimmungsebene angezeigt wird.

Änderungen an Methoden und Signaturen

1. Initialisierung
  • Old: CmpManager.initialize(context: Context, cmpConfig: CmpConfig)
  • Neu: CmpManager.createInstance(context: Context, cmpConfig: CmpConfig)
2. UI-Konfiguration festlegen
  • Old: .withCmpViewControllerConfigurationBlock { ... }
  • Neu: Die Option wird nicht bereitgestellt, aber Sie können eine Wrapper-Aktivität erstellen und den Lebenszyklus und das Erscheinungsbild auf Ihrer Seite des Codes steuern.
3. Überprüfung der Einwilligung
  • Old: check({ ... }, isCached: Bool),
  • Neu: checkAndOpen(completion: (Error?) -> Void)
3. Zustimmungsebene prüfen und bei Bedarf öffnen
  • Old: checkAndOpenConsentLayer()
  • Neu: checkAndOpen(completion: (Error?) -> Void)
4. Öffnen Sie die Zustimmungsebene
  • Old: openConsentLayer()
  • Neu: forceOpen(completion: (Result<Unit>) -> Unit)
5. Alle Einwilligungen akzeptieren
  • Old: acceptAll(callback: ConsentCallback)
  • Neu: cceptAll(completion: (Result<Unit>) -> Unit)
6. Alle Einwilligungen ablehnen
  • Old: rejectAll(onFinish: () -> Unit)
  • Neu: rejectAll(completion: (Result<Unit>) -> Unit)
7. Zwecke aktivieren
  • Old: enablePurposeList(purposes: List<String>, updateVendor: Boolean, onConsentReceivedCallback: OnConsentReceivedCallback?)
  • Neu: acceptPurposes(purposes: List<String>, updatePurpose: Boolean, completion: (Result<Unit>) -> Unit)
8. Zwecke deaktivieren
  • Old: disablePurposeList(purposes: List<String>, updateVendor: Boolean, onConsentReceivedCallback: OnConsentReceivedCallback?)
  • Neu: rejectPurposes(purposes: List<String>, updateVendor: Boolean, completion: (Result<Unit>) -> Unit)
9. Anbieter aktivieren
  • Old: enableVendorList(vendors: List<String>, onConsentReceivedCallback: OnConsentReceivedCallback?)
  • Neu: acceptVendors(vendors: List<String>, completion: (Result<Unit>) -> Unit)
10. Anbieter deaktivieren
  • Old: disableVendorList(vendors: List<String>, onConsentReceivedCallback: OnConsentReceivedCallback?)
  • Neu: rejectVendors(vendors: List<String>, completion: (Result<Unit>) -> Unit)
11. Alle Zwecke erfüllen
  • Old: getAllPurposes(): List<String>
  • Neu: getAllPurposesIDs(): List<String>
12. Aktivieren Sie die Zwecke
  • Old: getEnabledPurposes(): List<String>
  • Neu: getUserStatus(): UserConsentStatus
13. Alle Anbieter abrufen
  • Old: getAllVendors(): List<String>
  • Neu: getUserStatus(): UserConsentStatus
14. Holen Sie sich aktivierte Anbieter
  • Old: getEnabledVendors(): List<String>
  • Neu: getUserStatus(): UserConsentStatus
15. Zweckzustimmung prüfen
  • Old: hasPurposeConsent(String): Boolean
  • Neu: getStatusForPurpose(id: String): ConsentStatus
16. Zustimmung des Anbieters prüfen
  • Old: hasVendorConsent(String): Boolean
  • Neu: getStatusForVendor(id: String): ConsentStatus
17. CMP-Zeichenfolge exportieren
  • Old: exportCmpString() : String
  • Neu: exportCMPInfo(): String
18. CMP-Zeichenfolge importieren
  • Old: importCmpString(consentString: String, completionHandler: ((Error?) -> Unit)?)
  • Neu: importCMPInfo(cmpString: String, completion: (Result<Unit>) -> Unit)
19. Einwilligungsdaten zurücksetzen
  • Old: reset()
  • Neu: resetConsentManagementData(completion: (Result<Unit>) -> Unit)
19. Umgang mit dem Google Consent Mode-Status
  • Old: withGoogleAnalyticsCallback(analyticsListener: CmpGoogleAnalyticsInterface)
  • Neu: getGoogleConsentModeStatus

Veraltete Methoden:

  • checkIfConsentIsRequired(completion: @escaping (Bool) -> Void)

  • hasUserChoice() -> Bool

  • hasPurposeConsent(id: String) -> Bool

  • hasVendorConsent(id: String) -> Bool

  • openConsentLayer(completion: @escaping (NSError?) -> Void)

  • getAllPurposesIDs() -> [String]

  • getEnabledPurposesIDs() -> [String]

  • getDisabledPurposesIDs() -> [String]

  • getAllVendorsIDs() -> [String]

  • getEnabledVendorsIDs() -> [String]

  • getDisabledVendorsIDs() -> [String]

  • getUSPrivacyString()
  • calledThisDay(): Boolean
  • getConsentstring(): String
  • getGoogleACString(): String
  • getUSPrivacyString(): String
  • initialize(context: Context, cmpConfig: CmpConfig)
  • setCallbacks(...)
  • withGoogleAnalyticsCallback(analyticsListener: CmpGoogleAnalyticsInterface)

Migrationsbeispiele

Kotlin

// ============================================
// Previous versions
// ============================================

class CmpDemoActivity : FragmentActivity() {

    private lateinit var cmpManager: CmpManager

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        
        val config = CmpConfig.apply {
            id = "<YOUR-CONSENTMANAGER-APP-ID>" // example: b238acdf1a
            domain = "<YOUR-CONSENTMANAGER-APP-DOMAIN>" // example: delivery.consentmanager.net
            appName = "<YOUR-CONSENTMANAGER-APP-NAME>" // example: testApp
            language = "<YOUR-CONSENTMANAGER-APP-LANGUAGE>" // example: DE
        }
        
        cmpManager = CmpManager.createInstance(this, config)
        cmpManager.initialize(this)
    }
}
// ============================================
// SDK v3 implementation
// ============================================
                                           
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        enableEdgeToEdge()

        val urlConfig = UrlConfig(
            id = "09cb5dca91e6b",
            domain = "delivery.consentmanager.net",
            language = "EN",
            appName = "CMDemoAppKotlin"
        )

        // This UI Config for Android is limited, but you have the option to create an activity wrapper
        // to have full control over the appearance and the position
        val webViewConfig = ConsentLayerUIConfig(
            position = ConsentLayerUIConfig.Position.FULL_SCREEN, // that's the only position available for Android
            backgroundStyle = ConsentLayerUIConfig.BackgroundStyle.dimmed(Color.BLACK, 0.5f),
            cornerRadius = 10f,
            respectsSafeArea = true,
            isCancelable = false
        )

        cmpManager = CMPManager.getInstance(
            context = this,
            urlConfig = urlConfig,
            webViewConfig = webViewConfig,
            delegate = this
        )

        cmpManager.setActivity(this)

        checkAndOpen()
    }

    private fun checkAndOpenConsentLayer() {
        cmpManager.checkWithServerAndOpenIfNecessary { result ->
            result.onSuccess {
                showCMPDemoScreen()
            }.onFailure { error ->
                Log.e("DemoApp", "Check and open consent layer failed with error: $error")
            }
        }
    }

    private fun showCMPDemoScreen() {
        setContent {
            MaterialTheme {
                Surface(
                    modifier = Modifier.fillMaxSize(),
                    color = MaterialTheme.colorScheme.background
                ) {
                    CMPDemoScreen(cmpManager)
                }
            }
        }
    }

    override fun onConfigurationChanged(newConfig: Configuration) {
        Log.d("CMP DemoApp", "Configuration changed")
        super.onConfigurationChanged(newConfig)
        cmpManager.onApplicationResume()
    }

    override fun onPause() {
        Log.d("CMP DemoApp", "Activity paused")
        super.onPause()
        cmpManager.onApplicationPause()
    }

    override fun onDestroy() {
        Log.d("CMP DemoApp", "Activity destroyed")
        super.onDestroy()
        cmpManager.onActivityDestroyed()
    }

    override fun didReceiveConsent(consent: String, jsonObject: Map<String, Any>) {
        Log.d("CMP DemoApp", "Consent Layer successfully received consent message.")
        runOnUiThread {
            showCMPDemoScreen()
        }
    }

    override fun didShowConsentLayer() {
        Log.d("CMP DemoApp", "Consent Layer open message received.")
    }

    override fun didCloseConsentLayer() {
        Log.d("CMP DemoApp", "Consent Layer close message received.")
        runOnUiThread {
            showCMPDemoScreen()
        }
    }

    override fun didReceiveError(error: String) {
        Log.e("CMP DemoApp", "SDK error: $error")
    }
}

Javac 

// ===================================================
// Previuous versions
// ===================================================

public class CmpDemoActivity extends AppCompatActivity {

    private CmpManager cmpManager;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        CmpConfig cmpConfig = CmpConfig.INSTANCE;
        cmpConfig.setId("<YOUR-CONSENTMANAGER-APP-ID>"); // example: a000aaaa1a
        cmpConfig.setDomain("<YOUR-CONSENTMANAGER-APP-DOMAIN>"); // example: delivery.consentmanager.net
        cmpConfig.setAppName("<YOUR-CONSENTMANAGER-APP-NAME>"); // example: testApp
        cmpConfig.setLanguage("<YOUR-CONSENTMANAGER-APP-LANGUAGE>"); // example: EN
        cmpConfig.setTimeout(4000);

        cmpManager = CmpManager.createInstance(this, cmpConfig);
        cmpManager.initialize(this)
    }
}

// ===========================================
// SDK v3 implementation
// ===========================================

    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_cmp_demo);

        UrlConfig urlConfig = new UrlConfig(
                "09cb5dca91e6b",
                "delivery.consentmanager.net",
                "EN",
                "CMDemoAppJava"
        );

      // This UI Config for Android is limited, but you have the option to create an activity wrapper
      // to have full control over the appearance and the position

        ConsentLayerUIConfig webViewConfig = new ConsentLayerUIConfig(
                ConsentLayerUIConfig.Position.FULL_SCREEN,
                ConsentLayerUIConfig.BackgroundStyle.dimmed(Color.BLACK, 0.5f),
                10f,
                true,
                false
        );

        JavaCMPManager cmpManager = JavaCMPManager.getInstance(this, urlConfig, webViewConfig, this);
        cmpManager.setActivity(this);

        cmpManager.checkAndOpen(result -> {
            if (result.isSuccess()) {
            } else {
                Log.e("JavaDemoAp", "Initialize method failed with error: " + result.exceptionOrNull());
            }
            return null;
        });
    }

    private void showCMPDemoScreen() {
        Intent intent = new Intent(this, CMPDemoActivity.class);
        startActivity(intent);
        finish();
    }

    @Override
    public void didShowConsentLayer() {
        Log.d("CMP JavaDemoAp", "Consent Layer open message received.");
    }

    @Override
    public void didCloseConsentLayer() {
        Log.d("CMP JavaDemoAp", "Consent Layer close message received.");
    }

    @Override
    public void didReceiveError(@NonNull String error) {
        Log.e("CMP JavaDemoAp", "SDK error: " + error);
    }

    @Override
    public void didReceiveConsent(@NonNull String consent, @NonNull Map<String, Any> jsonObject) {
        Log.d("CMP JavaDemoAp", "Consent received: " + consent);
        runOnUiThread(this::showCMPDemoScreen);
    }

    @Override
    public void onPointerCaptureChanged(boolean hasCapture) {
        super.onPointerCaptureChanged(hasCapture);
    }

    @Override
    public void addMenuProvider(@NonNull MenuProvider provider, @NonNull LifecycleOwner owner, @NonNull Lifecycle.State state) {

    }
}

 

Details
Revision # 6
Erstellt 5 Monate her by fabio.torre@iubenda.com
Aktualisiert 3 Wochen her by fabio.torre@iubenda.com
Seitennavigation
  • Aufbewahrungsorte
  • Maven
  • Wichtige Migrationspunkte
  • Änderungen an Methoden und Signaturen
  • 1. Initialisierung
  • 2. UI-Konfiguration festlegen
  • 3. Überprüfung der Einwilligung
  • 3. Prüfen und Öffnen von Kont...
  • 4. Öffnen Sie die Zustimmungsebene
  • 5. Alle Einwilligungen akzeptieren
  • 6. Alle Einwilligungen ablehnen
  • 7. Zwecke aktivieren
  • 8. Zwecke deaktivieren
  • 9. Anbieter aktivieren
  • 10. Anbieter deaktivieren
  • 11. Alle Zwecke erfüllen
  • 12. Aktivieren Sie die Zwecke
  • 13. Alle Anbieter abrufen
  • 14. Holen Sie sich aktivierte Anbieter
  • 15. Zweckzustimmung prüfen
  • 16. Zustimmung des Anbieters prüfen
  • 17. CMP-Zeichenfolge exportieren
  • 18. CMP-Zeichenfolge importieren
  • 19. Einwilligungsdaten zurücksetzen
  • 19. Umgang mit Google Con...
  • Veraltete Methoden:
  • Migrationsbeispiele
  • Kotlin
  • Javac 
    • Sie haben noch kein Konto?

    Werden Sie DSGVO-konform mit unserer DSGVO Cookie Consent Manager-Lösung. Probieren Sie es jetzt kostenlos aus!

    DSGVO-Cookie Consent Manager
    Nach oben