文件Journey OptimizerJourney Optimizer 指南

開發人員快速入門 get-started-developers

Last update: Tue Jan 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 經驗豐富
  • 開發人員

身為​開發人員，您負責實作 Adobe Journey Optimizer 並將其整合至您的應用程式與系統。一旦系統管理員及資料工程師授予您存取權限並準備好您的環境，您就可以開始使用 Adobe Journey Optimizer。

您在 Journey Optimizer 生態系統中的角色

其他團隊成員透過使用者介面設定 Journey Optimizer 時，您將專注於：

  • 在行動應用程式和網頁應用程式中​實作 SDK
  • 從您的應用程式​ 傳送事件 ​以觸發歷程
  • 建立 API 端點，Journey Optimizer 可透過自訂動作呼叫此端點
  • 整合 Journey Optimizer 與您現有的系統和基礎結構
  • 測試和偵錯​您的實作

您的資料工程師將處理資料結構描述、事件設定和資料來源。您的管理員將設定權限和管道設定。行銷人員將設計使用您實作的歷程和內容。

本指南涵蓋基本技術實作步驟，以協助您快速入門 Journey Optimizer。無論您是建立行動應用程式、網頁體驗還是 API 整合，請遵循以下區段來設定您的實作。

先決條件 prerequisites

在開始實作之前，請確定您擁有：

類別
需求
技術技能
* 使用 JavaScript (適用於 Web SDK) 或 Swift/Kotlin (適用於 Mobile SDK) 的經驗
* 了解 RESTful API 和 JSON
* 熟悉非同步程式設計和事件導向架構
* 了解貴組織的應用程式架構
存取權與工具
* Adobe Developer Console 的存取權，以取得 API 認證
* 開發環境，以及應用程式程式碼庫的存取權
* 測試工具，例如 Postman 以進行 API 測試
* 瀏覽器開發人員工具或行動偵錯工具
來自其他團隊成員
您的管理員
授予的環境存取權 來自資料工程師
的 XDM 結構描述和事件定義* 來自行銷人員的需求和使用案例

了解技術基礎 technical-foundation

開始實作前，請先熟悉核心技術概念：

  1. Adobe Experience Platform 整合：Journey Optimizer 原生建立在 Adobe Experience Platform 上。了解基礎架構將幫助您建立更有效的實作。深入了解 Journey Optimizer 的運作方式。

  2. XDM 資料模型：Journey Optimizer 使用體驗資料模型 (XDM) 來建構事件和輪廓資料。身為開發人員，您必須了解如何傳送符合資料工程師所設定之結構描述的資料。了解 XDM 結構描述。

  3. 驗證和安全性：所有實作都需要正確的驗證。了解如何設定 SDK 和 API 的驗證。了解 API 驗證。

設定行動應用程式整合 mobile-integration

設定 Adobe Experience Platform Mobile SDK

若要啟用推播通知、應用程式內訊息和其他行動功能，請將 Adobe Experience Platform Mobile SDK 整合至您的行動應用程式。

  1. 安裝及設定 Mobile SDK：請依照 Adobe Experience Platform Mobile SDK 文件操作，開始進行 SDK 整合。

  2. 建立行動屬性：在 Adobe Experience Platform Data Collection 中設定行動屬性。了解如何建立和設定行動屬性。

  3. 設定推播通知：

    • 針對 iOS 應用程式：向 APN (Apple 推播通知服務) 註冊您的應用程式。若要了解更多資訊，請參閱 Apple 文件。
    • 針對 Android 應用程式：為您的 Android 應用程式設定 Firebase 雲端訊息。若要了解更多資訊，請參閱 Google 文件。

  4. 測試您的行動整合：使用行動快速入門工作流程來快速設定並測試您的行動設定。

設定推播通知的詳細步驟可在此頁面上取得。

實作程式碼型體驗 (Mobile SDK)

針對使用程式碼體驗的原生行動應用程式個人化：

實作網頁體驗 web-implementation

設定 Adobe Experience Platform Web SDK

