@algolia/client-analytics 5.38.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/browser.js
CHANGED
|
@@ -9,7 +9,7 @@ import {
|
|
|
9
9
|
|
|
10
10
|
// src/analyticsClient.ts
|
|
11
11
|
import { createAuth, createTransporter, getAlgoliaAgent } from "@algolia/client-common";
|
|
12
|
-
var apiClientVersion = "5.
|
|
12
|
+
var apiClientVersion = "5.40.0";
|
|
13
13
|
var REGIONS = ["de", "us"];
|
|
14
14
|
function getDefaultHosts(region) {
|
|
15
15
|
const url = !region ? "analytics.algolia.com" : "analytics.{region}.algolia.com".replace("{region}", region);
|
|
@@ -179,7 +179,7 @@ function createAnalyticsClient({
|
|
|
179
179
|
return transporter.request(request, requestOptions);
|
|
180
180
|
},
|
|
181
181
|
/**
|
|
182
|
-
* 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
|
|
182
|
+
* 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.
|
|
183
183
|
*
|
|
184
184
|
* Required API Key ACLs:
|
|
185
185
|
* - analytics
|
|
@@ -187,7 +187,7 @@ function createAnalyticsClient({
|
|
|
187
187
|
* @param getAddToCartRate.index - Index name.
|
|
188
188
|
* @param getAddToCartRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
189
189
|
* @param getAddToCartRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
190
|
-
* @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
|
|
190
|
+
* @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).
|
|
191
191
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
192
192
|
*/
|
|
193
193
|
getAddToCartRate({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -218,7 +218,7 @@ function createAnalyticsClient({
|
|
|
218
218
|
return transporter.request(request, requestOptions);
|
|
219
219
|
},
|
|
220
220
|
/**
|
|
221
|
-
* 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
|
|
221
|
+
* 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.
|
|
222
222
|
*
|
|
223
223
|
* Required API Key ACLs:
|
|
224
224
|
* - analytics
|
|
@@ -226,7 +226,7 @@ function createAnalyticsClient({
|
|
|
226
226
|
* @param getAverageClickPosition.index - Index name.
|
|
227
227
|
* @param getAverageClickPosition.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
228
228
|
* @param getAverageClickPosition.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
229
|
-
* @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
|
|
229
|
+
* @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).
|
|
230
230
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
231
231
|
*/
|
|
232
232
|
getAverageClickPosition({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -257,7 +257,7 @@ function createAnalyticsClient({
|
|
|
257
257
|
return transporter.request(request, requestOptions);
|
|
258
258
|
},
|
|
259
259
|
/**
|
|
260
|
-
* 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
|
|
260
|
+
* 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.
|
|
261
261
|
*
|
|
262
262
|
* Required API Key ACLs:
|
|
263
263
|
* - analytics
|
|
@@ -265,7 +265,7 @@ function createAnalyticsClient({
|
|
|
265
265
|
* @param getClickPositions.index - Index name.
|
|
266
266
|
* @param getClickPositions.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
267
267
|
* @param getClickPositions.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
268
|
-
* @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
|
|
268
|
+
* @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).
|
|
269
269
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
270
270
|
*/
|
|
271
271
|
getClickPositions({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -296,7 +296,7 @@ function createAnalyticsClient({
|
|
|
296
296
|
return transporter.request(request, requestOptions);
|
|
297
297
|
},
|
|
298
298
|
/**
|
|
299
|
-
* 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
|
|
299
|
+
* 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.
|
|
300
300
|
*
|
|
301
301
|
* Required API Key ACLs:
|
|
302
302
|
* - analytics
|
|
@@ -304,7 +304,7 @@ function createAnalyticsClient({
|
|
|
304
304
|
* @param getClickThroughRate.index - Index name.
|
|
305
305
|
* @param getClickThroughRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
306
306
|
* @param getClickThroughRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
307
|
-
* @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
|
|
307
|
+
* @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).
|
|
308
308
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
309
309
|
*/
|
|
310
310
|
getClickThroughRate({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -335,7 +335,7 @@ function createAnalyticsClient({
|
|
|
335
335
|
return transporter.request(request, requestOptions);
|
|
336
336
|
},
|
|
337
337
|
/**
|
|
338
|
-
* 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
|
|
338
|
+
* 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.
|
|
339
339
|
*
|
|
340
340
|
* Required API Key ACLs:
|
|
341
341
|
* - analytics
|
|
@@ -343,7 +343,7 @@ function createAnalyticsClient({
|
|
|
343
343
|
* @param getConversionRate.index - Index name.
|
|
344
344
|
* @param getConversionRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
345
345
|
* @param getConversionRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
346
|
-
* @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
|
|
346
|
+
* @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).
|
|
347
347
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
348
348
|
*/
|
|
349
349
|
getConversionRate({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -382,7 +382,7 @@ function createAnalyticsClient({
|
|
|
382
382
|
* @param getNoClickRate.index - Index name.
|
|
383
383
|
* @param getNoClickRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
384
384
|
* @param getNoClickRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
385
|
-
* @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
|
|
385
|
+
* @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).
|
|
386
386
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
387
387
|
*/
|
|
388
388
|
getNoClickRate({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -421,7 +421,7 @@ function createAnalyticsClient({
|
|
|
421
421
|
* @param getNoResultsRate.index - Index name.
|
|
422
422
|
* @param getNoResultsRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
423
423
|
* @param getNoResultsRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
424
|
-
* @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
|
|
424
|
+
* @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).
|
|
425
425
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
426
426
|
*/
|
|
427
427
|
getNoResultsRate({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -452,7 +452,7 @@ function createAnalyticsClient({
|
|
|
452
452
|
return transporter.request(request, requestOptions);
|
|
453
453
|
},
|
|
454
454
|
/**
|
|
455
|
-
* 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
|
|
455
|
+
* 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.
|
|
456
456
|
*
|
|
457
457
|
* Required API Key ACLs:
|
|
458
458
|
* - analytics
|
|
@@ -460,7 +460,7 @@ function createAnalyticsClient({
|
|
|
460
460
|
* @param getPurchaseRate.index - Index name.
|
|
461
461
|
* @param getPurchaseRate.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
462
462
|
* @param getPurchaseRate.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
463
|
-
* @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
|
|
463
|
+
* @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).
|
|
464
464
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
465
465
|
*/
|
|
466
466
|
getPurchaseRate({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -499,7 +499,7 @@ function createAnalyticsClient({
|
|
|
499
499
|
* @param getRevenue.index - Index name.
|
|
500
500
|
* @param getRevenue.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
501
501
|
* @param getRevenue.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
502
|
-
* @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
|
|
502
|
+
* @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).
|
|
503
503
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
504
504
|
*/
|
|
505
505
|
getRevenue({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -538,7 +538,7 @@ function createAnalyticsClient({
|
|
|
538
538
|
* @param getSearchesCount.index - Index name.
|
|
539
539
|
* @param getSearchesCount.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
540
540
|
* @param getSearchesCount.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
541
|
-
* @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
|
|
541
|
+
* @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).
|
|
542
542
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
543
543
|
*/
|
|
544
544
|
getSearchesCount({ index, startDate, endDate, tags }, requestOptions) {
|
|
@@ -579,7 +579,7 @@ function createAnalyticsClient({
|
|
|
579
579
|
* @param getSearchesNoClicks.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
580
580
|
* @param getSearchesNoClicks.limit - Number of items to return.
|
|
581
581
|
* @param getSearchesNoClicks.offset - Position of the first item to return.
|
|
582
|
-
* @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
|
|
582
|
+
* @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).
|
|
583
583
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
584
584
|
*/
|
|
585
585
|
getSearchesNoClicks({ index, startDate, endDate, limit, offset, tags }, requestOptions) {
|
|
@@ -626,7 +626,7 @@ function createAnalyticsClient({
|
|
|
626
626
|
* @param getSearchesNoResults.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
627
627
|
* @param getSearchesNoResults.limit - Number of items to return.
|
|
628
628
|
* @param getSearchesNoResults.offset - Position of the first item to return.
|
|
629
|
-
* @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
|
|
629
|
+
* @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).
|
|
630
630
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
631
631
|
*/
|
|
632
632
|
getSearchesNoResults({ index, startDate, endDate, limit, offset, tags }, requestOptions) {
|
|
@@ -700,7 +700,7 @@ function createAnalyticsClient({
|
|
|
700
700
|
* @param getTopCountries.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
701
701
|
* @param getTopCountries.limit - Number of items to return.
|
|
702
702
|
* @param getTopCountries.offset - Position of the first item to return.
|
|
703
|
-
* @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
|
|
703
|
+
* @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).
|
|
704
704
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
705
705
|
*/
|
|
706
706
|
getTopCountries({ index, startDate, endDate, limit, offset, tags }, requestOptions) {
|
|
@@ -748,7 +748,7 @@ function createAnalyticsClient({
|
|
|
748
748
|
* @param getTopFilterAttributes.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
749
749
|
* @param getTopFilterAttributes.limit - Number of items to return.
|
|
750
750
|
* @param getTopFilterAttributes.offset - Position of the first item to return.
|
|
751
|
-
* @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
|
|
751
|
+
* @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).
|
|
752
752
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
753
753
|
*/
|
|
754
754
|
getTopFilterAttributes({ index, search, startDate, endDate, limit, offset, tags }, requestOptions) {
|
|
@@ -800,7 +800,7 @@ function createAnalyticsClient({
|
|
|
800
800
|
* @param getTopFilterForAttribute.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
801
801
|
* @param getTopFilterForAttribute.limit - Number of items to return.
|
|
802
802
|
* @param getTopFilterForAttribute.offset - Position of the first item to return.
|
|
803
|
-
* @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
|
|
803
|
+
* @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).
|
|
804
804
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
805
805
|
*/
|
|
806
806
|
getTopFilterForAttribute({ attribute, index, search, startDate, endDate, limit, offset, tags }, requestOptions) {
|
|
@@ -843,7 +843,7 @@ function createAnalyticsClient({
|
|
|
843
843
|
return transporter.request(request, requestOptions);
|
|
844
844
|
},
|
|
845
845
|
/**
|
|
846
|
-
* 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](
|
|
846
|
+
* 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.
|
|
847
847
|
*
|
|
848
848
|
* Required API Key ACLs:
|
|
849
849
|
* - analytics
|
|
@@ -854,7 +854,7 @@ function createAnalyticsClient({
|
|
|
854
854
|
* @param getTopFiltersNoResults.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
855
855
|
* @param getTopFiltersNoResults.limit - Number of items to return.
|
|
856
856
|
* @param getTopFiltersNoResults.offset - Position of the first item to return.
|
|
857
|
-
* @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
|
|
857
|
+
* @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).
|
|
858
858
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
859
859
|
*/
|
|
860
860
|
getTopFiltersNoResults({ index, search, startDate, endDate, limit, offset, tags }, requestOptions) {
|
|
@@ -894,7 +894,7 @@ function createAnalyticsClient({
|
|
|
894
894
|
return transporter.request(request, requestOptions);
|
|
895
895
|
},
|
|
896
896
|
/**
|
|
897
|
-
* 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
|
|
897
|
+
* 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.
|
|
898
898
|
*
|
|
899
899
|
* Required API Key ACLs:
|
|
900
900
|
* - analytics
|
|
@@ -907,7 +907,7 @@ function createAnalyticsClient({
|
|
|
907
907
|
* @param getTopHits.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
908
908
|
* @param getTopHits.limit - Number of items to return.
|
|
909
909
|
* @param getTopHits.offset - Position of the first item to return.
|
|
910
|
-
* @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
|
|
910
|
+
* @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).
|
|
911
911
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
912
912
|
*/
|
|
913
913
|
getTopHits({ index, search, clickAnalytics, revenueAnalytics, startDate, endDate, limit, offset, tags }, requestOptions) {
|
|
@@ -953,7 +953,7 @@ function createAnalyticsClient({
|
|
|
953
953
|
return transporter.request(request, requestOptions);
|
|
954
954
|
},
|
|
955
955
|
/**
|
|
956
|
-
* 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
|
|
956
|
+
* 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.
|
|
957
957
|
*
|
|
958
958
|
* Required API Key ACLs:
|
|
959
959
|
* - analytics
|
|
@@ -967,7 +967,7 @@ function createAnalyticsClient({
|
|
|
967
967
|
* @param getTopSearches.direction - Sorting direction of the results: ascending or descending.
|
|
968
968
|
* @param getTopSearches.limit - Number of items to return.
|
|
969
969
|
* @param getTopSearches.offset - Position of the first item to return.
|
|
970
|
-
* @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
|
|
970
|
+
* @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).
|
|
971
971
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
972
972
|
*/
|
|
973
973
|
getTopSearches({
|
|
@@ -1035,7 +1035,7 @@ function createAnalyticsClient({
|
|
|
1035
1035
|
* @param getUsersCount.index - Index name.
|
|
1036
1036
|
* @param getUsersCount.startDate - Start date of the period to analyze, in `YYYY-MM-DD` format.
|
|
1037
1037
|
* @param getUsersCount.endDate - End date of the period to analyze, in `YYYY-MM-DD` format.
|
|
1038
|
-
* @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
|
|
1038
|
+
* @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).
|
|
1039
1039
|
* @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
|
|
1040
1040
|
*/
|
|
1041
1041
|
getUsersCount({ index, startDate, endDate, tags }, requestOptions) {
|