Show Menu
主題×

準備要用於 Intelligent Services

為了從行 Intelligent Services 銷事件資料中發掘見解,資料必須語義豐富並維護在標準結構中。 Intelligent Services 運 Experience Data Model 用(XDM)架構來達成此目的。 具體來說,所有使用的資料集 Intelligent Services 都必須符合 Consumer ExperienceEvent(CEE) XDM架構。
本檔案提供將行銷事件資料從多個管道對應至此架構的一般指引,概述有關架構中重要欄位的資訊,以協助您判斷如何有效地將資料對應至其架構。

工作流程摘要

準備程式會視您的資料儲存在Adobe Experience Platform或外部而定。 本節概述了在兩種情況下需要採取的必要步驟。

外部資料準備

如果您的資料儲存在外部, Experience Platform請遵循下列步驟:
  1. 請連絡Adobe諮詢服務以要求專屬Azure Blob儲存容器的存取憑證。
  2. 使用您的存取憑證,將資料上傳至Blob容器。
  3. 使用Adobe諮詢服務可將您的資料對應至 Consumer ExperienceEvent架構 ,並內嵌至 Intelligent Services。

Experience Platform 資料準備

如果您的資料已儲存在中 Platform,請遵循下列步驟:
  1. 檢閱Consumer ExperienceEvent架構的 結構 ,並判斷您的資料是否可對應至其欄位。
  2. 請連絡Adobe諮詢服務,協助您將資料對應至架構並將其內嵌 Intelligent Services,或 如果您要自行對應資料,請遵循本指南中的步驟

瞭解CEE架構

消費者體驗事件結構描述個人的行為,因為它與數位行銷事件(網路或行動裝置)以及線上或離線商務活動有關。 由於此模式在語義上定義 Intelligent Services 良好的欄位(列),因此需要使用此模式,以避免任何未知名稱,否則會使資料不那麼清晰。
CEE架構與所有XDM ExperienceEvent架構一樣,會在發生事件(或事件集)時擷取系統的時間序列狀態,包括時間點和相關主體的身分。 「體驗事件」是所發生事件的事實記錄,因此它們是不可變的,代表所發生的事件,而無需匯總或解讀。
Intelligent Services 利用此架構中的幾個關鍵欄位,從行銷事件資料產生深入資訊,所有這些資料都可在根層級找到並展開,以顯示其必要的子欄位。
與所有XDM模式一樣,CEE混合模式具有可擴充性。 換言之,CEE混音中可新增其他欄位,若有需要,可在多個結構中加入不同的變數。
在公共XDM儲存庫中可找到混 合的完整示例 。 此外,您還可以檢視並複製下列 JSON檔案 ,以取得如何結構化資料以符合CEE結構的範例。 在瞭解以下章節中概述的關鍵欄位時,請參閱這兩個範例,以決定如何將您自己的資料對應至架構。

關鍵字欄位

CEE混合內有幾個關鍵欄位,為了產生有用的見解,應 Intelligent Services 該使用這些欄位。 本節說明這些欄位的使用案例和預期資料,並提供參考檔案的連結,以取得更多範例。

必填欄位

雖然強烈建議使用所有關鍵欄位,但有兩個欄位是必 ,才 Intelligent Services 能運作:

主要身分

架構中的其中一個欄位必須設為主要識別欄位,這可 Intelligent Services 讓每個時間系列資料例項連結至個人。
您必鬚根據資料的來源和性質,決定最佳欄位作為主要身分識別。 身分欄位必須包含 識別名稱空間 ,以指出欄位預期的身分資料類型為值。 某些有效的命名空間值包括:
  • "電子郵件"
  • "phone"
  • "mcid"(適用於Adobe Audience Manager ID)
  • 「aid」(適用於Adobe Analytics ID)
如果您不確定應將哪個欄位當做主要身分識別,請聯絡Adobe諮詢服務以決定最佳解決方案。

xdm:timestamp

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

xdm:channel

只有在使用Attribution AI時,此欄位才是必填欄位。
此欄位代表與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 參閱體驗 管道架構規範 。 有關某些映射示例,請參見 下表
頻道映射範例
下表提供映射至架構的行銷渠道的一些范 xdm:channel 例:
Channel
@type
mediaType
mediaAction
付費搜尋
https:/ /ns.adobe.com/xdm/channel-types/search
付款
點擊
社交——行銷
https:/ /ns.adobe.com/xdm/channel-types/social
點擊
顯示
https:/ /ns.adobe.com/xdm/channel-types/display
付款
點擊
電子郵件
https:/ /ns.adobe.com/xdm/channel-types/email
付款
點擊
內部反向連結
https:/ /ns.adobe.com/xdm/channel-types/direct
擁有
點擊
顯示檢視
https:/ /ns.adobe.com/xdm/channel-types/display
付款
印象
QR Code重新導向
https:/ /ns.adobe.com/xdm/channel-types/direct
擁有
點擊
行動
https:/ /ns.adobe.com/xdm/channel-types/mobile
擁有
點擊