針對網頁型實作，Web SDK 是您的主要整合點：

  1. 安裝 Web SDK：請依照 Web SDK 實作指南操作，在您的網站上設定 SDK。

  2. 設定資料流：啟用 Journey Optimizer 後，在 Adobe Experience Platform Data Collection 中建立並設定資料串流。在資料流文件中了解更多相關資訊。

  3. 啟用網頁推播通知 (選用)：在您的 Web SDK 設定中設定 pushNotifications 屬性，並使用 sendPushSubscription 命令來註冊推播訂閱。

實作程式碼型體驗 (Web SDK)

程式碼型體驗可讓您個人化任何數位接觸點：

  1. 選擇您的實作方法：用戶端、伺服器端或混合式。檢閱每個方法的實作範例。

  2. 定義表面：識別您要在應用程式中傳遞個人化內容的位置。了解表面設定。

  3. 實作內容轉譯：使用 Web SDK 擷取並套用個人化內容。請參閱程式碼型實作教學課程。

  4. 傳送顯示和互動事件：追蹤內容顯示的時間以及使用者與內容互動以進行分析和最佳化的時間。

探索 GitHub 上的範例實作，了解程式碼型體驗的實際運作情況。

深入了解程式碼型體驗快速入門。

實作事件串流 event-streaming

傳送事件以觸發歷程

身為開發人員，您將實作程式碼以傳送觸發歷程的事件。您的資料工程師將在 Journey Optimizer 中設定事件結構描述和定義。

  1. 了解事件承載：請與您的資料工程師合作，取得事件結構描述和必要的承載結構。承載必須符合其所設定的 XDM 結構描述。了解事件結構描述需求。

  2. 實作事件串流：使用串流擷取 API 將事件傳送至 Adobe Experience Platform。了解傳送事件的步驟。

  3. 處理事件類型：

    • 單一事件：針對個人特定動作實作事件傳送 (例如，按鈕點按、購買完成)
    • 業務事件：傳送業務相關事件 (例如，庫存更新、價格變更)

  4. 測試事件傳送：確認事件已正確接收，並如預期觸發歷程。了解事件疑難排解。

透過 API 傳送事件的​實作範例：

POST https://{DATACOLLECTION_ENDPOINT}/collection/{DATASTREAM_ID}
Content-Type: application/json

{
  "header": {
    "datasetId": "{DATASET_ID}",
    "imsOrgId": "{ORG_ID}",
    "source": {
      "name": "Web SDK"
    }
  },
  "body": {
    "xdmMeta": {
      "schemaRef": {
        "id": "{SCHEMA_ID}"
      }
    },
    "xdmEntity": {
      "_id": "unique-event-id",
      "eventType": "purchase",
      "timestamp": "2024-01-01T12:00:00Z",
      // ... your event data
    }
  }
}

深入了解如何使用歷程事件。

開發自訂動作端點 custom-actions

自訂動作可讓歷程呼叫您的 API。身為開發人員，您將建立自訂動作叫用的 API 端點：

  1. 建立您的 API 端點：建立 Journey Optimizer 將在歷程執行期間呼叫的 RESTful API 端點。您的端點應：

    • 接受 JSON 承載
    • 驗證請求 (OAuth、API 金鑰或 JWT)
    • 在適當的逾時限制內處理請求
    • 以預期格式傳回回應

  2. 了解自訂動作功能：自訂動作可以連線至第三方系統，例如 Epsilon、Slack、Firebase 或您自己的服務。深入了解自訂動作。

  3. 使用動作設定：您的管理員或資料工程師將在 Journey Optimizer 中設定自訂動作，定義 API 端點 URL、驗證方法和參數。您將為他們提供您的 API 規格。了解自訂動作設定。

  4. 傳回可操作資料：設計您的 API 以傳回可用於後續歷程步驟的資料。了解動作回應。

  5. 實作速率限制：確保您的端點可以處理預期的流量。Journey Optimizer 套用每秒 5000 次呼叫的限制，但您的系統應可復原。了解上限與節流。

範例使用案例：使用自訂動作將歷程事件寫入 Experience Platform。

使用 Journey Optimizer API apis

