Skip to content

Commit dd7d2c2

Browse files
committed
Add recommId parameter to add interaction requests
1 parent f618ca2 commit dd7d2c2

34 files changed

+200
-63
lines changed

doc/AddBookmark.html

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -158,7 +158,10 @@ <h5>Parameters:</h5>
158158
- Description: UTC timestamp of the bookmark as ISO8601-1 pattern or UTC epoch time. The default value is the current time.
159159
- *cascadeCreate*
160160
- Type: boolean
161-
- Description: Sets whether the given user/item should be created if not present in the database.</td>
161+
- Description: Sets whether the given user/item should be created if not present in the database.
162+
- *recommId*
163+
- Type: string
164+
- Description: If this bookmark is based on a recommendation request, `recommId` is the id of the clicked recommendation.</td>
162165
</tr>
163166

164167

@@ -305,7 +308,7 @@ <h4 class="name" id="bodyParameters"><span class="type-signature"></span>bodyPar
305308

306309
<dt class="tag-source">Source:</dt>
307310
<dd class="tag-source"><ul class="dummy"><li>
308-
<a href="requests_add-bookmark.js.html">requests/add-bookmark.js</a>, <a href="requests_add-bookmark.js.html#line39">line 39</a>
311+
<a href="requests_add-bookmark.js.html">requests/add-bookmark.js</a>, <a href="requests_add-bookmark.js.html#line43">line 43</a>
309312
</li></ul></dd>
310313

311314

@@ -413,7 +416,7 @@ <h4 class="name" id="queryParameters"><span class="type-signature"></span>queryP
413416

414417
<dt class="tag-source">Source:</dt>
415418
<dd class="tag-source"><ul class="dummy"><li>
416-
<a href="requests_add-bookmark.js.html">requests/add-bookmark.js</a>, <a href="requests_add-bookmark.js.html#line57">line 57</a>
419+
<a href="requests_add-bookmark.js.html">requests/add-bookmark.js</a>, <a href="requests_add-bookmark.js.html#line64">line 64</a>
417420
</li></ul></dd>
418421

419422

@@ -485,7 +488,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="AddBookma
485488
<br class="clear">
486489

487490
<footer>
488-
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Feb 19 2018 17:28:03 GMT+0100 (CET)
491+
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 10 2018 17:31:14 GMT+0200 (CEST)
489492
</footer>
490493

491494
<script> prettyPrint(); </script>

doc/AddCartAddition.html

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -164,7 +164,10 @@ <h5>Parameters:</h5>
164164
- Description: Amount (number) added to cart. The default is 1. For example if `user-x` adds two `item-y` during a single order (session...), the `amount` should equal to 2.
165165
- *price*
166166
- Type: number
167-
- Description: Price of the added item. If `amount` is greater than 1, sum of prices of all the items should be given.</td>
167+
- Description: Price of the added item. If `amount` is greater than 1, sum of prices of all the items should be given.
168+
- *recommId*
169+
- Type: string
170+
- Description: If this cart addition is based on a recommendation request, `recommId` is the id of the clicked recommendation.</td>
168171
</tr>
169172

170173

@@ -311,7 +314,7 @@ <h4 class="name" id="bodyParameters"><span class="type-signature"></span>bodyPar
311314

312315
<dt class="tag-source">Source:</dt>
313316
<dd class="tag-source"><ul class="dummy"><li>
314-
<a href="requests_add-cart-addition.js.html">requests/add-cart-addition.js</a>, <a href="requests_add-cart-addition.js.html#line47">line 47</a>
317+
<a href="requests_add-cart-addition.js.html">requests/add-cart-addition.js</a>, <a href="requests_add-cart-addition.js.html#line51">line 51</a>
315318
</li></ul></dd>
316319

317320

@@ -419,7 +422,7 @@ <h4 class="name" id="queryParameters"><span class="type-signature"></span>queryP
419422

420423
<dt class="tag-source">Source:</dt>
421424
<dd class="tag-source"><ul class="dummy"><li>
422-
<a href="requests_add-cart-addition.js.html">requests/add-cart-addition.js</a>, <a href="requests_add-cart-addition.js.html#line71">line 71</a>
425+
<a href="requests_add-cart-addition.js.html">requests/add-cart-addition.js</a>, <a href="requests_add-cart-addition.js.html#line78">line 78</a>
423426
</li></ul></dd>
424427

425428

@@ -491,7 +494,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="AddBookma
491494
<br class="clear">
492495

493496
<footer>
494-
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Feb 19 2018 17:28:03 GMT+0100 (CET)
497+
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 10 2018 17:31:14 GMT+0200 (CEST)
495498
</footer>
496499

497500
<script> prettyPrint(); </script>

doc/AddDetailView.html

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -161,7 +161,10 @@ <h5>Parameters:</h5>
161161
- Description: Duration of the view
162162
- *cascadeCreate*
163163
- Type: boolean
164-
- Description: Sets whether the given user/item should be created if not present in the database.</td>
164+
- Description: Sets whether the given user/item should be created if not present in the database.
165+
- *recommId*
166+
- Type: string
167+
- Description: If this detail view is based on a recommendation request, `recommId` is the id of the clicked recommendation.</td>
165168
</tr>
166169

167170

@@ -308,7 +311,7 @@ <h4 class="name" id="bodyParameters"><span class="type-signature"></span>bodyPar
308311

309312
<dt class="tag-source">Source:</dt>
310313
<dd class="tag-source"><ul class="dummy"><li>
311-
<a href="requests_add-detail-view.js.html">requests/add-detail-view.js</a>, <a href="requests_add-detail-view.js.html#line43">line 43</a>
314+
<a href="requests_add-detail-view.js.html">requests/add-detail-view.js</a>, <a href="requests_add-detail-view.js.html#line47">line 47</a>
312315
</li></ul></dd>
313316

314317

@@ -416,7 +419,7 @@ <h4 class="name" id="queryParameters"><span class="type-signature"></span>queryP
416419

417420
<dt class="tag-source">Source:</dt>
418421
<dd class="tag-source"><ul class="dummy"><li>
419-
<a href="requests_add-detail-view.js.html">requests/add-detail-view.js</a>, <a href="requests_add-detail-view.js.html#line64">line 64</a>
422+
<a href="requests_add-detail-view.js.html">requests/add-detail-view.js</a>, <a href="requests_add-detail-view.js.html#line71">line 71</a>
420423
</li></ul></dd>
421424

422425

@@ -488,7 +491,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="AddBookma
488491
<br class="clear">
489492

490493
<footer>
491-
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Feb 19 2018 17:28:03 GMT+0100 (CET)
494+
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 10 2018 17:31:14 GMT+0200 (CEST)
492495
</footer>
493496

494497
<script> prettyPrint(); </script>

doc/AddItemProperty.html

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -128,7 +128,15 @@ <h5>Parameters:</h5>
128128

129129

130130

131-
<td class="description last">Value type of the item property to be created. One of: `int`, `double`, `string`, `boolean`, `timestamp`, `set`, `image` or `imageList`.</td>
131+
<td class="description last">Value type of the item property to be created. One of: `int`, `double`, `string`, `boolean`, `timestamp`, `set`, `image` or `imageList`.
132+
* `int`- Signed integer number.
133+
* `double` - Floating point number. It uses 64-bit base-2 format (IEEE 754 standard).
134+
* `string` - UTF-8 string.
135+
* `boolean` - *true* / *false*
136+
* `timestamp` - Value representing date and time.
137+
* `set` - Set of strings.
138+
* `image` - URL of an image (`jpeg`, `png` or `gif`).
139+
* `imageList` - List of URLs that refer to images.</td>
132140
</tr>
133141

134142

@@ -275,7 +283,7 @@ <h4 class="name" id="bodyParameters"><span class="type-signature"></span>bodyPar
275283

276284
<dt class="tag-source">Source:</dt>
277285
<dd class="tag-source"><ul class="dummy"><li>
278-
<a href="requests_add-item-property.js.html">requests/add-item-property.js</a>, <a href="requests_add-item-property.js.html#line28">line 28</a>
286+
<a href="requests_add-item-property.js.html">requests/add-item-property.js</a>, <a href="requests_add-item-property.js.html#line36">line 36</a>
279287
</li></ul></dd>
280288

281289

@@ -383,7 +391,7 @@ <h4 class="name" id="queryParameters"><span class="type-signature"></span>queryP
383391

384392
<dt class="tag-source">Source:</dt>
385393
<dd class="tag-source"><ul class="dummy"><li>
386-
<a href="requests_add-item-property.js.html">requests/add-item-property.js</a>, <a href="requests_add-item-property.js.html#line38">line 38</a>
394+
<a href="requests_add-item-property.js.html">requests/add-item-property.js</a>, <a href="requests_add-item-property.js.html#line46">line 46</a>
387395
</li></ul></dd>
388396

389397

@@ -455,7 +463,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="AddBookma
455463
<br class="clear">
456464

457465
<footer>
458-
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Apr 05 2018 17:17:21 GMT+0200 (CEST)
466+
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 10 2018 17:31:14 GMT+0200 (CEST)
459467
</footer>
460468

461469
<script> prettyPrint(); </script>

doc/AddPurchase.html

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -167,7 +167,10 @@ <h5>Parameters:</h5>
167167
- Description: Price paid by the user for the item. If `amount` is greater than 1, sum of prices of all the items should be given.
168168
- *profit*
169169
- Type: number
170-
- Description: Your profit from the purchased item. The profit is natural in e-commerce domain (for example if `user-x` purchases `item-y` for $100 and the gross margin is 30 %, then the profit is $30), but is applicable also in other domains (for example at a news company it may be income from displayed advertisement on article page). If `amount` is greater than 1, sum of profit of all the items should be given.</td>
170+
- Description: Your profit from the purchased item. The profit is natural in e-commerce domain (for example if `user-x` purchases `item-y` for $100 and the gross margin is 30 %, then the profit is $30), but is applicable also in other domains (for example at a news company it may be income from displayed advertisement on article page). If `amount` is greater than 1, sum of profit of all the items should be given.
171+
- *recommId*
172+
- Type: string
173+
- Description: If this purchase is based on a recommendation request, `recommId` is the id of the clicked recommendation.</td>
171174
</tr>
172175

173176

@@ -314,7 +317,7 @@ <h4 class="name" id="bodyParameters"><span class="type-signature"></span>bodyPar
314317

315318
<dt class="tag-source">Source:</dt>
316319
<dd class="tag-source"><ul class="dummy"><li>
317-
<a href="requests_add-purchase.js.html">requests/add-purchase.js</a>, <a href="requests_add-purchase.js.html#line51">line 51</a>
320+
<a href="requests_add-purchase.js.html">requests/add-purchase.js</a>, <a href="requests_add-purchase.js.html#line55">line 55</a>
318321
</li></ul></dd>
319322

320323

@@ -422,7 +425,7 @@ <h4 class="name" id="queryParameters"><span class="type-signature"></span>queryP
422425

423426
<dt class="tag-source">Source:</dt>
424427
<dd class="tag-source"><ul class="dummy"><li>
425-
<a href="requests_add-purchase.js.html">requests/add-purchase.js</a>, <a href="requests_add-purchase.js.html#line78">line 78</a>
428+
<a href="requests_add-purchase.js.html">requests/add-purchase.js</a>, <a href="requests_add-purchase.js.html#line85">line 85</a>
426429
</li></ul></dd>
427430

428431

@@ -494,7 +497,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="AddBookma
494497
<br class="clear">
495498

496499
<footer>
497-
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Feb 19 2018 17:28:03 GMT+0100 (CET)
500+
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 10 2018 17:31:14 GMT+0200 (CEST)
498501
</footer>
499502

500503
<script> prettyPrint(); </script>

doc/AddRating.html

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -181,7 +181,10 @@ <h5>Parameters:</h5>
181181
- Description: UTC timestamp of the rating as ISO8601-1 pattern or UTC epoch time. The default value is the current time.
182182
- *cascadeCreate*
183183
- Type: boolean
184-
- Description: Sets whether the given user/item should be created if not present in the database.</td>
184+
- Description: Sets whether the given user/item should be created if not present in the database.
185+
- *recommId*
186+
- Type: string
187+
- Description: If this rating is based on a recommendation request, `recommId` is the id of the clicked recommendation.</td>
185188
</tr>
186189

187190

@@ -328,7 +331,7 @@ <h4 class="name" id="bodyParameters"><span class="type-signature"></span>bodyPar
328331

329332
<dt class="tag-source">Source:</dt>
330333
<dd class="tag-source"><ul class="dummy"><li>
331-
<a href="requests_add-rating.js.html">requests/add-rating.js</a>, <a href="requests_add-rating.js.html#line41">line 41</a>
334+
<a href="requests_add-rating.js.html">requests/add-rating.js</a>, <a href="requests_add-rating.js.html#line45">line 45</a>
332335
</li></ul></dd>
333336

334337

@@ -436,7 +439,7 @@ <h4 class="name" id="queryParameters"><span class="type-signature"></span>queryP
436439

437440
<dt class="tag-source">Source:</dt>
438441
<dd class="tag-source"><ul class="dummy"><li>
439-
<a href="requests_add-rating.js.html">requests/add-rating.js</a>, <a href="requests_add-rating.js.html#line60">line 60</a>
442+
<a href="requests_add-rating.js.html">requests/add-rating.js</a>, <a href="requests_add-rating.js.html#line67">line 67</a>
440443
</li></ul></dd>
441444

442445

@@ -508,7 +511,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="AddBookma
508511
<br class="clear">
509512

510513
<footer>
511-
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Feb 19 2018 17:28:03 GMT+0100 (CET)
514+
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 10 2018 17:31:14 GMT+0200 (CEST)
512515
</footer>
513516

514517
<script> prettyPrint(); </script>

doc/AddUserProperty.html

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -128,7 +128,13 @@ <h5>Parameters:</h5>
128128

129129

130130

