--- title: "ゲストデータの送信" slug: "sending-guest-data" abstract: "Sitecore CDP Stream API、バッチAPI、REST APIを用いたゲストデータ管理の概要。" --- # ゲストデータの送信 Sitecore CDPは以下のAPIを使ってゲストデータを管理することを可能にします: - [Stream API](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/direct-http-requests-reference/direct-http-requests-reference.html "Direct HTTP requests reference") - ゲストがアプリケーションを操作しながらリアルタイムでゲスト、行動データ、注文データをキャプチャするために使用されます。 > !注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を裏で利用し、ウェブアプリ内で簡単にデータを取得できます。 Sitecore CDPはゲストデータを取得するための [イベント](https://doc.sitecore.com/cdp/ja/developers/api/before-you-start-sending-data/sending-events.html "Sending events") を提供します。注文情報や追跡データに関わるものはすべて記録され、[ゲストプロフィールで](https://doc.sitecore.com/cdp/en/users/sitecore-cdp/en/view-a-guest-profile-in-sitecore-cdp.html)確認できます。 組織はイベントに追加のカスタムデータを送り、そのデータをバッチセグメンテーションやオーディエンスエクスポートに活用できます。これは他のイベントデータと同様にです。Sitecore Personalizeがあれば、リアルタイムのパーソナライズや意思決定にも活用できます。 - [バッチAPI](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api.html "Batch API") - Sitecore CDPでゲストプロファイルの作成、更新、削除に使えます。このAPIは、Sitecore CDPをアプリケーションに統合する際に大量のゲストデータを効率的にアップロードするためによく使われます。例えば、Sitecore CDPで稼働する前に、レガシーシステムから過去12か月分の顧客データを読み込むことを決めるかもしれません。ゲストプロファイルでデータを閲覧し、バッチセグメンテーションやオーディエンスエクスポートでアクセスできるようにするには、Batch API向けに [ゲストデータオブジェクト](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-guest/guest-data-model.html "Guest data model") をモデル化する必要があります。 - [REST API](https://api-docs.sitecore.com/cdp/guest-rest-api) - ゲストプロファイルを作成・更新するために使Sitecore CDP。ゲストプロファイルのデータを確認し、バッチセグメンテーションやオーディエンスエクスポートでアクセスできるようにするには、[REST APIのゲストデータオブジェクト](https://api-docs.sitecore.com/cdp/guest-rest-api/guest/createguest) をモデリングする必要があります。 ## データ拡張を使って追加ゲストデータを送信する方法 バッチAPIとREST APIは、ゲストデータモデルに含まれない追加のゲストデータをSitecore CDPに送ることを可能にします。 データ拡張を使って追加データを送信できます。データ拡張とは、組織が望むキーと値のペア(属性)を指定できる配列です。これにより、組織はゲストに関するより堅牢な情報を収集できます。 *ゲストデータ拡張機能*を使って追加データを送信する方法は2通りあります: - バッチAPIを使用している場合は、 [追加のゲストデータ送信](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-guest/send-additional-guest-data.html "Send additional guest data")に関してバッチAPIのガイドラインに従ってください。データをゲスト [拡張データモデル](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-guest/guest-extension-data-model.html "Guest extension data model")に従ってフォーマットすることを必ず確認してください。 - REST APIを使うなら、 [ゲストデータ拡張機能を作成し](https://api-docs.sitecore.com/cdp/guest-rest-api/guest-data-extension)てください。 ゲストデータ拡張機能を使って追加のゲストデータを取得すると、そのデータはSitecore CDPで利用可能になります。以下のことができます: - ゲストプロファイルのプロパティタブで、ゲストに関連付けられたデータ拡張を確認 [できます](https://doc.sitecore.com/cdp/en/users/sitecore-cdp/en/view-guest-properties-in-sitecore-cdp.html) 。 - [バッチセグメンテーション](https://doc.sitecore.com/cdp/en/users/sitecore-cdp/en/introduction-to-batch-segmentation.html)でデータ拡張を活用してください。[バッチセグメンテーションでゲストデータ拡張がどのように表示](https://doc.sitecore.com/cdp/ja/developers/api/before-you-start-sending-data/send-additional-guest-data.html#UUID-1c0d5939-352c-db4e-8a00-8908a44d2885_sidebar-idm1903466974423286 "Accessing guest data extensions in batch segmentation")されるかの例もご覧ください。 - [オーディエンスエクスポート](https://doc.sitecore.com/cdp/en/users/sitecore-cdp/en/audience-export.html)には拡張データを含めること。