匯入和使用外部對象
Adobe Experience Platform支援匯入外部對象的功能,這些對象隨後可用作新對象的元件。 本檔案提供設定Experience Platform以匯入及使用外部對象的教學課程。
快速入門
此教學課程需要您實際瞭解建立對象所涉及的各種Adobe Experience Platform服務。 在開始本教學課程之前,請先檢閱下列服務的檔案:
受眾vs區段定義
開始匯入和使用外部對象之前,請務必瞭解對象和區段定義之間的差異。
對象是指您嘗試篩選的目標設定檔群組。 使用區段定義時,您可以建立區段定義,將您的設定檔篩選為符合區段資格標準的子集,以建立對象。
區段定義包含名稱、說明、運算式(如果適用)、建立日期、上次修改日期及ID等資訊。 ID會將區段中繼資料連結至符合區段資格的個別設定檔,並屬於產生的對象。
為外部對象建立身分名稱空間
使用外部對象的第一個步驟是建立身分名稱空間。 身分名稱空間可讓Platform關聯受眾的來源。
若要建立身分名稱空間,請依照身分名稱空間指南中的指示操作。 建立您的身分名稱空間時,請將來源詳細資料新增至身分名稱空間,並將其型別標籤為 非人員識別碼。
為區段中繼資料建立結構
建立身分名稱空間後,您需要為要建立的區段建立新的結構描述。
若要開始撰寫結構描述,請先在左側導覽列上選取「結構描述」,然後在「結構描述」工作區的右上角選取「建立結構描述」。 從這裡,選取 瀏覽,檢視可用的結構描述型別的完整選擇。
由於您正在建立預先定義的類別區段定義,請選取 使用現有類別。 現在選取 區段定義 類別,接著選取 指派類別。
現在您的結構描述已建立,您將需要指定哪個欄位將包含區段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
欄位。 如需此欄位的詳細資訊,請參閱區段成員資格詳細資料結構描述欄位群組的指南。