131-
<td class="description last">Value type of the user property to be created. One of: `int`, `double`, `string`, `boolean`, `timestamp`, `set`</td>
131+
<td class="description last">Value type of the user property to be created. One of: `int`, `double`, `string`, `boolean`, `timestamp`, `set`.
132+
* `int` - Signed integer number.
133+
* `double` - Floating point number. It uses 64-bit base-2 format (IEEE 754 standard).
134+
* `string` - UTF-8 string.
135+
* `boolean` - *true* / *false*
136+
* `timestamp` - Value representing date and time.
137+
* `set` - Set of strings.</td>
132138
</tr>
133139

134140

@@ -275,7 +281,7 @@ <h4 class="name" id="bodyParameters"><span class="type-signature"></span>bodyPar
275281

276282
<dt class="tag-source">Source:</dt>
277283
<dd class="tag-source"><ul class="dummy"><li>
278-
<a href="requests_add-user-property.js.html">requests/add-user-property.js</a>, <a href="requests_add-user-property.js.html#line28">line 28</a>
284+
<a href="requests_add-user-property.js.html">requests/add-user-property.js</a>, <a href="requests_add-user-property.js.html#line34">line 34</a>
279285
</li></ul></dd>
280286

281287

@@ -383,7 +389,7 @@ <h4 class="name" id="queryParameters"><span class="type-signature"></span>queryP
383389

384390
<dt class="tag-source">Source:</dt>
385391
<dd class="tag-source"><ul class="dummy"><li>
386-
<a href="requests_add-user-property.js.html">requests/add-user-property.js</a>, <a href="requests_add-user-property.js.html#line38">line 38</a>
392+
<a href="requests_add-user-property.js.html">requests/add-user-property.js</a>, <a href="requests_add-user-property.js.html#line44">line 44</a>
387393
</li></ul></dd>
388394

389395

@@ -455,7 +461,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="AddBookma
455461
<br class="clear">
456462

457463
<footer>
458-
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Feb 19 2018 17:28:03 GMT+0100 (CET)
464+
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 10 2018 17:31:14 GMT+0200 (CEST)
459465
</footer>
460466

461467
<script> prettyPrint(); </script>

doc/ItemBasedRecommendation.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -228,10 +228,10 @@ <h5>Parameters:</h5>
228228
- Description: **Expert option** If the *targetUserId* is provided: Specifies the threshold of how much relevant must the recommended items be to the user. Possible values one of: "low", "medium", "high". The default value is "low", meaning that the system attempts to recommend number of items equal to *count* at any cost. If there are not enough data (such as interactions or item properties), this may even lead to bestseller-based recommendations to be appended to reach the full *count*. This behavior may be suppressed by using "medium" or "high" values. In such case, the system only recommends items of at least the requested qualit, and may return less than *count* items when there is not enough data to fulfill it.
229229
- *rotationRate*
230230
- Type: number
231-
- Description: **Expert option** If the *targetUserId* is provided: If your users browse the system in real-time, it may easily happen that you wish to offer them recommendations multiple times. Here comes the question: how much should the recommendations change? Should they remain the same, or should they rotate? Recombee API allows you to control this per-request in backward fashion. You may penalize an item for being recommended in the near past. For the specific user, `rotationRate=1` means maximal rotation, `rotationRate=0` means absolutely no rotation. You may also use, for example `rotationRate=0.2` for only slight rotation of recommended items.
231+
- Description: **Expert option** If the *targetUserId* is provided: If your users browse the system in real-time, it may easily happen that you wish to offer them recommendations multiple times. Here comes the question: how much should the recommendations change? Should they remain the same, or should they rotate? Recombee API allows you to control this per-request in backward fashion. You may penalize an item for being recommended in the near past. For the specific user, `rotationRate=1` means maximal rotation, `rotationRate=0` means absolutely no rotation. You may also use, for example `rotationRate=0.2` for only slight rotation of recommended items. Default: `0.01`.
232232
- *rotationTime*
233233
- Type: number
234-
- Description: **Expert option** If the *targetUserId* is provided: Taking *rotationRate* into account, specifies how long time it takes to an item to recover from the penalization. For example, `rotationTime=7200.0` means that items recommended less than 2 hours ago are penalized.
234+
- Description: **Expert option** If the *targetUserId* is provided: Taking *rotationRate* into account, specifies how long time it takes to an item to recover from the penalization. For example, `rotationTime=7200.0` means that items recommended less than 2 hours ago are penalized. Default: `7200.0`.
235235
- *expertSettings*
236236
- Type:
237237
- Description: Dictionary of custom options.</td>
@@ -563,7 +563,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="AddBookma
563563
<br class="clear">
564564

565565
<footer>
566-
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Feb 19 2018 17:28:03 GMT+0100 (CET)
566+
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Mon Sep 10 2018 17:31:14 GMT+0200 (CEST)
567567
</footer>
568568

569569
<script> prettyPrint(); </script>

0 commit comments

Comments
 (0)