您位於此處：
身分增強自訂協同合作範本
身分增強自訂協同合作範本是 JSON 組態,在 Data 360 Clean Rooms 中支援身分增強使用個案。使用此範本以在隱私權安全環境中使用第三方身分屬性 (例如身分解析提供者的實際識別碼) 來增強第一方個人資料。
範本概觀
身分提升自訂協同合作範本包含以下欄位。
| 欄位名稱 | 資料類型 | 需求 | 描述 |
|---|---|---|---|
name |
字串 | 必要 | 協同合作範本的名稱。針對身分提升,此值為 MatchBoost。 |
description |
字串 | 選擇性 | 協同合作範本的簡短描述。 |
tables |
物件 | 必要 | 協同合作查詢中使用的輸入表格。包含 FirstPartyDataSet 表格組態。 |
queries |
物件 | 必要 | 在清除室協同合作中執行以支援使用個案的查詢。 |
useCaseConfigs |
物件 | 必要 | 使用定義支援連絡點和輸出物件對應以用於身分增強的個案特定組態。 |
表格組態
必須在 tables 欄位中定義查詢使用的每個輸入表格。tableConfigs 內容是可包含多個表格定義的陣列。
tableConfigs(陣列、必要) – 表格定義的清單。每個項目皆代表一個表格組態。身分提升範本包含一個表格組態,但您可以視需要新增其他表格。
| 欄位名稱 | 資料類型 | 需求 | 接受的值 | 描述 |
|---|---|---|---|---|
name |
字串 | 必要 | 無 | 表格的名稱。值：FirstPartyDataSet。 |
description |
字串 | 選擇性 | 無 | 表格的簡短描述。值：包含第一方資訊的 資料集。 |
role |
字串 | 必要 | 提供者或 消費者 | 共用協同合作中表格的角色。值：消費者。 |
columns |
array | 必要 | 無 | 表格的結構描述。每個資料欄物件都會定義表格中的欄位。 |
查詢組態
查詢區段定義清潔室中已組合資料集上允許的所有查詢。身分增強範本包含一個透過 queryConfigs 內容的查詢。
queryConfigs(陣列、必要) – 查詢組態的清單。身分增強範本包含一個查詢組態。
| 欄位名稱 | 資料類型 | 需求 | 接受的值 | 描述 |
|---|---|---|---|---|
name |
字串 | 必要 | 無 | 查詢的名稱。值：MatchBoost。 |
useCase |
字串 | 必要 | MatchBoost | 此查詢支援的使用個案。值：MatchBoost。 |
description |
字串 | 選擇性 | 無 | 查詢的簡短描述。值：使用第三方資料增強第一方資料集。 |
type |
字串 | 必要 | SQL | 查詢的類型。值：null (在執行階段決定)。 |
source |
字串 | 必要 | 無 | 實際 SQL 查詢文字。值：null (在執行階段決定)。 |
queryParameters |
物件 | 選擇性 | 無 | 查詢中使用的動態參數。值：null. |
referencedTables |
字串陣列 | 必要 | 無 | 查詢參照的所有表格清單。值:["FirstPartyDataSet"]。 |
MatchBoost 使用個案組態
useCaseConfigs 區段定義身分豐富的使用個案特定設定,包括支援的連絡點和輸出物件對應。
| 欄位名稱 | 資料類型 | 需求 | 描述 |
|---|---|---|---|
useCaseType |
字串 | 必要 | 使用個案的類型。值：MatchBoost。 |
supportedContactPoints |
字串陣列 | 必要 | 用來比對及豐富資料的連絡點類型。身分增強範本支援 電子郵件 和 PhoneNumber。 |
outputObjects |
物件 | 必要 | 定義 Data 360 在組織中寫入豐富資料的位置。 |
輸出物件
outputObjects 區段會告知 Data 360 寫入增強型身分資料的位置。執行清潔室查詢時,會建立三種類型的輸出:
- 將您原始客戶識別碼連接至身分提供者增強的「實際識別碼」的橋接表格
- 增強的個人記錄,可將「實際識別碼」連結至您的 Data 360 個人物件
- 將實際識別碼連結至您 Data 360 ContactPointEmail 物件的增強型連絡點記錄
範本定義三個共同作業的輸出物件,以儲存此增強的資料。
outputObjectConfigs(陣列、必要) – 輸出物件組態的清單。每個項目都會定義 Data 360 儲存其中一種類型的增強型資料的位置。
| 欄位名稱 | 資料類型 | 需求 | 描述 |
|---|---|---|---|
objectName |
字串 | 必要 | 在您 Data 360 組織中建立以儲存輸出的自訂物件名稱。 |
bridgeTable |
物件 | 選擇性 | 用於將來源識別碼連線至「實際識別碼」的對應表格。包含 sourceIdFieldName 內容。 |
relatedTable |
物件 | 選擇性 | 用於連結至標準 Data 360 物件的增強型資料表。包含 sourceObjectName (要連結的 Data 360 物件) 和 pathFromBridgeTable (如何聯結表格)。 |
SAMPLE_BRIDGE_TABLE
此輸出會在您的客戶識別碼與身分提供者的「實際識別碼」之間建立對應表格。
| 欄位 | 值 | 描述 |
|---|---|---|
objectName |
SAMPLE_BRIDGE_TABLE |
您組織中橋接表格物件的名稱。 |
bridgeTable.sourceIdFieldName |
SourceId__c |
儲存您原始客戶識別碼的欄位。 |
relatedTable |
null |
這是橋接表格,未連結至 Data 360 物件。 |
SAMPLE_INDV_BOOSTED
此輸出會建立增強的個人記錄,並將其連結至您的 Data 360 個人物件。
| 欄位 | 值 | 描述 |
|---|---|---|
objectName |
SAMPLE_INDV_BOOSTED |
貴組織中已增強的個人物件名稱。 |
bridgeTable |
null |
不是橋接表。 |
relatedTable.sourceObjectName |
ssot__Individual__dlm |
將增強的資料連結至 Data 360 中的「個人」資料模型物件。 |
relatedTable.pathFromBridgeTable |
關係路徑 | 使用實際識別碼將增強的個人資料連線至您的 Data 360 個人。 |
CONTACTEMAIL_BOOSTED
此輸出會建立豐富的連絡人電子郵件記錄,並將其連結至您的 Data 360 ContactPointEmail 物件。
| 欄位 | 值 | 描述 |
|---|---|---|
objectName |
CONTACTEMAIL_BOOSTED |
貴組織中已增強連絡人電子郵件物件的名稱。 |
bridgeTable |
null |
不是橋接表。 |
relatedTable.sourceObjectName |
ssot__ContactPointEmail__dlm |
將增強的資料連結至 Data 360 中的 ContactPointEmail DMO。 |
relatedTable.pathFromBridgeTable |
關係路徑 | 使用「實際識別碼」和「對象識別碼」將增強的電子郵件資料連線至您的 Data 360 ContactPointEmail 記錄。 |
備註
pathFromBridgeTable 內容定義如何將增強型資料表與橋接表格和 Data 360 物件聯結。它會指定連接記錄時要使用哪些欄位作為鍵值。範例案例
橋接表格對應:如果您的客戶識別碼是 CUST12345,則橋接表格會建立記錄,以將 CUST12345 連線至增強的「真實識別碼 REAL98765」。
增強的個別記錄:「實際識別碼 REAL98765」 的增強個人記錄會連結至您在 Data 360 中現有的「個人」記錄。
增強型連絡人電子郵件記錄:「實際識別碼 REAL98765」 的增強型電子郵件記錄會連結至您 Data 360 ContactPointEmail 物件中的對應電子郵件地址。
- 身分增強自訂範本範例 JSON
複製下列範本程式碼,或直接在 Data 360 中下載,以開始建立身分增強使用個案的自訂範本。使用適當的值填入必要和選擇性欄位。
此文章是否解決您的問題？
請讓我們知道，以便我們改進！
