@algolia/client-analytics 5.0.0-alpha.72 → 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
@@ -1,10 +1,10 @@
1
1
  export type ClickPosition = {
2
2
  /**
3
- * Range of positions with the following pattern: - Positions from 1 to 10 included are displayed in separated groups. - Positions from 11 to 20 included are grouped together. - Positions from 21 and up are grouped together.
3
+ * Range of positions with the following pattern: - For positions 1 to 10, the number of click events are shown for each position - For positions 11 to 20, all click events are grouped - For positions 21 and up, all click events are grouped.
4
4
  */
5
5
  position: number[];
6
6
  /**
7
- * The number of click event.
7
+ * Number of click events.
8
8
  */
9
9
  clickCount: number;
10
10
  };
@@ -1,18 +1,18 @@
1
1
  export type ClickThroughRateEvent = {
2
2
  /**
3
- * The click-through rate.
3
+ * [Click-through rate (CTR)](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#click-through-rate).
4
4
  */
5
5
  rate: number;
6
6
  /**
7
- * The number of click event.
7
+ * Number of click events.
8
8
  */
9
9
  clickCount: number;
10
10
  /**
11
- * The number of tracked search click.
11
+ * Number of tracked searches. This is the number of search requests where the `clickAnalytics` parameter is `true`.
12
12
  */
13
13
  trackedSearchCount: number;
14
14
  /**
15
- * Date of the event.
15
+ * Date of the event in the format YYYY-MM-DD.
16
16
  */
17
17
  date: string;
18
18
  };
@@ -5,11 +5,11 @@ import type { OrderBy } from './orderBy';
5
5
  */
6
6
  export type DelProps = {
7
7
  /**
8
- * The path of the API endpoint to target, anything after the /1 needs to be specified.
8
+ * Path of the endpoint, anything after \"/1\" must be specified.
9
9
  */
10
10
  path: string;
11
11
  /**
12
- * Query parameters to be applied to the current query.
12
+ * Query parameters to apply to the current query.
13
13
  */
14
14
  parameters?: Record<string, any>;
15
15
  };
