---
title: "ウィジェットクリックイベントの作成"
slug: "creating-a-widget-click-event"
abstract: "Sitecore SearchイベントREST APIのウィジェットクリックイベントの作成方法を説明しています。"
---
# ウィジェットクリックイベントの作成

訪問者がSitecore Searchウィジェットのどこかをクリックすると、widget clickイベントを送信する必要があります。ほとんどのウィジェットクリックはエンティティ上にありますが、カテゴリ、フィルター、ナビゲーションボタンにも当てはまります。

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

## ウィジェットがエンティティをクリックします

訪問者がSitecore Searchウィジェット内のエンティティをクリックした場合、action\_causeキーを*エンティティ*に設定したwidget clickイベントを送信します。

> !重要[すべてのイベントに必要なデフォルトの属性](urn:resource:fork:1075490)に加え、エンティティ上のclickイベントにはindex,\`\`rfk\_id属性とentities属性が必要です。entities配列には、クリックされたエンティティを表すオブジェクトが含まれ、少なくともidとentity\_type属性が含まれていなければなりません。

以下はエンティティ上のwidget clickイベントの例です:

{
 "name": "widget",
 "action": "click",
 "action\_cause": "entity",
 "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": "<>"
 },
 "index": 1,
 "entities": 
 {
 "id": "123",
 "entity\_type": "content",
 "entity\_subtype": "article",
 "attributes": {
 "author": "ABC"
 }
 }
 
 }
}

## ウィジェットでカテゴリをクリックします

訪問者がSitecoreウィジェットのカテゴリリンクをクリックした場合、action\_causeキーを"category"に設定したwidget clickイベントを送信します。

> !重要 [すべてのイベントに必要なデフォルトの属性](urn:resource:fork:1075490)に加え、カテゴリーのイベントでclick\_text、click\_uri、click\_text\_id、rfk\_id、entities属性がclick必要です。 entities配列には、クリックされたカテゴリを表すオブジェクトが含まれ、少なくともidとentity\_type属性が含まれていなければなりません。

以下は、ある圏上のwidget click事象の例です。

{
 "name": "widget",
 "action": "click",
 "action\_cause": "category",
 "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>",
 "request": {
 "keyword": "<kw>",
 "modified\_keyword": "<>"
 },
 "context": <context object>,
 "click\_text\_id": "top-article",
 "click\_text": "Top Articles",
 "click\_uri": "http://test.com/top-articles",
 "index": "3",
 "entities": 
 {
 "id": "123",
 "entity\_type": "category"
 }
 
 }
}

## ウィジェットをクリックしてフィルターを操作

訪問者がSitecore Searchウィジェットのフィルターやファセットをクリックした場合、action\_causeキーを"filter"に設定したwidget clickイベントを送信します。

> !重要 [すべてのイベントに必要なデフォルト属性](urn:resource:fork:1075490)に加え、filters属性とrfk\_id属性はフィルターのイベントclickにも必要です。 filters配列には、ユーザーが選択したフィルターを表すオブジェクトが含まれなければなりません。このオブジェクトには少なくともname属性が含まれていなければなりません。

以下はフィルター上のwidget clickイベントの例です。

{
 "name": "widget",
 "action": "click",
 "action\_cause": "filter",
 "uuid": "<uuid>",
 "client\_time\_ms": 1234,
 "page\_load\_time\_ms": 1233,
 "interaction\_id": "<Interaction ID>",
 "value": {
 "rfk\_id": "<Widget ID>",
 "context": <context object>,
 "request": {
 "keyword": "<kw>",
 "modified\_keyword": "<>"
 },
 "index": 1,
 "filters": 
 {
 "name": "content-type",
 "value": "article",
 "value\_position": 2,
 "facet\_position": 3,
 "display\_name": "Article",
 "title": "Content Type"
 }
 
 }
}