Experience League

匯入和使用外部對象

Adobe Experience Platform支援匯入外部對象的功能，這些對象隨後可用作新區段定義的元件。本檔案提供設定Experience Platform以匯入及使用外部對象的教學課程。

快速入門

本教學課程需要深入瞭解各種 Adobe Experience Platform 建立受眾區段所涉及的服務。在開始本教學課程之前，請檢閱下列服務的檔案：

細分服務：可讓您從即時客戶個人檔案資料建立受眾區段。
即時客戶個人檔案：根據來自多個來源的彙總資料，提供統一的即時消費者設定檔。
體驗資料模型(XDM)：Platform組織客戶體驗資料的標準化架構。為了充分利用「分段」，請確保您的資料已根據資料模型化的最佳實務.
資料集：Experience Platform中資料持續存在的儲存和管理結構。
串流擷取：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 欄位擷取您的對象資料時。如需有關本欄位的詳細資訊，請閱讀區段會籍詳細資料結構描述欄位群組.

匯入和使用外部對象

快速入門

區段資料與區段中繼資料

為外部對象建立身分名稱空間

為區段中繼資料建立結構

為結構描述建立資料集

設定和匯入對象資料

使用批次連線擷取資料

使用串流連線擷取資料

對象中繼資料結構

使用匯入的對象建立區段

後續步驟

附錄

設定外部區段會籍目的地結構描述

設定資料集

設定和匯入外部對象成員資格資料

使用批次連線擷取資料

使用串流連線擷取資料

區段會籍結構

Business.Adobe.com 資源

本頁內容

檢視下一個:

學習

說明文件

社群

技術支援

資源

Adobe 帳戶

Adobe