合併策略終結點

Adobe Experience Platform可讓您從多個來源將資料片段匯整在一起,並加以結合,以便查看每個客戶的完整檢視。 將此資料集合在一起時,Platform會使用合併原則來判斷資料的優先順序,以及要合併哪些資料來建立統一檢視。

例如,如果客戶跨多個管道與您的品牌互動,您的組織會在多個資料集中顯示與該單一客戶相關的多個設定檔片段。 將這些片段擷取至Platform時,會合併在一起,以便為該客戶建立單一設定檔。 當來自多個來源的資料發生衝突時(例如,一個片段將客戶列為「單一」,而另一個片段將客戶列為「已婚」),合併原則會決定要納入個人設定檔中的資訊。

使用RESTful API或用戶介面,您可以建立新的合併策略、管理現有策略,以及為組織設定預設的合併策略。 本指南提供使用API使用合併原則的步驟。

要使用UI使用合併策略,請參閱合併策略UI指南。 要了解有關一般合併策略及其在Experience Platform中的角色的詳細資訊,請首先閱讀合併策略概述

快速入門

本指南中使用的API端點是Real-time Customer Profile API的一部分。 繼續之前,請檢閱快速入門手冊,取得相關檔案的連結、閱讀本檔案中範例API呼叫的指南,以及成功呼叫任何Experience Platform API所需的重要標題資訊。

合併策略的元件

合併原則是IMS組織專用的,可讓您建立不同的原則,以便以您需要的特定方式合併結構。 任何存取Profile資料的API都需要合併原則,但若未明確提供,則會使用預設原則。 Platform 為組織提供預設的合併原則,或者您可以為特定Experience Data Model(XDM)結構類別建立合併原則,並將其標示為組織的預設值。

While each organization can potentially have multiple merge policies per schema class, each class can have only one default merge policy. 如果提供架構類名稱,但需要但未提供合併策略,則將使用任何設定為預設的合併策略。

注意

當您將新合併策略設定為預設時,先前設定為預設的任何現有合併策略將自動更新為不再作為預設使用。

完整合併策略對象

完整的合併策略對象表示一組控制合併配置檔案片段方面的首選項。

Merge policy object

    {
        "id": "{MERGE_POLICY_ID}",
        "name": "{NAME}",
        "imsOrgId": "{IMS_ORG}",
        "schema": {
            "name": "{SCHEMA_CLASS_NAME}"
        },
        "version": 1,
        "identityGraph": {
            "type": "{IDENTITY_GRAPH_TYPE}"
        },
        "attributeMerge": {
            "type": "{ATTRIBUTE_MERGE_TYPE}"
        },
        "default": "{BOOLEAN}",
        "updateEpoch": "{UPDATE_TIME}"
    }
屬性 說明
id The system generated unique identifier assigned at creation time
name 可在清單檢視中識別合併原則的易記名稱。
imsOrgId 此合併策略所屬的組織ID
identityGraph 分圖形物件,指出將從中取得相關身分的身分圖。所有相關身分識別的設定檔片段將會合併。
attributeMerge 性mergeobject ,指明在發生資料衝突時,合併策略優先處理配置檔案屬性的方式。
schema.name schema對象的一部分, name欄位包含與合併策略相關的XDM架構類。 有關架構和類的詳細資訊,請參閱XDM文檔
default 指示此合併策略是否為指定架構的預設策略的布爾值。
version Platform 維護的合併策略版本。只要更新合併策略,此唯讀值就會增加。
updateEpoch 合併策略的上次更新日期。

合併策略示例

    {
        "id": "10648288-cda5-11e8-a8d5-f2801f1b9fd1",
        "name": "profile-default",
        "imsOrgId": "{IMS_ORG}",
        "schema": {
            "name": "_xdm.context.profile"
        },
        "version": 1,
        "identityGraph": {
            "type": "none"
        },
        "attributeMerge": {
            "type": "timestampOrdered"
        },
        "default": true,
        "updateEpoch": 1551660639
    }

