@algolia/client-analytics 5.0.0-alpha.73 → 5.0.0-alpha.75

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (87) hide show
  1. package/dist/client-analytics.cjs.js +114 -116
  2. package/dist/client-analytics.esm.browser.js +114 -114
  3. package/dist/client-analytics.esm.node.js +114 -114
  4. package/dist/client-analytics.umd.js +2 -2
  5. package/dist/model/averageClickEvent.d.ts +3 -3
  6. package/dist/model/clickPosition.d.ts +2 -2
  7. package/dist/model/clickThroughRateEvent.d.ts +4 -4
  8. package/dist/model/clientMethodProps.d.ts +91 -91
  9. package/dist/model/conversionRateEvent.d.ts +4 -4
  10. package/dist/model/getAverageClickPositionResponse.d.ts +3 -3
  11. package/dist/model/getClickPositionsResponse.d.ts +1 -1
  12. package/dist/model/getClickThroughRateResponse.d.ts +4 -4
  13. package/dist/model/getConversationRateResponse.d.ts +4 -4
  14. package/dist/model/getNoClickRateResponse.d.ts +4 -4
  15. package/dist/model/getNoResultsRateResponse.d.ts +4 -4
  16. package/dist/model/getSearchesCountResponse.d.ts +2 -2
  17. package/dist/model/getSearchesNoClicksResponse.d.ts +1 -1
  18. package/dist/model/getSearchesNoResultsResponse.d.ts +1 -1
  19. package/dist/model/getStatusResponse.d.ts +1 -1
  20. package/dist/model/getTopCountriesResponse.d.ts +1 -1
  21. package/dist/model/getTopFilterAttribute.d.ts +2 -2
  22. package/dist/model/getTopFilterAttributesResponse.d.ts +1 -1
  23. package/dist/model/getTopFilterForAttribute.d.ts +4 -4
  24. package/dist/model/getTopFilterForAttributeResponse.d.ts +1 -1
  25. package/dist/model/getTopFiltersNoResultsResponse.d.ts +1 -1
  26. package/dist/model/getTopFiltersNoResultsValue.d.ts +3 -3
  27. package/dist/model/getTopFiltersNoResultsValues.d.ts +2 -2
  28. package/dist/model/getUsersCountResponse.d.ts +2 -2
  29. package/dist/model/noClickRateEvent.d.ts +4 -4
  30. package/dist/model/noResultsRateEvent.d.ts +4 -4
  31. package/dist/model/orderBy.d.ts +3 -0
  32. package/dist/model/orderBy.d.ts.map +1 -1
  33. package/dist/model/searchEvent.d.ts +2 -2
  34. package/dist/model/searchNoClickEvent.d.ts +3 -3
  35. package/dist/model/searchNoResultEvent.d.ts +3 -3
  36. package/dist/model/topCountry.d.ts +2 -2
  37. package/dist/model/topHit.d.ts +2 -2
  38. package/dist/model/topHitWithAnalytics.d.ts +7 -7
  39. package/dist/model/topHitsResponse.d.ts +1 -1
  40. package/dist/model/topHitsResponseWithAnalytics.d.ts +1 -1
  41. package/dist/model/topSearch.d.ts +3 -3
  42. package/dist/model/topSearchWithAnalytics.d.ts +9 -9
  43. package/dist/model/topSearchesResponse.d.ts +1 -1
  44. package/dist/model/topSearchesResponseWithAnalytics.d.ts +1 -1
  45. package/dist/model/userWithDate.d.ts +2 -2
  46. package/dist/src/analyticsClient.d.ts +114 -114
  47. package/model/averageClickEvent.ts +3 -3
  48. package/model/clickPosition.ts +2 -2
  49. package/model/clickThroughRateEvent.ts +4 -4
  50. package/model/clientMethodProps.ts +91 -91
  51. package/model/conversionRateEvent.ts +4 -4
  52. package/model/getAverageClickPositionResponse.ts +3 -3
  53. package/model/getClickPositionsResponse.ts +1 -1
  54. package/model/getClickThroughRateResponse.ts +4 -4
  55. package/model/getConversationRateResponse.ts +4 -4
  56. package/model/getNoClickRateResponse.ts +4 -4
  57. package/model/getNoResultsRateResponse.ts +4 -4
  58. package/model/getSearchesCountResponse.ts +2 -2
  59. package/model/getSearchesNoClicksResponse.ts +1 -1
  60. package/model/getSearchesNoResultsResponse.ts +1 -1
  61. package/model/getStatusResponse.ts +1 -1
  62. package/model/getTopCountriesResponse.ts +1 -1
  63. package/model/getTopFilterAttribute.ts +2 -2
  64. package/model/getTopFilterAttributesResponse.ts +1 -1
  65. package/model/getTopFilterForAttribute.ts +4 -4
  66. package/model/getTopFilterForAttributeResponse.ts +1 -1
  67. package/model/getTopFiltersNoResultsResponse.ts +1 -1
  68. package/model/getTopFiltersNoResultsValue.ts +3 -3
  69. package/model/getTopFiltersNoResultsValues.ts +2 -2
  70. package/model/getUsersCountResponse.ts +2 -2
  71. package/model/noClickRateEvent.ts +4 -4
  72. package/model/noResultsRateEvent.ts +4 -4
  73. package/model/orderBy.ts +3 -0
  74. package/model/searchEvent.ts +2 -2
  75. package/model/searchNoClickEvent.ts +3 -3
  76. package/model/searchNoResultEvent.ts +3 -3
  77. package/model/topCountry.ts +2 -2
  78. package/model/topHit.ts +2 -2
  79. package/model/topHitWithAnalytics.ts +7 -7
  80. package/model/topHitsResponse.ts +1 -1
  81. package/model/topHitsResponseWithAnalytics.ts +1 -1
  82. package/model/topSearch.ts +3 -3
  83. package/model/topSearchWithAnalytics.ts +9 -9
  84. package/model/topSearchesResponse.ts +1 -1
  85. package/model/topSearchesResponseWithAnalytics.ts +1 -1
  86. package/model/userWithDate.ts +2 -2
  87. package/package.json +8 -7
