傳送部分列更新至 Real-Time Customer Profile 使用 Data Prep

Last update: Wed May 29 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
Data Prep

建立對象：

Developer

WARNING

已棄用透過DCS入口針對設定檔更新擷取的Experience Data Model (XDM)實體更新訊息(含JSONPATCH作業)。或者，您可以將原始資料擷取至DCS入口並指定必要的資料對應，以將您的資料轉換為符合XDM的訊息以進行設定檔更新。

串流更新插入 Data Prep 可讓您將部分列更新傳送至 Real-Time Customer Profile 同時透過單一API請求建立和建立新的身分連結。

透過串流更新插入，您可以保留資料的格式，同時將該資料轉譯為 Real-Time Customer Profile 在內嵌期間PATCH請求。根據您提供的輸入， Data Prep 可讓您傳送單一API裝載，並將資料轉譯為兩者 Real-Time Customer Profile PATCH和 Identity Service 建立請求。

NOTE

若要利用更新插入功能，建議您在資料擷取期間關閉XDM相容的設定，並使用重新對應傳入的裝載資料準備對應程式.

本檔案提供如何在中串流更新外掛的資訊 Data Prep.

快速入門

此概覽需要深入瞭解下列Adobe Experience Platform元件：

Data Prep： Data Prep 可讓資料工程師對應、轉換及驗證來往於Experience Data Model (XDM)的資料。
Identity Service：透過跨裝置和系統橋接身分，更能瞭解個別客戶及其行為。
即時客戶個人檔案：根據來自多個來源的彙總資料，即時提供統一的客戶設定檔。
來源：Experience Platform可讓您從各種來源擷取資料，同時使用Platform服務來建構、加標籤及增強傳入資料。

在中使用串流更新插入 Data Prep streaming-upserts-in-data-prep

NOTE

下列來源支援使用串流更新插入：

串流更新插入高階工作流程

串流更新插入 Data Prep 其運作方式如下：

您必須先建立和啟用資料集 Profile 消耗。請參閱以下指南：啟用資料集 Profile 以取得詳細資訊。
如果新身分必須連結，則您也必須建立其他資料集 使用相同結構描述 作為您的 Profile 資料集。
準備好資料集後，您必須建立資料流，將傳入的請求對應至 Profile 資料集；
接下來，您必須更新傳入請求以包含必要的標頭。這些標頭會定義：
- 需要執行的資料操作 Profile： create， merge、和 delete.
- 要透過執行的選擇性身分操作 Identity Service： create.

設定身分資料集

如果新身分必須連結，則您必須在傳入裝載中建立並傳遞額外的資料集。建立身分資料集時，您必須確保符合下列需求：

身分資料集必須擁有其關聯的結構描述作為 Profile 資料集。結構描述不相符可能會導致不一致的系統行為。
不過，您必須確保身分資料集與不同 Profile 資料集。如果資料集相同，則會覆寫資料而非更新資料。
雖然初始資料集必須啟用 Profile，身分資料集 不應啟用 的 Profile. 否則，也會覆寫資料，而非更新資料。不過，身分資料集 應該啟用 的 Identity Service.

與身分資料集相關聯之結構描述中的必填欄位 identity-dataset-required-fileds

如果您的結構描述包含必填欄位，則必須抑制資料集的驗證才能啟用 Identity Service 以僅接收身分。您可以套用 disabled 值至 acp_validationContext 引數。請參閱下列範例：

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

TIP

如果與身分資料集相關聯的結構描述沒有任何必填欄位，則不需要進行任何其他設定。

傳入裝載結構

以下顯示可建立新身分連結之傳入裝載結構的範例。

具有身分設定的裝載

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

參數

說明

flowId

用於識別資料流的唯一ID。此資料流ID應該對應至使用建立的來源連線 Amazon Kinesis， Azure Event Hubs，或 HTTP API. 此資料流也應該有 Profile — 啟用資料集作為目標資料集。注意：的ID Profile啟用的目標資料集也會用作 datasetId 引數。

