Opt-in-Referenz

Letzte Aktualisierung: 17. Juli 2024
  • Themen:

Erstellt für:

  • Entwickler
  • Benutzende
  • Admin
  • Führungskraft

Referenz für die API der Opt-in-Bibliothek und die Konfigurationseinstellungen.

Die Zustimmungseinstellungen werden den Opt-in-Funktionen als Kategorien zur Verfügung gestellt:

adobe.OptInCategories = {
    "AAM": "aam",
    "ANALYTICS": "aa",
    "ECID": "ecid",
    "TARGET": "target"
}

Opt-in-Konfigurationsparameter

In diesem Abschnitt wird die Opt-in-Konfiguration mithilfe der API beschrieben. Ein Großteil der Konfiguration und Implementierung kann über die Experience Platform Launch-Erweiterung vorgenommen werden.

Opt-in-Konfigurationen werden in der Visitor JavaScript-Funktion getInstance() bereitgestellt, die das globale adobe-Objekt instanziiert. Im Folgenden werden die Konfigurationen von Visitor JS im Zusammenhang mit dem Opt-in-Dienst aufgelistet.

doesOptInApply (boolean or function that evaluates to a boolean)

„false“ bedeutet, dass für Besucher kein Opt-in erforderlich ist. Dies führt dazu, dass Experience Cloud Cookies erstellt, unabhängig von den Kategorien, denen zugestimmt oder die abgelehnt wurden. Bei dieser Konfiguration wird Opt-in holistisch aktiviert oder deaktiviert.

preOptInApprovals (Object <adobe.OptInCategories enum: boolean>)

Definiert, welche Kategorien genehmigt oder abgelehnt sind, wenn der Besucher noch keine Voreinstellungen festgelegt hat, d. h. die Standardeinstellungen der Organisation.

previousPermissions (Object<adobe.OptInCategories enum: boolean>)

Die vom Besucher ausdrücklich festgelegten Voreinstellungen. Die Berechtigungen in dieser Konfiguration überschreiben die Standardeinstellungen der Organisation (previousPermissions überschreibt preOptInApprovals).

isOptInStorageEnabled (boolean)

Ermöglicht Opt-in, die Berechtigungen in einem Erstanbieter-Cookie (in der Domain des aktuellen Kunden) zu speichern.

(Optional) optInCookiesDomain (string)

Erstanbieterdomäne oder untergeordnete Domain, die für den Opt-in-Cookie verwendet wird (wenn für isOptInStorageEnabled „true“ festgelegt wurde).

(Optional) optInStorageExpiry (integer)

Anzahl der Sekunden, um die Standardablaufzeit von 13 Monaten zu überschreiben.

Änderungen an den Zustimmungsparametern

Besucher Ihrer Site können Voreinstellungen jederzeit zum ersten Mal festlegen oder ihre Voreinstellungen mithilfe Ihrer CMP ändern. Nachdem Visitor JS mit den Ersteinstellungen initialisiert wurde, können die Berechtigungen des Besuchers mit den folgenden Funktionen geändert werden:

adobe.optIn.approve(categories, shouldWaitForComplete)

Funktion, die alle Kategorien in einer Liste für einen Besucher genehmigt oder zulässt. Weitere Informationen zum Parameter „shouldWaitForComplete“ finden Sie unter Opt-in-Workflow.

adobe.optIn.deny(categories, shouldWaitForComplete)

Funktion, die alle angegebenen Kategorien für einen Besucher ausschließt oder ablehnt.

adobe.optIn.approveAll()

Wenn Ihre Anfrage nach einer Erlaubnis für die Erstellung Ihrer Website so formuliert ist, dass eine Besucheroberfläche Ihrer Website die Erlaubnis zur Erstellung von Cookies erteilt oder verweigert, verwenden Sie approveAll() oder denyAll(), bezogen auf deren Antwort.

adobe.optIn.denyAll()

Wenn Ihre Genehmigungsanfrage so formuliert ist, dass Besucher Ihrer Site die Berechtigung zum Erstellen von Cookies pauschal erteilen oder verweigern, verwenden Sie approveAll() oder denyAll(), je nach Antwort der Besucher.

Parameter für Opt-in-Workflows

Opt-in unterstützt einen Workflow, bei dem Berechtigungen über mehrere Anfragezyklen erfasst werden können, z. B. wenn Voreinstellungen einzeln festgelegt werden. Mit den 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(categories, shouldWaitForComplete)

Funktion, die alle Kategorien in einer Liste für einen Besucher genehmigt oder zulässt.

adobe.optIn.deny(categories, shouldWaitForComplete)

Funktion, die alle angegebenen Kategorien für einen Besucher ausschließt oder ablehnt.

adobe.optIn.complete()

Funktion, die die fortlaufenden Aufrufe von approve() und deny() zu einer Anfrage zusammenführt, um die Voreinstellungen eines Besuchers festzulegen. Wenn Opt-in-Änderungen abonniert werden (siehe adobe.optIn.fetchPermissions(callback, shouldAutoSubscribe), wird der Callback nur durch Aufrufen dieser Funktion ausgelöst.

Parameter für Opt-in-Berechtigungen von Besuchern

Erfassen Sie die Opt-in-Berechtigungen eines Besuchers jederzeit mit einer der Berechtigungsfunktionen:

adobe.optIn.permissions

Ein Objekt, das alle Experience Cloud-Lösungen, die vom Besucher genehmigt oder abgelehnt wurden, als Kategorien aufführt.

adobe.optIn.isApproved(categories)

Wenn alle Kategorien genehmigt wurden, gibt diese Funktion „true“ zurück.

adobe.optIn.fetchPermissions(callback, shouldAutoSubscribe)

Rufen Sie die Liste der Berechtigungen asynchron ab. Der Rückruf wird mit Liste von Berechtigungen aufgerufen, sobald der Prozess zum Gewähren/Ablehnen von Berechtigungen abgeschlossen ist. Durch den Wert true für shouldAutoSubscribe erfasst der Callback alle zukünftigen Opt-in-Änderungen. Das Objekt adobe.OptIn verfügt über folgende Eigenschaften:

permissions

Ein Objekt, das alle Experience Cloud-Lösungen, die vom Besucher genehmigt oder abgelehnt wurden, als Kategorien aufführt. Beispiel: { aa: true, ecid: false, aam: true... }

status

  • Ausstehend
  • Geändert
  • Fertig

doesOptInApply

„True“ oder „false“, abhängig von der Konfiguration, die Sie bei der Initialisierung angegeben haben

isPending

„True“ oder „false“, je nach Statuswert. Opt-in-Berichte für diese Eigenschaft ergeben für Besucher den Wert „true“, die die Berechtigung noch nicht ausdrücklich akzeptiert oder verweigert haben.

isComplete

„True“ oder „false“, je nach Statuswert. Opt-in meldet für diese Eigenschaft möglicherweise den Wert „false“, wenn ein Workflow-ähnliches Einverständnis gestartet, aber nicht abgeschlossen wurde.