文件Journey OptimizerJourney Optimizer 指南

使用 Adobe Experience Platform 資料 aep-data

Last update: Wed Oct 01 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 中繼
  • 開發人員

Journey Optimizer可讓您透過個人化、決策和Journey Orchestration功能，善用Adobe Experience Platform資料中的資料。 若要這麼做，必須先為查詢服務啟用查詢個人化所需的記錄型資料集，如下所述。

必讀

護欄和指導方針 guidelines

開始之前，請檢閱下列限制和准則：

  • 資料集中沒有PII — 啟用查詢的資料集不應包含任何個人識別資訊(PII)。

  • ​

    • 刪除風險 — 未保護個人化中使用的資料集免於刪除。 您必須追蹤哪些資料集正在使用，以確保未將其移除。

  • 結構描述型別 — 資料集必須與設定檔或事件型別的​ NOT ​結構描述相關聯。

  • 保持查詢切換開啟 — 避免重複開啟和關閉資料集。 這樣做可能會導致意外的索引行為。 最佳實務是啟用資料集，直到您打算使用它進行查詢為止。

  • 批次資料刪除 — 從資料集移除批次資料，會從查詢服務中完全移除所有相符的索引鍵。 例如：

    批次1： Sku1、Sku2、Sku3
    批次2： Sku1、Sku2、Sku3、Sku4、Sku5、Sku6
    批次3： Sku7、Sku8、Sku9、Sku10

    如果您刪除​ 批次1，Sku1、Sku2和Sku3會從查詢存放區中移除。 然後產生的查詢資料將包含：Sku4、Sku5、Sku6、Sku7、Sku8、Sku9、Sku10。

查閱服務的權益

功能元件
限制
附註
啟用查閱資料集
每個組織最多10個
可於指定時間設定查閱的資料集數目上限。 此限制適用於客戶執行個體內生產及開發沙箱中的查閱資料集總合併數量。
資料集記錄計數
每個資料集最多200萬筆記錄
單一資料集中允許的最大記錄數，以該資料集中所有批次的總數來計算。
記錄大小
每筆記錄最多2 KB
支援預設最大記錄大小。
資料集大小
最大4 GB
個別資料集的大小上限，而不是沙箱中所有資料集的大小組合。 記錄計數和資料集大小限制是獨立的護欄 — 兩者都必須符合。
資料集頻率更新
每個資料集每天最多5次更新
單一資料集每天允許的最大更新作業頻率。
NOTE
如果除了上述的護欄以外，還需要其他卷冊，請聯絡您的Adobe代表。

啟用資料集以進行資料查詢 enable

為了將資料集中的資料用於個人化，您需要啟用資料集以進行查詢。

先決條件 prerequisites-enable

與您要啟用查詢的資料集關聯的結構描述必須是記錄型別。 結構描述不應屬於設定檔或事件類別。

範例

結構描述必須定義主要身分。

範例

如果尚未定義自訂名稱空間，請確保身分識別碼不是人員。

範例

在資料集管理介面中啟用資料集以進行查詢

在資料集管理使用者介面中，使用切換開關來啟用資料集以供查閱。

NOTE
我們建議不要為設定檔啟用此資料集，因為這會導致設定檔豐富度增加，而且不需要執行查詢。

API方法

依照本檔案中詳述的指示，設定您的環境以傳送API命令。

先決條件

  • 開發人員專案必須將Adobe Journey Optimizer和Adobe Experience Platform API新增至其專案。

  • 您角色中必須有管理資料集許可權。

  • 資料集所根據的結構描述必須包含可作為查詢金鑰的主要身分。

API呼叫結構

curl -s -XPATCH "https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION}" \ -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}"

其中：

  • URL為https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION}
  • 資料集ID是您要啟用的資料集。
  • 動作為啟用或停用。
  • 存取權杖可從開發人員控制檯中擷取。
  • API金鑰可從開發人員主控台擷取。
  • IMS組織ID是您的Adobe組織。
  • 「沙箱名稱」是資料集所在的沙箱名稱（即生產、開發等）。
NOTE
如果您在嘗試使用API呼叫啟用資料集時遇到以下錯誤，請嘗試從開發人員控制檯專案中移除Adobe Journey Optimizer API，然後重新新增它們：
"error_code": "403003",
"message": "Api Key is invalid"

資料集監控

資料集啟用查閱後，您可以前往​ 監視 ​功能表並選取​ Journey Optimizer ​索引標籤，來檢閱擷取至查閱服務的狀態。

此程式指標有助於瞭解查閱服務中何時可使用新的資料批次。

後續步驟

使用API呼叫啟用資料集進行查閱後，您就可以將該資料與Journey Optimizer個人化和決策功能搭配使用。 如需詳細資訊，請參閱以下區段：

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76