--- title: "イベントデータオブジェクト" slug: "event-data-object" abstract: "Sitecore Engage SDK(Sitecore CDP Stream API)におけるイベントデータオブジェクトを記述します。" --- # イベントデータオブジェクト イベントデータオブジェクトを使って、ユーザーのアプリとのやり取りに関する行動やトランザクションデータを収集します。拡張 [データオブジェクト](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/extension-data-object.html "Extension data object")を使ってイベントに関するカスタムデータを収集することも可能です。イベントデータオブジェクトを作成した後、イベントをSitecore CDPに送信できます。 ## 必要な属性 最低限、すべてのイベントデータオブジェクトには以下の属性が含まれなければなりません。異なるイベントタイプごとに、この表に記載されている以上の属性を必要とする場合があることに注意してください。 属性 種類 概要 例 channel 文字列(大文字) ユーザーがブランドと関わる接点です。 例えば、ウェブページの場合、チャンネルは "WEB"です。モバイルアプリの画面では、チャンネルは "MOBILE\_APP"です。 以下のいずれかでなければなりません: - "AIRPORT\_KIOSK" - "BRANCH" - "CALL\_CENTER" - "EMAIL" - "GDS" - "KIOSK" - "MOBILE\_APP" - "MOBILE\_WEB" - "SMS" - "OFFLINE" - "OTA" - "OTHER" - "WEB" currency 文字列(大文字の [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes)) ユーザーがアプリで使っている通貨のアルファベット順通貨コードです。 例えば、ユーザーがあなたのウェブサイトで通貨としてオーストラリアドルを選択した場合、通貨は "AUD"となります。 - "EUR" - "GBP" - "USD" pointOfSale ストリング [ブランドとのやり取りが行われる販売ポイントの名前。](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950166538) この値は、あなたのSitecore CDPインスタンス内に存在する販売時点名に設定する必要があります。 [設定オブジェクト](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/settings-object.html)でpointOfSaleを指定していなければ、すべてのイベントデータオブジェクトで指定しなければなりません。 設定オブジェクトで pointOfSale を指定していれば、イベントデータオブジェクトではオプションです。任意のイベントデータオブジェクトで、設定オブジェクトで以前指定された pointOfSaleの元の値をその特定のイベントに対して上書きすることができます。 "myretailsite/ireland" ## オプション属性 イベントデータオブジェクトはオプションで以下の属性を含めることができます。 属性 種類 概要 例 language 文字列(大文字 [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)) ユーザーがアプリを使っている言語。 例えば、ユーザーがウェブサイトで日本語を選択した場合、その言語は "JA"です。 これはお好みのカスタム値です。 クライアント側イベントでは、デフォルト値はHTML lang 属性から推定されます。HTML lang 属性が指定されていない場合、デフォルトは空文字列となります。 サーバーサイドイベントの場合、デフォルトは空文字列です。 - "DE" - "EN" - "FR" page ストリング ブランドとのやり取りが行われるウェブページの名前。 これはお好みのカスタム値です。 クライアント側イベントの場合、ウェブサイトのルートページのデフォルト値は Home Pageです。他のページについては、デフォルト値はURLパスネームから推定されます。 サーバーサイドイベントの場合、デフォルトは空文字列です。 - "Home Page" - "home" - "contact-us.html"