@algolia/client-analytics 5.0.0-alpha.108 → 5.0.0-alpha.109

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 (186) hide show
  1. package/dist/builds/browser.d.ts +6 -3
  2. package/dist/builds/browser.d.ts.map +1 -1
  3. package/dist/builds/node.d.ts +6 -3
  4. package/dist/builds/node.d.ts.map +1 -1
  5. package/dist/client-analytics.cjs +181 -53
  6. package/dist/client-analytics.esm.browser.js +182 -54
  7. package/dist/client-analytics.esm.node.js +181 -53
  8. package/dist/client-analytics.umd.js +2 -2
  9. package/dist/model/clickPositionsInner.d.ts +14 -0
  10. package/dist/model/clickPositionsInner.d.ts.map +1 -0
  11. package/dist/model/clientMethodProps.d.ts +96 -25
  12. package/dist/model/clientMethodProps.d.ts.map +1 -1
  13. package/dist/model/currenciesValue.d.ts +14 -0
  14. package/dist/model/currenciesValue.d.ts.map +1 -0
  15. package/dist/model/dailyAddToCartRates.d.ts +19 -0
  16. package/dist/model/dailyAddToCartRates.d.ts.map +1 -0
  17. package/dist/model/dailyAverageClicks.d.ts +15 -0
  18. package/dist/model/dailyAverageClicks.d.ts.map +1 -0
  19. package/dist/model/dailyClickThroughRates.d.ts +19 -0
  20. package/dist/model/dailyClickThroughRates.d.ts.map +1 -0
  21. package/dist/model/dailyConversionRates.d.ts +19 -0
  22. package/dist/model/dailyConversionRates.d.ts.map +1 -0
  23. package/dist/model/dailyNoClickRates.d.ts +19 -0
  24. package/dist/model/dailyNoClickRates.d.ts.map +1 -0
  25. package/dist/model/dailyNoResultsRates.d.ts +19 -0
  26. package/dist/model/dailyNoResultsRates.d.ts.map +1 -0
  27. package/dist/model/dailyPurchaseRates.d.ts +19 -0
  28. package/dist/model/dailyPurchaseRates.d.ts.map +1 -0
  29. package/dist/model/dailyRevenue.d.ts +12 -0
  30. package/dist/model/dailyRevenue.d.ts.map +1 -0
  31. package/dist/model/dailySearches.d.ts +11 -0
  32. package/dist/model/dailySearches.d.ts.map +1 -0
  33. package/dist/model/dailySearchesNoClicks.d.ts +15 -0
  34. package/dist/model/dailySearchesNoClicks.d.ts.map +1 -0
  35. package/dist/model/dailySearchesNoResults.d.ts +15 -0
  36. package/dist/model/dailySearchesNoResults.d.ts.map +1 -0
  37. package/dist/model/dailyUsers.d.ts +11 -0
  38. package/dist/model/dailyUsers.d.ts.map +1 -0
  39. package/dist/model/getAddToCartRateResponse.d.ts +20 -0
  40. package/dist/model/getAddToCartRateResponse.d.ts.map +1 -0
  41. package/dist/model/getAverageClickPositionResponse.d.ts +6 -6
  42. package/dist/model/getAverageClickPositionResponse.d.ts.map +1 -1
  43. package/dist/model/getClickPositionsResponse.d.ts +3 -3
  44. package/dist/model/getClickPositionsResponse.d.ts.map +1 -1
  45. package/dist/model/getClickThroughRateResponse.d.ts +8 -8
  46. package/dist/model/getClickThroughRateResponse.d.ts.map +1 -1
  47. package/dist/model/getConversionRateResponse.d.ts +20 -0
  48. package/dist/model/getConversionRateResponse.d.ts.map +1 -0
  49. package/dist/model/getNoClickRateResponse.d.ts +6 -6
  50. package/dist/model/getNoClickRateResponse.d.ts.map +1 -1
  51. package/dist/model/getNoResultsRateResponse.d.ts +6 -6
  52. package/dist/model/getNoResultsRateResponse.d.ts.map +1 -1
  53. package/dist/model/getPurchaseRateResponse.d.ts +20 -0
  54. package/dist/model/getPurchaseRateResponse.d.ts.map +1 -0
  55. package/dist/model/getRevenue.d.ts +13 -0
  56. package/dist/model/getRevenue.d.ts.map +1 -0
  57. package/dist/model/getSearchesCountResponse.d.ts +3 -3
  58. package/dist/model/getSearchesCountResponse.d.ts.map +1 -1
  59. package/dist/model/getSearchesNoClicksResponse.d.ts +3 -3
  60. package/dist/model/getSearchesNoClicksResponse.d.ts.map +1 -1
  61. package/dist/model/getSearchesNoResultsResponse.d.ts +3 -3
  62. package/dist/model/getSearchesNoResultsResponse.d.ts.map +1 -1
  63. package/dist/model/getStatusResponse.d.ts +2 -2
  64. package/dist/model/getStatusResponse.d.ts.map +1 -1
  65. package/dist/model/getTopCountriesResponse.d.ts +1 -1
  66. package/dist/model/getTopFilterAttributesResponse.d.ts +1 -1
  67. package/dist/model/getTopFilterForAttribute.d.ts +2 -4
  68. package/dist/model/getTopFilterForAttribute.d.ts.map +1 -1
  69. package/dist/model/getTopFiltersNoResultsResponse.d.ts +2 -2
  70. package/dist/model/getTopFiltersNoResultsResponse.d.ts.map +1 -1
  71. package/dist/model/getTopFiltersNoResultsValue.d.ts +2 -4
  72. package/dist/model/getTopFiltersNoResultsValue.d.ts.map +1 -1
  73. package/dist/model/getTopHitsResponse.d.ts +2 -1
  74. package/dist/model/getTopHitsResponse.d.ts.map +1 -1
  75. package/dist/model/getTopSearchesResponse.d.ts +2 -1
  76. package/dist/model/getTopSearchesResponse.d.ts.map +1 -1
  77. package/dist/model/getUsersCountResponse.d.ts +4 -4
  78. package/dist/model/getUsersCountResponse.d.ts.map +1 -1
  79. package/dist/model/index.d.ts +23 -11
  80. package/dist/model/index.d.ts.map +1 -1
  81. package/dist/model/operator.d.ts +5 -0
  82. package/dist/model/operator.d.ts.map +1 -0
  83. package/dist/model/orderBy.d.ts +1 -1
  84. package/dist/model/topCountry.d.ts +1 -1
  85. package/dist/model/topHit.d.ts +1 -1
  86. package/dist/model/topHitWithAnalytics.d.ts +9 -9
  87. package/dist/model/topHitWithAnalytics.d.ts.map +1 -1
  88. package/dist/model/topHitWithRevenueAnalytics.d.ts +52 -0
  89. package/dist/model/topHitWithRevenueAnalytics.d.ts.map +1 -0
  90. package/dist/model/topHitsResponse.d.ts +1 -1
  91. package/dist/model/topHitsResponseWithAnalytics.d.ts +1 -1
  92. package/dist/model/topHitsResponseWithRevenueAnalytics.d.ts +8 -0
  93. package/dist/model/topHitsResponseWithRevenueAnalytics.d.ts.map +1 -0
  94. package/dist/model/topSearch.d.ts +2 -2
  95. package/dist/model/topSearchWithAnalytics.d.ts +17 -12
  96. package/dist/model/topSearchWithAnalytics.d.ts.map +1 -1
  97. package/dist/model/topSearchWithRevenueAnalytics.d.ts +65 -0
  98. package/dist/model/topSearchWithRevenueAnalytics.d.ts.map +1 -0
  99. package/dist/model/topSearchesResponse.d.ts +1 -1
  100. package/dist/model/topSearchesResponseWithAnalytics.d.ts +1 -1
  101. package/dist/model/topSearchesResponseWithRevenueAnalytics.d.ts +8 -0
  102. package/dist/model/topSearchesResponseWithRevenueAnalytics.d.ts.map +1 -0
  103. package/dist/src/analyticsClient.d.ts +97 -50
  104. package/dist/src/analyticsClient.d.ts.map +1 -1
  105. package/model/clickPositionsInner.ts +16 -0
  106. package/model/clientMethodProps.ts +99 -25
  107. package/model/currenciesValue.ts +16 -0
  108. package/model/dailyAddToCartRates.ts +23 -0
  109. package/model/dailyAverageClicks.ts +18 -0
  110. package/model/dailyClickThroughRates.ts +23 -0
  111. package/model/dailyConversionRates.ts +23 -0
  112. package/model/dailyNoClickRates.ts +23 -0
  113. package/model/dailyNoResultsRates.ts +23 -0
  114. package/model/dailyPurchaseRates.ts +23 -0
  115. package/model/dailyRevenue.ts +15 -0
  116. package/model/{searchEvent.ts → dailySearches.ts} +2 -2
  117. package/model/{searchNoResultEvent.ts → dailySearchesNoClicks.ts} +3 -3
  118. package/model/{searchNoClickEvent.ts → dailySearchesNoResults.ts} +3 -3
  119. package/model/{userWithDate.ts → dailyUsers.ts} +3 -3
  120. package/model/getAddToCartRateResponse.ts +25 -0
  121. package/model/getAverageClickPositionResponse.ts +6 -6
  122. package/model/getClickPositionsResponse.ts +3 -3
  123. package/model/getClickThroughRateResponse.ts +8 -8
  124. package/model/getConversionRateResponse.ts +25 -0
  125. package/model/getNoClickRateResponse.ts +6 -6
  126. package/model/getNoResultsRateResponse.ts +6 -6
  127. package/model/getPurchaseRateResponse.ts +25 -0
  128. package/model/getRevenue.ts +16 -0
  129. package/model/getSearchesCountResponse.ts +3 -3
  130. package/model/getSearchesNoClicksResponse.ts +3 -3
  131. package/model/getSearchesNoResultsResponse.ts +3 -3
  132. package/model/getStatusResponse.ts +2 -2
  133. package/model/getTopCountriesResponse.ts +1 -1
  134. package/model/getTopFilterAttributesResponse.ts +1 -1
  135. package/model/getTopFilterForAttribute.ts +3 -4
  136. package/model/getTopFiltersNoResultsResponse.ts +2 -2
  137. package/model/getTopFiltersNoResultsValue.ts +3 -4
  138. package/model/getTopHitsResponse.ts +5 -1
  139. package/model/getTopSearchesResponse.ts +3 -1
  140. package/model/getUsersCountResponse.ts +4 -4
  141. package/model/index.ts +23 -11
  142. package/model/operator.ts +6 -0
  143. package/model/orderBy.ts +1 -1
  144. package/model/topCountry.ts +1 -1
  145. package/model/topHit.ts +1 -1
  146. package/model/topHitWithAnalytics.ts +9 -9
  147. package/model/topHitWithRevenueAnalytics.ts +65 -0
  148. package/model/topHitsResponse.ts +1 -1
  149. package/model/topHitsResponseWithAnalytics.ts +1 -1
  150. package/model/topHitsResponseWithRevenueAnalytics.ts +10 -0
  151. package/model/topSearch.ts +2 -2
  152. package/model/topSearchWithAnalytics.ts +19 -12
  153. package/model/topSearchWithRevenueAnalytics.ts +81 -0
  154. package/model/topSearchesResponse.ts +1 -1
  155. package/model/topSearchesResponseWithAnalytics.ts +1 -1
  156. package/model/topSearchesResponseWithRevenueAnalytics.ts +10 -0
  157. package/package.json +6 -6
  158. package/dist/model/averageClickEvent.d.ts +0 -15
  159. package/dist/model/averageClickEvent.d.ts.map +0 -1
  160. package/dist/model/clickPosition.d.ts +0 -11
  161. package/dist/model/clickPosition.d.ts.map +0 -1
  162. package/dist/model/clickThroughRateEvent.d.ts +0 -19
  163. package/dist/model/clickThroughRateEvent.d.ts.map +0 -1
  164. package/dist/model/conversionRateEvent.d.ts +0 -19
  165. package/dist/model/conversionRateEvent.d.ts.map +0 -1
  166. package/dist/model/getConversationRateResponse.d.ts +0 -20
  167. package/dist/model/getConversationRateResponse.d.ts.map +0 -1
  168. package/dist/model/noClickRateEvent.d.ts +0 -19
  169. package/dist/model/noClickRateEvent.d.ts.map +0 -1
  170. package/dist/model/noResultsRateEvent.d.ts +0 -19
  171. package/dist/model/noResultsRateEvent.d.ts.map +0 -1
  172. package/dist/model/searchEvent.d.ts +0 -11
  173. package/dist/model/searchEvent.d.ts.map +0 -1
  174. package/dist/model/searchNoClickEvent.d.ts +0 -15
  175. package/dist/model/searchNoClickEvent.d.ts.map +0 -1
  176. package/dist/model/searchNoResultEvent.d.ts +0 -15
  177. package/dist/model/searchNoResultEvent.d.ts.map +0 -1
  178. package/dist/model/userWithDate.d.ts +0 -11
  179. package/dist/model/userWithDate.d.ts.map +0 -1
  180. package/model/averageClickEvent.ts +0 -18
  181. package/model/clickPosition.ts +0 -13
  182. package/model/clickThroughRateEvent.ts +0 -23
  183. package/model/conversionRateEvent.ts +0 -23
  184. package/model/getConversationRateResponse.ts +0 -25
  185. package/model/noClickRateEvent.ts +0 -23
  186. package/model/noResultsRateEvent.ts +0 -23
