Verarbeiten von Datenschutzanfragen im Data Lake

Adobe Experience Platform Privacy Service bearbeitet Anfragen von Kunden, auf ihre personenbezogenen Daten zuzugreifen, sich gegen deren Verkauf zu wenden oder sie zu löschen, wie in den gesetzlichen und organisatorischen Datenschutzbestimmungen festgelegt.

In diesem Dokument werden wesentliche Konzepte bei der Verarbeitung von Datenschutzanfragen für im Data Lake gespeicherte Kundendaten behandelt.

HINWEIS

In diesem Handbuch wird nur beschrieben, wie Sie Datenschutzanfragen für den Data Lake in Experience Platform stellen. Wenn Sie auch Datenschutzanfragen für den Echtzeit-Kundenprofil-Datenspeicher vornehmen möchten, lesen Sie zusätzlich zu diesem Tutorial das Handbuch Verarbeitung von Datenschutzanfragen für Profil.

Anweisungen zum Ausführen von Datenschutzanfragen für andere Adobe Experience Cloud-Programme finden Sie in der Privacy Service-Dokumentation.

Erste Schritte

Sie sollten über Grundkenntnisse zu folgenden Experience Platform-Services verfügen, bevor Sie dieses Handbuch lesen:

  • Privacy Service: Verwaltet Anfragen von Kunden hinsichtlich Zugriff auf, Opt-out vom Verkauf oder Löschen ihrer personenbezogenen Daten in allen Adobe Experience Cloud-Anwendungen.
  • Catalog Service: Das Aufzeichnungssystem für Speicherort und Herkunft von Daten in Experience Platform. Stellt eine API bereit, mit der Metadaten von Datensätzen aktualisiert werden können.
  • Experience Data Model (XDM) System: Das standardisierte Framework, mit dem Experience Platform Kundenerlebnisdaten organisiert.
  • Identity Service: Löst die grundlegende Herausforderung, die sich aus der Fragmentierung von Kundenerlebnisdaten ergibt, indem Identitäten zwischen Geräten und Systemen zusammengeführt werden.

Identitäts-Namespaces verstehen

Adobe Experience Platform Identity Service führt Identitätsdaten von Kunden über Systeme und Geräte hinweg zusammen. Identity Service verwendet Identitäts-Namespaces, um einen Kontext zu Identitätswerten bereitzustellen, indem sie mit dem System ihrer Herkunft verknüpft werden. Ein Namespace kann ein allgemeines Konzept wie eine E-Mail-Adresse („E-Mail“) darstellen oder die Identität einer bestimmten Anwendung zuordnen, z. B. eine Adobe Advertising Cloud-ID („AdCloud“) oder eine Adobe Target-ID („TNTID“).

Identity Service verwaltet einen Speicher global definierter (standardmäßiger) und benutzerdefinierter Identitäts-Namespaces. Standardmäßige Namespaces (z. B. „E-Mail“ und „ECID“) stehen für alle Unternehmen zur Verfügung, während Ihr Unternehmen außerdem benutzerdefinierte Namespaces erstellen kann, die den jeweiligen Anforderungen entsprechen.

Weitere Informationen zu Identitäts-Namespaces in Experience Platform finden Sie unter Identitäts-Namespaces – Übersicht.

Hinzufügen von Identitätsdaten zu Datensätzen

Beim Erstellen von Datenschutzanfragen für den Data Lake müssen für jeden Kunden gültige Identitätswerte (und die zugehörigen Namespaces) angegeben werden, um die Daten finden und sie entsprechend verarbeiten zu können. Daher müssen alle Datensätze, die Datenschutzanfragen unterliegen, einen Identitätsdeskriptor in ihrem zugehörigen XDM-Schema enthalten.

HINWEIS

Datensätze, die auf Schemata basieren, die keine Identitätsdeskriptor-Metadaten unterstützen (z. B. Ad-hoc-Datensätze), können derzeit nicht in Datenschutzanfragen verarbeitet werden.

In diesem Abschnitt werden die Schritte zum Hinzufügen eines Identitätsdeskriptors zum XDM-Schema eines vorhandenen Datensatzes beschrieben. Wenn Sie bereits über einen Datensatz mit einem Identitätsdeskriptor verfügen, können Sie zum nächsten Abschnitt springen.

WICHTIG

Beachten Sie bei der Entscheidung, welche Schema-Felder als Identitäten festgelegt werden sollen, die Einschränkungen bei der Verwendung von verschachtelten Feldern vom Mapping-Typ.

Es gibt zwei Methoden zum Hinzufügen eines Identitätsdeskriptors zu einem Datensatzschema:

Verwenden der UI

