@algolia/client-analytics 5.39.0 → 5.40.0
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.
- package/README.md +4 -4
- package/dist/browser.d.ts +48 -48
- package/dist/builds/browser.js +29 -29
- package/dist/builds/browser.js.map +1 -1
- package/dist/builds/browser.min.js +1 -1
- package/dist/builds/browser.min.js.map +1 -1
- package/dist/builds/browser.umd.js +1 -1
- package/dist/builds/fetch.js +29 -29
- package/dist/builds/fetch.js.map +1 -1
- package/dist/builds/node.cjs +29 -29
- package/dist/builds/node.cjs.map +1 -1
- package/dist/builds/node.js +29 -29
- package/dist/builds/node.js.map +1 -1
- package/dist/builds/worker.js +29 -29
- package/dist/builds/worker.js.map +1 -1
- package/dist/fetch.d.ts +48 -48
- package/dist/node.d.cts +48 -48
- package/dist/node.d.ts +48 -48
- package/dist/src/analyticsClient.cjs +29 -29
- package/dist/src/analyticsClient.cjs.map +1 -1
- package/dist/src/analyticsClient.js +29 -29
- package/dist/src/analyticsClient.js.map +1 -1
- package/dist/worker.d.ts +48 -48
- package/package.json +9 -9
package/dist/builds/worker.js
CHANGED
|
@@ -4,7 +4,7 @@ import { createFetchRequester } from "@algolia/requester-fetch";
|
|
|
4
4
|
|
|
5
5
|
// src/analyticsClient.ts
|
|
6
6
|
import { createAuth, createTransporter, getAlgoliaAgent } from "@algolia/client-common";
|
|
7
|
-
var apiClientVersion = "5.
|
|
7
|
+
var apiClientVersion = "5.40.0";
|
|
8
8
|
var REGIONS = ["de", "us"];
|
|
9
9
|
function getDefaultHosts(region) {
|
|
10
10
|
const url = !region ? "analytics.algolia.com" : "analytics.{region}.algolia.com".replace("{region}", region);
|
|
@@ -174,7 +174,7 @@ function createAnalyticsClient({
|
|
|
174
174
|
return transporter.request(request, requestOptions);
|
|
175
175
|
},
|
|
176
176
|
/**
|
|
177
|
-
* Retrieves the add-to-cart rate for all 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. The rate is the number of add-to-cart conversion events divided by the number of tracked searches. A search is tracked if it returns a queryID (`clickAnalytics` is `true`). This differs from the response\'s `count`, which shows the overall number of searches, including those where `clickAnalytics` is `false`. **There\'s a difference between a 0 and null add-to-cart rate when `clickAnalytics` is enabled:** - **Null** means there were no queries: since Algolia didn\'t receive any events, the add-to-cart rate is null. - **0** mean there _were_ queries but no [add-to-cart events](https://www.algolia.com/doc/guides/sending-events/getting-started
|
|
177
|
+
* Retrieves the add-to-cart rate for all 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. The rate is the number of add-to-cart conversion events divided by the number of tracked searches. A search is tracked if it returns a queryID (`clickAnalytics` is `true`). This differs from the response\'s `count`, which shows the overall number of searches, including those where `clickAnalytics` is `false`. **There\'s a difference between a 0 and null add-to-cart rate when `clickAnalytics` is enabled:** - **Null** means there were no queries: since Algolia didn\'t receive any events, the add-to-cart rate is null. - **0** mean there _were_ queries but no [add-to-cart events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.
|
|
178
178
|
*
|
|
179
179
|
* Required API Key ACLs:
|
|
180
180
|
* - analytics
|
|
@@ -182,7 +182,7 @@ function createAnalyticsClient({
|
|
|
182
182
|
* @param getAddToCartRate.index - Index name.
|
|
183
183
|
* @param getAddToCartRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
184
184
|
* @param getAddToCartRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
185
|
-
* @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
|
|
185
|
+
* @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).
|
|
186
186
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
187
187
|
*/
|
|
188
188
|
getAddToCartRate({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -213,7 +213,7 @@ function createAnalyticsClient({
|
|
|
213
213
|
return transporter.request(request, requestOptions);
|
|
214
214
|
},
|
|
215
215
|
/**
|
|
216
|
-
* Retrieves the average click position of your search results, including a daily breakdown. The average click position is the average of all clicked search result 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. An average of `null` when `clickAnalytics` is enabled means Algolia didn\'t receive any [click events](https://www.algolia.com/doc/guides/sending-events/getting-started
|
|
216
|
+
* Retrieves the average click position of your search results, including a daily breakdown. The average click position is the average of all clicked search result 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. An average of `null` when `clickAnalytics` is enabled means Algolia didn\'t receive any [click events](https://www.algolia.com/doc/guides/sending-events/getting-started) for the queries. The average is `null` until Algolia receives at least one click event.
|
|
217
217
|
*
|
|
218
218
|
* Required API Key ACLs:
|
|
219
219
|
* - analytics
|
|
@@ -221,7 +221,7 @@ function createAnalyticsClient({
|
|
|
221
221
|
* @param getAverageClickPosition.index - Index name.
|
|
222
222
|
* @param getAverageClickPosition.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
223
223
|
* @param getAverageClickPosition.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
224
|
-
* @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
|
|
224
|
+
* @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).
|
|
225
225
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
226
226
|
*/
|
|
227
227
|
getAverageClickPosition({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -252,7 +252,7 @@ function createAnalyticsClient({
|
|
|
252
252
|
return transporter.request(request, requestOptions);
|
|
253
253
|
},
|
|
254
254
|
/**
|
|
255
|
-
* 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. An average of `0` when `clickAnalytics` is enabled means Algolia didn\'t receive any [click events](https://www.algolia.com/doc/guides/sending-events/getting-started
|
|
255
|
+
* 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. An average of `0` when `clickAnalytics` is enabled means Algolia didn\'t receive any [click events](https://www.algolia.com/doc/guides/sending-events/getting-started) for the queries.
|
|
256
256
|
*
|
|
257
257
|
* Required API Key ACLs:
|
|
258
258
|
* - analytics
|
|
@@ -260,7 +260,7 @@ function createAnalyticsClient({
|
|
|
260
260
|
* @param getClickPositions.index - Index name.
|
|
261
261
|
* @param getClickPositions.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
262
262
|
* @param getClickPositions.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
263
|
-
* @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
|
|
263
|
+
* @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).
|
|
264
264
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
265
265
|
*/
|
|
266
266
|
getClickPositions({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -291,7 +291,7 @@ function createAnalyticsClient({
|
|
|
291
291
|
return transporter.request(request, requestOptions);
|
|
292
292
|
},
|
|
293
293
|
/**
|
|
294
|
-
* Retrieves the click-through rate (CTR) for all 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. **There\'s a difference between a 0 and null CTR when `clickAnalytics` is enabled:** - **Null** means there were no queries: since Algolia didn\'t receive any events, CTR is null. - **0** mean there _were_ queries but no [click events](https://www.algolia.com/doc/guides/sending-events/getting-started
|
|
294
|
+
* Retrieves the click-through rate (CTR) for all 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. **There\'s a difference between a 0 and null CTR when `clickAnalytics` is enabled:** - **Null** means there were no queries: since Algolia didn\'t receive any events, CTR is null. - **0** mean there _were_ queries but no [click events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.
|
|
295
295
|
*
|
|
296
296
|
* Required API Key ACLs:
|
|
297
297
|
* - analytics
|
|
@@ -299,7 +299,7 @@ function createAnalyticsClient({
|
|
|
299
299
|
* @param getClickThroughRate.index - Index name.
|
|
300
300
|
* @param getClickThroughRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
301
301
|
* @param getClickThroughRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
302
|
-
* @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
|
|
302
|
+
* @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).
|
|
303
303
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
304
304
|
*/
|
|
305
305
|
getClickThroughRate({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -330,7 +330,7 @@ function createAnalyticsClient({
|
|
|
330
330
|
return transporter.request(request, requestOptions);
|
|
331
331
|
},
|
|
332
332
|
/**
|
|
333
|
-
* Retrieves the conversion rate (CR) for all 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. **There\'s a difference between a 0 and null CR when `clickAnalytics` is enabled:** - **Null** means there were no queries: since Algolia didn\'t receive any events, CR is null. - **0** mean there _were_ queries but no [conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started
|
|
333
|
+
* Retrieves the conversion rate (CR) for all 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. **There\'s a difference between a 0 and null CR when `clickAnalytics` is enabled:** - **Null** means there were no queries: since Algolia didn\'t receive any events, CR is null. - **0** mean there _were_ queries but no [conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.
|
|
334
334
|
*
|
|
335
335
|
* Required API Key ACLs:
|
|
336
336
|
* - analytics
|
|
@@ -338,7 +338,7 @@ function createAnalyticsClient({
|
|
|
338
338
|
* @param getConversionRate.index - Index name.
|
|
339
339
|
* @param getConversionRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
340
340
|
* @param getConversionRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
341
|
-
* @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
|
|
341
|
+
* @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).
|
|
342
342
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
343
343
|
*/
|
|
344
344
|
getConversionRate({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -377,7 +377,7 @@ function createAnalyticsClient({
|
|
|
377
377
|
* @param getNoClickRate.index - Index name.
|
|
378
378
|
* @param getNoClickRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
379
379
|
* @param getNoClickRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
380
|
-
* @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
|
|
380
|
+
* @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).
|
|
381
381
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
382
382
|
*/
|
|
383
383
|
getNoClickRate({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -416,7 +416,7 @@ function createAnalyticsClient({
|
|
|
416
416
|
* @param getNoResultsRate.index - Index name.
|
|
417
417
|
* @param getNoResultsRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
418
418
|
* @param getNoResultsRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
419
|
-
* @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
|
|
419
|
+
* @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).
|
|
420
420
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
421
421
|
*/
|
|
422
422
|
getNoResultsRate({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -447,7 +447,7 @@ function createAnalyticsClient({
|
|
|
447
447
|
return transporter.request(request, requestOptions);
|
|
448
448
|
},
|
|
449
449
|
/**
|
|
450
|
-
* Retrieves the purchase rate for all 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. The rate is the number of purchase conversion events divided by the number of tracked searches. A search is tracked if it returns a query ID (`clickAnalytics` is `true`). This differs from the response\'s `count`, which shows the overall number of searches, including those where `clickAnalytics` is `false`. **There\'s a difference between a 0 and null purchase rate when `clickAnalytics` is enabled:** - **Null** means there were no queries: since Algolia didn\'t receive any events, the purchase rate is null. - **0** mean there _were_ queries but no [purchase conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started
|
|
450
|
+
* Retrieves the purchase rate for all 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. The rate is the number of purchase conversion events divided by the number of tracked searches. A search is tracked if it returns a query ID (`clickAnalytics` is `true`). This differs from the response\'s `count`, which shows the overall number of searches, including those where `clickAnalytics` is `false`. **There\'s a difference between a 0 and null purchase rate when `clickAnalytics` is enabled:** - **Null** means there were no queries: since Algolia didn\'t receive any events, the purchase rate is null. - **0** mean there _were_ queries but no [purchase conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.
|
|
451
451
|
*
|
|
452
452
|
* Required API Key ACLs:
|
|
453
453
|
* - analytics
|
|
@@ -455,7 +455,7 @@ function createAnalyticsClient({
|
|
|
455
455
|
* @param getPurchaseRate.index - Index name.
|
|
456
456
|
* @param getPurchaseRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
457
457
|
* @param getPurchaseRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
458
|
-
* @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
|
|
458
|
+
* @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).
|
|
459
459
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
460
460
|
*/
|
|
461
461
|
getPurchaseRate({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -494,7 +494,7 @@ function createAnalyticsClient({
|
|
|
494
494
|
* @param getRevenue.index - Index name.
|
|
495
495
|
* @param getRevenue.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
496
496
|
* @param getRevenue.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
497
|
-
* @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
|
|
497
|
+
* @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).
|
|
498
498
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
499
499
|
*/
|
|
500
500
|
getRevenue({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -533,7 +533,7 @@ function createAnalyticsClient({
|
|
|
533
533
|
* @param getSearchesCount.index - Index name.
|
|
534
534
|
* @param getSearchesCount.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
535
535
|
* @param getSearchesCount.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
536
|
-
* @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
|
|
536
|
+
* @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).
|
|
537
537
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
538
538
|
*/
|
|
539
539
|
getSearchesCount({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -574,7 +574,7 @@ function createAnalyticsClient({
|
|
|
574
574
|
* @param getSearchesNoClicks.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
575
575
|
* @param getSearchesNoClicks.limit - Number of items to return.
|
|
576
576
|
* @param getSearchesNoClicks.offset - Position of the first item to return.
|
|
577
|
-
* @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
|
|
577
|
+
* @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).
|
|
578
578
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
579
579
|
*/
|
|
580
580
|
getSearchesNoClicks({ index, startDate, endDate, limit, offset, tags }, requestOptions) {
|
|
@@ -621,7 +621,7 @@ function createAnalyticsClient({
|
|
|
621
621
|
* @param getSearchesNoResults.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
622
622
|
* @param getSearchesNoResults.limit - Number of items to return.
|
|
623
623
|
* @param getSearchesNoResults.offset - Position of the first item to return.
|
|
624
|
-
* @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
|
|
624
|
+
* @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).
|
|
625
625
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
626
626
|
*/
|
|
627
627
|
getSearchesNoResults({ index, startDate, endDate, limit, offset, tags }, requestOptions) {
|
|
@@ -695,7 +695,7 @@ function createAnalyticsClient({
|
|
|
695
695
|
* @param getTopCountries.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
696
696
|
* @param getTopCountries.limit - Number of items to return.
|
|
697
697
|
* @param getTopCountries.offset - Position of the first item to return.
|
|
698
|
-
* @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
|
|
698
|
+
* @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).
|
|
699
699
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
700
700
|
*/
|
|
701
701
|
getTopCountries({ index, startDate, endDate, limit, offset, tags }, requestOptions) {
|
|
@@ -743,7 +743,7 @@ function createAnalyticsClient({
|
|
|
743
743
|
* @param getTopFilterAttributes.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
744
744
|
* @param getTopFilterAttributes.limit - Number of items to return.
|
|
745
745
|
* @param getTopFilterAttributes.offset - Position of the first item to return.
|
|
746
|
-
* @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
|
|
746
|
+
* @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).
|
|
747
747
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
748
748
|
*/
|
|
749
749
|
getTopFilterAttributes({ index, search, startDate, endDate, limit, offset, tags }, requestOptions) {
|
|
@@ -795,7 +795,7 @@ function createAnalyticsClient({
|
|
|
795
795
|
* @param getTopFilterForAttribute.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
796
796
|
* @param getTopFilterForAttribute.limit - Number of items to return.
|
|
797
797
|
* @param getTopFilterForAttribute.offset - Position of the first item to return.
|
|
798
|
-
* @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
|
|
798
|
+
* @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).
|
|
799
799
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
800
800
|
*/
|
|
801
801
|
getTopFilterForAttribute({ attribute, index, search, startDate, endDate, limit, offset, tags }, requestOptions) {
|
|
@@ -838,7 +838,7 @@ function createAnalyticsClient({
|
|
|
838
838
|
return transporter.request(request, requestOptions);
|
|
839
839
|
},
|
|
840
840
|
/**
|
|
841
|
-
* Retrieves the 1,000 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](
|
|
841
|
+
* Retrieves the 1,000 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](https://www.algolia.com/doc/rest-api/analytics/get-searches-no-results) operation.
|
|
842
842
|
*
|
|
843
843
|
* Required API Key ACLs:
|
|
844
844
|
* - analytics
|
|
@@ -849,7 +849,7 @@ function createAnalyticsClient({
|
|
|
849
849
|
* @param getTopFiltersNoResults.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
850
850
|
* @param getTopFiltersNoResults.limit - Number of items to return.
|
|
851
851
|
* @param getTopFiltersNoResults.offset - Position of the first item to return.
|
|
852
|
-
* @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
|
|
852
|
+
* @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).
|
|
853
853
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
854
854
|
*/
|
|
855
855
|
getTopFiltersNoResults({ index, search, startDate, endDate, limit, offset, tags }, requestOptions) {
|
|
@@ -889,7 +889,7 @@ function createAnalyticsClient({
|
|
|
889
889
|
return transporter.request(request, requestOptions);
|
|
890
890
|
},
|
|
891
891
|
/**
|
|
892
|
-
* Retrieves the object IDs of the 1,000 most frequent search results. If you set the `clickAnalytics` query parameter to true, the response also includes: - Tracked searches count. Tracked searches are Search API requests with the `clickAnalytics` parameter set to `true`. This differs from the response\'s `count`, which shows the overall number of searches, including those where `clickAnalytics` is `false`. - Click count - Click-through rate (CTR) - Conversion count - Conversion rate (CR) - Average click position If you set the `revenueAnalytics` parameter to `true`, the response also includes: - Add-to-cart count - Add-to-cart rate (ATCR) - Purchase count - Purchase rate - Revenue details for each currency **There\'s a difference between 0% rates and null rates:** - **Null** means there were no queries: since Algolia didn\'t receive any events, the rates (CTR, CR, ATCR, purchase rate) are null. - **0% rates** mean there _were_ queries but no [click or conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started
|
|
892
|
+
* Retrieves the object IDs of the 1,000 most frequent search results. If you set the `clickAnalytics` query parameter to true, the response also includes: - Tracked searches count. Tracked searches are Search API requests with the `clickAnalytics` parameter set to `true`. This differs from the response\'s `count`, which shows the overall number of searches, including those where `clickAnalytics` is `false`. - Click count - Click-through rate (CTR) - Conversion count - Conversion rate (CR) - Average click position If you set the `revenueAnalytics` parameter to `true`, the response also includes: - Add-to-cart count - Add-to-cart rate (ATCR) - Purchase count - Purchase rate - Revenue details for each currency **There\'s a difference between 0% rates and null rates:** - **Null** means there were no queries: since Algolia didn\'t receive any events, the rates (CTR, CR, ATCR, purchase rate) are null. - **0% rates** mean there _were_ queries but no [click or conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.
|
|
893
893
|
*
|
|
894
894
|
* Required API Key ACLs:
|
|
895
895
|
* - analytics
|
|
@@ -902,7 +902,7 @@ function createAnalyticsClient({
|
|
|
902
902
|
* @param getTopHits.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
903
903
|
* @param getTopHits.limit - Number of items to return.
|
|
904
904
|
* @param getTopHits.offset - Position of the first item to return.
|
|
905
|
-
* @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
|
|
905
|
+
* @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).
|
|
906
906
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
907
907
|
*/
|
|
908
908
|
getTopHits({ index, search, clickAnalytics, revenueAnalytics, startDate, endDate, limit, offset, tags }, requestOptions) {
|
|
@@ -948,7 +948,7 @@ function createAnalyticsClient({
|
|
|
948
948
|
return transporter.request(request, requestOptions);
|
|
949
949
|
},
|
|
950
950
|
/**
|
|
951
|
-
* Returns the most popular searches. For each search, it also includes the average number of hits. If you set the `clickAnalytics` query parameter to `true`, the response also includes - Tracked searches count. Tracked searches are Search API requests with the `clickAnalytics` parameter set to `true`. This differs from the response\'s `count`, which shows the overall number of searches, including those where `clickAnalytics` is `false`. - Click count - Click-through rate (CTR) - Conversion count - Conversion rate (CR) - Average click position If you set the `revenueAnalytics` query parameter to `true`, the response also includes: - Add-to-cart count - Add-to-cart rate (ATCR) - Purchase count - Purchase rate - Revenue details for each currency **There\'s a difference between 0% rates and null rates:** - **Null** means there were no queries: since Algolia didn\'t receive any events, the rates (CTR, CR, ATCR, purchase rate) are null. - **0% rates** mean there _were_ queries but no [click or conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started
|
|
951
|
+
* Returns the most popular searches. For each search, it also includes the average number of hits. If you set the `clickAnalytics` query parameter to `true`, the response also includes - Tracked searches count. Tracked searches are Search API requests with the `clickAnalytics` parameter set to `true`. This differs from the response\'s `count`, which shows the overall number of searches, including those where `clickAnalytics` is `false`. - Click count - Click-through rate (CTR) - Conversion count - Conversion rate (CR) - Average click position If you set the `revenueAnalytics` query parameter to `true`, the response also includes: - Add-to-cart count - Add-to-cart rate (ATCR) - Purchase count - Purchase rate - Revenue details for each currency **There\'s a difference between 0% rates and null rates:** - **Null** means there were no queries: since Algolia didn\'t receive any events, the rates (CTR, CR, ATCR, purchase rate) are null. - **0% rates** mean there _were_ queries but no [click or conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.
|
|
952
952
|
*
|
|
953
953
|
* Required API Key ACLs:
|
|
954
954
|
* - analytics
|
|
@@ -962,7 +962,7 @@ function createAnalyticsClient({
|
|
|
962
962
|
* @param getTopSearches.direction - Sorting direction of the results: ascending or descending.
|
|
963
963
|
* @param getTopSearches.limit - Number of items to return.
|
|
964
964
|
* @param getTopSearches.offset - Position of the first item to return.
|
|
965
|
-
* @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
|
|
965
|
+
* @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).
|
|
966
966
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
967
967
|
*/
|
|
968
968
|
getTopSearches({
|
|
@@ -1030,7 +1030,7 @@ function createAnalyticsClient({
|
|
|
1030
1030
|
* @param getUsersCount.index - Index name.
|
|
1031
1031
|
* @param getUsersCount.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
1032
1032
|
* @param getUsersCount.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
1033
|
-
* @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
|
|
1033
|
+
* @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).
|
|
1034
1034
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
1035
1035
|
*/
|
|
1036
1036
|
getUsersCount({ index, startDate, endDate, tags }, requestOptions) {
|