--- title: "世界的なイベント" slug: "global-events" abstract: "エンティティとのやり取りを追跡するために使われるエンティティのペイロードを記述します。" --- # 世界的なイベント Sitecore Search JS SDK for Reactは、訪問者がウェブサイトのエンティティまたはエンティティ詳細ページにログインし閲覧した際に送信されるグローバルイベントの以下のイベントを提供しています。 > !注特に記載がない限り、すべての属性は任意です。 ## TrackViewEvent ウィジェットのビューイベントを追跡します。通常はウィジェットとそのホストページの訪問者ビューを追跡するためにディスパッチされます。 名称 種類 概要 rfkid ストリング 必須。 追跡中のウィジェットを特定します。 entity ストリング 必須。 閲覧中のエンティティ名。 payload WidgetViewPayload 必須。 ペイロードはイベントと共に発送されました。 ### ウィジェットビューペイロード ペイロードはtrackViewEventと共に発送されました。 名称 種類 概要 items array< EntityPayload > ウィジェット内のエンティティが訪問者に表示され、閲覧されます。 keyword ストリング 必須。 フレーズ検索済み。 index 番号 必須。 クリックされたエンティティのインデックスです。 advancedQueryText ストリング modifiedKeyword ストリング 結果に反映されたキーワードを修正しました。 numResults 番号 取得できる最大結果数。 totalResults 番号 検索で特定された結果の総数 numRequested 番号 リクエストで送られた総数です。 pageSize 番号 1ページに表示される結果の最大数。 pageNumber 番号 結果がページ付けされた後のウィジェットをホストするページの番号はpageSize redirectUrl ストリング #### EntityPayload このペイロードはエンティティを記述します。エンティティとのやり取りを追跡したい場合、すべてのイベントでこのペイロードタイプを使いましょう。 名称 種類 概要 *ID* 番号 必須。 エンティティのID。 *entityType* ストリング 必須。 エンティティの名前。 *URL* ストリング エンティティのページのURL。通常はエンティティの詳細ページです。 提供されていない場合、SDKはページのURLを使用します。 *sourceId* ストリング コネクターによって割り当てられたエンティティの送信元のID。 ## trackPageViewEvent ページビューイベントを追跡します。通常、訪問者がどのウェブページを閲覧するたびに送信されます。 > !注このイベントは詳細に送信してください。SDKはこの動作がいつ起きているかを推測できません。 名称 種類 概要 name ストリング 必須。 閲覧されたページの種類を記述します。 widget entity page confirm cart category search detail qview other payload PageViewPayload 必須。 ペイロードはイベントと共に発送されました。 ### ページビューペイロード ペイロードオブジェクトはビューイベントでディスパッチされ、ウィジェットの有無にかかわらずページを記述します。 名称 種類 概要 items array< EntityPayload > ページ上のエンティティが訪問者に表示され、閲覧されます。通常は単一のエンティティです。 actionSubtype ストリング イベントをコンバージョンファネルに登録したい場合のみコン *バージョン* として設定してください。 #### EntityPayload このペイロードはエンティティを記述します。エンティティとのやり取りを追跡したい場合、すべてのイベントでこのペイロードタイプを使いましょう。 名称 種類 概要 *ID* 番号 必須。 エンティティのID。 *entityType* ストリング 必須。 エンティティの名前。 *URL* ストリング エンティティのページのURL。通常はエンティティの詳細ページです。 提供されていない場合、SDKはページのURLを使用します。 *sourceId* ストリング コネクターによって割り当てられたエンティティの送信元のID。 ## trackEntityPageViewEvent エンティティのページビューイベントを追跡します。訪問者がエンティティの詳細ビュー(通常はそのエンティティのページ)を入手した際に送信されます。 > !注このイベントは詳細に送信してください。SDKはこの動作がいつ起きているかを推測できません。 議論 種類 概要 entity ストリング 必須、 エンティティの種類。例えば、 content。 payload PageViewPayload 必須。 ペイロードはイベントと共に発送されました。 ### ページビューペイロード ペイロードオブジェクトはビューイベントでディスパッチされ、ウィジェットの有無にかかわらずページを記述します。 名称 種類 概要 items array< EntityPayload > ページ上のエンティティが訪問者に表示され、閲覧されます。通常は単一のエンティティです。 actionSubtype ストリング イベントをコンバージョンファネルに登録したい場合のみコン *バージョン* として設定してください。 #### EntityPayload このペイロードはエンティティを記述します。エンティティとのやり取りを追跡したい場合、すべてのイベントでこのペイロードタイプを使いましょう。 名称 種類 概要 *ID* 番号 必須。 エンティティのID。 *entityType* ストリング 必須。 エンティティの名前。 *URL* ストリング エンティティのページのURL。通常はエンティティの詳細ページです。 提供されていない場合、SDKはページのURLを使用します。 *sourceId* ストリング コネクターによって割り当てられたエンティティの送信元のID。