Adobe Experience Platform支援匯入外部對象的功能,這些對象隨後可用作新區段定義的元件。 本檔案提供設定Experience Platform以匯入及使用外部對象的教學課程。
本教學課程需要深入瞭解各種 Adobe Experience Platform 建立受眾區段所涉及的服務。 在開始本教學課程之前,請檢閱下列服務的檔案:
開始匯入和使用外部對象之前,請務必瞭解區段資料與區段中繼資料之間的差異。
區段資料是指符合區段資格條件的設定檔,因此也是對象的一部分。
區段中繼資料是有關區段本身的資訊,包括名稱、說明、運算式(如果適用)、建立日期、上次修改日期和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 |
資料集ID 必須 請參閱先前為您剛剛建立的結構描述建立的資料集。 |
xdmEntity._id |
ID 必須 請參閱您作為外部對象使用的相同區段ID。 |
xdmEntity.identityMap |
本節 必須 包含建立先前建立的名稱空間時使用的身分標籤。 |
{IDENTITY_NAMESPACE} |
這是先前建立之身分名稱空間的標籤。 因此,舉例來說,如果您將身分名稱空間稱為「externalAudience」,您可以將其用作陣列的索引鍵。 |
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 |
資料集ID 必須 請參閱先前建立之資料集,以瞭解您剛才建立的成員資格方案。 |
xdmEntity._id |
適合的ID,用來唯一識別資料集中的記錄。 |
{TENANT_NAME}.identities |
此區段用於連線自訂身分的欄位群組與您先前匯入的使用者。 |
segmentMembership.{IDENTITY_NAMESPACE} |
這是先前建立的自訂身分名稱空間的標籤。 因此,舉例來說,如果您將身分名稱空間稱為「externalAudience」,您可以將其用作陣列的索引鍵。 |
依預設,外部對象會籍僅保留30天。 若要保留超過30天,請使用 validUntil
欄位擷取您的對象資料時。 如需有關本欄位的詳細資訊,請閱讀 區段會籍詳細資料結構描述欄位群組.