Destinations 是預先構建的與目標平台的整合,允許無縫激活來自Adobe Experience Platform的資料。 您可以使用目標來激活跨渠道市場營銷活動、電子郵件活動、目標廣告和許多其他使用案例的已知和未知資料。
在激活資料之前,您需要先設定目標帳戶以連接到目標。 本教程介紹使用 Flow Service API。
當前僅在流服務API中支援刪除目標帳戶。 無法使用Experience PlatformUI刪除目標帳戶。
本教程要求您具有有效的連接ID。 連接ID表示到目標的帳戶連接。 如果您沒有有效的連接ID,請從 目標目錄 並按照 連接到目標 在嘗試本教程之前。
本教程還要求您對以下Adobe Experience Platform元件有一定的瞭解:
以下各節提供了您需要瞭解的其他資訊,以便使用 Flow Service API。
本教程提供了示例API調用,以演示如何格式化請求。 這些包括路徑、必需的標頭和正確格式化的請求負載。 還提供了API響應中返回的示例JSON。 有關示例API調用文檔中使用的約定的資訊,請參見上的 如何讀取示例API調用 的 Experience Platform 疑難解答指南。
為了呼叫 Platform API,必須首先完成 驗證教程。 完成身份驗證教程將提供所有中每個必需標頭的值 Experience Platform API調用,如下所示:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
中的所有資源 Experience Platform包括那些 Flow Service,與特定虛擬沙箱隔離。 所有請求 Platform API需要一個標頭,該標頭指定操作將在以下位置進行的沙盒的名稱:
x-sandbox-name: {SANDBOX_NAME}
如果 x-sandbox-name
未指定標頭,請求在 prod
沙盒。
所有包含負載(POST、PUT、PATCH)的請求都需要附加的媒體類型報頭:
Content-Type: application/json
刪除目標帳戶的第一步是找出與要刪除的目標帳戶對應的連接ID。
在Experience PlatformUI中,瀏覽到 目標 > 帳戶 並通過選擇 目標 的雙曲餘切值。
接下來,您可以從瀏覽器中的URL檢索目標帳戶的連接ID。
在刪除目標帳戶之前,必須刪除目標帳戶的任何現有資料流。
要刪除現有資料流,請參閱以下頁:
一旦您擁有連接ID並確保目標帳戶不存在任何資料流,請向 Flow Service API。
API格式
DELETE /connections/{CONNECTION_ID}
參數 | 說明 |
---|---|
{CONNECTION_ID} |
獨特 id 要刪除的連接的值。 |
要求
curl -X DELETE \
'https://platform.adobe.io/data/foundation/flowservice/connections/c8622ec7-7d94-44a5-a35a-ffcc6bdcc384' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
回應
成功的響應返回HTTP狀態204(無內容)和空白正文。 您可以通過嘗試查找(GET)連接請求來確認刪除。 API將返回HTTP 404(未找到)錯誤,表示目標帳戶已被刪除。
本教程中的API端點遵循一般Experience PlatformAPI錯誤消息原則。 請參閱 API狀態代碼 和 請求標頭錯誤 中。
按照本教程,您已成功使用 Flow Service 用於刪除現有目標帳戶的API。 有關使用目標的詳細資訊,請參閱 目標概述。