準備資料以用於Intelligent Services

為了讓Intelligent Services從行銷事件資料中探索見解，必須以標準結構在語義上擴充和維護資料。 Intelligent Services運用Experience Data Model (XDM)結構描述來達成此目標。 具體來說，Intelligent Services中使用的所有資料集都必須符合消費者ExperienceEvent (CEE) XDM結構描述或使用Adobe Analytics聯結器。 此外，Customer AI支援Adobe Audience Manager聯結器。

本檔案提供從多個管道對應行銷事件資料至CEE結構描述的一般指引，概述結構描述內重要欄位的資訊，協助您決定如何有效地將資料對應至其結構。 如果您打算使用Adobe Analytics資料，請檢視Adobe Analytics資料準備的區段。 如果您打算使用Adobe Audience Manager資料（僅限Customer AI），請檢視AdobeAudience Manger資料準備的區段。

資料需求

根據您建立的目標，Intelligent Services需要不同的歷史資料量。 無論如何，您為​ 所有 Intelligent Services準備的資料都必須包含正面和負面客戶歷程/事件。 同時具有負值和正值事件可改善模型精確度和精確度。

例如，如果您使用Customer AI來預測購買產品的傾向，Customer AI模型需要成功購買路徑的範例和不成功路徑的範例。 這是因為在模型訓練期間，Customer AI會尋找導致購買的事件和歷程。 這也包括未購買的客戶所執行的動作，例如個人停止其將專案新增至購物車的歷程。 這些客戶可能會表現出類似的行為，但Customer AI可提供深入分析並深入研究導致高傾向分數的主要差異和因素。 同樣地，Attribution AI需要事件和歷程這兩種型別，才能顯示量度，例如接觸點有效性、排名在前的轉換路徑，以及依接觸點位置的劃分。

如需歷史資料需求的更多範例和資訊，請造訪輸入/輸出檔案中的Customer AI或Attribution AI歷史資料需求區段。

彙整資料的准則

建議您儘可能將使用者的事件拼接在通用ID中。 例如，您可能有跨10個事件具有「id1」的使用者資料。 稍後，同一位使用者刪除了Cookie ID，並在接下來的20個事件中記錄為「id2」。 如果您知道id1和id2對應至相同的使用者，最佳做法是將所有30個事件與通用id拼接在一起。

如果無法這麼做，在建立模型輸入資料時，您應該將每組事件視為不同的使用者。 這可確保在模型訓練和評分期間獲得最佳結果。

工作流程摘要

準備程式會因您的資料是儲存在Adobe Experience Platform中還是儲存在外部而有所不同。 本節總結了您在任一情況下所需執行的必要步驟。

外部資料準備

如果您的資料儲存在Experience Platform之外，則需要將資料對應到消費者ExperienceEvent結構描述中的必要和相關欄位。 此結構描述可使用自訂欄位群組來增強，以便更妥善地擷取您的客戶資料。 對應後，您可以使用消費者ExperienceEvent結構描述建立資料集，並將資料內嵌至Platform。 接著在設定Intelligent Service時可以選取CEE資料集。

視您要使用的Intelligent Service而定，可能需要不同的欄位。 請注意，如果您有可用的資料，最佳實務是將資料新增到欄位。 若要深入瞭解必要欄位，請造訪Attribution AI或Customer AI資料需求指南。

Adobe Analytics資料準備 analytics-data

Customer AI和Attribution AI原生支援Adobe Analytics資料。 若要使用Adobe Analytics資料，請依照檔案中概述的步驟，設定Analytics來源聯結器。

一旦來源聯結器將您的資料串流到Experience Platform中，您就可以在執行個體設定期間選取Adobe Analytics作為資料來源，然後選取資料集。 在連線設定期間會自動建立所有必要的結構描述欄位群組和個別欄位。 您不需要將資料集ETL （擷取、轉換、載入）為CEE格式。

