Bestimmte Vorschriften erfordern eine ausdrückliche Zustimmung des Kunden, bevor seine persönlichen Daten gesammelt werden können. Mit dem /consent
-Endpunkt in der Privacy Service-API können Sie Anfragen zur Kundengenehmigung bearbeiten und in Ihren Datenschutzarbeitsablauf integrieren.
Bevor Sie dieses Handbuch verwenden, lesen Sie bitte den Abschnitt Erste Schritte, um Informationen zu den erforderlichen Authentifizierungskopfzeilen zu erhalten, die im Beispiel-API-Aufruf unten aufgeführt sind.
Zustimmungsanforderungen werden verarbeitet, indem eine POST an den /consent
-Endpunkt angefordert wird.
API-Format
POST /consent
Anfrage
Mit der folgenden Anforderung wird ein neuer Genehmigungsauftrag für die Benutzer-IDs erstellt, die im Array entities
bereitgestellt werden.
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: {IMS_ORG}' \
-d '{
"optOutOfSale": true,
"entities": [
{
"nameSpace": "email",
"values": [
"dsmith@acme.com",
"ajones@acme.com"
]
},
{
"nameSpace": "ECID",
"values": [
"443636576799758681021090721276"
]
}
]
}'
Eigenschaft | Beschreibung |
---|---|
optOutOfSale |
Wenn "true"festgelegt ist, zeigt an, dass die unter entities bereitgestellten Benutzer den Verkauf oder die Weitergabe ihrer personenbezogenen Daten deaktivieren möchten. |
entities |
Ein Array von Objekten, die die Benutzer angeben, für die die Genehmigungsanfrage gilt. Jedes Objekt enthält ein namespace - und ein Array von values , um die einzelnen Benutzer mit diesem Namensraum abzugleichen. |
nameSpace |
Jedes Objekt im Array entities muss einen der standardmäßigen Identitäts-Namensraum enthalten, die von der Privacy Service-API erkannt werden. |
values |
Ein Array von Werten für jeden Benutzer, das dem bereitgestellten nameSpace entspricht. |
Weitere Informationen dazu, wie Sie bestimmen, welche Werte zur Kundenidentität an Privacy Service gesendet werden sollen, finden Sie im Handbuch Identitätsdaten bereitstellen.
Antwort
Bei einer erfolgreichen Antwort wird HTTP-Status 202 (Akzeptiert) ohne Nutzlast zurückgegeben, was bedeutet, dass die Anforderung von Privacy Service akzeptiert wurde und verarbeitet wird.