Privacy Service 疑難排解指南

Adobe Experience Platform Privacy Service 提供RESTful API和使用者介面,協助公司管理客戶資料隱私權請求。 替換為 Privacy Service,您可以提交存取和刪除私人或個人客戶資料的請求,協助促進自動遵守組織和法律隱私權法規。

本檔案提供常見問題的解答,關於 Privacy Service,以及API中經常發生錯誤的相關資訊。

在API中提出隱私權要求時,使用者與使用者ID有何不同? user-ids

為了在API中建立新的隱私權工作,請求的JSON裝載必須包含 users 陣列,列出隱私權請求適用的每個使用者的特定資訊。 中的每一個專案 users array是代表特定使用者的物件,由其 key 值。

反過來,每個使用者物件(或 key)包含自身的 userIDs 陣列。 此陣列會列出特定ID值 針對該特定使用者.

考量下列範例 users 陣列:

"users": [
  {
    "key": "DavidSmith",
    "action": ["access"],
    "userIDs": [
      {
        "namespace": "email",
        "value": "dsmith@acme.com",
        "type": "standard"
      }
    ]
  },
  {
    "key": "user12345",
    "action": ["access", "delete"],
    "userIDs": [
      {
        "namespace": "email",
        "value": "ajones@acme.com",
        "type": "standard"
      },
      {
        "namespace": "ECID",
        "type": "standard",
        "value":  "443636576799758681021090721276",
        "isDeletedClientSide": false
      }
    ]
  }
]

陣列包含兩個物件,代表各自識別的使用者 key 值(「DavidSmith」和「user12345」)。 「DavidSmith」只有一個列出的ID (電子郵件地址),而「user12345」只有兩個(電子郵件地址和ECID)。

如需有關提供使用者身分資訊的詳細資訊,請參閱以下指南: 隱私權請求的身分資料.

我可以使用 Privacy Service 以清理不小心傳送到的資料 Platform?

Adobe不支援使用 Privacy Service 用於清除意外提交給產品的資料。 Privacy Service 是專為協助您履行資料主體(或消費者)存取或刪除請求的義務而設計。 不支援或允許將Privacy Service用於資料清理或維護的任何其他用途。

隱私權請求常有時效性,而且是根據適用的隱私權法律完成。 提交非資料主體/消費者存取或刪除請求的請求會影響所有 Privacy Service 客戶及以下功能 Privacy Service 以支援適當的法律時間表。 現已設定每日硬性上傳限制,以協助防止濫用服務。

請聯絡您的Adobe客戶團隊,以協調並提供移除任何PII或資料問題的所需時間。

如何取得隱私權請求或工作狀態的資訊?

您可以使用擷取特定工作的詳細資訊 Privacy Service API或使用者介面。

使用 API

若要使用擷取特定工作的狀態 Privacy Service API,向根提出請求(GET /)端點,使用請求路徑中作業的ID。 如需詳細資訊,請參閱以下章節: 檢查工作的狀態 在 Privacy Service API指南。

使用UI

所有作用中的工作請求都會列在 工作請求 上的Widget Privacy Service UI儀表板。 每個工作請求的狀態都會顯示在 狀態 欄。 如需在UI中檢視工作請求的詳細資訊,請參閱 Privacy Service使用手冊.

如何下載已完成的隱私權工作結果?

此 Privacy Service API和使用者介面都提供以ZIP格式下載已完成作業結果的方法。

使用 API

向根提出請求(GET /)端點 Privacy Service API,使用您要在請求路徑中下載其結果的工作的ID。 如果工作的狀態為完成,則API將包含 downloadURL 回應本文中的屬性。 此屬性包含一個URL,您可以將其貼到瀏覽器的位址列來下載ZIP檔案。

如需詳細資訊,請參閱以下章節: 依ID查詢工作 在 Privacy Service API指南。

使用UI

在 Privacy Service UI控制面板,尋找您要從下載的工作 工作請求 Widget. 選取工作的ID以開啟「工作詳細資訊」頁面。 從這裡,選擇 下載 右上角下載ZIP檔案。 請參閱 Privacy Service使用手冊 以取得更詳細的步驟。

常見錯誤訊息 common-error-messages

下表概述中一些常見的錯誤 Privacy Service,並提供說明以解決各自的問題。

錯誤訊息
說明
找不到使用者識別碼。
找不到請求中提供的部分使用者ID,已將其略過。 確保您在請求裝載中使用正確的名稱空間和ID值。 檢視檔案: 提供身分資料 以取得更詳細的說明。
無效的名稱空間
為使用者ID提供的身分名稱空間無效。 請參閱以下小節: 標準身分名稱空間 在 Privacy Service API指南附錄,以取得接受的名稱空間清單。 如果您使用自訂名稱空間,請務必設定ID的 type 屬性重新命名為「custom」。
部分完成
工作已成功完成,但部分資料不適用於特定請求,已略過。
資料不是要求的格式。
指定應用程式的一個或多個資料值格式不正確。 如需詳細資訊,請檢視工作詳細資料。
尚未布建該IMS組織。
當您的組織尚未布建時,就會出現此訊息 Privacy Service. 如需詳細資訊,請聯絡管理員。
需要存取權和許可權。
需要有存取權和許可權才能使用 Privacy Service. 請聯絡您的管理員以取得存取權。
上傳和封存存取資料時發生問題。
發生此錯誤時,請重新上傳存取資料,然後再試一次。
工作負載超過目前的檔案速率限制。
發生此錯誤時,請降低提交率並重試。
太多請求
(HTTP 429錯誤)
如果您的提交模式超過監控的允許資料主體作業限制,您將會收到HTTP 429錯誤,回應來自貴組織的持續流量。 Privacy Service用於處理資料主體隱私權請求。 它不用於資料清理。 如果您收到HTTP 429錯誤,系統會實作節流和請求限制,以保護Adobe免受濫用,避免合法合規工作面臨風險。
以下提供將資料最小化的替代方法: 設定資料集到期排程 並使用 記錄刪除功能. 如需如何套用這些功能的詳細資訊,請參閱其各自的檔案。
recommendation-more-help
9cbf7061-a312-49f7-aaf8-a10885d53580