algoliasearch 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 (141) hide show
  1. package/dist/algoliasearch/builds/browser.d.ts +1 -1
  2. package/dist/algoliasearch/builds/node.d.ts +1 -1
  3. package/dist/algoliasearch.cjs +196 -68
  4. package/dist/algoliasearch.esm.browser.js +197 -69
  5. package/dist/algoliasearch.esm.node.js +196 -68
  6. package/dist/algoliasearch.umd.js +2 -2
  7. package/dist/client-abtesting/model/{currenciesValue.d.ts → currency.d.ts} +2 -2
  8. package/dist/client-abtesting/model/currency.d.ts.map +1 -0
  9. package/dist/client-abtesting/model/index.d.ts +1 -1
  10. package/dist/client-abtesting/model/index.d.ts.map +1 -1
  11. package/dist/client-abtesting/model/variant.d.ts +4 -4
  12. package/dist/client-abtesting/model/variant.d.ts.map +1 -1
  13. package/dist/client-abtesting/src/abtestingClient.d.ts +1 -1
  14. package/dist/client-analytics/model/clickPositionsInner.d.ts +14 -0
  15. package/dist/client-analytics/model/clickPositionsInner.d.ts.map +1 -0
  16. package/dist/client-analytics/model/clientMethodProps.d.ts +96 -25
  17. package/dist/client-analytics/model/clientMethodProps.d.ts.map +1 -1
  18. package/dist/client-analytics/model/currenciesValue.d.ts +14 -0
  19. package/dist/client-analytics/model/currenciesValue.d.ts.map +1 -0
  20. package/dist/client-analytics/model/dailyAddToCartRates.d.ts +19 -0
  21. package/dist/client-analytics/model/dailyAddToCartRates.d.ts.map +1 -0
  22. package/dist/client-analytics/model/dailyAverageClicks.d.ts +15 -0
  23. package/dist/client-analytics/model/dailyAverageClicks.d.ts.map +1 -0
  24. package/dist/client-analytics/model/dailyClickThroughRates.d.ts +19 -0
  25. package/dist/client-analytics/model/dailyClickThroughRates.d.ts.map +1 -0
  26. package/dist/client-analytics/model/dailyConversionRates.d.ts +19 -0
  27. package/dist/client-analytics/model/dailyConversionRates.d.ts.map +1 -0
  28. package/dist/client-analytics/model/dailyNoClickRates.d.ts +19 -0
  29. package/dist/client-analytics/model/dailyNoClickRates.d.ts.map +1 -0
  30. package/dist/client-analytics/model/dailyNoResultsRates.d.ts +19 -0
  31. package/dist/client-analytics/model/dailyNoResultsRates.d.ts.map +1 -0
  32. package/dist/client-analytics/model/dailyPurchaseRates.d.ts +19 -0
  33. package/dist/client-analytics/model/dailyPurchaseRates.d.ts.map +1 -0
  34. package/dist/client-analytics/model/dailyRevenue.d.ts +12 -0
  35. package/dist/client-analytics/model/dailyRevenue.d.ts.map +1 -0
  36. package/dist/client-analytics/model/dailySearches.d.ts +11 -0
  37. package/dist/client-analytics/model/dailySearches.d.ts.map +1 -0
  38. package/dist/client-analytics/model/dailySearchesNoClicks.d.ts +15 -0
  39. package/dist/client-analytics/model/dailySearchesNoClicks.d.ts.map +1 -0
  40. package/dist/client-analytics/model/dailySearchesNoResults.d.ts +15 -0
  41. package/dist/client-analytics/model/dailySearchesNoResults.d.ts.map +1 -0
  42. package/dist/client-analytics/model/dailyUsers.d.ts +11 -0
  43. package/dist/client-analytics/model/dailyUsers.d.ts.map +1 -0
  44. package/dist/client-analytics/model/getAddToCartRateResponse.d.ts +20 -0
  45. package/dist/client-analytics/model/getAddToCartRateResponse.d.ts.map +1 -0
  46. package/dist/client-analytics/model/getAverageClickPositionResponse.d.ts +6 -6
  47. package/dist/client-analytics/model/getAverageClickPositionResponse.d.ts.map +1 -1
  48. package/dist/client-analytics/model/getClickPositionsResponse.d.ts +3 -3
  49. package/dist/client-analytics/model/getClickPositionsResponse.d.ts.map +1 -1
  50. package/dist/client-analytics/model/getClickThroughRateResponse.d.ts +8 -8
  51. package/dist/client-analytics/model/getClickThroughRateResponse.d.ts.map +1 -1
  52. package/dist/client-analytics/model/getConversionRateResponse.d.ts +20 -0
  53. package/dist/client-analytics/model/getConversionRateResponse.d.ts.map +1 -0
  54. package/dist/client-analytics/model/getNoClickRateResponse.d.ts +6 -6
  55. package/dist/client-analytics/model/getNoClickRateResponse.d.ts.map +1 -1
  56. package/dist/client-analytics/model/getNoResultsRateResponse.d.ts +6 -6
  57. package/dist/client-analytics/model/getNoResultsRateResponse.d.ts.map +1 -1
  58. package/dist/client-analytics/model/getPurchaseRateResponse.d.ts +20 -0
  59. package/dist/client-analytics/model/getPurchaseRateResponse.d.ts.map +1 -0
  60. package/dist/client-analytics/model/getRevenue.d.ts +13 -0
  61. package/dist/client-analytics/model/getRevenue.d.ts.map +1 -0
  62. package/dist/client-analytics/model/getSearchesCountResponse.d.ts +3 -3
  63. package/dist/client-analytics/model/getSearchesCountResponse.d.ts.map +1 -1
  64. package/dist/client-analytics/model/getSearchesNoClicksResponse.d.ts +3 -3
  65. package/dist/client-analytics/model/getSearchesNoClicksResponse.d.ts.map +1 -1
  66. package/dist/client-analytics/model/getSearchesNoResultsResponse.d.ts +3 -3
  67. package/dist/client-analytics/model/getSearchesNoResultsResponse.d.ts.map +1 -1
  68. package/dist/client-analytics/model/getStatusResponse.d.ts +2 -2
  69. package/dist/client-analytics/model/getStatusResponse.d.ts.map +1 -1
  70. package/dist/client-analytics/model/getTopCountriesResponse.d.ts +1 -1
  71. package/dist/client-analytics/model/getTopFilterAttributesResponse.d.ts +1 -1
  72. package/dist/client-analytics/model/getTopFilterForAttribute.d.ts +2 -4
  73. package/dist/client-analytics/model/getTopFilterForAttribute.d.ts.map +1 -1
  74. package/dist/client-analytics/model/getTopFiltersNoResultsResponse.d.ts +2 -2
  75. package/dist/client-analytics/model/getTopFiltersNoResultsResponse.d.ts.map +1 -1
  76. package/dist/client-analytics/model/getTopFiltersNoResultsValue.d.ts +2 -4
  77. package/dist/client-analytics/model/getTopFiltersNoResultsValue.d.ts.map +1 -1
  78. package/dist/client-analytics/model/getTopHitsResponse.d.ts +2 -1
  79. package/dist/client-analytics/model/getTopHitsResponse.d.ts.map +1 -1
  80. package/dist/client-analytics/model/getTopSearchesResponse.d.ts +2 -1
  81. package/dist/client-analytics/model/getTopSearchesResponse.d.ts.map +1 -1
  82. package/dist/client-analytics/model/getUsersCountResponse.d.ts +4 -4
  83. package/dist/client-analytics/model/getUsersCountResponse.d.ts.map +1 -1
  84. package/dist/client-analytics/model/index.d.ts +23 -11
  85. package/dist/client-analytics/model/index.d.ts.map +1 -1
  86. package/dist/client-analytics/model/operator.d.ts +5 -0
  87. package/dist/client-analytics/model/operator.d.ts.map +1 -0
  88. package/dist/client-analytics/model/orderBy.d.ts +1 -1
  89. package/dist/client-analytics/model/topCountry.d.ts +1 -1
  90. package/dist/client-analytics/model/topHit.d.ts +1 -1
  91. package/dist/client-analytics/model/topHitWithAnalytics.d.ts +9 -9
  92. package/dist/client-analytics/model/topHitWithAnalytics.d.ts.map +1 -1
  93. package/dist/client-analytics/model/topHitWithRevenueAnalytics.d.ts +52 -0
  94. package/dist/client-analytics/model/topHitWithRevenueAnalytics.d.ts.map +1 -0
  95. package/dist/client-analytics/model/topHitsResponse.d.ts +1 -1
  96. package/dist/client-analytics/model/topHitsResponseWithAnalytics.d.ts +1 -1
  97. package/dist/client-analytics/model/topHitsResponseWithRevenueAnalytics.d.ts +8 -0
  98. package/dist/client-analytics/model/topHitsResponseWithRevenueAnalytics.d.ts.map +1 -0
  99. package/dist/client-analytics/model/topSearch.d.ts +2 -2
  100. package/dist/client-analytics/model/topSearchWithAnalytics.d.ts +17 -12
  101. package/dist/client-analytics/model/topSearchWithAnalytics.d.ts.map +1 -1
  102. package/dist/client-analytics/model/topSearchWithRevenueAnalytics.d.ts +65 -0
  103. package/dist/client-analytics/model/topSearchWithRevenueAnalytics.d.ts.map +1 -0
  104. package/dist/client-analytics/model/topSearchesResponse.d.ts +1 -1
  105. package/dist/client-analytics/model/topSearchesResponseWithAnalytics.d.ts +1 -1
  106. package/dist/client-analytics/model/topSearchesResponseWithRevenueAnalytics.d.ts +8 -0
  107. package/dist/client-analytics/model/topSearchesResponseWithRevenueAnalytics.d.ts.map +1 -0
  108. package/dist/client-analytics/src/analyticsClient.d.ts +97 -50
  109. package/dist/client-analytics/src/analyticsClient.d.ts.map +1 -1
  110. package/dist/client-personalization/src/personalizationClient.d.ts +1 -1
  111. package/dist/client-search/src/searchClient.d.ts +1 -1
  112. package/dist/lite/lite.cjs +2 -2
  113. package/dist/lite/lite.esm.browser.js +3 -3
  114. package/dist/lite/lite.esm.node.js +2 -2
  115. package/dist/lite/lite.umd.js +2 -2
  116. package/dist/lite/src/liteClient.d.ts +1 -1
  117. package/lite/src/liteClient.ts +2 -2
  118. package/package.json +12 -12
  119. package/dist/client-abtesting/model/currenciesValue.d.ts.map +0 -1
  120. package/dist/client-analytics/model/averageClickEvent.d.ts +0 -15
  121. package/dist/client-analytics/model/averageClickEvent.d.ts.map +0 -1
  122. package/dist/client-analytics/model/clickPosition.d.ts +0 -11
  123. package/dist/client-analytics/model/clickPosition.d.ts.map +0 -1
  124. package/dist/client-analytics/model/clickThroughRateEvent.d.ts +0 -19
  125. package/dist/client-analytics/model/clickThroughRateEvent.d.ts.map +0 -1
  126. package/dist/client-analytics/model/conversionRateEvent.d.ts +0 -19
  127. package/dist/client-analytics/model/conversionRateEvent.d.ts.map +0 -1
  128. package/dist/client-analytics/model/getConversationRateResponse.d.ts +0 -20
  129. package/dist/client-analytics/model/getConversationRateResponse.d.ts.map +0 -1
  130. package/dist/client-analytics/model/noClickRateEvent.d.ts +0 -19
  131. package/dist/client-analytics/model/noClickRateEvent.d.ts.map +0 -1
  132. package/dist/client-analytics/model/noResultsRateEvent.d.ts +0 -19
  133. package/dist/client-analytics/model/noResultsRateEvent.d.ts.map +0 -1
  134. package/dist/client-analytics/model/searchEvent.d.ts +0 -11
  135. package/dist/client-analytics/model/searchEvent.d.ts.map +0 -1
  136. package/dist/client-analytics/model/searchNoClickEvent.d.ts +0 -15
  137. package/dist/client-analytics/model/searchNoClickEvent.d.ts.map +0 -1
  138. package/dist/client-analytics/model/searchNoResultEvent.d.ts +0 -15
  139. package/dist/client-analytics/model/searchNoResultEvent.d.ts.map +0 -1
  140. package/dist/client-analytics/model/userWithDate.d.ts +0 -11
  141. package/dist/client-analytics/model/userWithDate.d.ts.map +0 -1
