Ü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 Adobe personenbezogene Daten speichern, die auf Datenschutzbestimmungen wie die General Data Protection Regulation (DSGVO) und California Consumer Privacy Act (CCPA). Weiterführende Informationen zur Datenerfassung durch Experience Cloud-Lösungen finden Sie im Dokument zum Datenschutz in Adobe Experience Cloud.
Die JavaScript-Bibliothek zum Datenschutz in Adoben ermöglicht es den Datenverantwortlichen, den Abruf aller von Experience Cloud Lösungen für eine bestimmte Domäne. 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.
Funktionen
Die Privacy JS Library bietet mehrere Funktionen zum Verwalten von Identitäten in Privacy Service. 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 an die Experience Cloud Central Service direkt.
In der folgenden Tabelle sind die verschiedenen Funktionen der Bibliothek aufgeführt:
retrieveIdentities
validIds
), die von abgerufen wurden Privacy Servicesowie ein Array von Identitäten, die nicht gefunden wurden (failedIds
).removeIdentities
validIds
) zurück, wobei jede Identität einen booleschen isDeletedClientSide
-Wert enthält, der angibt, ob die Kennung gelöscht wurde.retrieveThenRemoveIdentities
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).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
So verwenden Sie die Privacy JS Librarymüssen Sie sie mit einer der folgenden Methoden auf Ihrem Computer installieren:
- Installieren Sie die Software mithilfe von npm, indem Sie den folgenden Befehl ausführen:
npm install @adobe/adobe-privacy
- Download von der Experience Cloud-GitHub-Repository
Sie können die Bibliothek auch über eine Tag-Erweiterung installieren. Die Übersicht finden Sie auf der Adobe-Datenschutz-Tag-Erweiterung für weitere Informationen.
Instanziieren Sie die Privacy JS Library
Alle Apps, die die Privacy JS Library muss eine neue AdobePrivacy
-Objekt, das für eine bestimmte Adobe-Lösung konfiguriert werden muss. Eine Instanziierung für Adobe Analytics würde beispielsweise wie folgt aussehen:
var adobePrivacy = new AdobePrivacy({
imsOrgID: "{ORG_ID}",
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 samples
Die folgenden Codebeispiele zeigen die Verwendung der Privacy JS Library für verschiedene gängige Szenarien, vorausgesetzt, Sie verwenden keine Tags.
Identitäten abrufen
Dieses Beispiel zeigt, wie eine Liste von Identitäten aus abgerufen werden kann. Experience Cloud.
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);
validIds
failedIDs
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)…
validIds
failedIDs
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 haben Sie die wichtigsten Funktionen der Privacy JS Library. Nachdem Sie die Bibliothek zum Abrufen einer Liste von Identitäten verwendet haben, können Sie diese Identitäten verwenden, um Datenzugriffs- und Löschanfragen für die Privacy Service API. Siehe Handbuch zur Privacy Service-API für weitere Informationen.
Anhang
Dieser Abschnitt enthält zusätzliche Informationen zur Verwendung der Privacy JS Library.
Konfigurationsparameter für Adobe-Lösungen config-params
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.
Alle Lösungen
key
Adobe Analytics
cookieDomainPeriods
2
, z. B. .domain.com
). Definieren Sie sie hier nur, wenn Sie in Ihrem JavaScript-Webbeacon spezifiziert sind.dataCenter
Das Datenerfassungscenter der Adobe. Dies sollte nur berücksichtigt werden, wenn es im JavaScript-Webbeacon angegeben ist. Mögliche Werte sind:
d1
: Rechenzentrum in San Josed2
: Dallas Rechenzentrum
reportSuite
s_code.js
oder dtm
).trackingServer
trackingServerSecure
visitorNamespace
Adobe Audience Manager
aamUUIDCookieName
Adobe Experience Cloud Identity Service (ECID)
imsOrgID
Adobe Target
clientCode