DokumentationExperience PlatformPrivacy Service-Anleitung

Einverständnis-Endpunkt

Last update: Mon Dec 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler

Bestimmte Vorschriften erfordern die ausdrückliche Zustimmung des Kunden, bevor seine personenbezogenen Daten erfasst werden können. Mit dem /consent-Endpunkt in der Privacy Service-API können Sie Einverständnisanfragen von Kunden verarbeiten und in Ihren Datenschutz-Workflow integrieren.

Bevor Sie dieses Handbuch verwenden, lesen Sie das Handbuch Erste Schritte um Informationen zu den erforderlichen Authentifizierungskopfzeilen zu erhalten, die im folgenden Beispiel-API-Aufruf dargestellt werden.

Verarbeiten einer Einverständnisanfrage eines Kunden

Einverständnisanfragen werden verarbeitet, indem eine POST-Anfrage an den /consent-Endpunkt gesendet wird.

API-Format

POST /consent

Anfrage

Die folgende Anfrage erstellt einen neuen Einverständnisvorgang für die im entities-Array angegebenen Benutzer-IDs.

curl -X POST \
  https://platform.adobe.io/data/core/privacy/consent \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -d '{
        "optOutOfSale": true,
        "entities": [
          {
            "nameSpace": "email",
            "values": [
              "dsmith@acme.com",
              "ajones@acme.com"
            ]
          },
          {
            "nameSpace": "ECID",
            "values": [
              "443636576799758681021090721276"
            ]
          }
        ]
      }'
Eigenschaft
Beschreibung
optOutOfSale
Wenn auf „true“ gesetzt, bedeutet dies, dass die unter entities bereitgestellten Benutzer den Verkauf oder die Freigabe ihrer personenbezogenen Daten deaktivieren möchten.
entities
Ein Array von Objekten, die die Benutzer angeben, für die die Einverständnisanfrage gilt. Jedes -Objekt enthält ein -namespace und ein -Array von values, um die einzelnen Benutzer mit diesem Namespace abzugleichen.
nameSpace
Jedes Objekt im entities-Array muss einen der Standard-Identity-Namespaces“ enthalten die von der Privacy Service-API erkannt werden.
values
Ein Array von Werten für jeden Benutzer, das der angegebenen nameSpace entspricht.
NOTE
Weiterführende Informationen dazu, wie Sie bestimmen, welche Kundenidentitätswerte an Privacy Service gesendet werden sollen, finden Sie im Handbuch Bereitstellen von Identitätsdaten.

Antwort

Eine erfolgreiche Antwort gibt den HTTP-Status 202 (Akzeptiert) ohne Payload zurück und zeigt an, dass die Anfrage von Privacy Service akzeptiert wurde und verarbeitet wird.

recommendation-more-help
9cbf7061-a312-49f7-aaf8-a10885d53580