Identity graph

Adobe Experience Platform Identity Service manages the identity graphs used globally and for each organization on Experience Platform. 合併策略的identityGraph屬性定義如何確定用戶的相關身份。

identityGraph物件

    "identityGraph": {
        "type": "{IDENTITY_GRAPH_TYPE}"
    }

Where {IDENTITY_GRAPH_TYPE} is one of the following:

  • 「無」: 不執行身分匯整。
  • "pdg": 根據您的私人身分圖表執行身分匯整。

範例identityGraph

    "identityGraph": {
        "type": "pdg"
    }

屬性合併

設定檔片段是特定使用者所在身分清單中,只有一個身分的設定檔資訊。 使用的身分圖表類型會產生多個身分時,可能會發生設定檔屬性衝突,且必須指定優先順序。 使用attributeMerge,您可以指定在關鍵值(記錄資料)類型資料集之間發生合併衝突時要排定優先順序的設定檔屬性。

attributeMerge物件

    "attributeMerge": {
        "type": "{ATTRIBUTE_MERGE_TYPE}"
    }

其中{ATTRIBUTE_MERGE_TYPE}是以下項之一:

  • timestampOrdered: (default) Give priority to the profile which was updated last. 使用此合併類型,不需要data屬性。 timestampOrdered 也支援自訂時間戳記,在資料集內或跨資料集合併設定檔片段時,會優先選擇此時間戳記。若要深入了解,請參閱上使用自訂時間戳記的附錄一節。
  • dataSetPrecedence :根據設定檔片段的來源資料集,為其指定優先順序。當一個資料集中的資訊比另一個資料集中的資料更偏好或更受信任時,即可使用此方法。 使用此合併類型時,需要order屬性,因為它按優先順序列出資料集。
    • order:使用「dataSetPrecerance」時,必須 order 為陣列提供資料集清單。清單中未包含的任何資料集都不會合併。 換言之,必須明確列出資料集,才能合併至設定檔中。 The order array lists the IDs of the datasets in order of priority.

Example attributeMerge object using dataSetPrecedence type

    "attributeMerge": {
        "type": "dataSetPrecedence",
        "order" : [
            "dataSetId_2", 
            "dataSetId_3", 
            "dataSetId_1", 
            "dataSetId_4"
        ]
    }

使用timestampOrdered類型的attributeMerge物件範例

    "attributeMerge": {
        "type": "timestampOrdered"
    }

結構

架構物件會指定要建立此合併原則的Experience Data Model(XDM)架構類別。

schema物件

    "schema": {
        "name": "{SCHEMA_NAME}"
    }

其中name的值是與合併策略關聯的架構所基於的XDM類的名稱。

範例schema

    "schema": {
        "name": "_xdm.context.profile"
    }

若要進一步了解XDM以及使用Experience Platform中的結構,請先閱讀XDM系統概觀

訪問合併策略

Real-time Customer Profile API可讓/config/mergePolicies端點執行查詢請求,以依其ID檢視特定合併原則,或存取IMS組織中依特定條件篩選的所有合併原則。 您也可以使用/config/mergePolicies/bulk-get端點來根據其ID檢索多個合併策略。 以下各節將概述執行這些呼叫的步驟。

按ID訪問單個合併策略

您可以通過向/config/mergePolicies端點發出GET請求,並在請求路徑中包括mergePolicyId ,以ID訪問單個合併策略。

API格式

GET /config/mergePolicies/{mergePolicyId}
參數 說明
{mergePolicyId} 要刪除的合併策略的標識符。

要求

curl -X GET \
  'https://platform.adobe.io/data/core/ups/config/mergePolicies/10648288-cda5-11e8-a8d5-f2801f1b9fd1' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}

回應

成功的響應返回合併策略的詳細資訊。

{
    "id": "10648288-cda5-11e8-a8d5-f2801f1b9fd1",
    "imsOrgId": "{IMS_ORG}",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "version": 1,
    "identityGraph": {
        "type": "pdg"
    },
    "attributeMerge": {
        "type": "timestampOrdered"
    },
    "default": false,
    "updateEpoch": 1551127597
}

有關組成合併策略的每個元素的詳細資訊,請參閱本文檔開頭的合併策略的元件部分。

Retrieve multiple merge policies by their IDs

You can retrieve multiple merge policies by making a POST request to the /config/mergePolicies/bulk-get endpoint and including the IDs of the merge policies you wish to retrieve in the request body.

API格式

POST /config/mergePolicies/bulk-get

要求

請求內文包含「ids」陣列,內含個別物件,其中包含您要擷取詳細資料之每個合併原則的「id」。

curl -X POST \
  'https://platform.adobe.io/data/core/ups/config/mergePolicies/bulk-get' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "ids": [
          {
            "id": "0bf16e61-90e9-4204-b8fa-ad250360957b"
          },
          {
            "id": "42d4a596-b1c6-46c0-994e-ca5ef1f85130"
          }
        ]
      }'

回應

成功的回應會傳回HTTP狀態207(多狀態),以及其ID已於POST請求中提供之合併原則的詳細資訊。

{ 
    "results": { 
        "0bf16e61-90e9-4204-b8fa-ad250360957b": {
            "id": "0bf16e61-90e9-4204-b8fa-ad250360957b",
            "name": "Profile Default Merge Policy",
            "imsOrgId": "{IMS_ORG}",
            "sandbox": {
                "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "schema": {
                "name": "_xdm.context.profile"
            },
            "version": 1,
            "identityGraph": {
                "type": "none"
            },
            "attributeMerge": {
                "type": "timestampOrdered"
            },
            "default": true,
            "updateEpoch": 1552086578
        },
        "42d4a596-b1c6-46c0-994e-ca5ef1f85130": {
            "id": "42d4a596-b1c6-46c0-994e-ca5ef1f85130",
            "name": "Dataset Precedence Merge Policy",
            "imsOrgId": "{IMS_ORG}",
            "sandbox": {
                "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "schema": {
                "name": "_xdm.context.profile"
            },
            "version": 1,
            "identityGraph": {
                "type": "pdg"
            },
            "attributeMerge": {
                "type": "dataSetPrecedence",
                "order": [
                    "5b76f86b85d0e00000be5c8b",
                    "5b76f8d787a6af01e2ceda18"
                ]
            },
            "default": false,
            "updateEpoch": 1576099719
        }
    }
}

See the components of merge policies section at the beginning of this document for details on each of the individual elements that make up a merge policy.

List multiple merge policies by criteria

您可以向/config/mergePolicies端點發出GET請求,並使用選用的查詢參數來篩選、排序和分頁回應,借此列出IMS組織內的多個合併原則。 可包含多個參數,以&符號分隔。 對此端點進行無參數呼叫將檢索組織可用的所有合併策略。

API格式

GET /config/mergePolicies?{QUERY_PARAMS}
參數 說明
default 一個布爾值,通過合併策略是否為架構類的預設策略來篩選結果。
limit 指定頁面大小限制以控制頁面中包含的結果數量。 預設值:20
orderBy 指定按orderBy=nameorderBy=+name排序結果的欄位,以按名稱升序排序,或按降序排序orderBy=-name。 省略此值會導致預設的name排序依遞增順序。
schema.name 要為其檢索可用合併策略的架構的名稱。
identityGraph.type 依身分圖表類型篩選結果。 可能的值包括「無」和「pdg」(專用圖表)。
attributeMerge.type 按使用的屬性合併類型篩選結果。 Possible values include "timestampOrdered" and "dataSetPrecedence".
start 頁面偏移 — 指定要擷取資料的起始ID。 Default value: 0
version 如果要使用合併策略的特定版本,請指定此選項。 By default, the latest version will be used.

