---
title: "推薦ウィジェットイベント"
slug: "recommendation-widget-events"
abstract: "エンティティとのやり取りを追跡するために使われるエンティティのペイロードを記述します。"
---
# 推薦ウィジェットイベント

JS DataパッケージSitecore Search、recommendationウィジェットとのやり取りを追跡するイベントをトリガーする機能を提供します。

## trackRecommendationClickEvent

この機能はrecommendationウィジェットのナビゲーションボタンのクリックを追跡するwidget click(creating-a-widget-click-event.md "Creating a widget click event") イベントをトリガーします。

名称

種類

概要

*rfkId*

ストリング

必須。  
  
追跡中のウィジェットを特定します。

*エンティティ*

ストリング

必須。  
  
エンティティの種類。  
  
例: content

*ペイロード*

[推奨ペイロード](https://doc.sitecore.com/search/ja/developers/search-developer-guide/integrating-using-search-js-data-package/tracking-user-interactions/recommendation-widget-events.html#UUID-e12fbc61-b6f8-07b7-f236-a8ed21f95a80_section-idm1743380786849700)

必須。  
  
ペイロードはイベントと共に発送されました。

### 推奨ペイロード

ウィジェットクリックイベントで、trackRecommendationClickEvent関数によってペイロードがディスパッチされます。

> !注特に明記がない限り、すべての属性は任意です。

名称

種類

概要

*アイテム*

[EntityPayload](https://doc.sitecore.com/search/ja/developers/search-developer-guide/integrating-using-search-js-data-package/tracking-user-interactions/recommendation-widget-events.html#UUID-e12fbc61-b6f8-07b7-f236-a8ed21f95a80_UUID-bbb261d8-0615-9e58-fb52-2e075c690e59) 配列

存在が映し出される。

*インデックス*

番号

クリックされたエンティティのインデックスです。

*actionCause*

ストリング

navigation または close

#### EntityPayload

このペイロードはエンティティを記述します。エンティティとのやり取りを追跡したい場合、すべてのイベントでこのペイロードタイプを使いましょう。

名称

種類

概要

*ID*

番号

必須。  
  
エンティティのID。

*entityType*

ストリング

必須。  
  
エンティティの名前。

*URL*

ストリング

エンティティページのURL。通常は事業体の詳細ページです。  
  
提供されていない場合、SDKはページのURLを使用します。

*sourceId*

ストリング

コネクターによって割り当てられたエンティティの送信元のID。

## trackRecommendationClickEntityEvent

この関数は、recommendationウィジェットのエンティティへのクリックを追跡する [ウィジェットクリック](https://doc.sitecore.com/search/ja/developers/search-developer-guide/integrating-using-rest-apis/using-the-events-api-to-track-events/widget-events/creating-a-widget-click-event.html "Creating a widget click event") イベントをトリガーします。

名称

種類

概要

*rfkId*

ストリング

必須。  
  
追跡中のウィジェットを特定します。

*エンティティ*

ストリング

必須。  
  
エンティティの種類。

*ペイロード*

[おすすめClickItemPayload](https://doc.sitecore.com/search/ja/developers/search-developer-guide/integrating-using-search-js-data-package/tracking-user-interactions/recommendation-widget-events.html#UUID-e12fbc61-b6f8-07b7-f236-a8ed21f95a80_section-idm1743380786864328)

必須。  
  
ペイロードはイベントと共に発送されました。

### おすすめClickItemPayload

ウィジェットクリックイベントで、trackRecommendationClickEntityEvent関数によってペイロードがディスパッチされます。

名称

種類

概要

*アイテム*

EntityPayload 配列

必須。  
  
エンティティをクリックしました。

*インデックス*

番号

必須。  
  
クリックされたエンティティのインデックスです。

#### EntityPayload

このペイロードはエンティティを記述します。エンティティとのやり取りを追跡したい場合、すべてのイベントでこのペイロードタイプを使いましょう。

名称

種類

概要

*ID*

番号

必須。  
  
エンティティのID。

*entityType*

ストリング

必須。  
  
エンティティの名前。

*URL*

ストリング

エンティティページのURL。通常は事業体の詳細ページです。  
  
提供されていない場合、SDKはページのURLを使用します。

*sourceId*

ストリング

コネクターによって割り当てられたエンティティの送信元のID。