導入和使用外部受眾

Adobe Experience Platform支援引進外部受眾的能力，這些受眾隨後可用作新段定義的元件。 本文檔提供了設定導入和使用外部受眾的Experience Platform的教程。

快速入門

本教程需要對各種 Adobe Experience Platform 服務。 在開始本教程之前，請查看以下服務的文檔：

• 分段服務:允許您從即時客戶配置檔案資料構建受眾段。
• 即時客戶概要資訊:基於來自多個源的聚合資料提供統一、即時的用戶配置檔案。
• 體驗資料模型(XDM):平台組織客戶體驗資料的標準化框架。 為最好地利用分段，請確保根據 資料建模的最佳做法。
• 資料集:Experience Platform中資料持久性的儲存和管理結構。
• 流攝入:Experience Platform如何即時接收和儲存來自客戶端和伺服器端設備的資料。

段資料與段元資料

在開始導入和使用外部訪問群體之前，瞭解段資料和段元資料之間的差異非常重要。

段資料是指符合段資格標準的配置檔案，因此是受眾的一部分。

段元資料是有關段本身的資訊，包括名稱、說明、表達式（如果適用）、建立日期、上次修改日期和ID。 該ID將段元資料連結到滿足段限定並且是所產生受眾的一部分的單個配置檔案。

為外部訪問群體建立標識命名空間

使用外部受眾的第一步是建立標識命名空間。 標識命名空間允許平台關聯段的來源。

要建立標識命名空間，請按照 標識命名空間指南。 建立標識命名空間時，將源詳細資訊添加到標識命名空間，並標籤其 類型 作為 非人員標識符。

為段元資料建立架構

建立標識命名空間後，需要為要建立的段建立新架構。

要開始合成架構，請首先選擇 架構 在左導航欄上，然後是 建立架構 在「架構」工作區的右上角。 從此處，選擇 瀏覽 查看可用架構類型的完整選擇。

由於要建立段定義（即預定義類），因此請選擇 使用現有類。 現在，選擇 段定義 類，後跟 分配類。

既然您的架構已建立，則需要指定包含段ID的欄位。 此欄位應標籤為主標識並分配給您以前建立的命名空間。

標籤 _id 欄位作為主標識，選擇架構的標題，然後按標有的切換 配置檔案。 選擇 啟用 為 Real-time Customer Profile。

現在，此架構已為配置檔案啟用，並且主標識已分配給您建立的非人員標識命名空間。 因此，這意味著使用此架構導入到平台中的段元資料將被導入到配置檔案中，而不會與其他與人員相關的配置檔案資料合併。

為架構建立資料集

配置架構後，您需要為段元資料建立資料集。

要建立資料集，請按照 資料集使用手冊。 您應該 從架構建立資料集 選項，使用先前建立的架構。

建立資料集後，繼續按照 資料集使用手冊 為即時客戶配置檔案啟用此資料集。

設定和導入受眾資料

啟用資料集後，現在可以通過UI或使用Experience PlatformAPI將資料發送到平台。 您可以通過批處理連接或流式處理連接接收此資料。

使用批處理連接接收資料

要建立批處理連接，可以按照通用 本地檔案上載UI指南。 有關可用源的完整清單，請閱讀 源概述。

使用流連接接收資料

要建立流連接，可以按照 API教程 或 UI教程。

建立流連接後，您將有權訪問唯一的流終結點，您可以將資料發送到該終結點。 要瞭解如何向這些端點發送資料，請閱讀 流記錄資料教程。

受眾元資料結構

建立連接後，您現在可以將資料接收到平台。

以下是外部受眾負載元資料的示例：

{
    "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"
        }
    }
}

使用導入的受眾構建段

一旦建立了導入的受眾，就可以將其用作分割過程的一部分。 要查找外部受眾，請轉到段生成器，然後選擇 觀眾 的 欄位 的子菜單。

後續步驟

現在，您可以在段中使用外部訪問群體，可以使用段生成器建立段。 要瞭解如何建立段，請閱讀 建立段的教程。

附錄

除了使用導入的外部訪問群體元資料並使用它們建立段外，還可以將外部段成員資格導入平台。

設定外部段成員身份目標架構

要開始合成架構，請首先選擇 架構 在左導航欄上，然後是 建立架構 在「架構」工作區的右上角。 從此處，選擇 XDM個人配置檔案。

既然已建立了架構，則需要將段成員身份欄位組添加為架構的一部分。 要執行此操作，請選擇 段成員身份詳細資訊，後跟 添加欄位組。

此外，確保將架構標籤為 配置檔案。 要執行此操作，您需要將欄位標籤為主標識。

設定資料集

建立架構後，需要建立資料集。

要建立資料集，請按照 資料集使用手冊。 您應該 從架構建立資料集 選項，使用先前建立的架構。

建立資料集後，繼續按照 資料集使用手冊 為即時客戶配置檔案啟用此資料集。

設定和導入外部受眾成員身份資料

啟用資料集後，現在可以通過UI或使用Experience PlatformAPI將資料發送到平台。 您可以通過批處理連接或流式處理連接接收此資料。

使用批處理連接接收資料

要建立批處理連接，可以按照通用 本地檔案上載UI指南。 有關可用源的完整清單，請閱讀 源概述。

使用流連接接收資料

要建立流連接，可以按照 API教程 或 UI教程。

建立流連接後，您將有權訪問唯一的流終結點，您可以將資料發送到該終結點。 要瞭解如何向這些端點發送資料，請閱讀 流記錄資料教程。

段成員結構

建立連接後，您現在可以將資料接收到平台。

以下是外部受眾成員有效負載的示例：

{
    "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"
                    }
                }
            }
        }
    }
}