@@ -1,11 +1,14 @@
1
1
  import type { CreateClientOptions, RequestOptions } from '@algolia/client-common';
2
- import type { CustomDeleteProps, CustomGetProps, CustomPostProps, CustomPutProps, GetAverageClickPositionProps, GetClickPositionsProps, GetClickThroughRateProps, GetConversationRateProps, GetNoClickRateProps, GetNoResultsRateProps, GetSearchesCountProps, GetSearchesNoClicksProps, GetSearchesNoResultsProps, GetStatusProps, GetTopCountriesProps, GetTopFilterAttributesProps, GetTopFilterForAttributeProps, GetTopFiltersNoResultsProps, GetTopHitsProps, GetTopSearchesProps, GetUsersCountProps } from '../model/clientMethodProps';
2
+ import type { CustomDeleteProps, CustomGetProps, CustomPostProps, CustomPutProps, GetAddToCartRateProps, GetAverageClickPositionProps, GetClickPositionsProps, GetClickThroughRateProps, GetConversionRateProps, GetNoClickRateProps, GetNoResultsRateProps, GetPurchaseRateProps, GetRevenueProps, GetSearchesCountProps, GetSearchesNoClicksProps, GetSearchesNoResultsProps, GetStatusProps, GetTopCountriesProps, GetTopFilterAttributesProps, GetTopFilterForAttributeProps, GetTopFiltersNoResultsProps, GetTopHitsProps, GetTopSearchesProps, GetUsersCountProps } from '../model/clientMethodProps';
3
+ import type { GetAddToCartRateResponse } from '../model/getAddToCartRateResponse';
3
4
  import type { GetAverageClickPositionResponse } from '../model/getAverageClickPositionResponse';
