--- title: "命令の送信" slug: "sending-orders" abstract: "注文データをSitecore CDPに送信する方法の概要。" --- # 命令の送信 Sitecore CDP Sitecore CDPに注文を送信するためのさまざまなAPIを提供しています。利用可能な選択肢は、注文がリアルタイム、オフライン、同期的に提出されるかどうかなど、さまざまな要因によって異なります。 このトピックでは、組織が使用するAPI、統合オプション、データモデル(2.1データモデルまたは2.0データモデル)に応じて異なるオーダーオブジェクトをどのようにモデル化するかについての情報を提供します。 注文データを送信する前にこのトピックを読むことをお勧めします。これにより、ユーザーがゲストプロフィールで注文データを閲覧し、バッチセグメンテーションやオーディエンスエクスポートで注文データを活用できるようにしてください。注文データを正しくモデル化していなければ、たとえSitecore CDPにうまく送信できたとしても、そのデータがUIで利用できない可能性があります。 ## リアルタイムでの注文管理 Stream APIを使って、注文作成時を含めてリアルタイムで注文データを収集・Sitecore CDPに送信できます。ゲストがサイトとやり取りする際に送信できる注文関連イベントはいくつかあります。例えば、ゲストが商品をショッピングカートに追加したり、購入したり、ショッピングカートを空にしたりする場合などです。 > !注JavaScriptやTypeScriptのウェブアプリケーションでデータを取得するには、[Sitecore Cloud SDKまたはEngage SDK](https://doc.sitecore.com/cdp/ja/developers/api/before-you-start-sending-data/integrating-with-sitecore-cdp.html "Integrating with Sitecore CDP")のどちらかを使うことをお勧めします。これらのSDKはStream APIを裏で利用し、ウェブアプリ内で簡単にデータを取得できます。 すべての注文情報や注文品情報は記録され、ゲストプロフィールで確認できます。 オーダーが作成されることを保証するためには、必要なイベントを正しい順序で送信し、以下のいずれかの統合オプションに基づいてイベントオブジェクトをモデル化する必要があります。 - もし組織がEngage SDKを使って統合しているなら、注文作成に必要なイベントの詳細は [「送信注文](https://doc.sitecore.com/cdp/ja/developers/api/integrating-with-sitecore-cdp/understanding-integration-details/sending-orders-using-the-engage-sdk.html "Sending orders using the Engage SDK") 」をご覧ください。これはSitecore CDPへの注文送信の推奨方法です。 - もし組織がEngage SDKを使っていない場合、注文作成に必要なイベントの詳細は [「送信注文](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/direct-http-requests-reference/sending-orders-1166443.html "Sending orders") 」をご覧ください。 ストリームAPIでは注文の更新や削除はできません。そのためにはバッチ[API](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api.html "Batch API")または[REST API](https://api-docs.sitecore.com/cdp/order-rest-api/guest-data-extension)を使ってください。 ## 注文の同期管理 [REST API](https://api-docs.sitecore.com/cdp/order-rest-api)を使って、注文を作成・更新し、商品を注文し、注文連絡先をSitecore CDPで消費者に注文できます。ゲストプロファイルで注文データを閲覧し、バッチセグメンテーションやオーディエンスエクスポートでアクセスできるようにするには、[REST APIの注文データオブジェクト](https://api-docs.sitecore.com/cdp/order-rest-api/order/createorder)および他のデータオブジェクトをモデル化する必要があります。 ## オフライン注文の提出 [Batch API](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api.html "Batch API")を使ってオフライン注文の作成、更新、削除が可能です。Batch APIで[オフライン注文の提出を使](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-offline-orders/sending-offline-orders.html "Sending offline orders")えば、以下のいずれかが可能です: - 組織がSitecore CDPと統合した際に、データレイクやデータウェアハウスからの大量の過去注文を一度きりで提出してください。 - コールセンターなどの第三者システムからオフライン注文を提出してください。 - クッキーをブロックするゲストや匿名ブラウザを使用しているゲストには注文を送信してください。 - もし組織がStream APIを使って部分的な注文を提出する場合は、完全な注文を提出してください。 - Stream APIで提出された注文は毎日更新されます。 注文データがSitecore CDP UIで利用可能であることを保証するためには、[注文データモデル](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-offline-orders/order-data-model.html "Order data model") および [注文品目データモデル](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-offline-orders/order-item-data-model.html "Order item data model")のバッチAPIガイドラインに従う必要があります。 ## データ拡張を使って追加の注文および注文品のデータを送信する バッチAPIとREST APIは、注文品目データモデルに含まれていない追加の注文および注文品目データをSitecore CDPに送信できます。 データ拡張を使って追加データを送ることができます。データ拡張とは、組織が望むキー-値ペア(属性)を指定できる配列のことです。これにより、組織は注文や注文項目に関するより信頼性の高い情報を取得できます。 追加データを注文 *データ拡張* または *注文項目データ拡張* のいずれかで送信できます: - Batch APIを使用する場合は、 [追加の注文データ](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-offline-orders/send-additional-order-data.html "Send additional order data") や [追加注文品目の送信](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-offline-orders/send-additional-order-items-data.html "Send additional order items data")に関してBatch APIのガイドラインに従ってください。 [注文拡張データモデル](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-offline-orders/order-extension-data-model.html "Order extension data model") および [注文項目拡張データモデル](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-offline-orders/order-item-extension-data-model.html "Order item extension data model")に従ってデータをフォーマットすることを確認してください。 - REST APIを使う場合は、 [注文や注文品のデータ拡張を作成し](https://api-docs.sitecore.com/cdp/order-rest-api/guest-data-extension)てください。 データ拡張を使って追加の注文や注文品目データを取得すると、そのデータはSitecore CDPで利用可能になります。以下が可能です: - ゲストプロフィールの [「注文」](https://doc.sitecore.com/cdp/en/users/sitecore-cdp/en/view-guest-orders-in-sitecore-cdp.html) タブで、ゲストに関連付けられた注文および注文アイテムデータの延長情報を閲覧できます。 - [バッチセグメンテーション](https://doc.sitecore.com/cdp/en/users/sitecore-cdp/en/introduction-to-batch-segmentation.html)で注文および注文品目のデータ拡張を活用してください。また、[バッチセグメンテーションにおける注文および注文品目のデータ拡張](https://doc.sitecore.com/cdp/en/users/sitecore-cdp/en/create-and-add-rules-to-a-segment-in-sitecore-cdp.html)の表示例もご覧ください。 - [オーディエンスエクスポート](https://doc.sitecore.com/cdp/en/users/sitecore-cdp/en/audience-export.html)には拡張データを含めること。