建議欄位

本節將概述其餘的關鍵欄位。 雖然這些欄位不一定需要 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:商務

此欄位包含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 Web詳細資訊結構規格

xdm:行銷

此欄位包含與觸點作用中之行銷活動相關的資訊。
範例架構
{
  "xdm:trackingCode": "marketingcampaign111",
  "xdm:campaignGroup": "50%_DISCOUNT",
  "xdm:campaignName": "50%_DISCOUNT_USA"
}

有關每個必填子欄位的完整資訊,請 xdm:productListItems 參閱行銷 說明

對應和收錄資料

一旦您決定行銷事件資料是否可映射至CEE結構,下一步就是決定要放入哪些資料 Intelligent Services。 所有使用的歷 Intelligent Services 史資料都必須落在資料四個月的最短時段內,加上預期做為回顧時段的天數。
在決定您要傳送的資料範圍後,請聯絡Adobe諮詢服務,協助將資料對應至架構,並將其內嵌至服務。
如果您有訂閱, Adobe Experience Platform 而且想要親自對應及收錄資料,請依照下節所述的步驟進行。

使用Adobe Experience Platform

下列步驟需要訂閱Experience Platform。 如果您沒有平台存取權,請跳至下 一步
本節概述將資料對應並收錄至Experience Platform以供使用的工作流程,包 Intelligent Services括教學課程的連結,以取得詳細步驟。

建立CEE架構和資料集

當您準備開始準備擷取資料時,第一個步驟是建立採用CEE mixin的新XDM架構。 下列教學課程將逐步說明在UI或API中建立新架構的程式:
上述教學課程會遵循建立架構的一般工作流程。 為架構選擇類時,必須使用 XDM ExperienceEvent類 。 選擇此類後,可以將CEE混合添加到模式。
將CEE混音新增至架構後,您就可以視資料中其他欄位的需要新增其他混音。
建立並儲存架構後,您就可以根據該架構建立新的資料集。 下列教學課程將逐步說明在UI或API中建立新資料集的程式:
建立資料集後,您可以在「資料集」工作區的「平台UI」中找 到它

新增主要身分命名空間標籤至資料集

未來的版 Intelligent Services 本將整 合Adobe Experience Platform Identity Service ,使其客戶識別功能。 因此,下列步驟可能會有所變更。
如果您要從、或其他外 Adobe Audience Manager部來源 Adobe Analytics匯入資料,則必須新增標 primaryIdentityNameSpace 記至資料集。 這可以通過向目錄服務API發出PATCH請求來完成。
如果您從本機CSV檔案擷取資料,可跳至下一節的對應與 擷取資料
在遵循下列範例API呼叫之前,請參閱目錄開 發人員指南中的 「快速入門」一節,以取得有關必要標題的重要資訊。
API格式
PATCH /dataSets/{DATASET_ID}

參數
說明
{DATASET_ID}
您先前建立之資料集的ID。
請求
您必須在請求裝載中提供適當的值和標 primaryIdentityNamespace 記值, sourceConnectorId 視您要從哪個來源擷取資料。
下列請求會為Audience Manager新增適當的標籤值:
curl -X PATCH \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "tags": {
          "primaryIdentityNameSpace": ["mcid"],
          "sourceConnectorId": ["audiencemanager"],
        }
      }'

下列請求會為Analytics新增適當的標籤值:
curl -X PATCH \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "tags": {
          "primaryIdentityNameSpace": ["aaid"],
          "sourceConnectorId": ["analytics"],
        }
      }'

如需在Platform中使用身分名稱空間的詳細資訊,請參閱身分名稱 空間概觀
回應
成功的回應會傳回包含已更新資料集ID的陣列。 此ID應與PATCH請求中發送的ID匹配。
[
    "@/dataSets/5ba9452f7de80400007fc52a"
]

映射和收錄資料

建立CEE架構和資料集後,您可以開始將資料表對應至架構,並將該資料內嵌至平台。 請參閱將CSV檔 案對應至XDM架構的教學課程 ,以取得如何在UI中執行此動作的步驟。 您可以使用下列 範例JSON檔案 ,在使用您自己的資料之前,先測試擷取程式。
在填入資料集後,可使用相同的資料集來擷取其他資料檔案。
如果您的資料儲存在支援的協力廠商應用程式中,您也可以選擇建立來源連 接器 ,以即時將行銷事件 Platform 資料收入。

下一步

本檔案提供有關準備資料以供使用的一般指引 Intelligent Services。 如果您需要根據使用案例提供其他諮詢服務,請聯絡Adobe諮詢支援。
在您成功將客戶體驗資料填入資料集後,您就可用來產 Intelligent Services 生見解。 請參閱下列檔案以開始使用: