---
title: "イベントAPIの利用によるイベント追跡"
slug: "using-the-events-api-to-track-events"
abstract: "このイベントAPI Sitecore Searchを紹介します。"
---
# イベントAPIの利用によるイベント追跡

訪問者がウィジェットをクリックしたり、ログインしたり、記事にアップボートしたりしてあなたのページとやり取りする際、そのやり取りを追跡し、イベントAPIを使ってその情報をSitecore Searchに送信する必要があります。

Sitecore Searchイベントを使って分析ダッシュボードを作成し、パーソナライズを推進します。イベントを徹底的かつ正確に追跡すれば、より有用なサイト分析が得られ、訪問者もよりパーソナライズされたコンテンツを受けられます。

訪問者のやり取りを追跡するには、関連する [イベントオブジェクト](https://doc.sitecore.com/search/ja/developers/search-developer-guide/integrating-using-rest-apis/using-the-events-api-to-track-events/events-api-reference-and-data-model.html "Events API reference and data model")を正しく構築し、[Events APIを呼び出し](https://doc.sitecore.com/search/ja/developers/search-developer-guide/integrating-using-rest-apis/using-the-events-api-to-track-events/calling-the-events-api.html "Calling the Events API")、[APIを使ってオブジェクトを送信](urn:resource:fork:958998)する必要があります。

> !重要Searchが正常に動作するには [特定のイベントを送](https://doc.sitecore.com/search/ja/developers/search-developer-guide/integrating-using-rest-apis/using-the-events-api-to-track-events/required-events-to-send-to-sitecore-search.html "Required events to send to Sitecore Search") る必要があります。

## イベントの種類と必要な属性

Sitecore SearchイベントAPIを使えば、さまざまな種類のイベントを追跡できます。Sitecore Searchイベントアクションや名前を組み合わせて様々なイベントを作成できます。

Sitecore Search以下のカテゴリーのイベントを支援しています:

-   [ファネルイベント](https://doc.sitecore.com/search/ja/developers/search-developer-guide/integrating-using-rest-apis/using-the-events-api-to-track-events/funnel-events.html "Funnel events") - Sitecore Searchコンポーネントに直接関与しないで追跡したい訪問者のアクション。ファネルイベントには [、ページの閲覧](https://doc.sitecore.com/search/ja/developers/search-developer-guide/integrating-using-rest-apis/using-the-events-api-to-track-events/funnel-events/creating-an-entity-page-view-event.html "Creating an entity page view event")、 [レビューの追加](https://doc.sitecore.com/search/ja/developers/search-developer-guide/integrating-using-rest-apis/using-the-events-api-to-track-events/funnel-events/creating-a-review-add-event.html "Creating a review add event")、 [ブックマークの削除](https://doc.sitecore.com/search/ja/developers/search-developer-guide/integrating-using-rest-apis/using-the-events-api-to-track-events/funnel-events/creating-a-bookmark-remove-event.html "Creating a bookmark remove event")、 [ログイン](https://doc.sitecore.com/search/ja/developers/search-developer-guide/integrating-using-rest-apis/using-the-events-api-to-track-events/funnel-events/creating-a-login-event.html "Creating a login event")などの操作が含まれます。ファネルイベントはしばしばrecommendationウィジェットで結果を提供します。例えば、recommendationウィジェットは最も閲覧された文書を表示できます。
-   [ウィジェットイベント](https://doc.sitecore.com/search/ja/developers/search-developer-guide/integrating-using-rest-apis/using-the-events-api-to-track-events/widget-events.html "Widget events") - Sitecore Searchウィジェットに対する訪問者のアクション。これらのイベントには [ウィジェットビュー](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-view-event.html "Creating a widget view event") や [ウィジェットクリック](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") イベントが含まれます。

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

以下はすべてのイベントオブジェクトに必要な属性を一覧にします。

> !重要イベントごとに必要な属性は異なります。必要な属性については個別のイベントタイプをご覧ください。

名称

種類

概要

価値観

作戦

ストリング

ユーザーがイベントを発生させるために取る行動を表す動詞。イベントの種類を表すために名前で使われます。

addclickviewremoveidentifygetNoteカスタムイベントを表す動詞も使えます。

名称

ストリング

イベント名。イベントの種類を表すためにアクションと共に使われます。

価値は行動価値に伴います。

ウイド

ストリング

訪問者を追跡するために生成する匿名ID。注:すべてのイベントにはuuidまたはuser\_idが必要です。

該当なし

user\_id

ストリング

システムで使うオプションのユーザー ID。これは生成するUUIDとは異なります。注:すべてのイベントでuuidまたはuser\_idが必要です。

該当なし

価値

Object

イベントや来訪者に関する詳細を含むObject。

該当なし

value.context

Object

コンテキストオブジェクトには、ユーザー、ブラウザ、位置情報、ページに関する詳細情報が含まれます。

該当なし