有關schema.nameidentityGraph.typeattributeMerge.type的詳細資訊,請參閱本指南前面提供的合併策略的元件部分。

要求

以下請求列出了給定架構的所有合併策略:

curl -X GET \
  'https://platform.adobe.io/data/core/ups/config/mergePolicies?schema.name=_xdm.context.profile' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}

回應

成功的回應會傳回符合要求中傳送之查詢參數所指定准則的合併原則編頁清單。

{
    "_page": {
        "totalCount": 2,
        "pageSize": 2
    },
    "children": [
        {
            "id": "0bf16e61-90e9-4204-b8fa-ad250360957b",
            "name": "Profile Default Merge Policy",
            "imsOrgId": "{IMS_ORG}",
            "sandbox": {
                "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "schema": {
                "name": "_xdm.context.profile"
            },
            "version": 1,
            "identityGraph": {
                "type": "none"
            },
            "attributeMerge": {
                "type": "timestampOrdered"
            },
            "default": true,
            "updateEpoch": 1552086578
        },
        {
            "id": "42d4a596-b1c6-46c0-994e-ca5ef1f85130",
            "name": "Dataset Precedence Merge Policy",
            "imsOrgId": "{IMS_ORG}",
            "sandbox": {
                "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "schema": {
                "name": "_xdm.context.profile"
            },
            "version": 1,
            "identityGraph": {
                "type": "pdg"
            },
            "attributeMerge": {
                "type": "dataSetPrecedence",
                "order": [
                    "5b76f86b85d0e00000be5c8b",
                    "5b76f8d787a6af01e2ceda18"
                ]
            },
            "default": false,
            "updateEpoch": 1576099719
        }
    ],
    "_links": {
        "next": {
            "href": "@/mergePolicies?start=K1JJRDpFaWc5QUpZWHY1c2JBQUFBQUFBQUFBPT0jUlQ6MSNUUkM6MiNGUEM6QWdFQUFBQldBQkVBQVBnaFFQLzM4VUIvL2tKQi8rLysvMUpBLzMrMi8wRkFmLzR4UUwvL0VrRC85em4zRTBEcmNmYi92Kzh4UUwvL05rQVgzRi8rMStqNS80WHQwN2NhUUVzQUFBUUFleGpLQ1JnVXRVcEFCQUFFQVBBRA==&orderBy=&limit=2"
        }
    }
}
屬性 說明
_links.next.href 結果下一頁的URI地址。 Use this URI as the request parameter for another API call to the same endpoint to view the page. 如果沒有下一頁存在,則此值將為空字串。

建立合併策略

您可以向/config/mergePolicies端點提出POST請求,以建立組織的新合併策略。

API format

POST /config/mergePolicies

Request
The following request creates a new merge policy, which is configured by the attribute values provided in the payload:

curl -X POST \
  https://platform.adobe.io/data/core/ups/config/mergePolicies \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Loyalty members ordered by ID",
    "identityGraph" : {
        "type": "none"
    },
    "attributeMerge" : {
        "type":"dataSetPrecedence",
        "order" : [
            "5b76f86b85d0e00000be5c8b",
            "5b76f8d787a6af01e2ceda18"
        ]
    },
    "schema": {
        "name":"_xdm.context.profile"
    },
    "default": true
}'
屬性 說明
name A human-friendly name by which the merge policy can be identified in list views.
identityGraph.type 要從中獲取要合併的相關身份的標識圖類型。 可能的值:「無」或「pdg」(專用圖表)。
attributeMerge 在發生資料衝突時,設定檔屬性值優先順序的方式。
schema 與合併策略關聯的XDM架構類。
default 指定此合併策略是否為架構的預設策略。

有關詳細資訊,請參閱合併策略的元件部分。

回應

成功的響應返回新建立的合併策略的詳細資訊。

