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 配列が含まれます。 この配列は、その1 人のユーザーのために​特定の 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
      }
    ]
  }
]

この配列には 2 つのオブジェクトが含まれ、それぞれの key 値（「DavidSmith」と「user12345」）で識別される個々のユーザーを表します。 「DavidSmith」には 1 つの ID（電子メールアドレス）しかありませんが、「user12345」には 2 つ（電子メールアドレスと ECID）があります。

ユーザID情報の提供について詳しくは、プライバシーリクエストの ID データに関するガイドを参照してください。

Experience Platform に誤って送信されたデータを、Privacy Service でクリーンアップすることはできますか？

アドビは、誤って製品に送信されたデータのクリーンアップに対する Privacy Service の使用をサポートしていません。 Privacy Service は、お客様が、データ主体（または消費者）のアクセスや削除のリクエストに対する義務を果たすのを支援するよう設計されています。 それ以外にデータのクリーンアップやメンテナンスに Privacy Service を使用することは、サポートされておらず、許可もされていません。

プライバシーリクエストは時間に依存し、該当するプライバシー法に従って行われます。 データ主体／消費者からのアクセスリクエストや削除リクエスト以外のリクエストの送信は、Privacy Service のすべてのユーザーや、Privacy Service が適切な法的日程をサポートできるかどうかに影響します。 サービスの不正使用を防ぐために、1 日あたりのアップロードに対するハードリミットが設定されるようになりました。

PII やデータの問題を解消するための一定のレベルの取り組みを調整および実現するには、担当のアドビアカウントチームにお問い合わせください。

プライバシーリクエストやジョブのステータスに関する情報を取得するにはどうすればよいですか？

Privacy Service API またはユーザーインターフェイスを使用して、特定のジョブに関する詳細を取得できます。

API の使用

Privacy Service API を使用して特定のジョブのステータスを取得するには、リクエストパスでジョブの ID を使用して、ルート（GET /）エンドポイントにリクエストを送信します。 詳しくは、『Privacy Service API ガイド』で、ジョブのステータスの確認に関するセクションを参照してください。

UI の使用

アクティブなすべてのジョブリクエストは、Privacy Service UI ダッシュボードの​ジョブリクエスト ウィジェットに一覧表示されます。 各ジョブリクエストのステータスは、ステータス​列の下に表示されます。 UI でのジョブリクエストの表示について詳しくは、Privacy Service のユーザーガイドを参照してください。

完了したプライバシージョブの結果をダウンロードする方法を教えてください。

Privacy Service API とユーザーインターフェイスの両方で、完了したジョブの結果を ZIP 形式でダウンロードする方法が用意されています。

API の使用

リクエストパスで結果をダウンロードするジョブの ID を使用して、Privacy Service API のルート（GET /）エンドポイントにリクエストを送信します。 ジョブのステータスが完了した場合、API は応答本文に downloadURL 属性を含めます。 この属性には、ブラウザーのアドレスバーに貼り付けて ZIP ファイルをダウンロードできる URL が含まれます。

詳しくは、『Privacy Service API ガイド』で、ID によるジョブの検索に関するセクションを参照してください。

UI の使用

Privacy Service の UI ダッシュボードで、ジョブリクエスト​ウィジェットからダウンロードするジョブを探します。 ジョブの ID を選択して、ジョブの詳細ページを開きます。 右上隅の「ダウンロード」を選択して、ZIP ファイルをダウンロードします。 詳細な手順については、『Privacy Service ユーザーガイド』を参照してください。

一般的なエラーメッセージ common-error-messages

次の表に、Privacy Service でよくあるエラーと、それぞれの問題の解決に役立つ説明をまとめています。