Show Menu
主題×

DULE Policy Service API開發人員指南

資料使用標籤與實施(DULE)是Adobe Experience Platform資料治理的核心機制。 DULE策略服務提供REST風格的API,允許您建立和管理資料使用策略,以確定可以針對已標籤有特定資料使用標籤的資料執行哪些行銷操作。
本檔案提供如何執行「原則服務API」中可用之關鍵作業的指示。 如果您尚未這麼做,請先檢閱資料管理概觀 資料治理概觀 ,以熟悉DULE架構。 有關建立和實施DULE策略的逐步說明,請參見 DULE策略教程
本檔案提供您在嘗試呼叫Policy Service API之前,需要瞭解的核心概念的簡介。

DULE策略服務快速入門

在開始使用原則服務之前,Experience Platform上的資料必須套用適當的DULE標籤。 有關將資料使用標籤應用於資料集和欄位的完整逐步說明,請參見 DULE標籤使用手冊

必要條件

本指南需要有效瞭解Adobe Experience Platform的下列元件:
  • 資料治理 :Experience Platform強制執行資料使用合規性的架構。
    • DULE標籤 :資料使用標籤會套用至「體驗資料模型」(XDM)資料欄位,指定資料存取限制。
  • 體驗資料模型(XDM)系統 :Experience Platform組織客戶體驗資料的標準化架構。
  • 即時客戶個人檔案 :根據來自多個來源的匯整資料,提供統一、即時的消費者個人檔案。
  • 沙盒 :Experience Platform提供虛擬沙盒,可將單一Platform實例分割為不同的虛擬環境,以協助開發和發展數位體驗應用程式。

讀取範例API呼叫

本指南提供範例API呼叫,以示範如何格式化您的請求。 這些包括路徑、必要標題和正確格式化的請求負載。 也提供API回應中傳回的範例JSON。 如需範例API呼叫檔案中所用慣例的詳細資訊,請參閱「Experience Platform疑難排解指 南」中有關如何讀取範例API呼叫的章節

收集必要標題的值

若要呼叫平台API,您必須先完成驗證教 學課程 。 完成驗證教學課程後,所有Experience Platform API呼叫中每個必要標題的值都會顯示在下方:
  • 授權:生產者 {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}
Experience Platform中的所有資源(包括屬於「資料治理」的資源)都會隔離至特定的虛擬沙盒。 所有對平台API的請求都需要一個標題,該標題會指定要在中執行的操作的沙盒名稱:
  • x-sandbox-name: {SANDBOX_NAME}
如需平台中沙盒的詳細資訊,請參閱沙盒 概觀檔案
所有包含裝載(POST、PUT、PATCH)的請求都需要額外的標題:
  • 內容類型:application/json

核心與自訂資源

在「原則服務API」中,所有原則和行銷動作皆稱為 core 或資 custom 源。
core 源由Adobe定義和維護,而資源則由個別 custom 客戶建立和維護,因此,資源是獨一無二且僅對建立資源的IMS組織可見。 因此,清單和查閱作業( GET )是唯一允許對資源執行的作業 core ,而清單、查閱和更新作業( POST PUT``PATCH DELETE )則適用於資源 custom

策略狀態

資料使用原則可能有三種狀態: DRAFT ENABLED DISABLED
預設情況下,只有「ENABLED」策略參與策略評估。
「DRAFT」策略也可以在策略評估中考慮,但只能通過設定查詢參數來考慮 ?includeDraft=true 。 有關策略評估的更多資訊,請參閱本文檔 末尾的 「策略執行」一節。

行銷動作名稱

行銷動作名稱是行銷動作的唯一識別碼。 每個 core 行銷動作都有一個唯一名稱,可套用至所有IMS組織。 這些名稱由Adobe定義和維護。 同時,所有客戶定義的行銷動作( custom 資源)在您個別組織中都是獨一無二的,不會顯示或與其他IMS組織共用。
在「原則服務API」中使用行銷動作的步驟,在本文稍後的「行 銷動作 」一節中有說明。

後續步驟

既然您已具備先決知識和認證,您就可以繼續閱讀本開發人員指南中提供的範例API呼叫: