[ベータ版]{class="badge informative"}
レコードの削除 record-delete
データライフサイクル ワークスペースを使用して、プライマリ ID に基づいてAdobe Experience Platform内のレコードを削除します。 これらのレコードは、個々のコンシューマーまたは ID グラフに含まれるその他のエンティティに関連付けることができます。
前提条件 prerequisites
レコードを削除するには、Experience Platformの ID フィールドがどのように機能するかについての実践的な理解が必要です。 特に、削除元の(1 つまたは複数の)データセットに応じて、レコードを削除するエンティティの ID 名前空間値を把握する必要があります。
Platform の ID について詳しくは、次のドキュメントを参照してください。
- Adobe Experience Platform ID サービス:デバイスやシステム間で ID をブリッジし、準拠する XDM スキーマで定義された ID フィールドに基づいてデータセットをリンクします。
- ID 名前空間:ID 名前空間は、1 人の人物に関連している可能性のある様々なタイプの ID 情報を定義する、各 ID フィールドに必須のコンポーネントです。
- リアルタイム顧客プロファイル:ID グラフを使用して、ほぼリアルタイムで更新される、複数のソースからの集計データに基づいて統合された消費者プロファイルを提供します。
- エクスペリエンスデータモデル(XDM):スキーマの使用により、Platform データの標準的な定義および構造を提供します。すべての Platform データセットは特定の XDM スキーマに準拠しており、スキーマはどのフィールドが ID であるかを定義しています。
- ID フィールド:XDM スキーマで ID フィールドが定義される方法を説明します。
リクエストの作成 create-request
プロセスを開始するには、Platform UI の左側のナビゲーションで データライフサイクル を選択します。 データライフサイクルリクエスト ワークスペースが表示されます。 次に、ワークスペースのメインページから「リクエストを作成」を選択します。
リクエスト作成ワークフローが表示されます。 デフォルトでは、「リクエストされたアクション セクションで レコードを削除 オプションが選択されています。 このオプションを選択されたままにします。
データセットの選択 select-dataset
次の手順では、単一のデータセットとすべてのデータセットのどちらからレコードを削除するかを決定します。 このオプションを使用できない場合は、ガイドの ID の提供の節に進みます。
「レコードの詳細 セクションで、ラジオボタンを使用して、特定のデータセットとすべてのデータセットを選択します。 「データセットを選択」を選択する場合は、データベースアイコン(
![ データセットが選択され ] 完了 がハイライト表示された データセットを選択 ダイアログ
すべてのデータセットからレコードを削除する場合、「すべてのデータセット」を選択します。
ID を提供 provide-identities
レコードを削除する場合、システムがどのレコードを削除するかを決定できるように、ID 情報を指定する必要があります。 Platform のデータセットの場合、レコードは、データセットのスキーマによって定義された ID 名前空間 フィールドに基づいて削除されます。
Platform のすべての ID フィールドと同様に、ID 名前空間は、タイプ (ID 名前空間とも呼ばれる)と 値 の 2 つで構成されます。 ID タイプは、フィールドがどのようにレコードを識別するかについてのコンテキストを提供します(メールアドレスなど)。 値は、そのタイプに対するレコードの特定の ID を表します(例えば、email
ID タイプの jdoe@example.com
)。 ID として使用される共通のフィールドには、アカウント情報、デバイス ID および Cookie ID が含まれます。
![データセットが選択されたデータセットダッシュボードに、データセットの詳細パネルからスキーマダイアログが開きます。 データセットのプライマリ ID がハイライト表示されている様子。](./media_14c7b162a23c6d9475f42b80488483e07d7c80a33.png?width=750&format=png&optimize=medium)
単一のデータセットからレコードを削除している場合、データセットが持つことができるのは 1 つの ID 名前空間のみなので、指定したすべての ID が同じタイプである必要があります。 すべてのデータセットから削除している場合、データセットが異なるとプライマリ ID が異なる可能性があるので、複数の ID タイプを含めることができます。
レコードを削除する場合、ID を提供するには 2 つのオプションがあります。
JSON ファイルのアップロード upload-json
JSON ファイルをアップロードするには、ファイルを指定された領域にドラッグ&ドロップするか、「ファイルを選択」を選択して、ローカルディレクトリから参照して選択できます。
JSON ファイルは、各オブジェクトが ID を表す、オブジェクトの配列としてフォーマットされている必要があります。
[
{
"namespaceCode": "email",
"value": "jdoe@example.com"
},
{
"namespaceCode": "email",
"value": "san.gray@example.com"
}
]
namespaceCode
value
ファイルがアップロードされると、引き続きリクエストを送信できます。
ID を手動で入力 manual-identity
ID を手動で入力するには、「ID を追加」を選択します。
ID を 1 つずつ入力できるコントロールが表示されます。 ID 名前空間 で、ドロップダウンメニューを使用して ID タイプを選択します。 「プライマリ ID 値」で、レコードの ID 名前空間値を指定します。
さらに ID を追加するには、プラスアイコン(
リクエストの送信 submit
リクエストへの ID の追加が完了したら、「送信」を選択する前に リクエスト設定 でリクエストの名前とオプションの説明を入力します。
UI を使用して 1 つのレコードを削除するリクエストを実行すると、一度に 10,000 個の ID を送信できます。 レコードを削除する API メソッドを使用すると、一度に 100,000 個の ID を送信できます。
ベストプラクティスとして、ID の制限を上限とするリクエストあたり、できるだけ多くの ID を送信します。 大量の ID を削除する場合は、少量の ID や、レコード削除リクエストごとに 1 つの ID を送信しないでください。
ID が削除されると復元できないことを示す リクエストを確認 ダイアログが表示されます。 「送信」を選択して、データを削除する ID のリストを確定します。
リクエストが送信されると、作業指示が作成され、「データライフサイクル ワークスペースの レコード タブに表示さ ます。 ここから、リクエストを処理する作業指示のステータスを監視できます。
次の手順
このドキュメントでは、Experience PlatformUI でレコードを削除する方法について説明しました。 UI で他のデータライフサイクル管理タスクを実行する方法について詳しくは、 データライフサイクル UI の概要を参照してください。
Data Hygiene API を使用したレコードの削除方法については、 作業指示エンドポイントガイドを参照してください。