Privacy Serviceのベストプラクティス
Privacy Serviceを使用すると、顧客がデータストアからの個人データへのアクセスや削除を希望する場合に、データプライバシー規制への準拠を自動化できます。 これらの変化するビジネスニーズに対応するために、Privacy Serviceでは、Adobe Experience Cloud アプリケーション全体で顧客データのアクセス要求や削除要求を送信できるRESTful APIとUIを提供しています。
このガイドでは、顧客データリクエストを管理する際に、プライバシーリクエストを効率的に処理し、完了時間を最適化するためのベストプラクティスについて説明します。
はじめに getting-started
このガイドでは、Privacy Serviceについて理解し、Adobe Experience Cloud アプリケーション全体でデータ主体（お客様）からのアクセス要求と削除要求を管理する方法を理解する必要があります。 また、UIまたはAPIでのプライバシージョブリクエストの作成に関するガイドを読み、これらの操作をプログラムで実行する方法を理解することをお勧めします。
前提条件 prerequisites
Adobe Experience Platform Privacy Serviceへのアクセスは、Adobe Admin Consoleのロールベースの詳細な権限によって制御できます。 Privacy Service UIとAPIの特定の機能を使用するには、製品プロファイルに関連する権限が必要です。 追加の権限が必要な場合は、システム管理者にお問い合わせください。
詳しくは、Privacy Serviceの権限の管理に関するガイドを参照してください。
プライバシージョブ作成ガイドライン creation-guidelines
リクエスト処理を合理化し、応答時間を短縮するには、プライバシージョブを作成する際に次のガイドラインを考慮してください。 これは、API メソッドとUI メソッドの両方に適用されます。
- リクエストごとにデータ主体を最大化： リクエストごとに最大1000個まで、できるだけ多くのデータ主体を含めます。
- 効率化のためのグループ ID:各リクエストで、1つのデータ主体（最大9件）に対して複数のIDをグループ化します。 IDは、同じリクエスト内の異なるAdobe サービスから取得できます。
- アクセスと削除のジョブを組み合わせる： データ主体が必要とする場合、「アクセス」と「削除」の両方のジョブタイプを1つのリクエストに含めます。
- 必要な製品のみを含める：必要またはライセンスが付与されている製品のみを含める。 その他の製品を追加すると、処理時間の延長とコストの増加を実現できます。
プライバシージョブのステータスの監視 monitor-status
Privacy Serviceでは、プライバシージョブを効果的に監視し、そのステータスを確認するために、次の3つの方法を提供しています。 効率と生産性を監視するために、利用可能な方法を以下に示します。 各方法には、エクスペリエンスを向上させるためのベストプラクティスガイドラインと、あらゆるアプローチを組み合わせた理想的なシナリオ例が記載されています。
リアルタイムの通知を受信 real-time-notifications
I/O イベントでは、ステータスイベントを通じてほぼリアルタイムのステータス監視が可能です。 これは、ポーリングメカニズムを実装し、追加のAPI トラフィックを発生させる必要性を回避するため、最も効率的な方法です。
レコメンデーション：
- Webhookの設定：送信済みジョブのステータスが変更されたときにプッシュ通知を受信するようにWebhookを設定します。 これにより、リアルタイムのモニタリングが可能になります。
- 通知： ジョブ レベルと製品レベルの両方で通知を使用して、リクエストの進行状況を監視します。
Privacy Service通知のイベント登録の設定方法と通知ペイロードの解釈方法については、Privacy Service イベントの購読に関するドキュメントを参照してください。
フィルターに基づくすべてのジョブの取得 retrieve-filtered-responses-for-all-jobs
指定されたフィルターに基づいてすべてのプライバシージョブデータを取得するには、エンドポイント /jobsに対してGET リクエストを実行します。 このAPI呼び出しは、1回のリクエストだけで大規模なジョブ ID セットの現在のジョブステータスの概要を提供するのに便利です。 詳細な製品応答はありませんが、/jobs/{jobID} エンドポイント を使用して見つけることができます。
/jobs エンドポイントへのGET リクエストは、ジョブ IDの大規模なセットのステータス データを収集または比較するのに最適ですが、notは通常のポーリング タイプ アクティビティ用です。
レコメンデーション：
- クエリパラメーター：特定のフィルターを使用して、結果を絞り込みます。例えば、データ範囲、規制タイプ、ステータス（処理、完了など）です。
Privacy Service UIを使用すると、組織内のすべての現在のプライバシージョブのリストを表示できます。 ジョブリクエストリストのフィルタリング方法について詳しくは、UI ドキュメントのプライバシージョブの管理を参照してください。 または、Privacy Service API🔗での/job エンドポイントの使用に関するドキュメントを参照してください。
Privacy Service API ドキュメントには、使用可能なクエリパラメーターフィルターの詳細が含まれています。
1つのジョブに対する詳細な応答の取得 retrieve-detailed-responses-for-specific-jobs
1つのジョブに対する詳細な応答を取得するには、GET リクエストを/jobs/{jobID} エンドポイントに実行します。 この方法は、製品固有の応答や成功メッセージなど、より深い情報収集を目的としています。 このエンドポイントへの呼び出しは、どの製品が応答し、どの製品がまだ保留中であるかを確認するための最良の方法ですが、定期的なポーリングアクティビティを目的とした not です。
特定のジョブのステータスを確認する方法について詳しくは、/jobs/{JOB_ID} エンドポイントのドキュメントを参照してください。
理想的なシナリオ例 ideal-scenario
Webhookを使用して、リクエストのIDのグループが完了したときにシステムがレコードを自動的に更新し、レポートやアラートを提供できるようにします。 ジョブがまだ未処理の場合、Privacy Service API /jobs エンドポイントに対するGET リクエストでこれらのジョブステータスを取得し、リストの上位レベルの更新を提供します。
特定のジョブがまだ保留中であるか、エラーを返した場合は、/job/{jobId} エンドポイントに対するGET リクエストを含む詳細な応答を取得できます。
リクエストデータへのアクセス access-request-data
データ主体の情報が要求された場合、各サービスは、そのデータの保存と使用方法に一貫性のある形式でデータを返します。 すべてのサービスがリクエストを完了すると、ジョブの詳細に.ZIP アーカイブファイルのURLが提供され、このデータをダウンロードできるようになります。 プライバシージョブの結果をダウンロードする方法について詳しくは、トラブルシューティングガイドを参照してください。
データアーカイブの管理に関する重要な注意事項は次のとおりです。
- すべてのアーカイブファイルは、30日後にExperience Platformサーバーから削除されます。 30日を超える顧客データはクエリできません。
- アーカイブファイルの構造には、リクエストに含まれる各製品のフォルダーと、その中に含まれるデータファイルが含まれます。 指定されたIDのデータが見つからなかった場合、アーカイブ ファイルまたはフォルダーが空になる可能性があります。
- 以前に作成したジョブのデータには、完了日から30日間のみアクセスできます。 その後、データはシステムから削除され、新しいリクエストを行う必要があります。
レコメンデーション：
- データ アーカイブの保護： URL と.ZIP ファイルは、データ主体の個人情報（PII）が含まれている可能性があるため、両方とも保護する必要があります。
技術的な考慮事項 technical-considerations
Privacy Service リクエストを完了する際に注意すべき技術的な考慮事項があります。
- データ保持期間：任意のジョブ グループの最大ルックバック期間は60日で、クエリの最大期間は30日（開始/終了日）です。
- ゲートウェイのタイムアウト： 60秒を超えると、要求がゲートウェイから削除される可能性があることに注意してください。
- エラー処理： エラーメッセージを徹底的に確認し、必要に応じてリクエストを再送信します。 Privacy Serviceは、エラー後にジョブを自動的に再処理しません。
- HTTP 429 エラーについて： HTTP 429 エラーメッセージと、問題を軽減するために必要な手順について説明します。 HTTP 429 エラーは、「リクエストが多すぎる」結果です。 問題の解決方法について詳しくは、トラブルシューティングガイドの「一般的なエラーメッセージ 」セクションを参照してください。
次の手順
このドキュメントでは、Privacy Serviceを効率的かつ効果的に使用するために必要な知識と実践について説明します。 次に、 トラブルシューティング ガイド で、Privacy Serviceに関するよくある質問と、APIで頻繁に発生するエラーに関する回答をご覧ください。