Journey Optimizer 提供完整的 REST API 以便進行程式化存取：

  1. 了解 API 功能：Journey Optimizer API 可讓您以程式設計方式建立、讀取、更新和刪除各種資源。深入了解 Journey Optimizer API。

  2. 驗證：請依照本教學課程中的指示，使用 Adobe Developer Console 設定 API 驗證。

  3. 探索 API 參考：瀏覽完整的 API 文件，並直接在 Adobe Journey Optimizer API 參考中試用 API。

  4. API 觸發的行銷活動：使用 API 觸發的行銷活動建立交易型訊息。若是高流量案例 (最多5000 TPS)，請探索高輸送量模式 (需要附加授權)。

  5. 決策管理 API：使用專門的 API 進行產品建議管理和決策。若要了解更多資訊，請參閱決策管理 API 指南。

測試和偵錯 testing

  1. 偵錯 SDK 實作：使用 Adobe Experience Platform Assurance 即時檢查 SDK 事件、驗證資料收集，以及疑難排解整合問題。深入了解 Assurance。

  2. 測試事件傳送：確認 Adobe Experience Platform 已正確接收來自您應用程式的事件，並如預期觸發歷程。監視事件擷取並驗證承載結構。

  3. 驗證 API 整合：測試您的自訂動作端點，以確保它們可正確處理 Journey Optimizer 請求、在逾時限制內回應，以及傳回預期的資料格式。

  4. 搭配測試輪廓使用測試模式：與您的資料工程師合作，存取測試輪廓，然後使用歷程測試模式驗證您的實作。了解如何測試歷程。

  5. 監視 SDK 記錄：在您的 SDK 實作中啟用偵錯記錄，以疑難排解開發期間的問題：

    • Mobile SDK：啟用記錄以檢視 SDK 事件和 API 呼叫
    • Web SDK：使用瀏覽器控制台監視 SDK 活動

  6. 驗證資料流設定：確定您的資料流已正確設定為傳送資料至 Journey Optimizer。檢查事件是否流經資料流到達正確的目的地。

  7. 查詢歷程資料以進行分析：使用資料湖上的 SQL 查詢來分析歷程步驟事件、偵錯問題，以及監視自訂動作績效。探索歷程分析的查詢範例，包括：

    • 輪廓進入/退出追蹤與捨棄原因
    • 自訂動作績效量度 (延遲、輸送量、錯誤)
    • 事件傳送和錯誤模式
    • 歷程執行個體狀態

進階開發人員主題 advanced-topics

使用內容資料及擴充

  • 反覆處理陣列：使用 Handlebars 語法在訊息中顯示來自事件、自訂動作回應和資料集查詢的動態清單。了解如何反覆處理內容資料。
  • 資料集查詢：實作資料集查詢，以擴充 Adobe Experience Platform 資料集的歷程資料。與您的資料工程師共同處理設定。了解資料集查詢。

使用同意與治理

在您的整合中實作資料治理和同意原則：

  • 資料治理：將資料使用原則套用至自訂動作。深入了解資料治理。
  • 同意管理：在您的實作中處理客戶同意偏好設定。了解同意。

最佳化和最佳做法

其他資源 additional-resources

跨角色共同作業 next-steps

您的實作工作與其他團隊成員的工作有交集：

與資料工程師合作

與資料工程師共同處理資料與事件設定：

  • 取得實作所需的 XDM 結構描述和事件結構

  • 了解您需要傳送哪些事件及其必要的承載格式

  • 就資料收集需求和資料品質標準達成一致

  • 同時測試事件傳送和資料擷取

與管理員合作

與管理員共同處理存取權和設定：

  • 提供要設定之自訂動作的 API 規格

  • 請求必要的權限和 API 認證

  • 協調管道設定需求 (例如推播憑證)

  • 就測試環境和沙箱策略達成一致

與行銷人員合作

與行銷人員共同處理歷程需求和測試：

  • 了解哪些使用者互動應該觸發事件

  • 實作內容績效和使用者參與的追蹤

  • 支援使用您實作的功能測試歷程

  • 對訊息傳送或個人化問題進行疑難排解

開始實作

準備好開始建立了嗎？從以上區段選擇您的第一個實作區域：

  1. 行動應用程式？​開始進行 Mobile SDK 整合
  2. 網站？​開始設定 Web SDK
  3. API 整合？​跳轉至使用 API
  4. 自訂系統？​查看自訂動作

每個區段都包含詳細技術文件、程式碼範例和教學課程的連結，以指導您的實作。

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