Privacy Service疑難排解指南

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

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

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

為了在API中建立新的隱私權工作,請求的JSON裝載必須包含users陣列,此陣列會列出隱私權請求適用的每個使用者的特定資訊。 users陣列中的每個專案都是物件,代表特定使用者,由其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 /)端點提出要求。 如需詳細資訊,請參閱Privacy Service API指南中檢查工作狀態一節。

使用UI

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

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

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

使用 API

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

如需詳細資訊,請參閱Privacy Service API指南中依其ID查詢工作的區段。

使用UI

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

常見錯誤訊息 common-error-messages

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

錯誤訊息
說明
找不到使用者 ID。
找不到請求中提供的部分使用者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