Übersicht über die Adobe Privacy JavaScript Library

Als Datenverarbeiter verarbeitet Adobe personenbezogene Daten gemäß den Berechtigungen und Anweisungen Ihres Unternehmens. Als Datenverantwortlicher legen Sie fest, welche personenbezogenen Daten Adobe in Ihrem Namen verarbeitet und speichert. Je nach den Informationen, die Sie über Adobe Experience Cloud-Lösungen senden, kann die Adobe private Informationen speichern, die für Datenschutzbestimmungen wie General Data Protection Regulation (GDPR) und California Consumer Privacy Act (CCPA) gelten. Weiterführende Informationen zur Datenerfassung durch Experience Cloud-Lösungen finden Sie im Dokument zum Datenschutz in Adobe Experience Cloud.

Die Adobe Privacy JavaScript Library ermöglicht es Datenverarbeitern, den Abruf aller durch Experience Cloud-Lösungen generierten Daten-Identitäten für eine bestimmte Domäne zu automatisieren. Mithilfe der vom Adobe Experience Platform Privacy Service bereitgestellten API können diese Identitäten dann zum Erstellen von Zugriffs- und Löschanfragen für personenbezogene Daten der betroffenen Personen verwendet werden.

HINWEIS

Das Privacy JS Library muss in der Regel nur auf datenschutzrelevanten Seiten installiert werden und muss nicht auf allen Seiten einer Website oder Domäne installiert werden.

Funktionen

Das Privacy JS Library stellt mehrere Funktionen zum Verwalten von Identitäten in Privacy Service bereit. Diese Funktionen können nur zur Verwaltung der Identitäten verwendet werden, die im Browser für einen bestimmten Besucher gespeichert sind. Sie können nicht verwendet werden, um Informationen direkt an das Experience Cloud Central Service zu senden.

In der folgenden Tabelle sind die verschiedenen Funktionen der Bibliothek aufgeführt:

Funktion Beschreibung
retrieveIdentities Gibt ein Array mit übereinstimmenden Identitäten (validIds) zurück, die von Privacy Service abgerufen wurden, sowie ein Array mit nicht gefundenen Identitäten (failedIds).
removeIdentities Entfernt jede übereinstimmende (gültige) Identität aus dem Browser. Gibt eine Gruppe mit übereinstimmenden Identitäten (validIds) zurück, wobei jede Identität einen booleschen isDeletedClientSide-Wert enthält, der angibt, ob die Kennung gelöscht wurde.
retrieveThenRemoveIdentities Ruft eine Gruppe mit übereinstimmenden Identitäten (validIds) ab und entfernt diese dann aus dem Browser. Diese Funktion ähnelt zwar removeIdentities, eignet sich jedoch am besten, wenn die von Ihnen verwendete Adobe-Lösung eine Zugriffsanfrage erfordert, bevor Löschen möglich ist (wenn z. B. eine eindeutige Kennung abgerufen werden muss, bevor sie in einer Löschanfrage bereitgestellt wurde).
HINWEIS

removeIdentities und retrieveThenRemoveIdentities entfernen Identitäten aus dem Browser nur bei bestimmten Adobe-Lösungen, die sie unterstützen. Adobe Audience Manager löscht beispielsweise keine demdex-Kennungen, die in Drittanbieter-Cookies gespeichert werden, während Adobe Target alle Cookies löscht, die ihre Kennungen speichern.

Da alle drei Funktionen asynchrone Prozesse sind, müssen abgerufene Identitäten mit Callbacks oder Zusagen behandelt werden.

Installation

Um mit dem Beginn Privacy JS Library zu arbeiten, müssen Sie es mit einer der folgenden Methoden auf Ihrem Computer installieren:

Privacy JS Library instanziieren

Alle Apps, die das Privacy JS Library verwenden, müssen ein neues AdobePrivacy-Objekt instanziieren, das für eine bestimmte Adobe konfiguriert werden muss. Eine Instanziierung für Adobe Analytics würde beispielsweise wie folgt aussehen:

var adobePrivacy = new AdobePrivacy({
    imsOrgID: "{IMS_ORG}",
    reportSuite: "{REPORT_SUITE_ID}",
    trackingServer: "{SERVER_URL}",
    clientCode: "{TARGET_CLIENT_CODE}"
});

Eine vollständige Liste der unterstützten Parameter für verschiedene Adobe-Lösungen finden Sie im Anhang zu den unterstützten Konfigurationsparametern für Adobe-Lösungen.

Code-Beispiele

Die folgenden Codebeispiele zeigen, wie Privacy JS Library für verschiedene gängige Szenarien verwendet wird, vorausgesetzt, Sie verwenden Platform Launch nicht.

Identitäten abrufen

Dieses Beispiel zeigt, wie eine Liste von Identitäten von Experience Cloud abgerufen wird.

JavaScript

Der folgende Code definiert eine Funktion (handleRetrievedIDs), die zur Verarbeitung der von retrieveIdentities abgerufenen Identitäten als Callback oder Zusage verwendet wird.

function handleRetrievedIDs(ids) {
    const validIDs = ids.validIDs;
    const failedIDs = ids.failedIDs;
}