如果您將透過Adobe Analytics來源聯結器傳入Adobe Experience Platform的資料與Adobe Analytics資料進行比較，您可能會注意到一些差異。 Analytics Source聯結器可能會在轉換成Experience Data Model (XDM)結構描述期間捨棄多列。 整列不適用於轉換的原因可能有多種，包括遺漏時間戳記、遺漏人員ID、無效或大筆人員ID、無效分析值等等。

如需詳細資訊和範例，請瀏覽比較Adobe Analytics和Customer Journey Analytics資料的檔案。 本文章旨在協助您診斷並解決這些差異，以便於您和您的團隊可以將Adobe Experience Platform資料用於智慧型服務，不會受到資料完整性疑慮所阻礙。

在Adobe Experience Platform查詢服務中，依channel.typeAtSource查詢執行下列介於開始和結束時間戳記之間的記錄總數，以依行銷管道尋找計數。

       Count(_id) AS Records
FROM  df_hotel
WHERE timestamp>=from_utc_timestamp('2021-05-15','UTC')
        AND timestamp<from_utc_timestamp('2022-01-10','UTC')
        AND timestamp IS NOT NULL
        AND enduserids._experience.aaid.id IS NOT NULL
GROUP BY channel.typeAtSource

Adobe Audience Manager資料準備（僅限Customer AI） AAM-data

Customer AI原生支援Adobe Audience Manager資料。 若要使用Audience Manager資料，請依照檔案中概述的步驟，設定Audience Manager來源聯結器。

一旦來源聯結器將您的資料串流到Experience Platform中，您就可以在Customer AI設定期間選取Adobe Audience Manager作為資料來源，然後選取資料集。 在連線設定期間會自動建立所有結構描述欄位群組和個別欄位。 您不需要將資料集ETL （擷取、轉換、載入）為CEE格式。

Experience Platform資料準備

如果您的資料已儲存在Platform中，且未透過Adobe Analytics或Adobe Audience Manager （僅限Customer AI）來源聯結器串流，請遵循下列步驟。 您仍建議您瞭解CEE結構。

瞭解CEE結構 cee-schema

消費者ExperienceEvent結構描述個人與數位行銷事件（網頁或行動裝置）以及線上或離線商務活動相關的行為。 Intelligent Services需要使用此結構描述，因為其語意定義良好的欄位（欄），避免任何未知名稱，否則會讓資料變得不那麼清晰。

CEE結構描述，像所有XDM ExperienceEvent結構描述一樣，會在事件（或事件集）發生時擷取系統以時間序列為基礎的狀態，包括時間點和所涉及主體的身分。 體驗事件是所發生情況的事實記錄，因此是不可變的，並代表在沒有彙總或詮釋的情況下所發生的情況。

Intelligent Services會利用此結構描述中的數個關鍵欄位，從行銷事件資料產生深入分析，所有這些可在根層級找到，並展開以顯示其必要的子欄位。

和所有XDM結構描述一樣，CEE結構描述欄位群組是可擴充的。 換言之，其他欄位可新增至CEE欄位群組，而不同的變數可視需要包含在多個結構描述中。

在公用XDM存放庫中可以找到欄位群組的完整範例。 此外，您可以檢視及複製下列JSON檔案，以取得如何建構資料以符合CEE結構描述的範例。 如需瞭解下節中概述的關鍵欄位，請參閱這兩個範例，以決定如何將您的資料對應到結構描述。

關鍵欄位

CEE欄位群組內有數個關鍵欄位，應該使用以便Intelligent Services產生有用的深入分析。 本節說明這些欄位的使用案例和預期資料，並提供參考檔案的連結以取得更多範例。

必填欄位

雖然強烈建議使用所有索引鍵欄位，但有兩個欄位是​ 必要的，才能讓Intelligent Services運作：

主要身分識別 identity

結構描述中的其中一個欄位必須設定為主要身分欄位，如此可讓Intelligent Services將時間序列資料的每個執行個體連結至個別人員。

