Skicka uppdateringar av delar av rader till Real-Time Customer Profile använda Data Prep

Direktuppspelande överföringar i Data Prep kan du skicka uppdateringar av delar av rader till Real-Time Customer Profile data samtidigt som nya identitetslänkar skapas och etableras med en enda API-begäran.

Genom att direktuppspela uppladdningar kan du behålla dataformatet samtidigt som du översätter dessa data till Real-Time Customer Profile PATCH begär vid förtäring. Baserat på de indata du anger Data Prep gör att du kan skicka en enda API-nyttolast och översätta data till båda Real-Time Customer Profile PATCH och Identity Service SKAPA förfrågningar.

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:

• Data Prep: Data Prep gör att datatekniker kan mappa, omvandla och validera data till och från Experience Data Model (XDM).
• Identity Service: Få en bättre bild av enskilda kunder och deras beteende genom att skapa en bro mellan identiteter på olika enheter och system.
• Kundprofil i realtid: Tillhandahåller en enhetlig kundprofil i realtid baserad på aggregerade data från flera källor.
• Källor: Experience Platform tillåter att data kan hämtas från olika källor samtidigt som du kan strukturera, märka och förbättra inkommande data med hjälp av plattformstjänster.

Använd direktuppspelande upserts i Data Prep

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

Direktuppspelande överföringar i Data Prep fungerar på följande sätt:

• Du måste först skapa och aktivera en datauppsättning för Profile förbrukning. Se guiden på aktivera en datauppsättning för Profile för mer information.
• Om nya identiteter måste länkas måste du också skapa ytterligare en datauppsättning med samma schema som Profile datauppsättning.
• När datauppsättningarna har förberetts måste du skapa ett dataflöde för att mappa din inkommande begäran till Profile datauppsättning,
• Därefter måste du uppdatera den inkommande begäran så att de nödvändiga rubrikerna inkluderas. Dessa rubriker definierar:
  • Den dataåtgärd som krävs för att utföras med Profile: create, mergeoch delete.
  • Den valfria identitetsåtgärden som ska utföras med Identity Service: create.

Konfigurera identitetsdatauppsättningen

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:

• Identitetsdatauppsättningen måste ha sitt associerade schema som Profile datauppsättning. Om scheman inte matchar kan det leda till inkonsekvent systembeteende.
• Du måste dock se till att identitetsdatauppsättningen skiljer sig från Profile datauppsättning. Om datauppsättningarna är desamma skrivs data över i stället för att uppdateras.
• När den första datauppsättningen måste aktiveras för Profile, identitetsdatauppsättningen ska inte aktiveras for Profile. Annars skrivs data också över i stället för att uppdateras. Identitetsdatauppsättningen ska vara aktiverat for Identity Service.

Obligatoriska fält i scheman som är associerade med identitetsdatauppsättningen

Om schemat innehåller obligatoriska fält måste valideringen av datauppsättningen inaktiveras för att aktivera Identity Service om du bara vill ta emot identiteterna. Du kan inaktivera valideringen genom att använda disabled värdet till acp_validationContext parameter. 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

Om nya identiteter inte behöver länkas kan du utelämna identity och identityDatasetId parametrar i operationerna. Om du gör det skickas endast data till Real-Time Customer Profile och hoppar över Identity Service. 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åller 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är identitet i XDM-schemat.
• Ange ett av identitetsfälten som primär identitet via fältgruppen för identitetskarta i XDM-schemat.

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

I exemplet nedan state, homePhone.number och andra attribut ersätts med sina respektive givna värden i Profile med den primära identiteten för sampleEmail@gmail.com. Ett uppdateringsmeddelande för en XDM-enhet genereras sedan av direktuppspelningen Data Prep -komponenten. 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 operations attributet med identity och identityDatasetId egenskaper. 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 att tänka på vid direktuppspelning med Data Prep:

• Metoden för direktuppspelning av överföringar bör endast användas när partiella raduppdateringar skickas till Real-Time Customer Profile. Uppdateringar av delar av rader är not som konsumeras av en datasjö.
• Metoden för att skicka direktuppspelning stöder inte uppdatering, ersättning och borttagning av identiteter. Nya identiteter skapas om de inte finns. Därför är identity måste alltid anges för att skapa. Om en identitet redan finns är åtgärden no-op.
• Metoden för direktuppspelning stöder för närvarande inte Adobe Experience Platform Web SDK och Adobe Experience Platform Mobile SDK.

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 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, läs Data Prep översikt. Så här använder du mappningsuppsättningar i Data Prep API, läs Data Prep utvecklarhandbok.