imsOrgId

與您的組織相對應的ID。

datasetId

的ID Profile — 啟用資料流的目標資料集。注意：此ID與 Profile — 已在資料流中找到啟用的目標資料集ID。

operations

此引數概述以下動作： Data Prep 將會根據傳入的請求來進行。

operations.data

定義必須在中執行的動作 Real-Time Customer Profile.

operations.identity

透過定義資料上允許的操作 Identity Service.

operations.identityDatasetId

（選用）只有在必須連結新身分時才需要身分資料集的ID。

支援的作業

支援下列作業 Real-Time Customer Profile：

運作

說明

create

預設操作。這會為產生XDM實體建立方法 Real-Time Customer Profile.

merge

這會為以下專案產生XDM實體更新方法 Real-Time Customer Profile.

delete

這會為以下專案產生XDM實體刪除方法 Real-Time Customer Profile 並永久移除以下專案的資料： Profile store.

支援下列作業 Identity Service：

運作

說明

create

此引數唯一允許的作業。如果 create 傳遞為的值 operations.identity，然後 Data Prep 產生XDM實體建立請求 Identity Service. 如果身分已經存在，則會忽略身分。 注意： 如果 operations.identity 設為 create，然後 identityDatasetId 也必須指定。 XDM實體建立由內部產生的訊息 Data Prep 將會為此資料集id產生元件。

沒有身分設定的裝載

如果不需要連結新身分，則可以省略 identity 和 identityDatasetId 操作中的引數。這麼做只會傳送資料至 Real-Time Customer Profile 並略過 Identity Service. 如需範例，請參閱以下裝載：

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

動態傳遞主要身分

若要進行XDM更新，結構描述必須啟用 Profile 並包含主要身分。您可以透過兩種方式指定XDM結構描述的主要身分：

在XDM結構中指定一個靜態欄位作為主要身分；
透過XDM結構描述中的身分對應欄位群組，將其中一個身分欄位指定為主要身分。

將靜態欄位指定為XDM結構描述中的主要身分欄位

在以下範例中， state， homePhone.number 和其他屬性會以其各自的指定值更新插入 Profile 主要身分為 sampleEmail@gmail.com. 然後，串流會產生XDM實體更新訊息 Data Prep 元件。 Real-Time Customer Profile 然後確認XDM更新訊息以更新插入設定檔記錄。

NOTE

在此範例中，身分將不會連結在一起，因為沒有定義身分的操作。

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

透過XDM結構描述中的身分對應欄位群組，將其中一個身分欄位指定為主要身分

在此範例中，標題包含 operations 屬性和 identity 和 identityDatasetId 屬性。如此可讓資料與 Real-Time Customer Profile 以及要傳遞至的身分 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"
  }
 }'

已知限制和主要考量事項

以下概述使用串流更新插入時應考量的已知限制清單 Data Prep：

只有當傳送部分列更新至時，才應該使用串流更新插入方法 Real-Time Customer Profile. 部分列更新為非由資料湖使用。
串流更新插入方法不支援更新、取代和移除身分。如果新身分不存在，則會建立新身分。因此， identity 作業必須一律設定為建立。如果身分已經存在，則操作是無操作。
串流更新插入方法目前不支援 Adobe Experience Platform Web SDK 和 Adobe Experience Platform Mobile SDK.

後續步驟

閱讀本檔案後，您現在應該瞭解如何在中串流更新插入 Data Prep 傳送部分資料列更新至 Real-Time Customer Profile 資料，同時透過單一API請求建立和連結身分識別。有關其他專案的詳細資訊 Data Prep 功能，請閱讀 Data Prep 概述. 若要瞭解如何在 Data Prep API，請閱讀 Data Prep 開發人員指南.

recommendation-more-help

461cc884-c234-4a0c-ac75-6efbaafc1394