匯入和使用外部對象
Adobe Experience Platform支援匯入外部對象的功能,這些對象隨後可用作新對象的元件。 本檔案提供設定Experience Platform以匯入及使用外部對象的教學課程。
快速入門
本教學課程需要您實際瞭解各種 Adobe Experience Platform 與建立對象相關的服務。 在開始本教學課程之前,請先檢閱下列服務的檔案:
- 分段服務:可讓您從即時客戶個人檔案資料建立對象。
- 即時客戶個人檔案:根據來自多個來源的彙總資料,提供統一的即時消費者個人檔案。
- 體驗資料模型(XDM):Platform組織客戶體驗資料的標準化架構。 為善用分段,請確保您的資料已根據 資料模型化的最佳實務.
- 資料集:Experience Platform中資料持續性的儲存和管理結構。
- 串流擷取:Experience Platform如何即時從使用者端和伺服器端裝置擷取及儲存資料。
受眾vs區段定義
開始匯入和使用外部對象之前,請務必瞭解對象和區段定義之間的差異。
對象是指您嘗試篩選的目標設定檔群組。 使用區段定義時,您可以建立區段定義,將您的設定檔篩選為符合區段資格標準的子集,以建立對象。
區段定義包含名稱、說明、運算式(如果適用)、建立日期、上次修改日期及ID等資訊。 ID會將區段中繼資料連結至符合區段資格的個別設定檔,並屬於產生的對象。
為外部對象建立身分名稱空間
使用外部對象的第一個步驟是建立身分名稱空間。 身分名稱空間可讓Platform關聯受眾的來源。
若要建立身分名稱空間,請依照 身分名稱空間指南. 建立身分名稱空間時,請將來源詳細資料新增到身分名稱空間中,並標籤其 型別 as a 非人員識別碼.
為區段中繼資料建立結構
建立身分名稱空間後,您需要為要建立的區段建立新的結構描述。
若要開始構成方案,請先選取 方案 ,然後按一下 建立結構描述 在「方案」工作區的右上角。 從這裡,選擇 瀏覽 以檢視可用綱要型別的完整選擇。
由於您正在建立預先定義的類別區段定義,請選取 使用現有類別. 現在,選取 區段定義 類別,後面接著 指派類別.
現在您的結構描述已建立,您將需要指定哪個欄位將包含區段ID。 此欄位應該標示為主要身分,並指派給您先前建立的名稱空間。
標示 _id
欄位做為主要身分識別,選取結構描述的標題,然後切換標示為 個人資料. 選取 啟用 啟用以下專案的結構描述: Real-Time Customer Profile.
現在,此結構描述已針對設定檔啟用,主要身分識別已指派給您建立的非個人身分名稱空間。 因此,這表示使用此結構描述匯入Platform的區段中繼資料將內嵌到設定檔中,而不會與其他人員相關的設定檔資料合併。
為結構描述建立資料集
設定結構後,您需要為區段中繼資料建立資料集。
若要建立資料集,請依照 資料集使用手冊. 您應遵循 從結構描述建立資料集 選項,使用您先前建立的結構描述。
建立資料集後,請繼續按照 資料集使用手冊 為即時客戶個人檔案啟用此資料集。
設定和匯入對象資料
在啟用資料集後,現在可以透過UI或使用Experience Platform API將資料傳送到Platform。 您可以透過批次或串流連線擷取此資料。
使用批次連線擷取資料
若要建立批次連線,您可以遵循一般中的指示 本機檔案上傳UI指南. 如需可搭配內嵌資料使用的可用來源完整清單,請參閱 來源概觀.
使用串流連線擷取資料
若要建立串流連線,您可以依照 api教學課程 或 UI教學課程.
建立串流連線後,您就可以存取唯一的串流端點,將資料傳送至該端點。 若要瞭解如何傳送資料至這些端點,請閱讀 串流記錄資料的教學課程.
對象中繼資料結構
建立連線後,您現在可以將資料內嵌至Platform。
您可在下方看到外部對象裝載中繼資料的範例:
{
"header": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
},
"imsOrgId": "{ORG_ID}",
"datasetId": "{DATASET_ID}",
"source": {
"name": "Sample External Audience"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_id": "{SEGMENT_ID}",
"description": "Sample description",
"identityMap": {
"{IDENTITY_NAMESPACE}": [{
"id": "{}"
}]
},
"segmentName" : "{SEGMENT_NAME}",
"segmentStatus": "ACTIVE",
"version": "1.0"
}
}
}
schemaRef
datasetId
xdmEntity._id
xdmEntity.identityMap
{IDENTITY_NAMESPACE}
segmentName
使用匯入的對象建立區段
設定好匯入的對象後,就可以在細分程式中使用這些對象。 若要尋找外部對象,請前往「區段產生器」,然後選取 受眾 索引標籤中的 欄位 區段。
後續步驟
現在,您可以在區段中使用外部對象,您可以使用區段產生器來建立區段。 若要瞭解如何建立區段,請參閱 有關建立區段的教學課程.
附錄
除了使用匯入的外部受眾中繼資料及使用這些中繼資料建立區段外,您也可以將外部區段會籍匯入至Platform。
設定外部區段會籍目的地結構描述
若要開始構成方案,請先選取 方案 ,然後按一下 建立結構描述 在「方案」工作區的右上角。 從這裡,選擇 XDM個別設定檔.
現在已建立結構描述,您將需要新增區段成員資格欄位群組作為結構描述的一部分。 要執行此操作,請選取 區塊會籍細節,後接 新增欄位群組.
此外,請確定結構已標籤為 個人資料. 為此,您需要將欄位標示為主要身分。
設定資料集
建立結構描述後,您需要建立資料集。
若要建立資料集,請依照 資料集使用手冊. 您應遵循 從結構描述建立資料集 選項,使用您先前建立的結構描述。
建立資料集後,請繼續按照 資料集使用手冊 為即時客戶個人檔案啟用此資料集。
設定和匯入外部對象成員資格資料
在啟用資料集後,現在可以透過UI或使用Experience Platform API將資料傳送到Platform。 您可以透過批次或串流連線擷取此資料。
使用批次連線擷取資料
若要建立批次連線,您可以遵循一般中的指示 本機檔案上傳UI指南. 如需可搭配內嵌資料使用的可用來源完整清單,請參閱 來源概觀.
使用串流連線擷取資料
若要建立串流連線,您可以依照 api教學課程 或 UI教學課程.
建立串流連線後,您就可以存取唯一的串流端點,將資料傳送至該端點。 若要瞭解如何傳送資料至這些端點,請閱讀 串流記錄資料的教學課程.
區段會籍結構
建立連線後,您現在可以將資料內嵌至Platform。
您可在下方看到外部對象成員資格裝載的範例:
{
"header": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
},
"imsOrgId": "{ORG_ID}",
"datasetId": "{DATASET_ID}",
"source": {
"name": "Sample External Audience Membership"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_id": "{UNIQUE_ID}",
"description": "Sample description",
"{TENANT_NAME}": {
"identities": {
"{SCHEMA_IDENTITY}": "sample-id"
}
},
"personId" : "sample-name",
"segmentMembership": {
"{IDENTITY_NAMESPACE}": {
"{EXTERNAL_IDENTITY}": {
"status": "realized",
"lastQualificationTime": "2022-03-14T:00:00:00Z"
}
}
}
}
}
}
schemaRef
datasetId
xdmEntity._id
{TENANT_NAME}.identities
segmentMembership.{IDENTITY_NAMESPACE}
validUntil
欄位擷取您的對象資料。 如需有關本欄位的詳細資訊,請閱讀以下指南: 區段會籍詳細資料結構欄位群組.