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

在此頁面上：​實作SDK、事件串流、自訂動作端點以及連線應用程式至Adobe Journey Optimizer的API，讓您的歷程可以在即時資料上執行。

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

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

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

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

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

先決條件 prerequisites

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

了解技術基礎 technical-foundation

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

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

設定 Adobe Experience Platform Mobile SDK

行動SDK是您直接內嵌在iOS或Android應用程式中的程式庫集合。 它可作為應用程式與Adobe Experience Platform之間的通訊層：可識別使用者、收集行為事件，並從Journey Optimizer提供指示，包括推播通知、應用程式內訊息和個人化內容。 若沒有它，Journey Optimizer就無法得知您的應用程式使用者在做什麼，也無法聯絡上他們。

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

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

程式碼型體驗可讓您向原生行動應用程式中的任何表面提供個人化內容（從入門畫面和產品詳細資料頁面，到應用程式內橫幅和功能標幟），而不需要新的應用程式版本。 使用Mobile SDK在執行階段擷取及呈現個人化內容，讓您的團隊可完全掌控版位和簡報：

實作網頁體驗 web-implementation

設定 Adobe Experience Platform Web SDK

Web SDK (alloy.js)是單一JavaScript資料庫，可取代您網站可能需要的個別Adobe標籤的修補程式。 它會收集行為資料、透過您設定的資料流將其串流至Adobe Experience Platform，並接收回傳的個人化指示 — 所有這些都在一個網路往返中。 設定完成後，Journey Optimizer就可以識別訪客、從他們的動作觸發歷程，並立即將自訂內容提供給您的頁面。

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

不同於行銷人員完全控制版面的視覺管道，程式碼型體驗可讓您完全掌控個人化內容在頁面上的呈現方式。 Journey Optimizer會傳回包含個人化資料的JSON裝載；您的程式碼會決定要在哪裡以及如何顯示。 此模型適用於任何網路介面（英雄橫幅、建議輪播、搜尋結果排名、A/B測試變體），而無需視覺化編輯器或頁面發佈工作流程。

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

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

實作事件串流 event-streaming

傳送事件以觸發歷程

歷程在事件上執行 — 使用者登入、將專案新增至購物車、完成購買、放棄表單。 您的工作是在正確的時間從應用程式發出這些事件。 每個事件都是傳送至Experience Platform串流擷取API的XDM結構化JSON裝載；Journey Optimizer會在毫秒內擷取該事件，並將設定檔路由至任何相符歷程。 事件結構描述和裝載結構是由您的資料工程師所定義 — 在您開始編碼之前先與其協調。

透過 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

當歷程達到自訂動作步驟時，Journey Optimizer會對您提供的URL （您的後端、CRM、忠誠度平台、任何REST端點）發出傳出HTTP呼叫。 您的工作是建置並公開該端點：定義請求合約（裝載形狀、驗證方法、回應格式）、實作其背後的商業邏輯，並確保其可處理Journey Optimizer將產生的呼叫量。 您的管理員接著會在Journey Optimizer中註冊端點，讓行銷人員可以將其用作其歷程中的步驟。

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

使用 Journey Optimizer API apis

並非所有事情都需要透過Journey Optimizer UI進行。 有時您需要從自己的後端觸發行銷活動、在隱私權請求後隱藏電子郵件地址，或從外部CMS同步內容範本。 Journey Optimizer的REST API可讓您以程式設計方式存取平台的核心功能。 所有呼叫都使用OAuth伺服器對伺服器驗證，舊版的JWT方法已過時。

測試和偵錯 testing

在實作上線之前，您需要確保事件在適當的時刻引發、歷程如預期般觸發、自訂動作在真實負載下運作，以及個人化內容正確呈現。 本節說明用於及早發現問題的工具和技術，從低階SDK記錄，到使用真實設定檔的端對端歷程測試執行。

進階開發人員主題 advanced-topics

一旦您的核心SDK、事件和API準備就緒，這些主題可協助您更進一步：在執行階段豐富歷程資料而不會膨脹設定檔、處理同意訊號以便選擇退出會傳播到每個整合，以及調整您的實作，以符合生產規模需求的輸送量和可靠性。

使用內容資料及擴充

歷程通常需要比觸發事件中提供的更多資料，例如產品名稱、忠誠度等級、訂單條列專案清單。 內容擴充功能可讓您的歷程在執行階段從AEP資料集查詢資料，或從自訂動作回應將其結轉，而非將所有這些預先載入每個設定檔。 然後，您的訊息和分支條件可以參考該資料，而不會將其永久儲存在設定檔上。

使用同意與治理

Journey Optimizer會在平台層級執行資料控管和同意原則，但您的整合也需要遵守這些原則。 當客戶選擇退出行銷通訊，或資料使用標籤限制欄位的使用方式時，這些規則需要在您的自訂動作和資料集查詢中傳播，而不僅僅是封鎖UI中的動作。

最佳化和最佳做法

生產Journey Optimizer實施會定期處理每秒數百萬個事件和數千個歷程執行。 這些資源可協助您針對該規模調整整合 — 在達到速率限制之前先瞭解限制、避免常見的歷程設計陷阱而無訊息地捨棄設定檔，以及建置可正常降低而不是不透明地失敗的錯誤處理。

呼叫Journey Optimizer REST API rest-apis

除了實作SDK和事件串流，您也可以以程式設計方式從您自己的系統中推動Journey Optimizer。 完整的API參考、OpenAPI規格和程式碼範例位於Journey Optimizer開發人員入口網站。

執行API觸發的行銷活動 api-triggered

使用互動式訊息執行REST API，觸發來自外部系統的交易或行銷訊息。 呼叫端點之前：

API參考 · 程式碼範例 · 使用API觸發的行銷活動

外部端點的上限和節流 capping-throttling

當歷程透過自訂動作或資料來源呼叫外部系統時，上限和節流API可保護這些系統避免過載。 上限會拒絕超過設定限制的呼叫；節流會將它們排入最多6小時的佇列（僅限生產沙箱、自訂動作）。

上限API參考 · 使用上限API · 使用節流API

更多REST API more-rest-apis

除了傳訊和上限，Journey Optimizer還會公開REST端點，用於隱藏管理、內容範本、行銷活動擷取、校訂和精心安排的行銷活動執行。 當您需要自動化操作時，請使用這些選項，否則UI中需要手動步驟，例如，拉取資料後大量隱藏位址，或從外部內容管道同步範本。

其他資源 additional-resources

跨角色共同作業 next-steps

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

開始實作

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

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

其他角色指南 other-role-guides

返回角色和責任總覽 ·返回開始