您必須根據資料的來源和性質，決定要當作主要身分使用的最佳欄位。 身分欄位必須包含​ 身分名稱空間，以指出欄位預期做為值的身分資料型別。 一些有效的名稱空間值包括：

如果您不確定應使用哪個欄位作為主要身分，請聯絡Adobe Consulting服務以決定最佳解決方案。 如果未設定主要身分，Intelligent Service應用程式會使用以下預設行為：

若要設定主要身分，請從​ 結構描述 ​標籤瀏覽到您的結構描述，然後選取結構描述名稱超連結以開啟​ Schema Editor。

接下來，導覽至您要作為主要身分的欄位，然後選取該欄位。 會開啟該欄位的​ 欄位屬性 ​功能表。

在​ 欄位屬性 ​功能表中，向下捲動直到您找到​ 身分 ​核取方塊為止。 核取此方塊後，會顯示將選取的身分設定為​ 主要身分 ​的選項。 也請選取此方塊。

接下來，您必須從下拉式清單中的預先定義名稱空間清單中提供​ 身分識別名稱空間。 在此範例中，由於正在使用Adobe Audience Manager ID mcid.id，因此已選取ECID名稱空間。 選取[套用]​ ​ ​以確認更新，然後在右上角選取[儲存]​ ​ ​以儲存對結構描述的變更。

xdm：timestamp timestamp

此欄位代表事件發生時的日期時間。 根據ISO 8601標準，此值必須以字串形式提供。

xdm：channel channel

此欄位代表與ExperienceEvent相關的行銷管道。 欄位包含有關頻道型別、媒體型別和位置型別的資訊。

範例結構描述

{
  "@id": "https://ns.adobe.com/xdm/channels/facebook-feed",
  "@type": "https://ns.adobe.com/xdm/channel-types/social",
  "xdm:mediaType": "earned",
  "xdm:mediaAction": "clicks"
}

如需xdm:channel每個必要子欄位的完整資訊，請參閱體驗管道結構描述規格。 如需某些範例對應，請參閱下方🔗的表格。

管道對應範例 example-channels

下表提供對應至xdm:channel結構描述的行銷管道範例：

建議欄位

本節將概述其餘主要欄位。 雖然Intelligent Services不一定需要這些欄位才能運作，但強烈建議您儘可能多地使用這些欄位，以獲得更豐富的見解。

xdm：productListItems

此欄位是一系列專案，代表客戶選取的產品，包括產品SKU、名稱、價格和數量。

範例結構描述

[
  {
    "xdm:SKU": "1002352692",
    "xdm:name": "24-Watt 8-Light Chrome Integrated LED Bath Light",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 159.45
  },
  {
    "xdm:SKU": "3398033623",
    "xdm:name": "16ft RGB LED Strips",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 79.99
  }
]

如需xdm:productListItems每個必要子欄位的完整資訊，請參閱商務詳細資料結構描述規格。

xdm：commerce

此欄位包含有關ExperienceEvent的商務特定資訊，包括採購單編號和付款資訊。

範例結構描述

{
    "xdm:order": {
      "xdm:purchaseID": "a8g784hjq1mnp3",
      "xdm:purchaseOrderNumber": "123456",
      "xdm:payments": [
        {
          "xdm:transactionID": "transactid-a111",
          "xdm:paymentAmount": 59,
          "xdm:paymentType": "credit_card",
          "xdm:currencyCode": "USD"
        },
        {
          "xdm:transactionId": "transactid-a222",
          "xdm:paymentAmount": 100,
          "xdm:paymentType": "gift_card",
          "xdm:currencyCode": "USD"
        }
      ],
      "xdm:currencyCode": "USD",
      "xdm:priceTotal": 159
    },
    "xdm:purchases": {
      "xdm:value": 1
    }
  }

如需xdm:commerce每個必要子欄位的完整資訊，請參閱商務詳細資料結構描述規格。