{
    "id": "e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2",
    "name": "Loyalty members ordered by ID",
    "imsOrgId": "{IMS_ORG}",
    "sandbox": {
        "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "schema": {
        "name": "_xdm.context.profile"
    },
    "version": 1,
    "identityGraph": {
        "type": "none"
    },
    "attributeMerge": {
        "type": "dataSetPrecedence",
        "order": [
            "5b76f86b85d0e00000be5c8b",
            "5b76f8d787a6af01e2ceda18"
        ]
    },
    "default": true,
    "updateEpoch": 1551898378
}

有關組成合併策略的每個元素的詳細資訊,請參閱本文檔開頭的合併策略的元件部分。

更新合併策略

通過編輯單個屬性(PATCH)或用新屬性(PUT)覆蓋整個合併策略,可以修改現有合併策略。 各個範例如下所示。

Edit individual merge policy fields

通過向/config/mergePolicies/{mergePolicyId}端點發出PATCH請求,可以編輯合併策略的各個欄位:

API格式

PATCH /config/mergePolicies/{mergePolicyId}
參數 說明
{mergePolicyId} 要刪除的合併策略的標識符。

要求

以下請求通過將其default屬性的值更改為true來更新指定的合併策略:

curl -X PATCH \
  https://platform.adobe.io/data/core/ups/config/mergePolicies/e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
    "op": "add",
    "path": "/default",
    "value": "true"
  }'
屬性 說明
op 指定要執行的操作。 若需其他PATCH操作的範例,請參閱JSON修補程式檔案
path The path of the field to update. Accepted values are: "/name", "/identityGraph.type", "/attributeMerge.type", "/schema.name", "/version", "/default"
value The value to set the specified field to.

有關詳細資訊,請參閱合併策略的元件部分。

回應

成功的響應返回新更新的合併策略的詳細資訊。

{
    "id": "e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2",
    "name": "Loyalty members ordered by ID",
    "imsOrgId": "{IMS_ORG}",
    "sandbox": {
        "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "schema": {
        "name": "_xdm.context.profile"
    },
    "version": 1,
    "identityGraph": {
        "type": "none"
    },
    "attributeMerge": {
        "type": "dataSetPrecedence",
        "order": [
            "5b76f86b85d0e00000be5c8b",
            "5b76f8d787a6af01e2ceda18"
        ]
    },
    "default": true,
    "updateEpoch": 1551898378
}

覆蓋合併策略

修改合併策略的另一種方法是使用PUT請求,該請求會覆蓋整個合併策略。

API format

PUT /config/mergePolicies/{mergePolicyId}
參數 說明
{mergePolicyId} The identifier of the merge policy you want to overwrite.

要求

The following request overwrites the specified merge policy, replacing its attribute values with those supplied in the payload. 由於此請求完全替換了現有的合併策略,因此您必須提供最初定義合併策略時所需的所有相同欄位。 However, this time you are providing updated values for the fields you want to change.

curl -X PUT \
  https://platform.adobe.io/data/core/ups/config/mergePolicies/e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "name": "Loyalty members ordered by ID",
        "imsOrgId": "{IMS_ORG}",
        "schema": {
            "name": "_xdm.context.profile"
        },
        "version": 1,
        "identityGraph": {
            "type": "none"
        },
        "attributeMerge": {
            "type": "dataSetPrecedence",
            "order": [
                "5b76f86b85d0e00000be5c8b",
                "5b76f8d787a6af01e2ceda18"
            ]
        },
        "default": true,
        "updateEpoch": 1551898378
    }'
屬性 說明
name 一個好記的名稱,可在清單檢視中識別合併政策。
identityGraph 要從中獲取要合併的相關標識的標識圖。
attributeMerge 在發生資料衝突時,設定檔屬性值優先順序的方式。
schema The XDM schema class associated with the merge policy.
default 指定此合併策略是否為架構的預設策略。

