Senden Sie partielle Zeilenaktualisierungen an Real-Time Customer Profile mithilfe von Data Prep

Verwenden Sie das Streaming von Upserts in Data Prep, um partielle Zeilenaktualisierungen an Real-Time Customer Profile-Daten zu senden und gleichzeitig neue Identitätsverknüpfungen mit einer einzigen API-Anfrage zu erstellen und herzustellen.

Durch das Streamen von Upserts können Sie das Format Ihrer Daten beibehalten, während Sie diese Daten während der Aufnahme in Real-Time Customer Profile PATCH-Anforderungen übersetzen. Basierend auf den von Ihnen bereitgestellten Eingaben können Sie mit Data Prep eine einzige API-Payload senden und die Daten an Real-Time Customer Profile PATCH- und Identity Service CREATE-Anfragen übersetzen.

Data Prep verwendet Header-Parameter, um zwischen Einfügungen und Upserts zu unterscheiden. Alle Zeilen, die Upserts verwenden, müssen eine Kopfzeile haben. Sie können Upserts mit oder ohne Identitätsdeskriptoren verwenden. Wenn Sie Upserts mit Identitäten verwenden, müssen Sie die Konfigurationsschritte ausführen, die im Abschnitt „Konfigurieren Identitätsdatensatzes“ beschrieben. Wenn Sie Upserts ohne Identitäten verwenden, müssen Sie in Ihrer Anfrage keine Identitätskonfigurationen angeben. Weitere Informationen finden Sie im Abschnitt Streamen von Upserts ohne".

Dieses Dokument enthält Informationen zum Streamen von Upserts in Data Prep.

Erste Schritte

Diese Übersicht setzt ein Verständnis der folgenden Komponenten von Adobe Experience Platform voraus:

Streamen von Upserts in Data Prep verwenden streaming-upserts-in-data-prep

Hochrangiger Workflow zum Streamen von Upserts

Das Streamen von Upserts in Data Prep funktioniert wie folgt:

Identitätsdatensatz konfigurieren configure-the-identity-dataset

Wenn neue Identitäten verknüpft werden müssen, müssen Sie einen zusätzlichen Datensatz in der eingehenden Payload erstellen und übergeben. Beim Erstellen eines Identitätsdatensatzes müssen Sie sicherstellen, dass die folgenden Anforderungen erfüllt sind:

Erforderliche Felder in den mit dem Identitätsdatensatz verknüpften Schemata identity-dataset-required-fileds

Wenn Ihr Schema erforderliche Felder enthält, muss die Validierung des Datensatzes unterdrückt werden, damit Identity Service nur die Identitäten erhalten können. Sie können die Validierung unterdrücken, indem Sie den disabled auf den acp_validationContext anwenden. Siehe folgendes Beispiel:

curl -X POST 'https://platform.adobe.io/data/foundation/catalog/dataSets/62257bef7a75461948ebcaaa' \
  -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 '{
    "tags": {
        "acp_validationContext": [
            "disabled"
        ],
        "unifiedProfile": [
            "enabled:false"
        ],
        "unifiedIdentity": [
            "enabled:true"
        ]
    }
}'

Struktur der eingehenden Payloads

Im Folgenden sehen Sie ein Beispiel für eine Struktur eingehender Payloads, die neue Identitäts-Links erstellt.

Payload mit Identitätskonfiguration

{
  "header": {
    "flowId": "923e2ac3-3869-46ec-9e6f-7012c4e23f69",
    "imsOrgId": "{ORG_ID}",
    "datasetId": "621fc19ab33d941949af16c8",
    "operations": {
        "data": "create" (default)/"merge"/"delete",
        "identity": "create",
        "identityDatasetId": "621fc19ab33d941949af16d9"
    }
  }
... //The raw data attributes are included here as the key/value pairs of the "body" property.
}

Unterstützte Vorgänge

Die folgenden Vorgänge werden von Real-Time Customer Profile unterstützt:

Die folgenden Vorgänge werden von Identity Service unterstützt:

Payload ohne Identitätskonfiguration payload-without-identity-configuration

Wenn neue Identitäten nicht verknüpft werden müssen, können Sie die Parameter identity und identityDatasetId in den Vorgängen auslassen. Dadurch werden Daten nur an Real-Time Customer Profile gesendet und die Identity Service übersprungen. Ein Beispiel finden Sie unten in der Payload:

{
  "header": {
    "flowId": "923e2ac3-3869-46ec-9e6f-7012c4e23f69",
    "imsOrgId": "{ORG_ID}",
    "datasetId": "621fc19ab33d941949af16c8",
    "operations": {
        "data": "create"/"merge"/"delete",
    }
  }
... //The raw data attributes are included here as the key/value pairs of the "body" property.
}