xdm：web

此欄位代表與ExperienceEvent相關的網頁詳細資訊，例如互動、頁面詳細資訊和反向連結。

範例結構描述

{
  "xdm:webPageDetails": {
    "xdm:siteSection": "Shopping Cart",
    "xdm:server": "example.com",
    "xdm:name": "Purchase Confirmation",
    "xdm:URL": "https://www.example.com/orderConf",
    "xdm:errorPage": false,
    "xdm:homePage": false,
    "xdm:pageViews": {
      "xdm:value": 1
    }
  },
  "xdm:webReferrer": {
    "xdm:URL": "https://www.example.com/checkout",
    "xdm:referrerType": "internal"
  }
}

如需xdm:productListItems每個必要子欄位的完整資訊，請參閱ExperienceEvent網頁詳細資料結構描述規格。

xdm：marketing

此欄位包含與使用接觸點啟用的行銷活動相關的資訊。

範例結構描述

{
  "xdm:trackingCode": "marketingcampaign111",
  "xdm:campaignGroup": "50%_DISCOUNT",
  "xdm:campaignName": "50%_DISCOUNT_USA"
}

如需xdm:productListItems每個必要子欄位的完整資訊，請參閱行銷密碼規格。

對應及擷取資料 mapping

一旦您決定行銷事件資料是否可對應至CEE結構描述，下一步就是決定要將哪些資料帶入Intelligent Services。 Intelligent Services中使用的所有歷史資料必須在資料的最短四個月時間範圍內，加上預期做為回顧期間的天數。

決定您要傳送的資料範圍後，請聯絡Adobe Consulting服務，協助將您的資料對應到結構描述並將其擷取到服務。

如果您有Adobe Experience Platform訂閱，而且想要自己對應及擷取資料，請遵循下節中概述的步驟。

使用Adobe Experience Platform

本節概述對應及擷取資料至Experience Platform以用於Intelligent Services的工作流程，包括詳細步驟的教學課程連結。

建立CEE結構和資料集

當您準備好要開始準備要擷取的資料時，第一步是建立採用CEE欄位群組的新XDM結構描述。 以下教學課程會逐步說明在UI或API中建立新結構的程式：

將CEE欄位群組新增到結構描述後，您可以視需要在資料內新增其他欄位群組。

建立並儲存結構描述後，您就可以根據該結構描述建立新的資料集。 以下教學課程會逐步說明在UI或API中建立新資料集的程式：

建立資料集後，您可以在​ 資料集 ​工作區的Platform UI中找到它。

將身分欄位新增至資料集

如果您從Adobe Audience Manager、Adobe Analytics或其他外部來源引進資料，則您可選擇將結構描述欄位設為身分欄位。 若要將結構描述欄位設定為身分欄位，請檢視UI教學課程或API教學課程中關於設定身分欄位的章節，以建立結構描述。

如果您要從本機CSV檔案擷取資料，您可以跳到有關對應與擷取資料的下一節。

對應及擷取資料 ingest

建立CEE結構描述和資料集後，您可以開始將資料表格對應至結構描述，並將該資料擷取到Platform。 請參閱有關將CSV檔案對應到XDM結構描述的教學課程，以瞭解如何在UI中執行此動作的步驟。 您可以使用下列範例JSON檔案來測試擷取程式，然後再使用您自己的資料。

填入資料集後，相同的資料集可用於內嵌其他資料檔案。

如果您的資料儲存在支援的協力廠商應用程式中，您也可以選擇建立來源聯結器，即時將您的行銷事件資料擷取到Platform。

後續步驟 next-steps

本檔案提供準備資料以用於Intelligent Services的一般指引。 如果您需要根據使用案例獲得其他諮詢，請聯絡Adobe Consulting支援。

當您成功將客戶體驗資料填入資料集後，您就可以使用Intelligent Services來產生深入分析。 請參閱下列檔案以開始使用：