---
title: "ウィジェットビューイベントの作成"
slug: "creating-a-widget-view-event"
abstract: "Sitecore SearchイベントREST APIのためのウィジェットビューイベントを作成することを説明しています。"
---
# ウィジェットビューイベントの作成

訪問者がページ上のウィジェットを閲覧した際には、必ずwidget viewイベントを送信しなければなりません。分析データを正しく記録するためには、ウィジェットが訪問者のビューポートにある時のみこのイベントを送信する必要があります。これは、訪問者がまだ十分にスクロールしてウィジェットを見ていない状態で誤って報告widget viewイベントを避けるためです。

> !重要[すべてのイベントに必要なデフォルト属性](urn:resource:fork:1075490)に加え、widget viewイベントにはentities属性とrfk\_id属性が必要です。

ウィジェットは複数のエンティティを含み、ウィジェットを閲覧することで、ユーザーは推奨されたすべてのコンテンツ(エンティティ)を確認できます。そのため、widget viewイベントにはentities属性が含まれなければなりません。この属性の値は、推奨されるすべてのエンティティを表すオブジェクトの配列です。これらのオブジェクトを含めることで、ビューごとにエンティティの適切な帰属が保証されます。

以下はwidget view事象の例です。

> !注イベントオブジェクトデータモデルについては、[Events API参照](https://doc.sitecore.com/search/en/developers/events-api/index.html)を参照してください。

{
 "name": "widget",
 "action": "view",
 "uuid": "<uuid>",
 "client\_time\_ms": 1234,
 "page\_load\_time\_ms": 1233,
 "request\_id": "<Request ID from search/rec request>",
 "interaction\_id": "<Interaction ID>",
 "value": {
 "rfk\_id": "<Widget ID>",
 "context": <context object>,
 "request": {
 "keyword": "<kw>",
 "modified\_keyword": "<>",
 "num\_results": 20,
 "total\_results": 50,
 "num\_requested": 100,
 "page\_size": 20
 },
 "entities": 
 {
 "id": "123",
 "entity\_type": "content",
 "entity\_subtype": "article",
 "attributes": {
 "author": "ABC"
 }
 },
 {
 "id": "124",
 "entity\_type": "content",
 "entity\_subtype": "article",
 "attributes": {
 "author": "ABC"
 }
 },
 {
 "id": "125",
 "entity\_type": "content",
 "entity\_subtype": "article",
 "attributes": {
 "author": "ABC"
 }
 }
 
 }
}