@@ -18,11 +18,11 @@ export type DelProps = {
18
18
  */
19
19
  export type GetProps = {
20
20
  /**
21
- * The path of the API endpoint to target, anything after the /1 needs to be specified.
21
+ * Path of the endpoint, anything after \"/1\" must be specified.
22
22
  */
23
23
  path: string;
24
24
  /**
25
- * Query parameters to be applied to the current query.
25
+ * Query parameters to apply to the current query.
26
26
  */
27
27
  parameters?: Record<string, any>;
28
28
  };
@@ -31,19 +31,19 @@ export type GetProps = {
31
31
  */
32
32
  export type GetAverageClickPositionProps = {
33
33
  /**
34
- * The index name to target.
34
+ * Index name to target.
35
35
  */
36
36
  index: string;
37
37
  /**
38
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
38
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
39
39
  */
40
40
  startDate?: string;
41
41
  /**
42
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
42
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
43
43
  */
44
44
  endDate?: string;
45
45
  /**
46
- * 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.
46
+ * 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.
47
47
  */
48
48
  tags?: string;
49
49
  };
@@ -52,19 +52,19 @@ export type GetAverageClickPositionProps = {
52
52
  */
53
53
  export type GetClickPositionsProps = {
54
54
  /**
55
- * The index name to target.
55
+ * Index name to target.
56
56
  */
57
57
  index: string;
58
58
  /**
59
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
59
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
60
60
  */
61
61
  startDate?: string;
62
62
  /**
63
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
63
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
64
64
  */
65
65
  endDate?: string;
66
66
  /**
67
- * 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.
67
+ * 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.
68
68
  */
69
69
  tags?: string;
70
70
  };
@@ -73,19 +73,19 @@ export type GetClickPositionsProps = {
73
73
  */
74
74
  export type GetClickThroughRateProps = {
75
75
  /**
76
- * The index name to target.
76
+ * Index name to target.
77
77
  */
78
78
  index: string;
79
79
  /**
80
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
80
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
81
81
  */
82
82
  startDate?: string;
83
83
  /**
84
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
84
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
85
85
  */
86
86
  endDate?: string;
87
87
  /**
88
- * 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.
88
+ * 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.
89
89
  */
90
90
  tags?: string;
91
91
  };
@@ -94,19 +94,19 @@ export type GetClickThroughRateProps = {
94
94
  */
95
95
  export type GetConversationRateProps = {
96
96
  /**
97
- * The index name to target.
97
+ * Index name to target.
98
98
  */
99
99
  index: string;
100
100
  /**
101
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
101
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
102
102
  */
103
103
  startDate?: string;
104
104
  /**
105
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
105
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
106
106
  */
107
107
  endDate?: string;
108
108
  /**
109
- * 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.
109
+ * 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.
110
110
  */
111
111
  tags?: string;
112
112
  };
@@ -115,19 +115,19 @@ export type GetConversationRateProps = {
115
115
  */
116
116
  export type GetNoClickRateProps = {
117
117
  /**
118
- * The index name to target.
118
+ * Index name to target.
119
119
  */
120
120
  index: string;
121
121
  /**
122
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
122
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
123
123
  */
124
124
  startDate?: string;
125
125
  /**
126
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
126
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
127
127
  */
128
128
  endDate?: string;
129
129
  /**
130
- * 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.
130
+ * 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.
131
131
  */
132
132
  tags?: string;
133
133
  };
@@ -136,19 +136,19 @@ export type GetNoClickRateProps = {
136
136
  */
137
137
  export type GetNoResultsRateProps = {
138
138
  /**
139
- * The index name to target.
139
+ * Index name to target.
140
140
  */
141
141
  index: string;
142
142
  /**
143
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
143
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
144
144
  */
145
145
  startDate?: string;
146
146
  /**
147
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
147
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
148
148
  */
149
149
  endDate?: string;
150
150
  /**
151
- * 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.
151
+ * 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.
152
152
  */
153
153
  tags?: string;
154
154
  };
@@ -157,19 +157,19 @@ export type GetNoResultsRateProps = {
157
157
  */
158
158
  export type GetSearchesCountProps = {
159
159
  /**
160
- * The index name to target.
160
+ * Index name to target.
161
161
  */
162
162
  index: string;
163
163
  /**
164
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
164
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
165
165
  */
166
166
  startDate?: string;
167
167
  /**
168
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
168
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
169
169
  */
170
170
  endDate?: string;
171
171
  /**
172
- * 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.
172
+ * 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.
173
173
  */
174
174
  tags?: string;
175
175
  };
@@ -178,19 +178,19 @@ export type GetSearchesCountProps = {
178
178
  */
179
179
  export type GetSearchesNoClicksProps = {
180
180
  /**
181
- * The index name to target.
181
+ * Index name to target.
182
182
  */
183
183
  index: string;
184
184
  /**
185
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
185
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
186
186
  */
187
187
  startDate?: string;
188
188
  /**
189
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
189
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
190
190
  */
191
191
  endDate?: string;
192
192
  /**
193
- * Number of records to return. Limit is the size of the page.
193
+ * Number of records to return (page size).
194
194
  */
195
195
  limit?: number;
196
196
  /**
@@ -198,7 +198,7 @@ export type GetSearchesNoClicksProps = {
198
198
  */
199
199
  offset?: number;
200
200
  /**
201
- * 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.
201
+ * 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.
202
202
  */
203
203
  tags?: string;
204
204
  };
@@ -207,19 +207,19 @@ export type GetSearchesNoClicksProps = {
207
207
  */
208
208
  export type GetSearchesNoResultsProps = {
209
209
  /**
210
- * The index name to target.
210
+ * Index name to target.
211
211
  */
212
212
  index: string;
213
213
  /**
214
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
214
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
215
215
  */
216
216
  startDate?: string;
217
217
  /**
218
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
218
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
219
219
  */
220
220
  endDate?: string;
221
221
  /**
222
- * Number of records to return. Limit is the size of the page.
222
+ * Number of records to return (page size).
223
223
  */
224
224
  limit?: number;
225
225
  /**
@@ -227,7 +227,7 @@ export type GetSearchesNoResultsProps = {
227
227
  */
228
228
  offset?: number;
229
229
  /**
230
- * 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.
230
+ * 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.
231
231
  */
232
232
  tags?: string;
233
233
  };
@@ -236,7 +236,7 @@ export type GetSearchesNoResultsProps = {
236
236
  */
237
237
  export type GetStatusProps = {
238
238
  /**
239
- * The index name to target.
239
+ * Index name to target.
240
240
  */
241
241
  index: string;
242
242
  };
@@ -245,19 +245,19 @@ export type GetStatusProps = {
245
245
  */
246
246
  export type GetTopCountriesProps = {
247
247
  /**
248
- * The index name to target.
248
+ * Index name to target.
249
249
  */
250
250
  index: string;
251
251
  /**
252
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
252
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
253
253
  */
254
254
  startDate?: string;
255
255
  /**
256
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
256
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
257
257
  */
258
258
  endDate?: string;
259
259
  /**
260
- * Number of records to return. Limit is the size of the page.
260
+ * Number of records to return (page size).
261
261
  */
262
262
  limit?: number;
263
263
  /**
@@ -265,7 +265,7 @@ export type GetTopCountriesProps = {
265
265
  */
266
266
  offset?: number;
267
267
  /**
268
- * 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.
268
+ * 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.
269
269
  */
270
270
  tags?: string;
271
271
  };
@@ -274,23 +274,23 @@ export type GetTopCountriesProps = {
274
274
  */
275
275
  export type GetTopFilterAttributesProps = {
276
276
  /**
277
- * The index name to target.
277
+ * Index name to target.
278
278
  */
279
279
  index: string;
280
280
  /**
281
- * The query term to search for. Must match the exact user input.
281
+ * User query.
282
282
  */
283
283
  search?: string;
284
284
  /**
285
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
285
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
286
286
  */
287
287
  startDate?: string;
288
288
  /**
289
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
289
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
290
290
  */
291
291
  endDate?: string;
292
292
  /**
293
- * Number of records to return. Limit is the size of the page.
293
+ * Number of records to return (page size).
294
294
  */
295
295
  limit?: number;
296
296
  /**
@@ -298,7 +298,7 @@ export type GetTopFilterAttributesProps = {
298
298
  */
299
299
  offset?: number;
300
300
  /**
301
- * 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.
301
+ * 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.
302
302
  */
303
303
  tags?: string;
304
304
  };
@@ -307,27 +307,27 @@ export type GetTopFilterAttributesProps = {
307
307
  */
308
308
  export type GetTopFilterForAttributeProps = {
309
309
  /**
310
- * The exact name of the attribute.
310
+ * Attribute name.
311
311
  */
312
312
  attribute: string;
313
313
  /**
314
- * The index name to target.
314
+ * Index name to target.
315
315
  */
316
316
  index: string;
317
317
  /**
318
- * The query term to search for. Must match the exact user input.
318
+ * User query.
319
319
  */
320
320
  search?: string;
321
321
  /**
322
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
322
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
323
323
  */
324
324
  startDate?: string;
325
325
  /**
326
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
326
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
327
327
  */
328
328
  endDate?: string;
329
329
  /**
330
- * Number of records to return. Limit is the size of the page.
330
+ * Number of records to return (page size).
331
331
  */
332
332
  limit?: number;
333
333
  /**
@@ -335,7 +335,7 @@ export type GetTopFilterForAttributeProps = {
335
335
  */
336
336
  offset?: number;
337
337
  /**
338
- * 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.
338
+ * 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.
339
339
  */
340
340
  tags?: string;
341
341
  };
@@ -344,23 +344,23 @@ export type GetTopFilterForAttributeProps = {
344
344
  */
345
345
  export type GetTopFiltersNoResultsProps = {
346
346
  /**
347
- * The index name to target.
347
+ * Index name to target.
348
348
  */
349
349
  index: string;
350
350
  /**
351
- * The query term to search for. Must match the exact user input.
351
+ * User query.
352
352
  */
353
353
  search?: string;
354
354
  /**
355
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
355
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
356
356
  */
357
357
  startDate?: string;
358
358
  /**
359
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
359
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
360
360
  */
361
361
  endDate?: string;
362
362
  /**
363
- * Number of records to return. Limit is the size of the page.
363
+ * Number of records to return (page size).
364
364
  */
365
365
  limit?: number;
366
366
  /**
@@ -368,7 +368,7 @@ export type GetTopFiltersNoResultsProps = {
368
368
  */
369
369
  offset?: number;
370
370
  /**
371
- * 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.
371
+ * 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.
372
372
  */
373
373
  tags?: string;
374
374
  };
@@ -377,27 +377,27 @@ export type GetTopFiltersNoResultsProps = {
377
377
  */
378
378
  export type GetTopHitsProps = {
379
379
  /**
380
- * The index name to target.
380
+ * Index name to target.
381
381
  */
382
382
  index: string;
383
383
  /**
384
- * The query term to search for. Must match the exact user input.
384
+ * User query.
385
385
  */
386
386
  search?: string;
387
387
  /**
388
- * Whether to include the click-through and conversion rates for a search.
388
+ * Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
389
389
  */
390
390
  clickAnalytics?: boolean;
391
391
  /**
392
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
392
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
393
393
  */
394
394
  startDate?: string;
395
395
  /**
396
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
396
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
397
397
  */
398
398
  endDate?: string;
399
399
  /**
400
- * Number of records to return. Limit is the size of the page.
400
+ * Number of records to return (page size).
401
401
  */
402
402
  limit?: number;
403
403
  /**
@@ -405,7 +405,7 @@ export type GetTopHitsProps = {
405
405
  */
406
406
  offset?: number;
407
407
  /**
408
- * 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.
408
+ * 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.
409
409
  */
410
410
  tags?: string;
411
411
  };
@@ -414,19 +414,19 @@ export type GetTopHitsProps = {
414
414
  */
415
415
  export type GetTopSearchesProps = {
416
416
  /**
417
- * The index name to target.
417
+ * Index name to target.
418
418
  */
419
419
  index: string;
420
420
  /**
421
- * Whether to include the click-through and conversion rates for a search.
421
+ * Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
422
422
  */
423
423
  clickAnalytics?: boolean;
424
424
  /**
425
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
425
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
426
426
  */
427
427
  startDate?: string;
428
428
  /**
429
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
429
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
430
430
  */
431
431
  endDate?: string;
432
432
  /**
@@ -434,11 +434,11 @@ export type GetTopSearchesProps = {
434
434
  */
435
435
  orderBy?: OrderBy;
436
436
  /**
437
- * The sorting of the result.
437
+ * Sorting direction of the results: ascending or descending.
438
438
  */
439
439
  direction?: Direction;
440
440
  /**
441
- * Number of records to return. Limit is the size of the page.
441
+ * Number of records to return (page size).
442
442
  */
443
443
  limit?: number;
444
444
  /**
@@ -446,7 +446,7 @@ export type GetTopSearchesProps = {
446
446
  */
447
447
  offset?: number;
448
448
  /**
449
- * 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.
449
+ * 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.
450
450
  */
451
451
  tags?: string;
452
452
  };
@@ -455,19 +455,19 @@ export type GetTopSearchesProps = {
455
455
  */
456
456
  export type GetUsersCountProps = {
457
457
  /**
458
- * The index name to target.
458
+ * Index name to target.
459
459
  */
460
460
  index: string;
461
461
  /**
462
- * The lower bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
462
+ * Start date (a string in the format `YYYY-MM-DD`) of the period to analyze.
463
463
  */
464
464
  startDate?: string;
465
465
  /**
466
- * The upper bound timestamp (a date, a string like \"2006-01-02\") of the period to analyze.
466
+ * End date (a string in the format `YYYY-MM-DD`) of the period to analyze.
467
467
  */
468
468
  endDate?: string;
469
469
  /**
470
- * 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.
470
+ * 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.
471
471
  */
472
472
  tags?: string;
473
473
  };
@@ -476,15 +476,15 @@ export type GetUsersCountProps = {
476
476
  */
477
477
  export type PostProps = {
478
478
  /**
479
- * The path of the API endpoint to target, anything after the /1 needs to be specified.
479
+ * Path of the endpoint, anything after \"/1\" must be specified.
480
480
  */
481
481
  path: string;
482
482
  /**
483
- * Query parameters to be applied to the current query.
483
+ * Query parameters to apply to the current query.
484
484
  */
485
485
  parameters?: Record<string, any>;
486
486
  /**
487
- * The parameters to send with the custom request.
487
+ * Parameters to send with the custom request.
488
488
  */
489
489
  body?: Record<string, any>;
490
490
  };
@@ -493,15 +493,15 @@ export type PostProps = {
493
493
  */
494
494
  export type PutProps = {
495
495
  /**
496
- * The path of the API endpoint to target, anything after the /1 needs to be specified.
496
+ * Path of the endpoint, anything after \"/1\" must be specified.
497
497
  */
498
498
  path: string;
499
499
  /**
500
- * Query parameters to be applied to the current query.
500
+ * Query parameters to apply to the current query.
501
501
  */
502
502
  parameters?: Record<string, any>;
503
503
  /**
504
- * The parameters to send with the custom request.
504
+ * Parameters to send with the custom request.
505
505
  */
506
506
  body?: Record<string, any>;
507
507
  };
@@ -1,18 +1,18 @@
1
1
  export type ConversionRateEvent = {
2
2
  /**
3
- * The click-through rate.
3
+ * [Click-through rate (CTR)](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#click-through-rate).
4
4
  */
5
5
  rate: number;
6
6
  /**
7
- * The number of tracked search click.
7
+ * Number of tracked searches. This is the number of search requests where the `clickAnalytics` parameter is `true`.
8
8
  */
9
9
  trackedSearchCount: number;
10
10
  /**
11
- * The number of converted clicks.
11
+ * Number of converted clicks.
12
12
  */
13
13
  conversionCount: number;
14
14
  /**
15
- * Date of the event.
15
+ * Date of the event in the format YYYY-MM-DD.
16
16
  */
17
17
  date: string;
18
18
  };