4
5
  import type { GetClickPositionsResponse } from '../model/getClickPositionsResponse';
5
6
  import type { GetClickThroughRateResponse } from '../model/getClickThroughRateResponse';
6
- import type { GetConversationRateResponse } from '../model/getConversationRateResponse';
7
+ import type { GetConversionRateResponse } from '../model/getConversionRateResponse';
7
8
  import type { GetNoClickRateResponse } from '../model/getNoClickRateResponse';
8
9
  import type { GetNoResultsRateResponse } from '../model/getNoResultsRateResponse';
10
+ import type { GetPurchaseRateResponse } from '../model/getPurchaseRateResponse';
11
+ import type { GetRevenue } from '../model/getRevenue';
9
12
  import type { GetSearchesCountResponse } from '../model/getSearchesCountResponse';
10
13
  import type { GetSearchesNoClicksResponse } from '../model/getSearchesNoClicksResponse';
11
14
  import type { GetSearchesNoResultsResponse } from '../model/getSearchesNoResultsResponse';
@@ -17,7 +20,7 @@ import type { GetTopFiltersNoResultsResponse } from '../model/getTopFiltersNoRes
17
20
  import type { GetTopHitsResponse } from '../model/getTopHitsResponse';
18
21
  import type { GetTopSearchesResponse } from '../model/getTopSearchesResponse';
