Show Menu
トピック×

プライバシーサービストラブルシューティングガイド

Adobe Experience Platform Privacy Serviceは、RESTful APIとユーザーインターフェイスを備えており、会社は顧客データのプライバシーリクエストを管理できます。 プライバシーサービスを使用すると、個人または個人の顧客データにアクセスして削除する要求を送信でき、組織や法的プライバシーに関する規制への自動コンプライアンスを容易に行うことができます。
このドキュメントでは、プライバシーサービスに関するよくある質問と、APIでよく発生するエラーに関する情報を提供します。

APIでプライバシーリクエストを行う場合、ユーザーとユーザーIDの違いは何ですか。

APIで新しいプライバシージョブを作成するには、リクエストのJSONペイロードに、プライバシーリクエストが適用される各ユーザーに対して特定のリストを含む users 配列を含める必要があります。 配列内の各項目は、 users 値で識別される特定のユーザーを表すオブジェクトで key す。
次に、各ユーザーオブジェクト(または key )には、それぞれ独自の userIDs 配列が含まれます。 この配列は、その特定 のユーザーに固有のID値をリストします
Consider the following example users array:
"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つのID(電子メールアドレスとECID)があります。
ユーザーID情報の提供について詳しくは、プライバシー要求の IDデータに関するガイドを参照してください

誤ってプラットフォームに送信されたデータをクリーンアップするために、プライバシーサービスを使用できますか。

アドビでは、誤って製品に送信されたデータの消去に関するプライバシーサービスの使用をサポートしていません。 プライバシーサービスは、データの件名(消費者)へのアクセスや削除の要求に対する義務を満たすのに役立つように設計されています。 これらの要求は時間に依存し、適用されるプライバシー法に関するものです。 データの件名/消費者アクセス、または削除の要求以外の要求の送信は、すべてのプライバシーサービスのお客様に影響を与えます。また、プライバシーサービスが適切な法的日程をサポートする機能にも影響します。
PIIやデータの問題を取り除くための作業レベルを、アカウントマネージャ(CDM)に問い合わせて調整し、ご連絡ください。

プライバシーの要請や仕事の状態に関する情報を取得する方法を教えてください。

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

APIの使用

プライバシーサービスAPIを使用して特定のジョブのステータスを取得するには、要求パスにあるジョブのIDを使用して、ルート( GET / )エンドポイントにリクエストを行います。 詳しくは、プライバシーサービス開発者ガイドのジョブのステータス チェックに関する節を参照してください

UIの使用

すべてのアクティブなジョブ要求は、プライバシーサービスのUIダッシュボードの ジョブ要求 Widgetに一覧表示されます。 各ジョブリクエストのステータスが「 ステータス 」列に表示されます。 UIでのジョブ要求の表示について詳しくは、 プライバシーサービスのユーザーガイドを参照してください

完了したプライバシージョブの結果をダウンロードするにはどうしますか?

プライバシーサービスAPIとユーザーインターフェイスは共に、完了したジョブの結果をZIP形式でダウンロードする方法を提供します。

APIの使用

結果を要求パスにダウンロードするジョブのIDを使用して、プライバシーサービスAPIのルート( GET / )エンドポイントに要求を行います。 ジョブのステータスが完了した場合、APIは応答本文に downloadURL 属性を含めます。 この属性にはURLが含まれ、このURLをブラウザーのアドレスバーに貼り付けてZIPファイルをダウンロードできます。
詳しくは、「プライバシーサービス開発者ガイド privacy-jobs.translate.html#check-the-status-of-a-job 」のIDによるジョブの検索に関する節を参照してください。

UIの使用

プライバシーサービスのUIダッシュボードで、 Job Requests Widgetからダウンロードするジョブを探します。 ジョブのIDをクリックして、 ジョブの詳細 ページを開きます。 ここから、右上隅の「 ダウンロード 」をクリックしてZIPファイルをダウンロードします。 詳細な手順については、 プライバシーサービスのユーザーガイド を参照してください。

一般的なエラーメッセージ

次の表に、プライバシーサービスの一般的なエラーの概要と、それぞれの問題を解決するのに役立つ説明を示します。
エラーメッセージ
説明
ユーザーIDが見つかりませんでした。
要求で指定された一部のユーザーIDが見つからず、スキップされました。 リクエストペイロードで正しい名前空間とID値を使用していることを確認します。 詳しくは、IDデータの 提供に関するドキュメント (英語)を参照してください。
無効な名前空間
ユーザーIDに対して入力されたID名前空間が無効でした。 受け入れられる名前空間のリストについては、「プライバシーサービス開発者ガイド付録 」の「 標準ID名前空間」の節を参照してください。 カスタム名前空間を使用する場合は、IDのプロパティを「custom」に設定しているこ type とを確認してください。
部分的に完了
ジョブは正常に完了しましたが、一部のデータが指定された要求に適用されず、スキップされました。
データが必要な形式ではありません。
指定されたアプリケーションの1つ以上のデータ値が正しく形式設定されていません。 ジョブの詳細を確認し、詳細を確認します。
IMS組織がプロビジョニングされていません。
このメッセージは、IMS組織がプライバシーサービス用にプロビジョニングされていない場合に発生します。 詳細については、管理者に問い合わせてください。
アクセスと権限が必要です。
プライバシーサービスを使用するには、アクセスと権限が必要です。 アクセス権を取得するには、管理者に問い合わせてください。
アクセスデータのアップロードとアーカイブで問題が発生しました。
このエラーが発生した場合は、アクセスデータを再度アップロードして、もう一度お試しください。
現在のドキュメントレート制限を超えたワークロードです。
このエラーが発生した場合は、送信率を下げてから、もう一度お試しください。