@@ -8,11 +8,11 @@ import type { OrderBy } from './orderBy';
8
8
  */
9
9
  export type DelProps = {
10
10
  /**
11
- * The path of the API endpoint to target, anything after the /1 needs to be specified.
11
+ * Path of the endpoint, anything after \"/1\" must be specified.
12
12
  */
13
13
  path: string;
14
14
  /**
15
- * Query parameters to be applied to the current query.
15
+ * Query parameters to apply to the current query.
16
16
  */
17
17
  parameters?: Record<string, any>;
18
18
  };
@@ -22,11 +22,11 @@ export type DelProps = {
22
22
  */
23
23
  export type GetProps = {
24
24
  /**
25
- * The path of the API endpoint to target, anything after the /1 needs to be specified.
25
+ * Path of the endpoint, anything after \"/1\" must be specified.
26
26
  */
27
27
  path: string;
28
28
  /**
29
- * Query parameters to be applied to the current query.
29
+ * Query parameters to apply to the current query.
30
30
  */
31
31
  parameters?: Record<string, any>;
32
32
  };
@@ -36,19 +36,19 @@ export type GetProps = {
36
36
  */
37
37
  export type GetAverageClickPositionProps = {
38
38
  /**
39
- * The index name to target.
39
+ * Index name to target.
40
40
  */
41
41
  index: string;
42
42
  /**
43
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
43
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
44
44
  */
45
45
  startDate?: string;
46
46
  /**
47
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
47
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
48
48
  */
49
49
  endDate?: string;
50
50
  /**
51
- * Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
51
+ * Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
52
52
  */
53
53
  tags?: string;
54
54
  };
@@ -58,19 +58,19 @@ export type GetAverageClickPositionProps = {
58
58
  */
59
59
  export type GetClickPositionsProps = {
60
60
  /**
61
- * The index name to target.
61
+ * Index name to target.
62
62
  */
63
63
  index: string;
64
64
  /**
65
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
65
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
66
66
  */
67
67
  startDate?: string;
68
68
  /**
69
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
69
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
70
70
  */
71
71
  endDate?: string;
72
72
  /**
73
- * Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
73
+ * Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
74
74
  */
75
75
  tags?: string;
76
76
  };
@@ -80,19 +80,19 @@ export type GetClickPositionsProps = {
80
80
  */
81
81
  export type GetClickThroughRateProps = {
82
82
  /**
83
- * The index name to target.
83
+ * Index name to target.
84
84
  */
85
85
  index: string;
86
86
  /**
87
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
87
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
88
88
  */
89
89
  startDate?: string;
90
90
  /**
91
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
91
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
92
92
  */
93
93
  endDate?: string;
94
94
  /**
95
- * Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
95
+ * Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
96
96
  */
97
97
  tags?: string;
98
98
  };
@@ -102,19 +102,19 @@ export type GetClickThroughRateProps = {
102
102
  */
103
103
  export type GetConversationRateProps = {
104
104
  /**
105
- * The index name to target.
105
+ * Index name to target.
106
106
  */
107
107
  index: string;
108
108
  /**
109
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
109
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
110
110
  */
111
111
  startDate?: string;
112
112
  /**
113
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
113
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
114
114
  */
115
115
  endDate?: string;
116
116
  /**
117
- * Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
117
+ * Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
118
118
  */
119
119
  tags?: string;
120
120
  };
@@ -124,19 +124,19 @@ export type GetConversationRateProps = {
124
124
  */
125
125
  export type GetNoClickRateProps = {
126
126
  /**
127
- * The index name to target.
127
+ * Index name to target.
128
128
  */
129
129
  index: string;
130
130
  /**
131
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
131
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
132
132
  */
133
133
  startDate?: string;
134
134
  /**
135
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
135
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
136
136
  */
137
137
  endDate?: string;
138
138
  /**
139
- * Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
139
+ * Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
140
140
  */
141
141
  tags?: string;
142
142
  };
@@ -146,19 +146,19 @@ export type GetNoClickRateProps = {
146
146
  */
147
147
  export type GetNoResultsRateProps = {
148
148
  /**
149
- * The index name to target.
149
+ * Index name to target.
150
150
  */
151
151
  index: string;
152
152
  /**
153
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
153
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
154
154
  */
155
155
  startDate?: string;
156
156
  /**
157
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
157
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
158
158
  */
159
159
  endDate?: string;
160
160
  /**
161
- * Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
161
+ * Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
162
162
  */
163
163
  tags?: string;
164
164
  };
@@ -168,19 +168,19 @@ export type GetNoResultsRateProps = {
168
168
  */
169
169
  export type GetSearchesCountProps = {
170
170
  /**
171
- * The index name to target.
171
+ * Index name to target.
172
172
  */
173
173
  index: string;
174
174
  /**
175
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
175
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
176
176
  */
177
177
  startDate?: string;
178
178
  /**
179
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
179
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
180
180
  */
181
181
  endDate?: string;
182
182
  /**
183
- * Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
183
+ * Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
184
184
  */
185
185
  tags?: string;
186
186
  };
@@ -190,19 +190,19 @@ export type GetSearchesCountProps = {
190
190
  */
191
191
  export type GetSearchesNoClicksProps = {
192
192
  /**
193
- * The index name to target.
193
+ * Index name to target.
194
194
  */
195
195
  index: string;
196
196
  /**
197
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
197
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
198
198
  */
199
199
  startDate?: string;
200
200
  /**
201
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
201
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
202
202
  */
203
203
  endDate?: string;
204
204
  /**
205
- * Number of records to return. Limit is the size of the page.
205
+ * Number of records to return (page size).
206
206
  */
207
207
  limit?: number;
208
208
  /**
@@ -210,7 +210,7 @@ export type GetSearchesNoClicksProps = {
210
210
  */
211
211
  offset?: number;
212
212
  /**
213
- * Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
213
+ * Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
214
214
  */
215
215
  tags?: string;
216
216
  };
@@ -220,19 +220,19 @@ export type GetSearchesNoClicksProps = {
220
220
  */
221
221
  export type GetSearchesNoResultsProps = {
222
222
  /**
223
- * The index name to target.
223
+ * Index name to target.
224
224
  */
225
225
  index: string;
226
226
  /**
227
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
227
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
228
228
  */
229
229
  startDate?: string;
230
230
  /**
231
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
231
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
232
232
  */
233
233
  endDate?: string;
234
234
  /**
235
- * Number of records to return. Limit is the size of the page.
235
+ * Number of records to return (page size).
236
236
  */
237
237
  limit?: number;
238
238
  /**
@@ -240,7 +240,7 @@ export type GetSearchesNoResultsProps = {
240
240
  */
241
241
  offset?: number;
242
242
  /**
243
- * Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
243
+ * Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
244
244
  */
245
245
  tags?: string;
246
246
  };
@@ -250,7 +250,7 @@ export type GetSearchesNoResultsProps = {
250
250
  */
251
251
  export type GetStatusProps = {
252
252
  /**
253
- * The index name to target.
253
+ * Index name to target.
254
254
  */
255
255
  index: string;
256
256
  };
@@ -260,19 +260,19 @@ export type GetStatusProps = {
260
260
  */
261
261
  export type GetTopCountriesProps = {
262
262
  /**
263
- * The index name to target.
263
+ * Index name to target.
264
264
  */
265
265
  index: string;
266
266
  /**
267
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
267
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
268
268
  */
269
269
  startDate?: string;
270
270
  /**
271
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
271
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
272
272
  */
273
273
  endDate?: string;
274
274
  /**
275
- * Number of records to return. Limit is the size of the page.
275
+ * Number of records to return (page size).
276
276
  */
277
277
  limit?: number;
278
278
  /**
@@ -280,7 +280,7 @@ export type GetTopCountriesProps = {
280
280
  */
281
281
  offset?: number;
282
282
  /**
283
- * Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
283
+ * Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
284
284
  */
285
285
  tags?: string;
286
286
  };
@@ -290,23 +290,23 @@ export type GetTopCountriesProps = {
290
290
  */
291
291
  export type GetTopFilterAttributesProps = {
292
292
  /**
293
- * The index name to target.
293
+ * Index name to target.
294
294
  */
295
295
  index: string;
296
296
  /**
297
- * The query term to search for. Must match the exact user input.
297
+ * User query.
298
298
  */
299
299
  search?: string;
300
300
  /**
301
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
301
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
302
302
  */
303
303
  startDate?: string;
304
304
  /**
305
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
305
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
306
306
  */
307
307
  endDate?: string;
308
308
  /**
309
- * Number of records to return. Limit is the size of the page.
309
+ * Number of records to return (page size).
310
310
  */
311
311
  limit?: number;
312
312
  /**
@@ -314,7 +314,7 @@ export type GetTopFilterAttributesProps = {
314
314
  */
315
315
  offset?: number;
316
316
  /**
317
- * Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
317
+ * Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
318
318
  */
319
319
  tags?: string;
320
320
  };
@@ -324,27 +324,27 @@ export type GetTopFilterAttributesProps = {
324
324
  */
325
325
  export type GetTopFilterForAttributeProps = {
326
326
  /**
327
- * The exact name of the attribute.
327
+ * Attribute name.
328
328
  */
329
329
  attribute: string;
330
330
  /**
331
- * The index name to target.
331
+ * Index name to target.
332
332
  */
333
333
  index: string;
334
334
  /**
335
- * The query term to search for. Must match the exact user input.
335
+ * User query.
336
336
  */
337
337
  search?: string;
338
338
  /**
339
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
339
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
340
340
  */
341
341
  startDate?: string;
342
342
  /**
343
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
343
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
344
344
  */
345
345
  endDate?: string;
346
346
  /**
347
- * Number of records to return. Limit is the size of the page.
347
+ * Number of records to return (page size).
348
348
  */
349
349
  limit?: number;
350
350
  /**
@@ -352,7 +352,7 @@ export type GetTopFilterForAttributeProps = {
352
352
  */
353
353
  offset?: number;
354
354
  /**
355
- * Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
355
+ * Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
356
356
  */
357
357
  tags?: string;
358
358
  };
@@ -362,23 +362,23 @@ export type GetTopFilterForAttributeProps = {
362
362
  */
363
363
  export type GetTopFiltersNoResultsProps = {
364
364
  /**
365
- * The index name to target.
365
+ * Index name to target.
366
366
  */
367
367
  index: string;
368
368
  /**
369
- * The query term to search for. Must match the exact user input.
369
+ * User query.
370
370
  */
371
371
  search?: string;
372
372
  /**
373
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
373
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
374
374
  */
375
375
  startDate?: string;
376
376
  /**
377
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
377
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
378
378
  */
379
379
  endDate?: string;
380
380
  /**
381
- * Number of records to return. Limit is the size of the page.
381
+ * Number of records to return (page size).
382
382
  */
383
383
  limit?: number;
384
384
  /**
@@ -386,7 +386,7 @@ export type GetTopFiltersNoResultsProps = {
386
386
  */
387
387
  offset?: number;
388
388
  /**
389
- * Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
389
+ * Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
390
390
  */
391
391
  tags?: string;
392
392
  };
@@ -396,27 +396,27 @@ export type GetTopFiltersNoResultsProps = {
396
396
  */
397
397
  export type GetTopHitsProps = {
398
398
  /**
399
- * The index name to target.
399
+ * Index name to target.
400
400
  */
401
401
  index: string;
402
402
  /**
403
- * The query term to search for. Must match the exact user input.
403
+ * User query.
404
404
  */
405
405
  search?: string;
406
406
  /**
407
- * Whether to include the click-through and conversion rates for a search.
407
+ * Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
408
408
  */
409
409
  clickAnalytics?: boolean;
410
410
  /**
411
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
411
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
412
412
  */
413
413
  startDate?: string;
414
414
  /**
415
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
415
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
416
416
  */
417
417
  endDate?: string;
418
418
  /**
419
- * Number of records to return. Limit is the size of the page.
419
+ * Number of records to return (page size).
420
420
  */
421
421
  limit?: number;
422
422
  /**
@@ -424,7 +424,7 @@ export type GetTopHitsProps = {
424
424
  */
425
425
  offset?: number;
426
426
  /**
427
- * Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
427
+ * Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
428
428
  */
429
429
  tags?: string;
430
430
  };
@@ -434,19 +434,19 @@ export type GetTopHitsProps = {
434
434
  */
435
435
  export type GetTopSearchesProps = {
436
436
  /**
437
- * The index name to target.
437
+ * Index name to target.
438
438
  */
439
439
  index: string;
440
440
  /**
441
- * Whether to include the click-through and conversion rates for a search.
441
+ * Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
442
442
  */
443
443
  clickAnalytics?: boolean;
444
444
  /**
445
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
445
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
446
446
  */
447
447
  startDate?: string;
448
448
  /**
449
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
449
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
450
450
  */
451
451
  endDate?: string;
452
452
  /**
@@ -454,11 +454,11 @@ export type GetTopSearchesProps = {
454
454
  */
455
455
  orderBy?: OrderBy;
456
456
  /**
457
- * The sorting of the result.
457
+ * Sorting direction of the results: ascending or descending.
458
458
  */
459
459
  direction?: Direction;
460
460
  /**
461
- * Number of records to return. Limit is the size of the page.
461
+ * Number of records to return (page size).
462
462
  */
463
463
  limit?: number;
464
464
  /**
@@ -466,7 +466,7 @@ export type GetTopSearchesProps = {
466
466
  */
467
467
  offset?: number;
468
468
  /**
469
- * Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
469
+ * Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
470
470
  */
471
471
  tags?: string;
472
472
  };
@@ -476,19 +476,19 @@ export type GetTopSearchesProps = {
476
476
  */
477
477
  export type GetUsersCountProps = {
478
478
  /**
479
- * The index name to target.
479
+ * Index name to target.
480
480
  */
481
481
  index: string;
482
482
  /**
483
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
483
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
484
484
  */
485
485
  startDate?: string;
486
486
  /**
487
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
487
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
488
488
  */
489
489
  endDate?: string;
490
490
  /**
491
- * Filter metrics on the provided tags. Each tag must correspond to an analyticsTags set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it should be URL encoded.
491
+ * Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
492
492
  */
493
493
  tags?: string;
494
494
  };
@@ -498,15 +498,15 @@ export type GetUsersCountProps = {
498
498
  */
499
499
  export type PostProps = {
500
500
  /**
501
- * The path of the API endpoint to target, anything after the /1 needs to be specified.
501
+ * Path of the endpoint, anything after \"/1\" must be specified.
502
502
  */
503
503
  path: string;
504
504
  /**
505
- * Query parameters to be applied to the current query.
505
+ * Query parameters to apply to the current query.
506
506
  */
507
507
  parameters?: Record<string, any>;
508
508
  /**
509
- * The parameters to send with the custom request.
509
+ * Parameters to send with the custom request.
510
510
  */
511
511
  body?: Record<string, any>;
512
512
  };
@@ -516,15 +516,15 @@ export type PostProps = {
516
516
  */
517
517
  export type PutProps = {
518
518
  /**
519
- * The path of the API endpoint to target, anything after the /1 needs to be specified.
519
+ * Path of the endpoint, anything after \"/1\" must be specified.
520
520
  */
521
521
  path: string;
522
522
  /**
523
- * Query parameters to be applied to the current query.
523
+ * Query parameters to apply to the current query.
524
524
  */
525
525
  parameters?: Record<string, any>;
526
526
  /**
527
- * The parameters to send with the custom request.
527
+ * Parameters to send with the custom request.
528
528
  */
529
529
  body?: Record<string, any>;
530
530
  };
@@ -2,22 +2,22 @@
2
2
 
3
3
  export type ConversionRateEvent = {
4
4
  /**
5
- * The click-through rate.
5
+ * [Click-through rate (CTR)](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#click-through-rate).
6
6
  */
7
7
  rate: number;
8
8
 
9
9
  /**
10
- * The number of tracked search click.
10
+ * Number of tracked searches. This is the number of search requests where the `clickAnalytics` parameter is `true`.
11
11
  */
12
12
  trackedSearchCount: number;
13
13
 
14
14
  /**
15
- * The number of converted clicks.
15
+ * Number of converted clicks.
16
16
  */
17
17
  conversionCount: number;
18
18
 
19
19
  /**
20
- * Date of the event.
20
+ * Date of the event in the format YYYY-MM-DD.
21
21
  */
22
22
  date: string;
23
23
  };
@@ -4,17 +4,17 @@ import type { AverageClickEvent } from './averageClickEvent';
4
4
 
5
5
  export type GetAverageClickPositionResponse = {
6
6
  /**
7
- * The average of all the click count event.
7
+ * Average count of all click events.
8
8
  */
9
9
  average: number;
10
10
 
11
11
  /**
12
- * The number of click event.
12
+ * Number of click events.
13
13
  */
14
14
  clickCount: number;
15
15
 
16
16
  /**
17
- * A list of average click position with their date.
17
+ * Average click positions.
18
18
  */
19
19
  dates: AverageClickEvent[];
20
20
  };
@@ -4,7 +4,7 @@ import type { ClickPosition } from './clickPosition';
4
4
 
5
5
  export type GetClickPositionsResponse = {
6
6
  /**
7
- * A list of the click positions with their click count.
7
+ * Click positions.
8
8
  */
9
9
  positions: ClickPosition[];
10
10
  };