Dynamisches Übergeben primärer Identitäten

Für XDM-Aktualisierungen muss das Schema für die Profile aktiviert sein und eine primäre Identität enthalten. Sie können die primäre Identität eines XDM-Schemas auf zwei Arten angeben:

Bestimmen Sie ein statisches Feld als primäres Identitätsfeld im XDM-Schema

Im folgenden Beispiel werden state, homePhone.number und andere Attribute mit ihren jeweiligen angegebenen Werten in die Profile mit der primären Identität sampleEmail@gmail.com upsertiert. Eine XDM-Entitäts-Aktualisierungsmeldung wird dann von der Streaming-Data Prep generiert. Real-Time Customer Profile bestätigt dann, dass die XDM-Aktualisierungsmeldung den Profildatensatz upsert.

curl -X POST 'https://dcs.adobedc.net/collection/9aba816d350a69c4abbd283eb5818ec3583275ffce4880ffc482be5a9d810c4b' \
  -H 'Content-Type: application/json' \
  -H 'x-adobe-flow-id: d5262d48-0f47-4949-be6d-795f06933527' \
  -d '{
    "header": {
        "flowId" : "d5262d48-0f47-4949-be6d-795f06933527",
        "imsOrgId": "{ORG_ID}",
        "datasetId": "62259f817f62d71947929a7b",
        "operations": {
         "data": "create"
     }
    },
    {
        "body": {
        "homeAddress": {
            "country": "US",
            "state": "GA",
            "region": "va7"
        },
        "homePhone": {
            "number": "123.456.799"
        },
        "identityMap": {
            "Email": [{
                "id": "sampleEmail@gmail.com",
                "primary": true
            }]
        },
      "personalEmail": {
            "address": "sampleEmail@gmail.com",
            "primary": true
       },
      "personID": "346576345",
      "_id": "346576345",
      "timestamp": "2021-05-05T17:51:45.1880+02",
      "workEmail": "sampleWorkEmail@gmail.com"
  }
}'

Bestimmen Sie eines der Identitätsfelder als primäre Identität über die Feldergruppe „Identitätszuordnung“ im XDM-Schema

In diesem Beispiel enthält die Kopfzeile das Attribut operations mit den Eigenschaften identity und identityDatasetId . Auf diese Weise können Daten mit Real-Time Customer Profile zusammengeführt und Identitäten an Identity Service übergeben werden.

curl -X POST 'https://dcs.adobedc.net/collection/9aba816d350a69c4abbd283eb5818ec3583275ffce4880ffc482be5a9d810c4b' \
  -H 'Content-Type: application/json' \
  -H 'x-adobe-flow-id: d5262d48-0f47-4949-be6d-795f06933527' \
  -d '{
    "header": {
        "flowId" : "d5262d48-0f47-4949-be6d-795f06933527",
        "imsOrgId": "{ORG_ID}",
        "datasetId": "62259f817f62d71947929a7b",
        "operations": {
            "data": "merge",
            "identity": "create",
            "identityDatasetId": "6254a93b851ecd194b64af9e"
      }
    },
    {
       "body": {
        "homeAddress": {
            "country": "US",
            "state": "GA",
            "region": "va7"
        },
        "homePhone": {
            "number": "123.456.799"
        },
        "identityMap": {
            "Email": [{
                "id": "sampleEmail@gmail.com",
                "primary": true
            }]
        },
      "personalEmail": {
            "address": "sampleEmail@gmail.com",
            "primary": true
       },
      "personID": "346576345",
      "_id": "346576345",
      "timestamp": "2021-05-05T17:51:45.1880+02",
      "workEmail": "sampleWorkEmail@gmail.com"
  }
 }'

Bekannte Einschränkungen und wichtige Überlegungen

Im Folgenden finden Sie eine Liste bekannter Einschränkungen, die beim Streaming von Upserts mit Data Prep zu beachten sind:

Nächste Schritte

Durch Lesen dieses Dokuments sollten Sie jetzt verstehen, wie Sie Upserts in streamen, Data Prep partielle Zeilenaktualisierungen an Ihre Real-Time Customer Profile-Daten zu senden und gleichzeitig Identitäten mit einer einzigen API-Anfrage zu erstellen und zu verknüpfen. Weitere Informationen zu anderen Data Prep-Funktionen finden Sie unter Data Prep Übersicht. Informationen zur Verwendung von Zuordnungssätzen in der Data Prep-API finden Sie im Data Prep Entwicklerhandbuch.