Voraussetzungen
-
ECID Version 4.0.
Laden Sie unsere neueste ECID-Version herunter.
-
Unterstützungsbibliotheken:
- ECID 4.0 oder höher
- AppMeasurement 2.11 oder höher
- DIL 9.0
- AT.js Version 1.7.0
- AT.js Launch-Erweiterung, Version 9.0
- Für Analytics: App Measurement 2.11 mit Erweiterung 1.6
- Für Target: Erweiterung 0.9.1
-
Machen Sie sich mit dem Framework zur Zustimmungsverwaltung vertraut, das Sie mit Opt-in verwenden, und stellen Sie sicher, dass Sie alle zusätzlichen Voraussetzungen überblicken.
-
Die Datenschutzanforderungen Ihrer Firma richten sich danach, für welche Art der DSGVO-Konformität Sie sich entscheiden. Beachten Sie, welche vordefinierten Bibliotheken für die Datenschutz-Teams Ihrer Firma in Ordnung sind.
Wenn Sie Tags in Adobe Experience Platform verwenden, nutzen Sie die Opt-in-Erweiterung, um den Opt-in-Dienst zu konfigurieren.
Opt-in-Kategorien
Die Opt-in-Voreinstellungen eines Besuchers beziehen sich auf eine Adobe Experience Cloud-Lösung, wobei jede Lösung einer Kategorie entspricht. Kategorien werden durch das adobe.OptInCategories Objekt bereitgestellt. Die ECID-Komponente entspricht beispielsweise adobe.OptInCategories. ECID. Die Definition von adobe.OptInCategories lautet:
Opt-in-Einstellungen werden pro Kategorie verwaltet, wobei jede Experience Cloud-Lösung einer Kategorie entspricht:
adobe.OptInCategories = {
AAM: "aam",
TARGET: "target",
ANALYTICS: "aa",
ECID: "ecid",
};
Mit dem Opt-in-Dienst können Sie die Berechtigungsvoreinstellungen der Besucher für jede Adobe-Lösung auf Ihrer Site festlegen. Das Objekt umfasst eine Bibliothek zum Speichern der Einstellungen eines Besuchers nach genehmigter Kategorie und unterstützt einen sequenziellen Ablauf, bei dem der Genehmigungsprozess Voreinstellungen zum Bestätigen oder Ablehnen jeder Kategorie erhält. Sie können festlegen, dass den Lösungen/Kategorien gleichzeitig oder einzeln zugestimmt wird.
Die clientseitigen Bibliotheken aller Adobe-Lösungen sind vom Opt-in-Dienst abhängig. Es werden nur Cookies generiert, wenn eine Berechtigung dafür erteilt wurde. Opt-in unterstützt verschiedene Ansätze zur Bereitstellung und Aktualisierung von Zustimmungseinstellungen für den aktuellen Besucher. Dieser Abschnitt enthält Beispiele für die Festlegung von Opt-in-Dienstvoreinstellungen. Eine vollständige Liste der Funktionen und Parameter finden Sie in der Opt-in-API-Referenz.
Opt-in-Dienstkonfigurationen werden in der Visitor getInstance() JS-Funktion bereitgestellt, die das globale adobe-Objekt instanziiert. Im Folgenden werden die Visitor JS-Konfigurationseinstellungen für den Opt-in-Dienst aufgeführt.
Beispiel für eine Opt-in-Konfiguration bei der Initialisierung des globalen Visitor-Objekts
// FORMAT: Object<adobe.OptInCategories enum: boolean>
var preOptInApprovalsConfig = {};
preOptInApprovals[adobe.OptInCategories.ANALYTICS] = true;
// FORMAT: Object<adobe.OptInCategories enum: boolean>
// If you are storing the OptIn permissions on your side (in a cookie you manage or in a CMP),
// you have to provide those permissions through the previousPermissions config.
// previousPermissions will overwrite preOptInApprovals.
var previousPermissionsConfig = {};
previousPermissionsConfig[adobe.OptInCategories.AAM] = true;
previousPermissionsConfig[adobe.OptInCategories.ANALYTICS] = false;
Visitor.getInstance("YOUR_ORG_ID", {
"doesOptInApply": true, // NOTE: This can be a function that evaluates to true or false.
"preOptInApprovals": preOptInApprovalsConfig,
"previousPermissions": previousPermissionsConfig,
"isOptInStorageEnabled": true
});
Umgang mit Änderungen der Zustimmung
Während Benutzer Ihre Site besuchen, können sie jederzeit Voreinstellungen zum ersten Mal festlegen oder ihre Voreinstellungen mithilfe Ihrer CMP ändern. Nachdem Besucher-JS mit den ursprünglichen Einstellungen initialisiert wurde, können die Berechtigungen des Besuchers geändert werden. Eine Liste der Funktionen zur Zustimmungsverwaltung finden Sie unter Änderungen an den Zustimmungsparametern.
Opt-in-Workflows
Der Opt-in-Dienst unterstützt einen Workflow, bei dem Berechtigungen über mehrere Anfragezyklen erfasst werden können und Voreinstellungen einzeln festgelegt werden. Mit folgenden Funktionen und durch Festlegen von true für shouldWaitForComplete kann Ihre Lösung zunächst die Zustimmung für eine Kategorie oder Untergruppe von Kategorien erfassen und dann für die nächste Kategorie oder Untergruppe von Kategorien. Beim ersten Aufruf hat die Eigenschaft adobe.optIn.status den Wert pending, bis adobe.optIn.complete() am Ende des Workflows aufgerufen wird. Danach lautet der Status complete.
adobe.optIn.approve(['AAM', 'ECID'], true);
adobe.optIn.deny(['ANALYTICS'], true);
adobe.optIn.complete();
Siehe Workflow-Konfigurationseinstellungen.
Opt-in-Berechtigungen des Benutzers prüfen
Wenn Besucher ihre Berechtigungen ändern, müssen Sie das Ergebnis dieser Änderungen in Erfahrung bringen, um Ihre gespeicherten Zustimmungen mit den Änderungen am Opt-in-Dienst zu synchronisieren. Überprüfen Sie die Voreinstellungen Ihrer Besucher mithilfe der Berechtigungsfunktionen. Beispiel:
fetchPermissions-Beispiel
optIn.fetchPermissions(function (permissions) {
// Here you can check if your category has been approved or not.
// We recommend using optIn.isApproved() to check for permissions because it abstracts out the details of knowing exactly how the permissions list looks like.
if (adobe.optIn.isApproved(MY_CATEGORY) {
sendBeacon(); // Or something
}
});
OR: You can pass in shouldAutoSubscribe as true, your callback will be used to subscribe to all OptIn events going forward:
function callback() {
if (adobe.optIn.isApproved(MY_CATEGORY) {
sendBeacon(); // Or something
}
}
optIn.fetchPermissions(callback, true);
In der API-Dokumentation erhalten Sie weitere Details zu diesen und anderen in diesem Dokument erwähnten Funktionen, Eigenschaften und Konfigurationen.