In der Experience Platform -Benutzeroberfläche können Sie mit dem Arbeitsbereich Schemata Ihre vorhandenen XDM-Schemata bearbeiten. Um einem Schema einen Identitätsdeskriptor hinzuzufügen, wählen Sie das Schema in der Liste aus und befolgen Sie die Schritte zum Einrichten eines Schema-Felds als Identitätsfeld im Tutorial Schema Editor.

Nachdem Sie die entsprechenden Felder im Schema als Identitätsfelder festgelegt haben, können Sie mit dem nächsten Abschnitt zum Senden von Datenschutzanfragen fortfahren.

Verwenden der API

HINWEIS

In diesem Abschnitt wird davon ausgegangen, dass Sie den eindeutigen URI-ID-Wert des XDM-Schemas Ihres Datensatzes kennen. Wenn Sie diesen Wert nicht kennen, können Sie ihn mit der Catalog Service-API abrufen. Nachdem Sie den Abschnitt Erste Schritte des Entwicklerhandbuchs gelesen haben, führen Sie die Schritte aus, die unter Auflistung oder Suchen von Catalog-Objekten beschrieben sind, um Ihren Datensatz zu finden. Die Schema-ID befindet sich unter schemaRef.id

Dieser Abschnitt enthält Aufrufe der Schema Registry-API. Wichtige Informationen zur Verwendung der API, einschließlich Details über {TENANT_ID} und das Konzept der Container, finden Sie im Abschnitt Erste Schritte des Entwicklerhandbuchs.

Sie können dem XDM-Schema eines Datensatzes einen Identitätsdeskriptor hinzufügen, indem Sie eine POST-Anfrage an den /descriptors-Endpunkt in der Schema Registry-API stellen.

API-Format

POST /descriptors

Anfrage

Die folgende Anfrage definiert einen Identitätsdeskriptor für ein Feld „E-Mail-Adresse“ in einem Beispielschema.

curl -X POST \
  https://platform.adobe.io/data/foundation/schemaregistry/tenant/descriptors \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '
      {
        "@type": "xdm:descriptorIdentity",
        "xdm:sourceSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/fbc52b243d04b5d4f41eaa72a8ba58be",
        "xdm:sourceVersion": 1,
        "xdm:sourceProperty": "/personalEmail/address",
        "xdm:namespace": "Email",
        "xdm:property": "xdm:code",
        "xdm:isPrimary": false
      }'
Eigenschaft Beschreibung
@type Der Typ des zu erstellenden Deskriptors. Bei Identitätsdeskriptoren muss der Wert „xdm:descriptorIdentity“ lauten.
xdm:sourceSchema Die eindeutige URI-ID des XDM-Schemas Ihres Datensatzes.
xdm:sourceVersion Die in xdm:sourceSchema angegebene Version des XDM-Schemas.
xdm:sourceProperty Der Pfad zum Schemafeld, auf das der Deskriptor angewendet wird.
xdm:namespace Einer der standardmäßigen Identity-Namespaces, die von Privacy Service erkannt werden, oder ein benutzerdefinierter Namespace, der von Ihrem Unternehmen definiert wurde.
xdm:property Entweder „xdm:id“ oder „xdm:code“, je nach Namespace, der unter xdm:namespace verwendet wird.
xdm:isPrimary Ein optionaler boolescher Wert. Wenn „true“, bedeutet dies, dass das Feld eine primäre Identität ist. Schemas dürfen nur eine primäre Identität enthalten. Die Standardeinstellung lautet „false“, wenn sie nicht enthalten ist.

Antwort

Eine erfolgreiche Antwort gibt den HTTP-Status 201 (Erstellt) sowie die Details des neu erstellten Deskriptors zurück.

{
  "@type": "xdm:descriptorIdentity",
  "xdm:sourceSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/fbc52b243d04b5d4f41eaa72a8ba58be",
  "xdm:sourceVersion": 1,
  "xdm:sourceProperty": "/personalEmail/address",
  "xdm:namespace": "Email",
  "xdm:property": "xdm:code",
  "xdm:isPrimary": false,
  "meta:containerId": "tenant",
  "@id": "f3a1dfa38a4871cf4442a33074c1f9406a593407"
}

Übermitteln von Anfragen

HINWEIS

In diesem Abschnitt wird beschrieben, wie Sie Datenschutzanfragen für Data Lake formatieren. Es wird dringend empfohlen, die Dokumentation zur Privacy Service Benutzeroberfläche oder zur Privacy Service API zu lesen, um mehr über alle Schritte beim Übermitteln eines Datenschutzauftrags zu erfahren, einschließlich der richtigen Formatierung gesendeter Benutzeridentitätsdaten in Payloads von Anfragen.

Im folgenden Abschnitt wird beschrieben, wie Sie Datenschutzanfragen für Data Lake mithilfe der Privacy Service-Benutzeroberfläche oder -API durchführen.

