順序削除データモデル
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Order Delete APIは、referenceId値とorderedAt値の組み合わせを使って注文を削除します。これは、一部の組織がreferenceId値をリサイクルするため、orderedAt値を同時に提供することで、削除の正しい順序を特定していることが保証されます。Sitecore CDP、リクエストで送信されたorderedAt値から24時間以内に、orderedAt値が24時間以内にあってreferenceId値が同じであれば、削除命令を識別します。
まれなケースでは、リクエスト内でorderRef属性を使って正しい削除順序を特定する必要があります。削除したい注文のorderedAt値が他の注文と24時間以内で、かつ両方の注文が同じreferenceId値を持っている場合にのみ、この操作が必要です。例えば、orderedAt値が17
.000Z"の注文を削除したい場合"2023-09-25T16:、orderedAt値が47.000Z""2023-09-25T20。両方の注文が同じreferenceId値"B94TXY-1"であれば、リクエスト内でorderRef属性も使用しなければなりません。これは2つ目のJSON例に示されているようにです。orderRef値を取得するには、デバッグモードでゲストプロファイルのJSONを確認し、ordersオブジェクトからref値をコピーできます。または、Data Lakeのエクスポートサービスを使ってorderRef値と同じmeta_ref値を取得することもできます。また、Audience Exportを使ってorderRef値を取得することもできます。
バッチファイルを作成する際は、以下の表の属性に加えて 、必要なすべての属性 を含めてください。
属性
概要
種類
例
ref
アップロードプロセス中にJSONレコードを識別する一意IDです。このIDはSitecore CDP内でゲストやレコードを識別するためには使われません。アップロードプロセス専用です。
ストリング
バージョン4 UUID
"056621C2-C955-492D-B7EE-C77C6BDDFDEE"
schema
インポート中の value フィールドに含まれるレコードの種類。注文を削除する際にはこれを "order" に設定する必要があります。
ストリング
"order"
mode
バッチAPIモード。これは "delete"に設定されている必要があります。
ストリング
"delete"
value
Sitecore CDPから削除されるエンティティを含みます。
JSON オブジェクト
該当なし
orderRef
注文を参照するためにSitecore CDPによって生成される固有のIDです。
ストリング
"1202a558-5de3-46fc-8e45-eac7420f8c55"
referenceId
あなたの組織が発行する唯一のIDで、その注文を参照します。
ストリング
"B94TXY-1"
orderedAt
注文が行われた日時。
ISO 8601 日付/時刻 UTC
"2026-03-07T16:15
.000Z"こちらは "referenceId" 属性と "orderedAt" 属性を使って注文を削除するJSON例です:
{ "ref":"056621C2-C955-492D-B7EE-C77C6BDDFDEE", "schema":"order", "mode":"delete", "value":{ "referenceId":"B94TXY-1", "orderedAt":"2026-03-07T16:`15
`.000Z" } }以下は "orderRef"、"referenceId"、"orderedAt" 属性を使ってオーダーを削除するJSON例です。
{ "ref":"056621C2-C955-492D-B7EE-C77C6BDDFDEE", "schema":"order", "mode":"delete", "value":{ "orderRef":"1202a558-5de3-46fc-8e45-eac7420f8c55", "referenceId":"B94TXY-1", "orderedAt":"2026-03-07T16:`15
`.000Z" } }