19
22
  import type { GetUsersCountResponse } from '../model/getUsersCountResponse';
20
- export declare const apiClientVersion = "5.0.0-alpha.108";
23
+ export declare const apiClientVersion = "5.0.0-alpha.109";
21
24
  export declare const REGIONS: readonly ["de", "us"];
22
25
  export type Region = (typeof REGIONS)[number];
23
26
  export declare function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authMode, algoliaAgents, region: regionOption, ...options }: CreateClientOptions & {
@@ -82,7 +85,21 @@ export declare function createAnalyticsClient({ appId: appIdOption, apiKey: apiK
82
85
  */
83
86
  customPut({ path, parameters, body }: CustomPutProps, requestOptions?: RequestOptions): Promise<Record<string, any>>;
84
87
  /**
85
- * Return the average click position for the complete time range and for individual days. > **Note**: If all `positions` have a `clickCount` of `0` or `null`, it means Algolia didn\'t receive any click events for tracked searches. A _tracked_ search is a search request where the `clickAnalytics` parameter is `true`.
88
+ * Retrieves the add-to-cart rate for all of your searches with at least one add-to-cart event, including a daily breakdown. By default, the analyzed period includes the last eight days including the current day.
89
+ *
90
+ * Required API Key ACLs:
91
+ * - analytics.
92
+ *
93
+ * @param getAddToCartRate - The getAddToCartRate object.
94
+ * @param getAddToCartRate.index - Index name.
95
+ * @param getAddToCartRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
96
+ * @param getAddToCartRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
97
+ * @param getAddToCartRate.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
98
+ * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
99
+ */
100
+ getAddToCartRate({ index, startDate, endDate, tags }: GetAddToCartRateProps, requestOptions?: RequestOptions): Promise<GetAddToCartRateResponse>;
101
+ /**
102
+ * Retrieves the average click position of your search results, including a daily breakdown. The average click position is the average of all clicked search results\' positions. For example, if users only ever click on the first result for any search, the average click position is 1. By default, the analyzed period includes the last eight days including the current day.
86
103
  *
87
104
  * Required API Key ACLs:
88
105
  * - analytics.
@@ -91,12 +108,12 @@ export declare function createAnalyticsClient({ appId: appIdOption, apiKey: apiK
91
108
  * @param getAverageClickPosition.index - Index name.
92
109
  * @param getAverageClickPosition.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
93
110
  * @param getAverageClickPosition.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
94
- * @param getAverageClickPosition.tags - 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.
111
+ * @param getAverageClickPosition.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
95
112
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
96
113
  */
97
114
  getAverageClickPosition({ index, startDate, endDate, tags }: GetAverageClickPositionProps, requestOptions?: RequestOptions): Promise<GetAverageClickPositionResponse>;
98
115
  /**
99
- * Show the number of clicks events and their associated position in the search results. > **Note**: If all `positions` have a `clickCount` of `0` or `null`, it means Algolia didn\'t receive any click events for tracked searches. A _tracked_ search is a search request where the `clickAnalytics` parameter is `true`.
116
+ * Retrieves the positions in the search results and their associated number of clicks. This lets you check how many clicks the first, second, or tenth search results receive.
100
117
  *
101
118
  * Required API Key ACLs:
102
119
  * - analytics.
@@ -105,12 +122,12 @@ export declare function createAnalyticsClient({ appId: appIdOption, apiKey: apiK
105
122
  * @param getClickPositions.index - Index name.
106
123
  * @param getClickPositions.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
107
124
  * @param getClickPositions.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
108
- * @param getClickPositions.tags - 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.
125
+ * @param getClickPositions.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
109
126
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
110
127
  */
111
128
  getClickPositions({ index, startDate, endDate, tags }: GetClickPositionsProps, requestOptions?: RequestOptions): Promise<GetClickPositionsResponse>;
112
129
  /**
113
- * Returns a [click-through rate (CTR)](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#click-through-rate).
130
+ * Retrieves the click-through rate for all of your searches with at least one click event, including a daily breakdown By default, the analyzed period includes the last eight days including the current day.
114
131
  *
115
132
  * Required API Key ACLs:
116
133
  * - analytics.
@@ -119,26 +136,26 @@ export declare function createAnalyticsClient({ appId: appIdOption, apiKey: apiK
119
136
  * @param getClickThroughRate.index - Index name.
120
137
  * @param getClickThroughRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
121
138
  * @param getClickThroughRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
122
- * @param getClickThroughRate.tags - 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.
139
+ * @param getClickThroughRate.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
123
140
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
124
141
  */
125
142
  getClickThroughRate({ index, startDate, endDate, tags }: GetClickThroughRateProps, requestOptions?: RequestOptions): Promise<GetClickThroughRateResponse>;
126
143
  /**
127
- * Return a [conversion rate](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#conversion-rate).
144
+ * Retrieves the conversion rate for all of your searches with at least one conversion event, including a daily breakdown. By default, the analyzed period includes the last eight days including the current day.
128
145
  *
129
146
  * Required API Key ACLs:
130
147
  * - analytics.
131
148
  *
132
- * @param getConversationRate - The getConversationRate object.
133
- * @param getConversationRate.index - Index name.
134
- * @param getConversationRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
135
- * @param getConversationRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
136
- * @param getConversationRate.tags - 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.
149
+ * @param getConversionRate - The getConversionRate object.
150
+ * @param getConversionRate.index - Index name.
151
+ * @param getConversionRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
152
+ * @param getConversionRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
153
+ * @param getConversionRate.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
137
154
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
138
155
  */
139
- getConversationRate({ index, startDate, endDate, tags }: GetConversationRateProps, requestOptions?: RequestOptions): Promise<GetConversationRateResponse>;
156
+ getConversionRate({ index, startDate, endDate, tags }: GetConversionRateProps, requestOptions?: RequestOptions): Promise<GetConversionRateResponse>;
140
157
  /**
141
- * Returns the rate at which searches don\'t lead to any clicks. The endpoint returns a value for the complete given time range, as well as a value per day. It also returns the count of searches and searches without clicks.
158
+ * Retrieves the fraction of searches that didn\'t lead to any click within a time range, including a daily breakdown. By default, the analyzed period includes the last eight days including the current day.
142
159
  *
143
160
  * Required API Key ACLs:
144
161
  * - analytics.
@@ -147,12 +164,12 @@ export declare function createAnalyticsClient({ appId: appIdOption, apiKey: apiK
147
164
  * @param getNoClickRate.index - Index name.
148
165
  * @param getNoClickRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
149
166
  * @param getNoClickRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
150
- * @param getNoClickRate.tags - 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.
167
+ * @param getNoClickRate.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
151
168
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
152
169
  */
153
170
  getNoClickRate({ index, startDate, endDate, tags }: GetNoClickRateProps, requestOptions?: RequestOptions): Promise<GetNoClickRateResponse>;
154
171
  /**
155
- * Returns the rate at which searches didn\'t return any results.
172
+ * Retrieves the fraction of searches that didn\'t return any results within a time range, including a daily breakdown. By default, the analyzed period includes the last eight days including the current day.
156
173
  *
157
174
  * Required API Key ACLs:
158
175
  * - analytics.
@@ -161,12 +178,40 @@ export declare function createAnalyticsClient({ appId: appIdOption, apiKey: apiK
161
178
  * @param getNoResultsRate.index - Index name.
162
179
  * @param getNoResultsRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
163
180
  * @param getNoResultsRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
164
- * @param getNoResultsRate.tags - 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.
181
+ * @param getNoResultsRate.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
165
182
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
166
183
  */
167
184
  getNoResultsRate({ index, startDate, endDate, tags }: GetNoResultsRateProps, requestOptions?: RequestOptions): Promise<GetNoResultsRateResponse>;
168
185
  /**
169
- * Returns the number of searches within a time range.
186
+ * Retrieves the purchase rate for all of your searches with at least one purchase event, including a daily breakdown. By default, the analyzed period includes the last eight days including the current day.
187
+ *
188
+ * Required API Key ACLs:
189
+ * - analytics.
190
+ *
191
+ * @param getPurchaseRate - The getPurchaseRate object.
192
+ * @param getPurchaseRate.index - Index name.
193
+ * @param getPurchaseRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
194
+ * @param getPurchaseRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
195
+ * @param getPurchaseRate.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
196
+ * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
197
+ */
198
+ getPurchaseRate({ index, startDate, endDate, tags }: GetPurchaseRateProps, requestOptions?: RequestOptions): Promise<GetPurchaseRateResponse>;
199
+ /**
200
+ * Retrieves revenue-related metrics, such as the total revenue or the average order value. To retrieve revenue-related metrics, sent purchase events. By default, the analyzed period includes the last eight days including the current day.
201
+ *
202
+ * Required API Key ACLs:
203
+ * - analytics.
204
+ *
205
+ * @param getRevenue - The getRevenue object.
206
+ * @param getRevenue.index - Index name.
207
+ * @param getRevenue.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
208
+ * @param getRevenue.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
209
+ * @param getRevenue.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
210
+ * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
211
+ */
212
+ getRevenue({ index, startDate, endDate, tags }: GetRevenueProps, requestOptions?: RequestOptions): Promise<GetRevenue>;
213
+ /**
214
+ * Retrieves the number of searches within a time range, including a daily breakdown. By default, the analyzed period includes the last eight days including the current day.
170
215
  *
171
216
  * Required API Key ACLs:
172
217
  * - analytics.
@@ -175,12 +220,12 @@ export declare function createAnalyticsClient({ appId: appIdOption, apiKey: apiK
175
220
  * @param getSearchesCount.index - Index name.
176
221
  * @param getSearchesCount.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
177
222
  * @param getSearchesCount.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
178
- * @param getSearchesCount.tags - 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.
223
+ * @param getSearchesCount.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
179
224
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
180
225
  */
181
226
  getSearchesCount({ index, startDate, endDate, tags }: GetSearchesCountProps, requestOptions?: RequestOptions): Promise<GetSearchesCountResponse>;
182
227
  /**
183
- * Return the most popular of the last 1,000 searches that didn\'t lead to any clicks.
228
+ * Retrieves the most popular searches that didn\'t lead to any clicks, from the 1,000 most frequent searches.
184
229
  *
185
230
  * Required API Key ACLs:
186
231
  * - analytics.
@@ -191,12 +236,12 @@ export declare function createAnalyticsClient({ appId: appIdOption, apiKey: apiK
191
236
  * @param getSearchesNoClicks.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
192
237
  * @param getSearchesNoClicks.limit - Number of items to return.
193
238
  * @param getSearchesNoClicks.offset - Position of the first item to return.
194
- * @param getSearchesNoClicks.tags - 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.
239
+ * @param getSearchesNoClicks.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
195
240
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
196
241
  */
197
242
  getSearchesNoClicks({ index, startDate, endDate, limit, offset, tags, }: GetSearchesNoClicksProps, requestOptions?: RequestOptions): Promise<GetSearchesNoClicksResponse>;
198
243
  /**
199
- * Returns the most popular of the latest 1,000 searches that didn\'t return any results.
244
+ * Retrieves the most popular searches that didn\'t return any results.
200
245
  *
201
246
  * Required API Key ACLs:
202
247
  * - analytics.
@@ -207,12 +252,12 @@ export declare function createAnalyticsClient({ appId: appIdOption, apiKey: apiK
207
252
  * @param getSearchesNoResults.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
208
253
  * @param getSearchesNoResults.limit - Number of items to return.
209
254
  * @param getSearchesNoResults.offset - Position of the first item to return.
210
- * @param getSearchesNoResults.tags - 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.
255
+ * @param getSearchesNoResults.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
211
256
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
212
257
  */
213
258
  getSearchesNoResults({ index, startDate, endDate, limit, offset, tags, }: GetSearchesNoResultsProps, requestOptions?: RequestOptions): Promise<GetSearchesNoResultsResponse>;
214
259
  /**
215
- * Return the latest update time of the Analytics API for an index. If the index has been recently created or no search has been performed yet, `updatedAt` will be `null`. > **Note**: The Analytics API is updated every 5&nbsp;minutes.
260
+ * Retrieves the time when the Analytics data for the specified index was last updated. The Analytics data is updated every 5 minutes.
216
261
  *
217
262
  * Required API Key ACLs:
218
263
  * - analytics.
@@ -223,7 +268,7 @@ export declare function createAnalyticsClient({ appId: appIdOption, apiKey: apiK
223
268
  */
224
269
  getStatus({ index }: GetStatusProps, requestOptions?: RequestOptions): Promise<GetStatusResponse>;
225
270
  /**
226
- * Returns top countries. Limited to the 1,000 most frequent ones.
271
+ * Retrieves the countries with the most searches to your index.
227
272
  *
228
273
  * Required API Key ACLs:
229
274
  * - analytics.
@@ -234,29 +279,29 @@ export declare function createAnalyticsClient({ appId: appIdOption, apiKey: apiK
234
279
  * @param getTopCountries.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
235
280
  * @param getTopCountries.limit - Number of items to return.
236
281
  * @param getTopCountries.offset - Position of the first item to return.
237
- * @param getTopCountries.tags - 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.
282
+ * @param getTopCountries.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
238
283
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
239
284
  */
240
285
  getTopCountries({ index, startDate, endDate, limit, offset, tags }: GetTopCountriesProps, requestOptions?: RequestOptions): Promise<GetTopCountriesResponse>;
241
286
  /**
242
- * Return the most popular [filterable attributes](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering/) in the 1,000 most recently used filters.
287
+ * Retrieves the most frequently used filter attributes. These are attributes of your records that you included in the `attributesForFaceting` setting.
243
288
  *
244
289
  * Required API Key ACLs:
245
290
  * - analytics.
246
291
  *
247
292
  * @param getTopFilterAttributes - The getTopFilterAttributes object.
248
293
  * @param getTopFilterAttributes.index - Index name.
249
- * @param getTopFilterAttributes.search - User query.
294
+ * @param getTopFilterAttributes.search - Search query.
250
295
  * @param getTopFilterAttributes.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
251
296
  * @param getTopFilterAttributes.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
252
297
  * @param getTopFilterAttributes.limit - Number of items to return.
253
298
  * @param getTopFilterAttributes.offset - Position of the first item to return.
254
- * @param getTopFilterAttributes.tags - 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.
299
+ * @param getTopFilterAttributes.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
255
300
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
256
301
  */
257
302
  getTopFilterAttributes({ index, search, startDate, endDate, limit, offset, tags, }: GetTopFilterAttributesProps, requestOptions?: RequestOptions): Promise<GetTopFilterAttributesResponse>;
258
303
  /**
259
- * Returns the most popular filter values for an attribute in the 1,000 most recently used filters.
304
+ * Retrieves the most frequent filter (facet) values for a filter attribute. These are attributes of your records that you included in the `attributesForFaceting` setting.
260
305
  *
261
306
  * Required API Key ACLs:
262
307
  * - analytics.
@@ -264,71 +309,73 @@ export declare function createAnalyticsClient({ appId: appIdOption, apiKey: apiK
264
309
  * @param getTopFilterForAttribute - The getTopFilterForAttribute object.
265
310
  * @param getTopFilterForAttribute.attribute - Attribute name.
266
311
  * @param getTopFilterForAttribute.index - Index name.
267
- * @param getTopFilterForAttribute.search - User query.
312
+ * @param getTopFilterForAttribute.search - Search query.
268
313
  * @param getTopFilterForAttribute.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
269
314
  * @param getTopFilterForAttribute.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
270
315
  * @param getTopFilterForAttribute.limit - Number of items to return.
271
316
  * @param getTopFilterForAttribute.offset - Position of the first item to return.
272
- * @param getTopFilterForAttribute.tags - 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.
317
+ * @param getTopFilterForAttribute.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
273
318
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
274
319
  */
275
320
  getTopFilterForAttribute({ attribute, index, search, startDate, endDate, limit, offset, tags, }: GetTopFilterForAttributeProps, requestOptions?: RequestOptions): Promise<GetTopFilterForAttributeResponse>;
276
321
  /**
277
- * Returns top filters for filter-enabled searches that don\'t return results. Limited to the 1,000 most recently used filters.
322
+ * Retrieves the most frequently used filters for a search that didn\'t return any results. To get the most frequent searches without results, use the [Retrieve searches without results](#tag/search/operation/getSearchesNoResults) operation.
278
323
  *
279
324
  * Required API Key ACLs:
280
325
  * - analytics.
281
326
  *
282
327
  * @param getTopFiltersNoResults - The getTopFiltersNoResults object.
283
328
  * @param getTopFiltersNoResults.index - Index name.
284
- * @param getTopFiltersNoResults.search - User query.
329
+ * @param getTopFiltersNoResults.search - Search query.
285
330
  * @param getTopFiltersNoResults.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
286
331
  * @param getTopFiltersNoResults.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
287
332
  * @param getTopFiltersNoResults.limit - Number of items to return.
288
333
  * @param getTopFiltersNoResults.offset - Position of the first item to return.
289
- * @param getTopFiltersNoResults.tags - 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.
334
+ * @param getTopFiltersNoResults.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
290
335
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
291
336
  */
292
337
  getTopFiltersNoResults({ index, search, startDate, endDate, limit, offset, tags, }: GetTopFiltersNoResultsProps, requestOptions?: RequestOptions): Promise<GetTopFiltersNoResultsResponse>;
293
338
  /**
294
- * Return the most popular clicked results in the last 1,000 searches.
339
+ * Retrieves the object IDs of the most frequent search results.
295
340
  *
296
341
  * Required API Key ACLs:
297
342
  * - analytics.
298
343
  *
299
344
  * @param getTopHits - The getTopHits object.
300
345
  * @param getTopHits.index - Index name.
301
- * @param getTopHits.search - User query.
302
- * @param getTopHits.clickAnalytics - Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
346
+ * @param getTopHits.search - Search query.
347
+ * @param getTopHits.clickAnalytics - Whether to include metrics related to click and conversion events in the response.
348
+ * @param getTopHits.revenueAnalytics - Whether to include revenue-related metrics in the response. If true, metrics related to click and conversion events are also included in the response.
303
349
  * @param getTopHits.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
304
350
  * @param getTopHits.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
305
351
  * @param getTopHits.limit - Number of items to return.
306
352
  * @param getTopHits.offset - Position of the first item to return.
307
- * @param getTopHits.tags - 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.
353
+ * @param getTopHits.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
308
354
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
309
355
  */
310
- getTopHits({ index, search, clickAnalytics, startDate, endDate, limit, offset, tags, }: GetTopHitsProps, requestOptions?: RequestOptions): Promise<GetTopHitsResponse>;
356
+ getTopHits({ index, search, clickAnalytics, revenueAnalytics, startDate, endDate, limit, offset, tags, }: GetTopHitsProps, requestOptions?: RequestOptions): Promise<GetTopHitsResponse>;
311
357
  /**
312
- * Returns the most popular of the latest 1,000 searches. For each search, also returns the number of hits.
358
+ * Returns the most popular search terms.
313
359
  *
314
360
  * Required API Key ACLs:
315
361
  * - analytics.
316
362
  *
317
363
  * @param getTopSearches - The getTopSearches object.
318
364
  * @param getTopSearches.index - Index name.
319
- * @param getTopSearches.clickAnalytics - Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
365
+ * @param getTopSearches.clickAnalytics - Whether to include metrics related to click and conversion events in the response.
366
+ * @param getTopSearches.revenueAnalytics - Whether to include revenue-related metrics in the response. If true, metrics related to click and conversion events are also included in the response.
320
367
  * @param getTopSearches.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
321
368
  * @param getTopSearches.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
322
- * @param getTopSearches.orderBy - Reorder the results.
369
+ * @param getTopSearches.orderBy - Attribute by which to order the response items. If the `clickAnalytics` parameter is false, only `searchCount` is available.
323
370
  * @param getTopSearches.direction - Sorting direction of the results: ascending or descending.
324
371
  * @param getTopSearches.limit - Number of items to return.
325
372
  * @param getTopSearches.offset - Position of the first item to return.
326
- * @param getTopSearches.tags - 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.
373
+ * @param getTopSearches.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
327
374
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
328
375
  */
329
- getTopSearches({ index, clickAnalytics, startDate, endDate, orderBy, direction, limit, offset, tags, }: GetTopSearchesProps, requestOptions?: RequestOptions): Promise<GetTopSearchesResponse>;
376
+ getTopSearches({ index, clickAnalytics, revenueAnalytics, startDate, endDate, orderBy, direction, limit, offset, tags, }: GetTopSearchesProps, requestOptions?: RequestOptions): Promise<GetTopSearchesResponse>;
330
377
  /**
331
- * Return the count of unique users.
378
+ * Retrieves the number of unique users within a time range, including a daily breakdown. Since this endpoint returns the number of unique users, the sum of the daily values might be different from the total number. By default, Algolia distinguishes search users by their IP address, _unless_ you include a pseudonymous user identifier in your search requests with the `userToken` API parameter or `x-algolia-usertoken` request header. By default, the analyzed period includes the last eight days including the current day.
332
379
  *
333
380
  * Required API Key ACLs:
334
381
  * - analytics.
@@ -337,7 +384,7 @@ export declare function createAnalyticsClient({ appId: appIdOption, apiKey: apiK
337
384
  * @param getUsersCount.index - Index name.
338
385
  * @param getUsersCount.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
339
386
  * @param getUsersCount.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
340
- * @param getUsersCount.tags - 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.
387
+ * @param getUsersCount.tags - Tags by which to segment the analytics. You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
341
388
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
342
389
  */
343
390
  getUsersCount({ index, startDate, endDate, tags }: GetUsersCountProps, requestOptions?: RequestOptions): Promise<GetUsersCountResponse>;
@@ -1 +1 @@
1
- {"version":3,"file":"analyticsClient.d.ts","sourceRoot":"","sources":["../../src/analyticsClient.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"analyticsClient.d.ts","sourceRoot":"","sources":["../../src/analyticsClient.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
2
+
3
+ /**
4
+ * Click position.
5
+ */
6
+ export type ClickPositionsInner = {
7
+ /**
8
+ * Range of positions in the search results, using the pattern `[start,end]`. For positions 11 and up, click events are summed over the specified range. `-1` indicates the end of the list of search results.
9
+ */
10
+ position?: number[];
11
+
12
+ /**
13
+ * Number of times this search has been clicked at that position.
14
+ */
15
+ clickCount?: number;
16
+ };