Refer to the components of merge policies section for more information.

回應

成功的響應返回更新的合併策略的詳細資訊。

{
    "id": "e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2",
    "name": "Loyalty members ordered by ID",
    "imsOrgId": "{IMS_ORG}",
    "sandbox": {
        "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "schema": {
        "name": "_xdm.context.profile"
    },
    "version": 1,
    "identityGraph": {
        "type": "none"
    },
    "attributeMerge": {
        "type": "dataSetPrecedence",
        "order": [
            "5b76f86b85d0e00000be5c8b",
            "5b76f8d787a6af01e2ceda18"
        ]
    },
    "default": true,
    "updateEpoch": 1551898378
}

刪除合併策略

A merge policy can be deleted by making a DELETE request to the /config/mergePolicies endpoint and including the ID of the merge policy that you wish to delete in the request path.

API格式

DELETE /config/mergePolicies/{mergePolicyId}
參數 說明
{mergePolicyId} 要刪除的合併策略的標識符。

要求

以下請求將刪除合併策略。

curl -X DELETE \
  https://platform.adobe.io/data/core/ups/config/mergePolicies/e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

回應

成功的刪除請求會傳回HTTP狀態200(OK)和空的回應內文。 若要確認刪除是否成功,您可以執行GET請求,依其ID檢視合併原則。 如果刪除合併策略,您會收到HTTP狀態404(找不到)錯誤。

後續步驟

現在您知道如何為組織建立和設定合併原則,可以使用這些原則來調整Platform中客戶設定檔的檢視,並從Real-time Customer Profile資料建立受眾區段。 Please see the Adobe Experience Platform Segmentation Service documentation to begin defining and working with segments.

附錄

本節提供與使用合併政策相關的補充資訊。

使用自訂時間戳記

當記錄被Experience Platform時,系統時間戳在獲取時獲得並添加到記錄中。 當選擇timestampOrdered作為合併策略的attributeMerge類型時,將根據系統時間戳合併配置檔案。 換言之,合併會根據記錄擷取至Platform時的時間戳記完成。

有時候,可能會出現使用案例,例如回填資料,或在未依序擷取記錄時確保事件的正確順序,此時需要提供自訂時間戳記,且合併政策必須遵循自訂時間戳記,而非系統時間戳記。

若要使用自訂時間戳記,必須將External Source System Audit Details 架構欄位群組新增至您的設定檔架構。 新增後,可使用xdm:lastUpdatedDate欄位填入自訂時間戳記。 擷取記錄並填入xdm:lastUpdatedDate欄位時,Experience Platform會使用該欄位來合併資料集內和跨資料集的記錄或設定檔片段。 如果xdm:lastUpdatedDate不存在或未填入,Platform將繼續使用系統時間戳記。

注意

在相同記錄上傳送PATCH時,您必須確保填入xdm:lastUpdatedDate時間戳記。

有關使用架構註冊表API來使用架構的逐步指示,包括如何將欄位群組新增至架構,請參閱使用API建立架構的教學課程。

若要使用UI使用自訂時間戳記,請參閱合併原則概述中使用自訂時間戳記🔗的區段。

External Source System Audit Details field group details

下列範例顯示External Source System Audit Details欄位群組中正確填入的欄位。 The complete field group JSON can also be viewed in the public Experience Data Model (XDM) repo on GitHub.

{
  "xdm:createdBy": "{CREATED_BY}",
  "xdm:createdDate": "2018-01-02T15:52:25+00:00",
  "xdm:lastUpdatedBy": "{LAST_UPDATED_BY}",
  "xdm:lastUpdatedDate": "2018-01-02T15:52:25+00:00",
  "xdm:lastActivityDate": "2018-01-02T15:52:25+00:00",
  "xdm:lastReferencedDate": "2018-01-02T15:52:25+00:00",
  "xdm:lastViewedDate": "2018-01-02T15:52:25+00:00"
 }

本頁內容