@@ -247,7 +247,7 @@ function _toPrimitive(t, r) {
247
247
  }
248
248
  function _toPropertyKey(t) {
249
249
  var i = _toPrimitive(t, "string");
250
- return "symbol" == typeof i ? i : String(i);
250
+ return "symbol" == typeof i ? i : i + "";
251
251
  }
252
252
  function _defineProperty(obj, key, value) {
253
253
  key = _toPropertyKey(key);
@@ -685,7 +685,7 @@ const DEFAULT_READ_TIMEOUT_BROWSER = 2000;
685
685
  const DEFAULT_WRITE_TIMEOUT_BROWSER = 30000;
686
686
 
687
687
  // 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.
688
- const apiClientVersion$4 = '5.0.0-alpha.108';
688
+ const apiClientVersion$4 = '5.0.0-alpha.109';
689
689
  const REGIONS$2 = ['de', 'us'];
690
690
  function getDefaultHosts$3(region) {
691
691
  const url = !region
@@ -790,7 +790,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
790
790
  if (!path) {
791
791
  throw new Error('Parameter `path` is required when calling `customDelete`.');
792
792
  }
793
- const requestPath = '/1{path}'.replace('{path}', path);
793
+ const requestPath = '/{path}'.replace('{path}', path);
794
794
  const headers = {};
795
795
  const queryParameters = parameters ? parameters : {};
796
796
  const request = {
@@ -813,7 +813,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
813
813
  if (!path) {
814
814
  throw new Error('Parameter `path` is required when calling `customGet`.');
815
815
  }
816
- const requestPath = '/1{path}'.replace('{path}', path);
816
+ const requestPath = '/{path}'.replace('{path}', path);
817
817
  const headers = {};
818
818
  const queryParameters = parameters ? parameters : {};
819
819
  const request = {
@@ -837,7 +837,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
837
837
  if (!path) {
838
838
  throw new Error('Parameter `path` is required when calling `customPost`.');
839
839
  }
840
- const requestPath = '/1{path}'.replace('{path}', path);
840
+ const requestPath = '/{path}'.replace('{path}', path);
841
841
  const headers = {};
842
842
  const queryParameters = parameters ? parameters : {};
843
843
  const request = {
@@ -862,7 +862,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
862
862
  if (!path) {
863
863
  throw new Error('Parameter `path` is required when calling `customPut`.');
864
864
  }
865
- const requestPath = '/1{path}'.replace('{path}', path);
865
+ const requestPath = '/{path}'.replace('{path}', path);
866
866
  const headers = {};
867
867
  const queryParameters = parameters ? parameters : {};
868
868
  const request = {
@@ -990,7 +990,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
990
990
  }
991
991
 
992
992
  // 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.
993
- const apiClientVersion$3 = '5.0.0-alpha.108';
993
+ const apiClientVersion$3 = '5.0.0-alpha.109';
994
994
  const REGIONS$1 = ['de', 'us'];
995
995
  function getDefaultHosts$2(region) {
996
996
  const url = !region
@@ -1061,7 +1061,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1061
1061
  if (!path) {
1062
1062
  throw new Error('Parameter `path` is required when calling `customDelete`.');
1063
1063
  }
1064
- const requestPath = '/1{path}'.replace('{path}', path);
1064
+ const requestPath = '/{path}'.replace('{path}', path);
1065
1065
  const headers = {};
1066
1066
  const queryParameters = parameters ? parameters : {};
1067
1067
  const request = {
@@ -1084,7 +1084,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1084
1084
  if (!path) {
1085
1085
  throw new Error('Parameter `path` is required when calling `customGet`.');
1086
1086
  }
1087
- const requestPath = '/1{path}'.replace('{path}', path);
1087
+ const requestPath = '/{path}'.replace('{path}', path);
1088
1088
  const headers = {};
1089
1089
  const queryParameters = parameters ? parameters : {};
1090
1090
  const request = {
@@ -1108,7 +1108,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1108
1108
  if (!path) {
1109
1109
  throw new Error('Parameter `path` is required when calling `customPost`.');
1110
1110
  }
1111
- const requestPath = '/1{path}'.replace('{path}', path);
1111
+ const requestPath = '/{path}'.replace('{path}', path);
1112
1112
  const headers = {};
1113
1113
  const queryParameters = parameters ? parameters : {};
1114
1114
  const request = {
@@ -1133,7 +1133,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1133
1133
  if (!path) {
1134
1134
  throw new Error('Parameter `path` is required when calling `customPut`.');
1135
1135
  }
1136
- const requestPath = '/1{path}'.replace('{path}', path);
1136
+ const requestPath = '/{path}'.replace('{path}', path);
1137
1137
  const headers = {};
1138
1138
  const queryParameters = parameters ? parameters : {};
1139
1139
  const request = {
@@ -1146,7 +1146,47 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1146
1146
  return transporter.request(request, requestOptions);
1147
1147
  },
1148
1148
  /**
1149
- * 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`.
1149
+ * 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.
1150
+ *
1151
+ * Required API Key ACLs:
1152
+ * - analytics.
1153
+ *
1154
+ * @param getAddToCartRate - The getAddToCartRate object.
1155
+ * @param getAddToCartRate.index - Index name.
1156
+ * @param getAddToCartRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1157
+ * @param getAddToCartRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1158
+ * @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/).
1159
+ * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1160
+ */
1161
+ getAddToCartRate({ index, startDate, endDate, tags }, requestOptions) {
1162
+ if (!index) {
1163
+ throw new Error('Parameter `index` is required when calling `getAddToCartRate`.');
1164
+ }
1165
+ const requestPath = '/2/conversions/addToCartRate';
1166
+ const headers = {};
1167
+ const queryParameters = {};
1168
+ if (index !== undefined) {
1169
+ queryParameters.index = index.toString();
1170
+ }
1171
+ if (startDate !== undefined) {
1172
+ queryParameters.startDate = startDate.toString();
1173
+ }
1174
+ if (endDate !== undefined) {
1175
+ queryParameters.endDate = endDate.toString();
1176
+ }
1177
+ if (tags !== undefined) {
1178
+ queryParameters.tags = tags.toString();
1179
+ }
1180
+ const request = {
1181
+ method: 'GET',
1182
+ path: requestPath,
1183
+ queryParameters,
1184
+ headers,
1185
+ };
1186
+ return transporter.request(request, requestOptions);
1187
+ },
1188
+ /**
1189
+ * 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.
1150
1190
  *
1151
1191
  * Required API Key ACLs:
1152
1192
  * - analytics.
@@ -1155,7 +1195,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1155
1195
  * @param getAverageClickPosition.index - Index name.
1156
1196
  * @param getAverageClickPosition.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1157
1197
  * @param getAverageClickPosition.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1158
- * @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.
1198
+ * @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/).
1159
1199
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1160
1200
  */
1161
1201
  getAverageClickPosition({ index, startDate, endDate, tags }, requestOptions) {
@@ -1186,7 +1226,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1186
1226
  return transporter.request(request, requestOptions);
1187
1227
  },
1188
1228
  /**
1189
- * 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`.
1229
+ * 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.
1190
1230
  *
1191
1231
  * Required API Key ACLs:
1192
1232
  * - analytics.
@@ -1195,7 +1235,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1195
1235
  * @param getClickPositions.index - Index name.
1196
1236
  * @param getClickPositions.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1197
1237
  * @param getClickPositions.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1198
- * @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.
1238
+ * @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/).
1199
1239
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1200
1240
  */
1201
1241
  getClickPositions({ index, startDate, endDate, tags }, requestOptions) {
@@ -1226,7 +1266,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1226
1266
  return transporter.request(request, requestOptions);
1227
1267
  },
1228
1268
  /**
1229
- * Returns a [click-through rate (CTR)](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#click-through-rate).
1269
+ * 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.
1230
1270
  *
1231
1271
  * Required API Key ACLs:
1232
1272
  * - analytics.
@@ -1235,7 +1275,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1235
1275
  * @param getClickThroughRate.index - Index name.
1236
1276
  * @param getClickThroughRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1237
1277
  * @param getClickThroughRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1238
- * @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.
1278
+ * @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/).
1239
1279
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1240
1280
  */
1241
1281
  getClickThroughRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -1266,21 +1306,21 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1266
1306
  return transporter.request(request, requestOptions);
1267
1307
  },
1268
1308
  /**
1269
- * Return a [conversion rate](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#conversion-rate).
1309
+ * 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.
1270
1310
  *
1271
1311
  * Required API Key ACLs:
1272
1312
  * - analytics.
1273
1313
  *
1274
- * @param getConversationRate - The getConversationRate object.
1275
- * @param getConversationRate.index - Index name.
1276
- * @param getConversationRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1277
- * @param getConversationRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1278
- * @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.
1314
+ * @param getConversionRate - The getConversionRate object.
1315
+ * @param getConversionRate.index - Index name.
1316
+ * @param getConversionRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1317
+ * @param getConversionRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1318
+ * @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/).
1279
1319
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1280
1320
  */
1281
- getConversationRate({ index, startDate, endDate, tags }, requestOptions) {
1321
+ getConversionRate({ index, startDate, endDate, tags }, requestOptions) {
1282
1322
  if (!index) {
1283
- throw new Error('Parameter `index` is required when calling `getConversationRate`.');
1323
+ throw new Error('Parameter `index` is required when calling `getConversionRate`.');
1284
1324
  }
1285
1325
  const requestPath = '/2/conversions/conversionRate';
1286
1326
  const headers = {};
@@ -1306,7 +1346,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1306
1346
  return transporter.request(request, requestOptions);
1307
1347
  },
1308
1348
  /**
1309
- * 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.
1349
+ * 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.
1310
1350
  *
1311
1351
  * Required API Key ACLs:
1312
1352
  * - analytics.
@@ -1315,7 +1355,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1315
1355
  * @param getNoClickRate.index - Index name.
1316
1356
  * @param getNoClickRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1317
1357
  * @param getNoClickRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1318
- * @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.
1358
+ * @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/).
1319
1359
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1320
1360
  */
1321
1361
  getNoClickRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -1346,7 +1386,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1346
1386
  return transporter.request(request, requestOptions);
1347
1387
  },
1348
1388
  /**
1349
- * Returns the rate at which searches didn\'t return any results.
1389
+ * 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.
1350
1390
  *
1351
1391
  * Required API Key ACLs:
1352
1392
  * - analytics.
@@ -1355,7 +1395,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1355
1395
  * @param getNoResultsRate.index - Index name.
1356
1396
  * @param getNoResultsRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1357
1397
  * @param getNoResultsRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1358
- * @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.
1398
+ * @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/).
1359
1399
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1360
1400
  */
1361
1401
  getNoResultsRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -1386,7 +1426,87 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1386
1426
  return transporter.request(request, requestOptions);
1387
1427
  },
1388
1428
  /**
1389
- * Returns the number of searches within a time range.
1429
+ * 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.
1430
+ *
1431
+ * Required API Key ACLs:
1432
+ * - analytics.
1433
+ *
1434
+ * @param getPurchaseRate - The getPurchaseRate object.
1435
+ * @param getPurchaseRate.index - Index name.
1436
+ * @param getPurchaseRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1437
+ * @param getPurchaseRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1438
+ * @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/).
1439
+ * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1440
+ */
1441
+ getPurchaseRate({ index, startDate, endDate, tags }, requestOptions) {
1442
+ if (!index) {
1443
+ throw new Error('Parameter `index` is required when calling `getPurchaseRate`.');
1444
+ }
1445
+ const requestPath = '/2/conversions/purchaseRate';
1446
+ const headers = {};
1447
+ const queryParameters = {};
1448
+ if (index !== undefined) {
1449
+ queryParameters.index = index.toString();
1450
+ }
1451
+ if (startDate !== undefined) {
1452
+ queryParameters.startDate = startDate.toString();
1453
+ }
1454
+ if (endDate !== undefined) {
1455
+ queryParameters.endDate = endDate.toString();
1456
+ }
1457
+ if (tags !== undefined) {
1458
+ queryParameters.tags = tags.toString();
1459
+ }
1460
+ const request = {
1461
+ method: 'GET',
1462
+ path: requestPath,
1463
+ queryParameters,
1464
+ headers,
1465
+ };
1466
+ return transporter.request(request, requestOptions);
1467
+ },
1468
+ /**
1469
+ * 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.
1470
+ *
1471
+ * Required API Key ACLs:
1472
+ * - analytics.
1473
+ *
1474
+ * @param getRevenue - The getRevenue object.
1475
+ * @param getRevenue.index - Index name.
1476
+ * @param getRevenue.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1477
+ * @param getRevenue.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1478
+ * @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/).
1479
+ * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1480
+ */
1481
+ getRevenue({ index, startDate, endDate, tags }, requestOptions) {
1482
+ if (!index) {
1483
+ throw new Error('Parameter `index` is required when calling `getRevenue`.');
1484
+ }
1485
+ const requestPath = '/2/conversions/revenue';
1486
+ const headers = {};
1487
+ const queryParameters = {};
1488
+ if (index !== undefined) {
1489
+ queryParameters.index = index.toString();
1490
+ }
1491
+ if (startDate !== undefined) {
1492
+ queryParameters.startDate = startDate.toString();
1493
+ }
1494
+ if (endDate !== undefined) {
1495
+ queryParameters.endDate = endDate.toString();
1496
+ }
1497
+ if (tags !== undefined) {
1498
+ queryParameters.tags = tags.toString();
1499
+ }
1500
+ const request = {
1501
+ method: 'GET',
1502
+ path: requestPath,
1503
+ queryParameters,
1504
+ headers,
1505
+ };
1506
+ return transporter.request(request, requestOptions);
1507
+ },
1508
+ /**
1509
+ * 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.
1390
1510
  *
1391
1511
  * Required API Key ACLs:
1392
1512
  * - analytics.
@@ -1395,7 +1515,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1395
1515
  * @param getSearchesCount.index - Index name.
1396
1516
  * @param getSearchesCount.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1397
1517
  * @param getSearchesCount.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1398
- * @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.
1518
+ * @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/).
1399
1519
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1400
1520
  */
1401
1521
  getSearchesCount({ index, startDate, endDate, tags }, requestOptions) {
@@ -1426,7 +1546,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1426
1546
  return transporter.request(request, requestOptions);
1427
1547
  },
1428
1548
  /**
1429
- * Return the most popular of the last 1,000 searches that didn\'t lead to any clicks.
1549
+ * Retrieves the most popular searches that didn\'t lead to any clicks, from the 1,000 most frequent searches.
1430
1550
  *
1431
1551
  * Required API Key ACLs:
1432
1552
  * - analytics.
@@ -1437,7 +1557,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1437
1557
  * @param getSearchesNoClicks.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1438
1558
  * @param getSearchesNoClicks.limit - Number of items to return.
1439
1559
  * @param getSearchesNoClicks.offset - Position of the first item to return.
1440
- * @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.
1560
+ * @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/).
1441
1561
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1442
1562
  */
1443
1563
  getSearchesNoClicks({ index, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -1474,7 +1594,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1474
1594
  return transporter.request(request, requestOptions);
1475
1595
  },
1476
1596
  /**
1477
- * Returns the most popular of the latest 1,000 searches that didn\'t return any results.
1597
+ * Retrieves the most popular searches that didn\'t return any results.
1478
1598
  *
1479
1599
  * Required API Key ACLs:
1480
1600
  * - analytics.
@@ -1485,7 +1605,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1485
1605
  * @param getSearchesNoResults.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1486
1606
  * @param getSearchesNoResults.limit - Number of items to return.
1487
1607
  * @param getSearchesNoResults.offset - Position of the first item to return.
1488
- * @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.
1608
+ * @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/).
1489
1609
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1490
1610
  */
1491
1611
  getSearchesNoResults({ index, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -1522,7 +1642,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1522
1642
  return transporter.request(request, requestOptions);
1523
1643
  },
1524
1644
  /**
1525
- * 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 minutes.
1645
+ * Retrieves the time when the Analytics data for the specified index was last updated. The Analytics data is updated every 5 minutes.
1526
1646
  *
1527
1647
  * Required API Key ACLs:
1528
1648
  * - analytics.
@@ -1550,7 +1670,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1550
1670
  return transporter.request(request, requestOptions);
1551
1671
  },
1552
1672
  /**
1553
- * Returns top countries. Limited to the 1,000 most frequent ones.
1673
+ * Retrieves the countries with the most searches to your index.
1554
1674
  *
1555
1675
  * Required API Key ACLs:
1556
1676
  * - analytics.
@@ -1561,7 +1681,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1561
1681
  * @param getTopCountries.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1562
1682
  * @param getTopCountries.limit - Number of items to return.
1563
1683
  * @param getTopCountries.offset - Position of the first item to return.
1564
- * @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.
1684
+ * @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/).
1565
1685
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1566
1686
  */
1567
1687
  getTopCountries({ index, startDate, endDate, limit, offset, tags }, requestOptions) {
@@ -1598,19 +1718,19 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1598
1718
  return transporter.request(request, requestOptions);
1599
1719
  },
1600
1720
  /**
1601
- * 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.
1721
+ * Retrieves the most frequently used filter attributes. These are attributes of your records that you included in the `attributesForFaceting` setting.
1602
1722
  *
1603
1723
  * Required API Key ACLs:
1604
1724
  * - analytics.
1605
1725
  *
1606
1726
  * @param getTopFilterAttributes - The getTopFilterAttributes object.
1607
1727
  * @param getTopFilterAttributes.index - Index name.
1608
- * @param getTopFilterAttributes.search - User query.
1728
+ * @param getTopFilterAttributes.search - Search query.
1609
1729
  * @param getTopFilterAttributes.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1610
1730
  * @param getTopFilterAttributes.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1611
1731
  * @param getTopFilterAttributes.limit - Number of items to return.
1612
1732
  * @param getTopFilterAttributes.offset - Position of the first item to return.
1613
- * @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.
1733
+ * @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/).
1614
1734
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1615
1735
  */
1616
1736
  getTopFilterAttributes({ index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -1650,7 +1770,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1650
1770
  return transporter.request(request, requestOptions);
1651
1771
  },
1652
1772
  /**
1653
- * Returns the most popular filter values for an attribute in the 1,000 most recently used filters.
1773
+ * Retrieves the most frequent filter (facet) values for a filter attribute. These are attributes of your records that you included in the `attributesForFaceting` setting.
1654
1774
  *
1655
1775
  * Required API Key ACLs:
1656
1776
  * - analytics.
@@ -1658,12 +1778,12 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1658
1778
  * @param getTopFilterForAttribute - The getTopFilterForAttribute object.
1659
1779
  * @param getTopFilterForAttribute.attribute - Attribute name.
1660
1780
  * @param getTopFilterForAttribute.index - Index name.
1661
- * @param getTopFilterForAttribute.search - User query.
1781
+ * @param getTopFilterForAttribute.search - Search query.
1662
1782
  * @param getTopFilterForAttribute.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1663
1783
  * @param getTopFilterForAttribute.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1664
1784
  * @param getTopFilterForAttribute.limit - Number of items to return.
1665
1785
  * @param getTopFilterForAttribute.offset - Position of the first item to return.
1666
- * @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.
1786
+ * @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/).
1667
1787
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1668
1788
  */
1669
1789
  getTopFilterForAttribute({ attribute, index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -1706,19 +1826,19 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1706
1826
  return transporter.request(request, requestOptions);
1707
1827
  },
1708
1828
  /**
1709
- * Returns top filters for filter-enabled searches that don\'t return results. Limited to the 1,000 most recently used filters.
1829
+ * 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.
1710
1830
  *
1711
1831
  * Required API Key ACLs:
1712
1832
  * - analytics.
1713
1833
  *
1714
1834
  * @param getTopFiltersNoResults - The getTopFiltersNoResults object.
1715
1835
  * @param getTopFiltersNoResults.index - Index name.
1716
- * @param getTopFiltersNoResults.search - User query.
1836
+ * @param getTopFiltersNoResults.search - Search query.
1717
1837
  * @param getTopFiltersNoResults.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1718
1838
  * @param getTopFiltersNoResults.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1719
1839
  * @param getTopFiltersNoResults.limit - Number of items to return.
1720
1840
  * @param getTopFiltersNoResults.offset - Position of the first item to return.
1721
- * @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.
1841
+ * @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/).
1722
1842
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1723
1843
  */
1724
1844
  getTopFiltersNoResults({ index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -1758,23 +1878,24 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1758
1878
  return transporter.request(request, requestOptions);
1759
1879
  },
1760
1880
  /**
1761
- * Return the most popular clicked results in the last 1,000 searches.
1881
+ * Retrieves the object IDs of the most frequent search results.
1762
1882
  *
1763
1883
  * Required API Key ACLs:
1764
1884
  * - analytics.
1765
1885
  *
1766
1886
  * @param getTopHits - The getTopHits object.
1767
1887
  * @param getTopHits.index - Index name.
1768
- * @param getTopHits.search - User query.
1769
- * @param getTopHits.clickAnalytics - Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
1888
+ * @param getTopHits.search - Search query.
1889
+ * @param getTopHits.clickAnalytics - Whether to include metrics related to click and conversion events in the response.
1890
+ * @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.
1770
1891
  * @param getTopHits.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1771
1892
  * @param getTopHits.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1772
1893
  * @param getTopHits.limit - Number of items to return.
1773
1894
  * @param getTopHits.offset - Position of the first item to return.
1774
- * @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.
1895
+ * @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/).
1775
1896
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1776
1897
  */
1777
- getTopHits({ index, search, clickAnalytics, startDate, endDate, limit, offset, tags, }, requestOptions) {
1898
+ getTopHits({ index, search, clickAnalytics, revenueAnalytics, startDate, endDate, limit, offset, tags, }, requestOptions) {
1778
1899
  if (!index) {
1779
1900
  throw new Error('Parameter `index` is required when calling `getTopHits`.');
1780
1901
  }
@@ -1790,6 +1911,9 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1790
1911
  if (clickAnalytics !== undefined) {
1791
1912
  queryParameters.clickAnalytics = clickAnalytics.toString();
1792
1913
  }
1914
+ if (revenueAnalytics !== undefined) {
1915
+ queryParameters.revenueAnalytics = revenueAnalytics.toString();
1916
+ }
1793
1917
  if (startDate !== undefined) {
1794
1918
  queryParameters.startDate = startDate.toString();
1795
1919
  }
@@ -1814,24 +1938,25 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1814
1938
  return transporter.request(request, requestOptions);
1815
1939
  },
1816
1940
  /**
1817
- * Returns the most popular of the latest 1,000 searches. For each search, also returns the number of hits.
1941
+ * Returns the most popular search terms.
1818
1942
  *
1819
1943
  * Required API Key ACLs:
1820
1944
  * - analytics.
1821
1945
  *
1822
1946
  * @param getTopSearches - The getTopSearches object.
1823
1947
  * @param getTopSearches.index - Index name.
1824
- * @param getTopSearches.clickAnalytics - Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
1948
+ * @param getTopSearches.clickAnalytics - Whether to include metrics related to click and conversion events in the response.
1949
+ * @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.
1825
1950
  * @param getTopSearches.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1826
1951
  * @param getTopSearches.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1827
- * @param getTopSearches.orderBy - Reorder the results.
1952
+ * @param getTopSearches.orderBy - Attribute by which to order the response items. If the `clickAnalytics` parameter is false, only `searchCount` is available.
1828
1953
  * @param getTopSearches.direction - Sorting direction of the results: ascending or descending.
1829
1954
  * @param getTopSearches.limit - Number of items to return.
1830
1955
  * @param getTopSearches.offset - Position of the first item to return.
1831
- * @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.
1956
+ * @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/).
1832
1957
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1833
1958
  */
1834
- getTopSearches({ index, clickAnalytics, startDate, endDate, orderBy, direction, limit, offset, tags, }, requestOptions) {
1959
+ getTopSearches({ index, clickAnalytics, revenueAnalytics, startDate, endDate, orderBy, direction, limit, offset, tags, }, requestOptions) {
1835
1960
  if (!index) {
1836
1961
  throw new Error('Parameter `index` is required when calling `getTopSearches`.');
1837
1962
  }
@@ -1844,6 +1969,9 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1844
1969
  if (clickAnalytics !== undefined) {
1845
1970
  queryParameters.clickAnalytics = clickAnalytics.toString();
1846
1971
  }
1972
+ if (revenueAnalytics !== undefined) {
1973
+ queryParameters.revenueAnalytics = revenueAnalytics.toString();
1974
+ }
1847
1975
  if (startDate !== undefined) {
1848
1976
  queryParameters.startDate = startDate.toString();
1849
1977
  }
@@ -1874,7 +2002,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1874
2002
  return transporter.request(request, requestOptions);
1875
2003
  },
1876
2004
  /**
1877
- * Return the count of unique users.
2005
+ * 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.
1878
2006
  *
1879
2007
  * Required API Key ACLs:
1880
2008
  * - analytics.
@@ -1883,7 +2011,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1883
2011
  * @param getUsersCount.index - Index name.
1884
2012
  * @param getUsersCount.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1885
2013
  * @param getUsersCount.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1886
- * @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.
2014
+ * @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/).
1887
2015
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1888
2016
  */
1889
2017
  getUsersCount({ index, startDate, endDate, tags }, requestOptions) {
@@ -1917,7 +2045,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1917
2045
  }
1918
2046
 
1919
2047
  // 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.
1920
- const apiClientVersion$2 = '5.0.0-alpha.108';
2048
+ const apiClientVersion$2 = '5.0.0-alpha.109';
1921
2049
  const REGIONS = ['eu', 'us'];
1922
2050
  function getDefaultHosts$1(region) {
1923
2051
  const url = 'personalization.{region}.algolia.com'.replace('{region}', region);
@@ -1986,7 +2114,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1986
2114
  if (!path) {
1987
2115
  throw new Error('Parameter `path` is required when calling `customDelete`.');
1988
2116
  }
1989
- const requestPath = '/1{path}'.replace('{path}', path);
2117
+ const requestPath = '/{path}'.replace('{path}', path);
1990
2118
  const headers = {};
1991
2119
  const queryParameters = parameters ? parameters : {};
1992
2120
  const request = {
@@ -2009,7 +2137,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
2009
2137
  if (!path) {
2010
2138
  throw new Error('Parameter `path` is required when calling `customGet`.');
2011
2139
  }
2012
- const requestPath = '/1{path}'.replace('{path}', path);
2140
+ const requestPath = '/{path}'.replace('{path}', path);
2013
2141
  const headers = {};
2014
2142
  const queryParameters = parameters ? parameters : {};
2015
2143
  const request = {
@@ -2033,7 +2161,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
2033
2161
  if (!path) {
2034
2162
  throw new Error('Parameter `path` is required when calling `customPost`.');
2035
2163
  }
2036
- const requestPath = '/1{path}'.replace('{path}', path);
2164
+ const requestPath = '/{path}'.replace('{path}', path);
2037
2165
  const headers = {};
2038
2166
  const queryParameters = parameters ? parameters : {};
2039
2167
  const request = {
@@ -2058,7 +2186,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
2058
2186
  if (!path) {
2059
2187
  throw new Error('Parameter `path` is required when calling `customPut`.');
2060
2188
  }
2061
- const requestPath = '/1{path}'.replace('{path}', path);
2189
+ const requestPath = '/{path}'.replace('{path}', path);
2062
2190
  const headers = {};
2063
2191
  const queryParameters = parameters ? parameters : {};
2064
2192
  const request = {
@@ -2178,7 +2306,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
2178
2306
  }
2179
2307
 
2180
2308
  // 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.
2181
- const apiClientVersion$1 = '5.0.0-alpha.108';
2309
+ const apiClientVersion$1 = '5.0.0-alpha.109';
2182
2310
  function getDefaultHosts(appId) {
2183
2311
  return [
2184
2312
  {
@@ -2867,7 +2995,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2867
2995
  if (!path) {
2868
2996
  throw new Error('Parameter `path` is required when calling `customDelete`.');
2869
2997
  }
2870
- const requestPath = '/1{path}'.replace('{path}', path);
2998
+ const requestPath = '/{path}'.replace('{path}', path);
2871
2999
  const headers = {};
2872
3000
  const queryParameters = parameters ? parameters : {};
2873
3001
  const request = {
@@ -2890,7 +3018,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2890
3018
  if (!path) {
2891
3019
  throw new Error('Parameter `path` is required when calling `customGet`.');
2892
3020
  }
2893
- const requestPath = '/1{path}'.replace('{path}', path);
3021
+ const requestPath = '/{path}'.replace('{path}', path);
2894
3022
  const headers = {};
2895
3023
  const queryParameters = parameters ? parameters : {};
2896
3024
  const request = {
@@ -2914,7 +3042,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2914
3042
  if (!path) {
2915
3043
  throw new Error('Parameter `path` is required when calling `customPost`.');
2916
3044
  }
2917
- const requestPath = '/1{path}'.replace('{path}', path);
3045
+ const requestPath = '/{path}'.replace('{path}', path);
2918
3046
  const headers = {};
2919
3047
  const queryParameters = parameters ? parameters : {};
2920
3048
  const request = {
@@ -2939,7 +3067,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2939
3067
  if (!path) {
2940
3068
  throw new Error('Parameter `path` is required when calling `customPut`.');
2941
3069
  }
2942
- const requestPath = '/1{path}'.replace('{path}', path);
3070
+ const requestPath = '/{path}'.replace('{path}', path);
2943
3071
  const headers = {};
2944
3072
  const queryParameters = parameters ? parameters : {};
2945
3073
  const request = {