Skicka uppdateringar av delar av rader till Real-Time Customer Profile med Data Prep

Använd direktuppspelande upserts i Data Prep för att skicka uppdateringar (del av rad) till Real-Time Customer Profile-data samtidigt som nya identitetslänkar skapas och etableras med en enda API-begäran.

Genom att direktuppspela uppspelningar kan du behålla dataformatet samtidigt som data översätts till Real-Time Customer Profile PATCH-begäranden under importen. Baserat på de indata du anger kan du i Data Prep skicka en enda API-nyttolast och översätta data till både Real-Time Customer Profile PATCH och Identity Service CREATE-begäranden.

Data Prep använder rubrikparametrar för att skilja mellan infogningar och infogningar. Alla rader som använder upserts måste ha en rubrik. Du kan använda upserts med eller utan identitetsbeskrivare. Om du använder överföringar med identiteter måste du följa de konfigurationssteg som beskrivs i avsnittet Konfigurera identitetsdatauppsättningen. Om du använder överföringar utan identiteter behöver du inte ange några identitetskonfigurationer i din begäran. Läs avsnittet om direktuppspelande överföringar utan identiteter om du vill ha mer information.

Det här dokumentet innehåller information om hur du direktuppspelar överföringar i Data Prep.

Komma igång

Den här översikten kräver en fungerande förståelse av följande komponenter i Adobe Experience Platform:

Använd direktuppspelande upserts i Data Prep streaming-upserts-in-data-prep

Direktuppspelning ger ett arbetsflöde på hög nivå

Direktuppspelande uppdateringar i Data Prep fungerar så här:

Konfigurera identitetsdatauppsättningen configure-the-identity-dataset

Om nya identiteter måste länkas måste du skapa och skicka ytterligare en datauppsättning i den inkommande nyttolasten. När du skapar en identitetsdatauppsättning måste du se till att följande krav uppfylls:

Obligatoriska fält i scheman som är associerade med identitetsdatauppsättningen identity-dataset-required-fileds

Om schemat innehåller obligatoriska fält måste verifieringen av datauppsättningen ignoreras för att Identity Service bara ska kunna ta emot identiteterna. Du kan inaktivera valideringen genom att tillämpa värdet disabled på parametern acp_validationContext. Se exemplet nedan:

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"
        ]
    }
}'

Inkommande nyttolaststruktur

I följande exempel visas ett exempel på en inkommande nyttolaststruktur som skapar nya identitetslänkar.

Nyttolast med identitetskonfiguration

{
  "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.
}

Åtgärder som stöds

Följande åtgärder stöds av Real-Time Customer Profile:

Följande åtgärder stöds av Identity Service:

Nyttolast utan identitetskonfiguration payload-without-identity-configuration

Om nya identiteter inte behöver länkas kan du utelämna parametrarna identity och identityDatasetId i åtgärderna. Om du gör det skickas endast data till Real-Time Customer Profile och Identity Service hoppas över. Se nyttolasten nedan för exempel:

{
  "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.
}

Skicka primära identiteter dynamiskt

För XDM-uppdateringar måste schemat aktiveras för Profile och innehålla en primär identitet. Du kan ange den primära identiteten för ett XDM-schema på två sätt:

Ange ett statiskt fält som primärt identitetsfält i XDM-schemat

I exemplet nedan har state, homePhone.number och andra attribut uppdaterats med sina respektive angivna värden till Profile med den primära identiteten sampleEmail@gmail.com. Ett uppdateringsmeddelande för en XDM-entitet genereras sedan av den direktuppspelade komponenten Data Prep. Real-Time Customer Profile bekräftar sedan att XDM-uppdateringsmeddelandet ska infoga profilposten.

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"
  }
}'

Ange ett av identitetsfälten som primär identitet via fältgruppen för identitetsmappning i XDM-schemat

I det här exemplet innehåller rubriken attributet operations med egenskaperna identity och identityDatasetId. Detta gör att data kan sammanfogas med Real-Time Customer Profile och även för identiteter som ska skickas till Identity Service.

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"
  }
 }'

Kända begränsningar och viktiga överväganden

Följande visar en lista med kända begränsningar som ska beaktas när direktuppspelning överförs med Data Prep:

Nästa steg

Genom att läsa det här dokumentet bör du nu förstå hur du direktuppspelar överföringar i Data Prep för att skicka uppdateringar av delar av rader till dina Real-Time Customer Profile-data, samtidigt som du skapar och länkar identiteter med en enda API-begäran. Mer information om andra Data Prep-funktioner finns i Data Prep översikten. Läs Data Prep utvecklarhandboken om du vill lära dig hur du använder mappningsuppsättningar i Data Prep-API:t.