Ü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 private Informationen speichern, die für Datenschutzbestimmungen wie die General Data Protection Regulation (DSGVO) und die 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.

Mit der Adobe Privacy JavaScript Library können Datenverantwortliche den Abruf aller von Experience Cloud -Lösungen für eine bestimmte Domäne generierten Identitäten von Datensubjekten 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.

Funktionen

Der Privacy JS Library bietet verschiedene 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 direkt an die Experience Cloud Central Service zu senden.

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

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

Installation

Um mit der Verwendung des Privacy JS Library zu beginnen, müssen Sie es mit einer der folgenden Methoden auf Ihrem Computer installieren:

Sie können die Bibliothek auch über eine Tag-Erweiterung installieren. Weitere Informationen finden Sie in der Übersicht über die Adobe Privacy Tag-Erweiterung .

Instanziieren der Privacy JS Library

Alle Apps, die den Privacy JS Library verwenden, müssen ein neues AdobePrivacy -Objekt instanziieren, 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, wie Sie den Privacy JS Library für verschiedene gängige Szenarien verwenden, vorausgesetzt, Sie verwenden keine Tags.

Identitäten abrufen

Dieses Beispiel zeigt, wie eine Liste von Identitäten aus 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);

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)…

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 mit den Kernfunktionen von Privacy JS Library vertraut gemacht. 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 an die Privacy Service -API zu erstellen. Weitere Informationen finden Sie im Privacy Service-API-Handbuch .

Anhang

Dieser Abschnitt enthält zusätzliche Informationen zur Verwendung von 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

Adobe Analytics

Adobe Audience Manager

Adobe Experience Cloud Identity Service (ECID)

Adobe Target