You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _search-plugins/ubi/index.md
+49-24
Original file line number
Diff line number
Diff line change
@@ -14,38 +14,63 @@ redirect_from:
14
14
**References UBI Specification 1.2.0**
15
15
{: .label .label-purple }
16
16
17
-
User Behavior Insights (UBI) is a project for capturing client-side events and queries for the purposes of improving search relevance and the user experience.
17
+
User Behavior Insights (UBI) is a standard for capturing client-side events and queries for the purposes of improving search relevance and the user experience.
18
18
It is a *causal* system, linking a user's query to all of their subsequent interactions with your application until they perform another search.
19
19
This differs from many systems that infer the linking of search to events through *chronological* sequence.
20
20
21
-
UBI includes the following elements:
22
-
* A machine-readable [schema](https://github.com/o19s/ubi) that faciliates interoperablity of the UBI specification.
23
-
* An OpenSearch [plugin](https://github.com/opensearch-project/user-behavior-insights) that facilitates the storage of client-side events and queries.
24
-
* A client-side JavaScript [reference implementation](https://github.com/opensearch-project/user-behavior-insights/tree/main/ubi-javascript-collector/ubi.js) that shows how to capture searches and events.
25
-
26
-
<!-- vale off -->
27
21
28
-
The UBI documentation is organized into two categories: *Explanation and reference* and *Tutorials and how-to guides*:
22
+
> “how our users are using our product, whether search results were useful for them and whether they clicked on top-n results we gave and all related stuff” - Data Scientist
29
23
30
-
*Explanation and reference*
31
-
32
-
| Link | Description |
33
-
| :--------- | :------- |
34
-
|[UBISearch.dev](https://UBISearch.dev)| The User Behavior Insights community website. |
35
-
|[UBI Request/Response Specification](https://github.com/o19s/ubi/)| The industry-standard schema for UBI requests and responses. The current version references UBI Specification 1.2.0. |
36
-
|[UBI index schema]({{site.url}}{{site.baseurl}}/search-plugins/ubi/schemas/)| Documentation on the individual OpenSearch query and event stores. |
24
+
UBI includes the following elements:
25
+
*[ubi.js](https://github.com/opensearch-project/user-behavior-insights/tree/main/ubi-javascript-collector/ubi.js): a client-side JavaScript library that captures searches and events.
26
+
* A machine-readable [schema](https://github.com/o19s/ubi) that faciliates interoperablity of the UBI specification.
27
+
* An (optional!) OpenSearch [plugin](https://github.com/opensearch-project/user-behavior-insights) that streamlines the recording of query data.
37
28
29
+
Advanced features in OpenSearch, such as the Search Quality Evaluation Framework, and the Hybrid Search Optimizer all build on the UBI specification.
38
30
39
-
*Tutorials and how-to guides*
31
+
<!-- vale off -->
40
32
41
-
| Link | Description |
42
-
| :--------- | :------- |
43
-
|[UBI plugin](https://github.com/opensearch-project/user-behavior-insights)| How to install and use the UBI plugin. |
44
-
|[UBI JavaScript Collector]({{site.url}}{{site.baseurl}}/search-plugins/ubi/ubi-javascript-collector/)| Clientside JavaScript library to capture events. |
45
-
|[Example UBI query DSL queries]({{site.url}}{{site.baseurl}}/search-plugins/ubi/dsl-queries/)| How to write queries for UBI data in OpenSearch query DSL. |
46
-
|[Example UBI SQL queries]({{site.url}}{{site.baseurl}}/search-plugins/ubi/sql-queries/)| How to write analytic queries for UBI data in SQL. |
47
-
|[UBI dashboard tutorial]({{site.url}}{{site.baseurl}}/search-plugins/ubi/ubi-dashboard-tutorial/)| How to build a dashboard containing UBI data. |
48
-
|[Chorus Opensearch Edition](https://github.com/o19s/chorus-opensearch-edition/?tab=readme-ov-file#structured-learning-using-chorus-opensearch-edition) katas | A series of structured tutorials that teach you how to use UBI with OpenSearch through a demo e-commerce store. |
33
+
<table>
34
+
<tr style="vertical-align: top;">
35
+
<td>
36
+
<h2>Tutorials</h2>
37
+
<ul>
38
+
<li><a href="#">Learn to use <code>ubi.js</code></a></li>
39
+
<li><a href="#">Using OpenSearch Ingestion from AWS with UBI</a></li>
40
+
<li><a href="#">Link 3</a></li>
41
+
</ul>
42
+
</td>
43
+
<td>
44
+
<h2>How To Guides</h2>
45
+
<ul>
46
+
<li><a href="https://github.com/opensearch-project/user-behavior-insights">How to install and use the UBI plugin</a><b>do we keep this</b></li>
47
+
<li><a href="{{site.url}}{{site.baseurl}}/search-plugins/ubi/ubi-dashboard-tutorial/">How to build a custom dashboard with UBI data.</a></li>
48
+
<li><a href="{{site.url}}{{site.baseurl}}/search-plugins/ubi/dsl-queries/">How to write queries for UBI data in OpenSearch query DSL.</a></li>
49
+
<li><a href="{{site.url}}{{site.baseurl}}/search-plugins/ubi/sql-queries/">How to write analytic queries for UBI data in SQL.</a></li>
50
+
<li><a href="https://github.com/o19s/chorus-opensearch-edition/blob/main/katas/006_protecting_sensitive_information.md">How to protect sensistive information when using UBI.</a> <small>Part of Chorus series.</small></li>
0 commit comments