開發人員快速入門 get-started-developers
您身為開發人員，有責任實作並整合Adobe Journey Optimizer至您的應用程式與系統。 一旦Adobe Journey Optimizer系統管理員和資料工程師授予您存取許可權並準備好您的環境，您就可以開始使用。
您在Journey Optimizer生態系統中的角色
其他團隊成員透過使用者介面設定Journey Optimizer時，您將專注於：
- 在行動應用程式和網頁應用程式中實作SDK
- 從您的應用程式 傳送事件 以觸發歷程
- 建置API端點，Journey Optimizer可透過自訂動作呼叫此端點
- 整合 Journey Optimizer與您現有的系統和基礎結構
- 測試和偵錯您的實作
您的資料工程師將處理資料結構描述、事件設定和資料來源。 您的管理員將設定許可權和通道設定。 行銷人員將設計使用您實作的歷程和內容。
本指南涵蓋開始使用Journey Optimizer的基本技術實作步驟。 無論您是建置行動應用程式、網頁體驗或API整合，請遵循以下區段來設定您的實施。
先決條件 prerequisites
在開始實作之前，請確定您已：
*瞭解RESTful API和JSON
*熟悉非同步程式設計和事件導向架構
*瞭解貴組織的應用程式架構
瞭解技術基礎 technical-foundation
開始實作前，請先熟悉核心技術概念：
-
Adobe Experience Platform整合： Journey Optimizer原本是建置在Adobe Experience Platform上。 瞭解基礎架構將幫助您建置更有效的實作。 深入瞭解Journey Optimizer的運作方式。
-
XDM資料模型： Journey Optimizer使用Experience Data Model (XDM)來建構事件和設定檔資料。 作為開發人員，您必須瞭解如何傳送符合資料工程師所設定之結構描述的資料。 瞭解XDM結構描述。
-
驗證和安全性：所有實作都需要正確的驗證。 瞭解如何設定SDK和API的驗證。 瞭解API驗證。
設定行動應用程式整合 mobile-integration
設定Adobe Experience Platform Mobile SDK
若要啟用推播通知、應用程式內訊息和其他行動功能，請將Adobe Experience Platform Mobile SDK整合至您的行動應用程式。
-
安裝及設定Mobile SDK：請依照Adobe Experience Platform Mobile SDK檔案操作，開始使用SDK整合。
-
建立行動屬性：在Adobe Experience Platform Data Collection中設定行動屬性。 瞭解如何建立和設定行動屬性。
-
設定推播通知：
-
測試您的行動整合：使用行動入門快速入門工作流程來快速設定並測試您的行動設定。
設定推播通知的詳細步驟可在此頁面上取得。
實作程式碼型體驗(行動SDK)
針對使用程式碼體驗的原生行動應用程式個人化：
實作Web體驗 web-implementation
設定Adobe Experience Platform Web SDK
針對網頁型實作，Web SDK是您的主要整合點：
-
安裝Web SDK：請依照Web SDK實作指南操作，在您的網站上設定SDK。
-
設定資料串流：啟用Journey Optimizer後，在Adobe Experience Platform Data Collection中建立並設定資料串流。 在資料串流檔案中進一步瞭解。
-
啟用Web推播通知 （選用）：在您的Web SDK設定中設定pushNotifications屬性，並使用sendPushSubscription命令來註冊推播訂閱。
實作程式碼型體驗(網頁SDK)
程式碼型體驗可讓您個人化任何數位接觸點：
-
選擇您的實作方法：使用者端、伺服器端或混合式。 檢閱每個方法的實作範例。
-
定義介面：識別您要在應用程式中傳遞個人化內容的位置。 瞭解表面組態。
-
實作內容呈現：使用網頁SDK擷取並套用個人化內容。 請參閱程式碼型實作教學課程。
-
傳送顯示和互動事件：追蹤內容顯示的時間以及使用者與內容互動以進行分析和最佳化的時間。
探索GitHub 上的範例實作，瞭解程式碼型體驗的實際運作情況。
深入瞭解程式碼式體驗快速入門。
實作事件串流 event-streaming
傳送事件以觸發歷程
作為開發人員，您將實作程式碼以傳送觸發歷程的事件。 您的資料工程師將在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
自訂動作可讓歷程呼叫您的API。 作為開發人員，您將建置自訂動作呼叫的API端點：
-
建置您的API端點：建立Journey Optimizer將在歷程執行期間呼叫的RESTful API端點。 您的端點應：
- 接受JSON裝載
- 驗證請求（OAuth、API金鑰或JWT）
- 在適當的逾時限制內處理請求
- 以預期格式傳回回應
-
瞭解自訂動作功能：自訂動作可以連線至協力廠商系統，例如Epsilon、Slack、Firebase或您自己的服務。 深入了解自訂動作。
-
使用動作設定：您的管理員或資料工程師將在Journey Optimizer中設定自訂動作，定義API端點URL、驗證方法和引數。 您會提供他們您的API規格。 瞭解自訂動作組態。
-
傳回可操作的資料：設計您的API以傳回可用於後續歷程步驟的資料。 瞭解動作回應。
-
實作速率限制：請確定您的端點可以處理預期的磁碟區。 Journey Optimizer套用5000次呼叫/秒的限制，但您的系統應可復原。 瞭解上限與節流。
範例使用案例： 使用自訂動作將歷程事件寫入Experience Platform。
使用 Journey Optimizer API 運作 apis
Journey Optimizer提供完整的REST API以便程式設計方式存取：
-
瞭解API功能： Journey Optimizer API可讓您以程式設計方式建立、讀取、更新和刪除各種資源。 瞭解Journey Optimizer API。
-
驗證：請依照本教學課程中的指示，使用Adobe Developer Console設定API驗證。
-
探索API參考：瀏覽完整的API檔案，並直接在Adobe Journey Optimizer API參考中試用API。
-
API觸發的行銷活動：使用API觸發的行銷活動建立交易式訊息。 若是大量情況（最多5000 TPS），請探索高輸送量模式 （需要附加授權）。
-
決定管理API：使用專門的API進行優惠方案管理和決定。 進一步瞭解決定管理API指南。
測試和除錯 testing
-
偵錯SDK實作：使用Adobe Experience Platform Assurance即時檢查SDK事件、驗證資料收集，以及疑難排解整合問題。 進一步瞭解Assurance。
-
測試事件傳送：確認Adobe Experience Platform已正確接收來自您應用程式的事件，並如預期觸發歷程。 監視事件擷取並驗證裝載結構。
-
驗證API整合：測試您的自訂動作端點，以確保它們可正確處理Journey Optimizer要求、在逾時限制內回應，以及傳回預期的資料格式。
-
搭配測試設定檔使用測試模式：與您的資料工程師合作，以存取測試設定檔，然後使用歷程測試模式驗證您的實作。 瞭解如何測試歷程。
-
監視SDK記錄：在您的SDK實作中啟用偵錯記錄，以解決開發期間的問題：
- 行動SDK：啟用記錄以檢視SDK事件和API呼叫
- 網頁SDK：使用瀏覽器主控台監視SDK活動
-
驗證資料流設定：確定您的資料流已正確設定為傳送資料至Journey Optimizer。 檢查事件是否流經資料流到達正確的目的地。
-
查詢歷程資料以進行分析：使用資料湖上的SQL查詢來分析歷程步驟事件、偵錯問題，以及監視自訂動作效能。 探索歷程分析的查詢範例，包括：
- 設定檔登入/退出追蹤與捨棄原因
- 自訂動作效能測量結果（延遲、輸送量、錯誤）
- 事件傳遞和錯誤模式
- 歷程執行個體狀態
進階開發人員主題 advanced-topics
使用內容資料及擴充
使用同意與控管
在您的整合中實作資料控管和同意原則：
最佳化和最佳實務
其他資源 additional-resources
- Developer Console：存取Adobe Developer Console以建立整合併管理API認證。
- 範常式式碼：探索GitHub上的範例實作。
- 教學課程影片：透過Experience League的實作教學課程學習。
- 開發人員社群：與其他開發人員交流，並在Adobe社群論壇中取得支援。
跨角色共同作業 next-steps
您的實作工作與其他團隊成員相交：
開始實作
準備好開始建立了嗎？ 從以上區段選擇您的第一個實作區域：
每個區段都包含詳細技術檔案、程式碼範例和教學課程的連結，以指導您的實施。