WICHTIG

Die Dauer, die eine Datenschutzanfrage in Anspruch nehmen kann, kann nicht garantiert werden. Wenn Änderungen in Data Lake während der Verarbeitung einer Anfrage auftreten, kann auch nicht garantiert werden, ob diese Datensätze verarbeitet werden oder nicht.

Verwenden der UI

Wählen Sie beim Erstellen von Auftragsanfragen in der Benutzeroberfläche AEP Data Lake und/oder Profil unter Produkte aus, um Aufträge für Daten, die in Data Lake bzw. Real-time Customer Profile gespeichert sind, zu verarbeiten.


Verwenden der API

Beim Erstellen von Auftragsanfragen in der API müssen alle angegebenen userIDs einen bestimmten namespace und type nutzen, je nach dem Datenspeicher, für den sie gelten. Kennungen für Data Lake müssen bei type den Wert „Nicht registriert“ aufweisen sowie über einen namespace-Wert verfügen, der mit einer der Datenschutzkennzeichnungen übereinstimmt, die den entsprechenden Datensätzen hinzugefügt wurden.

Darüber hinaus muss das include-Array der Anfrage-Payload die Produktwerte für die verschiedenen Datenspeicher enthalten, an die die Anfrage gesendet wird. Bei Anfragen an Data Lake muss das Array den Wert aepDataLake enthalten.

Die folgende Anfrage erstellt einen neuen Datenschutzauftrag für Data Lake mit dem nicht registrierten Namespace „email_label“. Sie enthält außerdem den Produktwert für Data Lake im include-Array:

curl -X POST \
  https://platform.adobe.io/data/core/privacy/jobs \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -d '{
    "companyContexts": [
      {
        "namespace": "imsOrgID",
        "value": "{IMS_ORG}"
      }
    ],
    "users": [
      {
        "key": "user12345",
        "action": ["access","delete"],
        "userIDs": [
          {
            "namespace": "email_label",
            "value": "ajones@acme.com",
            "type": "unregistered"
          },
          {
            "namespace": "email_label",
            "value": "jdoe@example.com",
            "type": "unregistered"
          }
        ]
      }
    ],
    "include": ["aepDataLake"],
    "expandIds": false,
    "priority": "normal",
    "regulation": "ccpa"
}'

Verarbeitung von Löschanfragen

Wenn Experience Platform von Privacy Service eine DELETE-Anfrage erhält, sendet Platform eine Bestätigung an Privacy Service, dass die Anfrage empfangen wurde und die betroffenen Daten zum Löschen markiert wurden. Die Datensätze werden dann innerhalb von sieben Tagen aus Data Lake entfernt. Während dieses 7-Tage-Fensters werden die Daten vorläufig gelöscht und stehen somit keinem Platform-Service mehr zur Verfügung.

In zukünftigen Versionen wird Platform eine Bestätigung an Privacy Service senden, nachdem Daten physisch gelöscht wurden.

Nächste Schritte

In diesem Dokument haben Sie eine Einleitung zu den wichtigsten Konzepten bei der Verarbeitung von Datenschutzanfragen für Data Lake erhalten. Wir empfehlen Ihnen, die Dokumentation in diesem Handbuch weiterzulesen, um Ihr Verständnis hinsichtlich der Verwaltung von Identitätsdaten und Erstellung von Datenschutzaufträgen zu vertiefen.

Anweisungen zur Verarbeitung von Datenschutzanfragen für den Profile-Speicher finden Sie im Dokument zur Verarbeitung von Datenschutzanfragen für Echtzeit-Kundenprofile.

Anhang

Der folgende Abschnitt enthält zusätzliche Informationen zur Verarbeitung von Datenschutzanfragen in Data Lake.

Kennzeichnen verschachtelter Felder vom Typ Zuordnung

Beachten Sie, dass es zwei Arten von verschachtelten Feldern des Typs Zuordnung gibt, die keine Datenschutzkennzeichnung unterstützen:

  • Feld vom Typ Zuordnung in einem Feld vom Typ Array
  • Feld vom Typ Zuordnung in einem anderen Feld vom Typ Zuordnung

Die Verarbeitung von Datenschutzaufträgen für beide obigen Beispiele schlägt letztendlich fehl. Aus diesem Grund wird empfohlen, verschachtelte Felder vom Typ Zuordnung nicht zum Speichern vertraulicher Kundendaten zu verwenden. Relevante Kundenkennungen sollten bei datensatzbasierten Datensätzen als Nicht-Zuordnungs-Datentyp im identityMap-Feld (selbst ein Feld vom Typ Zuordnung) bzw. bei zeitreihenbasierten Datensätzen im endUserID-Feld gespeichert werden.

Auf dieser Seite