// If using callbacks:
adobePrivacy.retrieveIdentities(handleRetrievedIDs);

// If using promises:
adobePrivacy.retrieveIdentities().then(handleRetrievedIDs);
Variable Beschreibung
validIds Ein JSON-Objekt, das alle Kennungen enthält, die erfolgreich abgerufen wurden.
failedIDs Ein JSON-Objekt, das alle IDs enthält, die nicht von Privacy Service abgerufen wurden oder anderweitig nicht gefunden werden konnten.

Ergebnis

Wenn der Code erfolgreich ausgeführt wird, wird validIDs mit einer Liste der abgerufenen Identitäten ausgefüllt.

{
    "company": "adobe",
    "namespace": "ECID",
    "namespaceId": 4,
    "type": "standard",
    "name": "Experience Cloud ID",
    "description": "This is the ID generated by the ID Service.",
    "value": "79352169365966186342525781172209986543"
},
{
    "company": "adobe",
    "namespace": "gsurfer_id",
    "namespaceId": 411,
    "type": "standard",
    "value": "WqmIJQAAB669Ciao"
}

Identitäten entfernen

Dieses Beispiel zeigt, wie Sie eine Liste von Identitäten aus dem Browser entfernen.

JavaScript

Der folgende Code definiert eine Funktion (handleRemovedIDs), die zur Verarbeitung der von removeIdentities abgerufenen Identitäten als Callback oder Zusage verwendet wird, nachdem die Identitäten aus dem Browser entfernt wurden.

function handleRemovedIDs(ids) {
    const validIDs = ids.validIDs;
    const failedIDs = ids.failedIDs;
}

// If using callbacks:
adobePrivacy.removeIdentities(handleRemovedIDs);

// If using promises:
adobePrivacy.removeIdentities().then(handleRemovedIDs)…
Variable Beschreibung
validIds Ein JSON-Objekt, das alle Kennungen enthält, die erfolgreich abgerufen wurden.
failedIDs Ein JSON-Objekt, das alle IDs enthält, die nicht von Privacy Service abgerufen wurden oder anderweitig nicht gefunden werden konnten.

Ergebnis

Wenn der Code erfolgreich ausgeführt wird, wird validIDs mit einer Liste der abgerufenen Identitäten ausgefüllt.

{
    "company": "adobe",
    "namespace": "ECID",
    "namespaceId": 4,
    "type": "standard",
    "name": "Experience Cloud ID",
    "description": "This is the ID generated by the ID Service.",
    "value": "79352169365966186342525781172209986543",
    "isDeletedClientSide": false
},
{
    "company": "adobe",
    "namespace": "AMO",
    "namespaceId": 411,
    "type": "standard",
    "value": "WqmIJQAAB669Ciao",
    "isDeletedClientSide": true
}

Nächste Schritte

Durch Lesen dieses Dokuments wurden Sie in die Kernfunktionalitäten des Privacy JS Library eingeführt. Nachdem Sie die Bibliothek zum Abrufen einer Liste von Identitäten verwendet haben, können Sie mit diesen Identitäten Datenzugriff erstellen und Anforderungen an die Privacy Service-API löschen. Weiterführende Informationen finden Sie im Entwicklerhandbuch für Privacy Service.

Anhang

Dieser Abschnitt enthält zusätzliche Informationen zur Verwendung von Privacy JS Library.

Konfigurationsparameter für Adobe-Lösungen

Im Folgenden finden Sie eine Liste der zulässigen Konfigurationsparameter für unterstützte Adobe-Lösungen, die beim Instanziieren eines AdobePrivacy-Objekts verwendet werden können.

Adobe Analytics

Parameter Beschreibung
cookieDomainPeriods Die Zahlenperioden in einer Domain für das Cookie-Tracking (Standard ist 2).
dataCenter Adobe-Rechenzentrum für die Datenerfassung. Dies sollte nur berücksichtigt werden, wenn es im JavaScript-Webbeacon angegeben ist. Mögliche Werte sind:
  • „d1“: Rechenzentrum in San Jose.
  • „d2“: Rechenzentrum in Dallas.
reportSuite Report Suite-ID, wie in Ihrem JavaScript-Webbeacon angegeben (z. B. „s_code.js“ oder „dtm“).
trackingServer Datenerfassungs-Domain (nicht SSL). Dies sollte nur berücksichtigt werden, wenn es im JavaScript-Webbeacon angegeben ist.
trackingServerSecure Datenerfassungs-Domain (SSL). Dies sollte nur berücksichtigt werden, wenn es im JavaScript-Webbeacon angegeben ist.
visitorNamespace Namespace zur Gruppierung von Besuchern. Dies sollte nur berücksichtigt werden, wenn es im JavaScript-Webbeacon angegeben ist.

Adobe Target

Parameter Beschreibung
clientCode Client-Code, der einen Client im Adobe Target-System identifiziert.

Adobe Audience Manager

Parameter Beschreibung
aamUUIDCookieName Name des Erstanbieter-Cookies mit der eindeutigen Benutzer-ID, die von Adobe Audience Manager zurückgegeben wird.

Adobe ID Service (ECID)

Parameter Beschreibung
imsOrgID Die Kennung Ihrer IMS-Organisation.

Auf dieser Seite