快速入門
概觀 overview
本頁說明如何驗證並開始使用Adobe Experience Platform Destination SDK。 其中包括如何取得Adobe I/O驗證認證、沙箱名稱和目的地編寫存取控制許可權的指示。
術語 terminology
本指南使用平台專屬的概念,例如組織和沙箱。 請參閱Experience Platform字彙表,瞭解這些字詞的定義。 請參閱Destination SDK字彙表,以取得與此功能直接相關的辭彙。
取得必要的驗證認證 obtain-authentication-credentials
Destination SDK使用Adobe I/O閘道進行驗證。 若要對Destination SDK端點進行API呼叫,您必須在API呼叫中提供某些標題。 與Adobe Exchange團隊合作,為您設定Adobe Developer Console的驗證。
若要成功呼叫Destination SDK API端點,請依照Experience Platform驗證教學課程操作。 從產生API金鑰、組織ID和使用者端密碼步驟開始教學課程。 Adobe Exchange團隊將為您處理先前的步驟。 完成驗證教學課程,提供Destination SDK API呼叫中每個必要標題的值,如下所示:
x-api-key: {API_KEY}
,也稱為使用者端識別碼x-gw-ims-org-id: {ORG_ID}
,也稱為組織識別碼Authorization: Bearer {ACCESS_TOKEN}
。存取權杖的到期時間為24小時(以毫秒為單位),因此您必須重新整理。 若要重新整理存取Token,請重複驗證教學課程中概述的步驟。
目的地擁有權和沙箱 destination-ownership
Experience Platform中的所有資源都會隔離至特定的虛擬沙箱。 請求Destination SDK需要標頭,指定執行操作的沙箱名稱:
x-sandbox-name: {SANDBOX_NAME}
Adobe Exchange團隊會提供您沙箱名稱,您必須在呼叫Destination SDKAPI端點時使用它。
角色型存取控制(RBAC) rbac
若要使用參考檔案中說明的Destination SDKAPI端點,您需要 目的地製作 存取控制許可權。 與Adobe Exchange團隊合作,在Adobe Admin Console中將此許可權指派給您。
如需詳細資訊,請閱讀下列Experience Platform存取控制檔案:
其他考量事項 additional-considerations
- 對於產品化/公用目的地,無論您對目的地設定所做的任何變更(建立或編輯目的地設定)都需要Adobe稽核和核准。 您的變更只有在檢閱完成後才會反映在您的目的地。 這不適用於只有您才能使用的私人目的地。
- 只有屬於相同組織且具有沙箱存取許可權的使用者才能編輯目的地設定。
後續步驟 next-steps
依照本文的步驟操作,您已取得Adobe I/O的驗證認證、沙箱名稱和目的地編寫存取控制許可權。 接下來,您可以使用Destination SDK來設定目的地。
-
根據您的目的地型別,閱讀下列設定指南:
-
如需所有作業,請參閱Destination Authoring API檔案。
-
使用Destination Authoring API Postman集合,使用Destination SDKAPI端點設定您的目的地。 若要開始使用Postman,請參閱匯入環境和集合的步驟以及建立Postman環境的影片指南。