使用 Adobe Customer Journey Analytics API 的第一步

本指南涵蓋 Adobe Customer Journey Analytics (CJA) API，詳細介紹了數據擷取、自訂解決方案和第三方整合。其中包含存取設定、API 金鑰、使用 Postman 進行測試、逐步 API 呼叫範例，以及針對初次使用者的提示。

您是 API 新手嗎？想知道 Adobe Customer Journey Analytics (CJA) API 能如何幫助您嗎？不要害怕！在這個對初學者友善的指南中，我們將引導您瞭解基本知識、解釋術語，並協助您邁出令人興奮的第一步，進入 CJA API 世界。

想像一下，您不需要手動操作，就能以程式方式存取和分析 CJA 數據。這正是 CJA API 可以讓您做到的！

高效擷取數據：利用 API 呼叫簡化數據擷取。
建置自訂解決方案：設計並實作符合特定業務需求的自動化報告管道。
無縫連線：透過強大的整合，使 CJA 與第三方應用程式之間的數據流順暢流通。

將 API 視為信使——它們將您的請求傳送到 Adobe 伺服器，並將結果整齊地封裝帶回來。

設定以取得成功

在執行初次 API 呼叫之前，您需要設定適當的存取權和權限。首先，確保您已新增為組織的開發人員。然後，確認您有可以存取產品設定檔的必要權限。

步驟 1：取得您的 API 金鑰

登入 Adobe Developer Console。
建立新專案 並將 Customer Journey Analytics API 新增至您的專案，然後選擇所需的產品設定檔。
按一下 新增至專案 並，將 Adobe Experience Platform API 也新增至專案。
完成設定後，您就可以在左側的憑證標籤下取得所有所需的資訊。

以下是所有 API 請求所需的三個基本標頭參數

存取權杖——這可確保只有授權的使用者才能存取數據，而且可以按一下螢幕擷圖中反白顯示的 產生存取權杖 CTA 來產生。這在 AP 請求中稱為授權參數
用戶端 ID——也稱為 API 金鑰，在 API 請求中稱為 x-api-key
組織 ID——這在 API 請求中稱為 x-gw-ims-org-id

請務必儲存這些憑證——它們是您開啟 API 功能的金鑰！更詳細的逐步指示包含在 CJA API 的快速入門部分。

步驟 2：測試您的設定

使用功能強大且使用者友好的工具 Postman 是無需撰寫任何程式碼即可測試 API 的絕佳方式。啟動應用程式後，您可以輕鬆匯入 API 憑證，並開始實驗簡單的 GET 請求，以驗證您的連線和驗證是否正常運作。建議您透過 GET 請求開始 API 測試歷程，這些請求被視為更安全且非破壞性，因為它們只會從伺服器擷取數據，不會進行任何修改。這與 POST、PUT 或 DELETE 請求等其他 HTTP 方法相反，這些方法可能會變更或移除伺服器上的數據，因此在測試時應更謹慎。

進行您的初次 API 呼叫

讓我們做些簡單的事：擷取您 CJA 帳戶中可用的數據視圖清單。

範例：數據視圖清單

端點：
GET https://cja.adobe.io/data/dataviews

標頭：

x-api-key: {API_KEY}

x-gw-ims-org-id: {IMS_ORG_ID}

Authorization: Bearer {AUTHORIZATION_TOKEN}

CURL 請求：

curl -X GET "https://cja.adobe.io/data/dataviewsexpansion=name%2Cowner%2Corganization%2Cdescription"\

-H "x-api-key: {API_KEY}" \

-H "x-gw-ims-org-id: {IMS_ORG_ID}" \

-H "Authorization: Bearer {AUTHORIZATION_TOKEN}"

您還可以使用試用功能，在 CJA API 端點文件內嘗試這些請求。以下是嘗試上述請求的連結。