AnalyticsClient

algoliasearch.api.AnalyticsClient
See theAnalyticsClient companion object
class AnalyticsClient(appId: String, apiKey: String, region: Option[String], clientOptions: ClientOptions) extends ApiClient

Attributes

Companion
object
Graph
Supertypes
class ApiClient
trait AutoCloseable
class Object
trait Matchable
class Any

Members list

Value members

Concrete methods

def customDelete[T : Manifest](path: String, parameters: Option[Map[String, Any]], requestOptions: Option[RequestOptions])(implicit evidence$1: Manifest[T], ec: ExecutionContext): Future[T]

This method allow you to send requests to the Algolia REST API.

This method allow you to send requests to the Algolia REST API.

Value parameters

parameters

Query parameters to apply to the current query.

path

Path of the endpoint, anything after "/1" must be specified.

Attributes

def customGet[T : Manifest](path: String, parameters: Option[Map[String, Any]], requestOptions: Option[RequestOptions])(implicit evidence$2: Manifest[T], ec: ExecutionContext): Future[T]

This method allow you to send requests to the Algolia REST API.

This method allow you to send requests to the Algolia REST API.

Value parameters

parameters

Query parameters to apply to the current query.

path

Path of the endpoint, anything after "/1" must be specified.

Attributes

def customPost[T : Manifest](path: String, parameters: Option[Map[String, Any]], body: Option[Any], requestOptions: Option[RequestOptions])(implicit evidence$3: Manifest[T], ec: ExecutionContext): Future[T]

This method allow you to send requests to the Algolia REST API.

This method allow you to send requests to the Algolia REST API.

Value parameters

body

Parameters to send with the custom request.

parameters

Query parameters to apply to the current query.

path

Path of the endpoint, anything after "/1" must be specified.

Attributes

def customPut[T : Manifest](path: String, parameters: Option[Map[String, Any]], body: Option[Any], requestOptions: Option[RequestOptions])(implicit evidence$4: Manifest[T], ec: ExecutionContext): Future[T]

This method allow you to send requests to the Algolia REST API.

This method allow you to send requests to the Algolia REST API.

Value parameters

body

Parameters to send with the custom request.

parameters

Query parameters to apply to the current query.

path

Path of the endpoint, anything after "/1" must be specified.

Attributes

def getAverageClickPosition(index: String, startDate: Option[String], endDate: Option[String], tags: Option[String], requestOptions: Option[RequestOptions])(implicit ec: ExecutionContext): Future[GetAverageClickPositionResponse]

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.

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.

Value parameters

endDate

End date (a string in the format YYYY-MM-DD) of the period to analyze.

index

Index name to target.

startDate

Start date (a string in the format YYYY-MM-DD) of the period to analyze.

tags

Filter analytics on the 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.

Attributes

def getClickPositions(index: String, startDate: Option[String], endDate: Option[String], tags: Option[String], requestOptions: Option[RequestOptions])(implicit ec: ExecutionContext): Future[GetClickPositionsResponse]

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.

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.

Value parameters

endDate

End date (a string in the format YYYY-MM-DD) of the period to analyze.

index

Index name to target.

startDate

Start date (a string in the format YYYY-MM-DD) of the period to analyze.

tags

Filter analytics on the 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.

Attributes

def getClickThroughRate(index: String, startDate: Option[String], endDate: Option[String], tags: Option[String], requestOptions: Option[RequestOptions])(implicit ec: ExecutionContext): Future[GetClickThroughRateResponse]

Returns a click-through rate (CTR).

Value parameters

endDate

End date (a string in the format YYYY-MM-DD) of the period to analyze.

index

Index name to target.

startDate

Start date (a string in the format YYYY-MM-DD) of the period to analyze.

tags

Filter analytics on the 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.

Attributes

def getConversationRate(index: String, startDate: Option[String], endDate: Option[String], tags: Option[String], requestOptions: Option[RequestOptions])(implicit ec: ExecutionContext): Future[GetConversationRateResponse]

Return a conversion rate.

Return a conversion rate.

Value parameters

endDate

End date (a string in the format YYYY-MM-DD) of the period to analyze.

index

Index name to target.

startDate

Start date (a string in the format YYYY-MM-DD) of the period to analyze.

tags

Filter analytics on the 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.

Attributes

def getNoClickRate(index: String, startDate: Option[String], endDate: Option[String], tags: Option[String], requestOptions: Option[RequestOptions])(implicit ec: ExecutionContext): Future[GetNoClickRateResponse]

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.

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.

Value parameters

endDate

End date (a string in the format YYYY-MM-DD) of the period to analyze.

index

Index name to target.

startDate

Start date (a string in the format YYYY-MM-DD) of the period to analyze.

tags

Filter analytics on the 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.

Attributes

def getNoResultsRate(index: String, startDate: Option[String], endDate: Option[String], tags: Option[String], requestOptions: Option[RequestOptions])(implicit ec: ExecutionContext): Future[GetNoResultsRateResponse]

Returns the rate at which searches didn't return any results.

Returns the rate at which searches didn't return any results.

Value parameters

endDate

End date (a string in the format YYYY-MM-DD) of the period to analyze.

index

Index name to target.

startDate

Start date (a string in the format YYYY-MM-DD) of the period to analyze.

tags

Filter analytics on the 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.

Attributes

def getSearchesCount(index: String, startDate: Option[String], endDate: Option[String], tags: Option[String], requestOptions: Option[RequestOptions])(implicit ec: ExecutionContext): Future[GetSearchesCountResponse]

Returns the number of searches within a time range.

Returns the number of searches within a time range.

Value parameters

endDate

End date (a string in the format YYYY-MM-DD) of the period to analyze.

index

Index name to target.

startDate

Start date (a string in the format YYYY-MM-DD) of the period to analyze.

tags

Filter analytics on the 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.

Attributes

def getSearchesNoClicks(index: String, startDate: Option[String], endDate: Option[String], limit: Option[Int], offset: Option[Int], tags: Option[String], requestOptions: Option[RequestOptions])(implicit ec: ExecutionContext): Future[GetSearchesNoClicksResponse]

Return the most popular of the last 1,000 searches that didn't lead to any clicks.

Return the most popular of the last 1,000 searches that didn't lead to any clicks.

Value parameters

endDate

End date (a string in the format YYYY-MM-DD) of the period to analyze.

index

Index name to target.

limit

Number of records to return (page size).

offset

Position of the starting record. Used for paging. 0 is the first record.

startDate

Start date (a string in the format YYYY-MM-DD) of the period to analyze.

tags

Filter analytics on the 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.

Attributes

def getSearchesNoResults(index: String, startDate: Option[String], endDate: Option[String], limit: Option[Int], offset: Option[Int], tags: Option[String], requestOptions: Option[RequestOptions])(implicit ec: ExecutionContext): Future[GetSearchesNoResultsResponse]

Returns the most popular of the latest 1,000 searches that didn't return any results.

Returns the most popular of the latest 1,000 searches that didn't return any results.

Value parameters

endDate

End date (a string in the format YYYY-MM-DD) of the period to analyze.

index

Index name to target.

limit

Number of records to return (page size).

offset

Position of the starting record. Used for paging. 0 is the first record.

startDate

Start date (a string in the format YYYY-MM-DD) of the period to analyze.

tags

Filter analytics on the 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.

Attributes

def getStatus(index: String, requestOptions: Option[RequestOptions])(implicit ec: ExecutionContext): Future[GetStatusResponse]

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.

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.

Value parameters

index

Index name to target.

Attributes

def getTopCountries(index: String, startDate: Option[String], endDate: Option[String], limit: Option[Int], offset: Option[Int], tags: Option[String], requestOptions: Option[RequestOptions])(implicit ec: ExecutionContext): Future[GetTopCountriesResponse]

Returns top countries. Limited to the 1,000 most frequent ones.

Returns top countries. Limited to the 1,000 most frequent ones.

Value parameters

endDate

End date (a string in the format YYYY-MM-DD) of the period to analyze.

index

Index name to target.

limit

Number of records to return (page size).

offset

Position of the starting record. Used for paging. 0 is the first record.

startDate

Start date (a string in the format YYYY-MM-DD) of the period to analyze.

tags

Filter analytics on the 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.

Attributes

def getTopFilterAttributes(index: String, search: Option[String], startDate: Option[String], endDate: Option[String], limit: Option[Int], offset: Option[Int], tags: Option[String], requestOptions: Option[RequestOptions])(implicit ec: ExecutionContext): Future[GetTopFilterAttributesResponse]

Return the most popular filterable attributes in the 1,000 most recently used filters.

Return the most popular filterable attributes in the 1,000 most recently used filters.

Value parameters

endDate

End date (a string in the format YYYY-MM-DD) of the period to analyze.

index

Index name to target.

limit

Number of records to return (page size).

offset

Position of the starting record. Used for paging. 0 is the first record.

search

User query.

startDate

Start date (a string in the format YYYY-MM-DD) of the period to analyze.

tags

Filter analytics on the 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.

Attributes

def getTopFilterForAttribute(attribute: String, index: String, search: Option[String], startDate: Option[String], endDate: Option[String], limit: Option[Int], offset: Option[Int], tags: Option[String], requestOptions: Option[RequestOptions])(implicit ec: ExecutionContext): Future[GetTopFilterForAttributeResponse]

Returns the most popular filter values for an attribute in the 1,000 most recently used filters.

Returns the most popular filter values for an attribute in the 1,000 most recently used filters.

Value parameters

attribute

Attribute name.

endDate

End date (a string in the format YYYY-MM-DD) of the period to analyze.

index

Index name to target.

limit

Number of records to return (page size).

offset

Position of the starting record. Used for paging. 0 is the first record.

search

User query.

startDate

Start date (a string in the format YYYY-MM-DD) of the period to analyze.

tags

Filter analytics on the 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.

Attributes

def getTopFiltersNoResults(index: String, search: Option[String], startDate: Option[String], endDate: Option[String], limit: Option[Int], offset: Option[Int], tags: Option[String], requestOptions: Option[RequestOptions])(implicit ec: ExecutionContext): Future[GetTopFiltersNoResultsResponse]

Returns top filters for filter-enabled searches that don't return results. Limited to the 1,000 most recently used filters.

Returns top filters for filter-enabled searches that don't return results. Limited to the 1,000 most recently used filters.

Value parameters

endDate

End date (a string in the format YYYY-MM-DD) of the period to analyze.

index

Index name to target.

limit

Number of records to return (page size).

offset

Position of the starting record. Used for paging. 0 is the first record.

search

User query.

startDate

Start date (a string in the format YYYY-MM-DD) of the period to analyze.

tags

Filter analytics on the 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.

Attributes

def getTopHits(index: String, search: Option[String], clickAnalytics: Option[Boolean], startDate: Option[String], endDate: Option[String], limit: Option[Int], offset: Option[Int], tags: Option[String], requestOptions: Option[RequestOptions])(implicit ec: ExecutionContext): Future[GetTopHitsResponse]

Return the most popular clicked results in the last 1,000 searches.

Return the most popular clicked results in the last 1,000 searches.

Value parameters

clickAnalytics

Whether to include click and conversion rates for a search.

endDate

End date (a string in the format YYYY-MM-DD) of the period to analyze.

index

Index name to target.

limit

Number of records to return (page size).

offset

Position of the starting record. Used for paging. 0 is the first record.

search

User query.

startDate

Start date (a string in the format YYYY-MM-DD) of the period to analyze.

tags

Filter analytics on the 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.

Attributes

def getTopSearches(index: String, clickAnalytics: Option[Boolean], startDate: Option[String], endDate: Option[String], orderBy: Option[OrderBy], direction: Option[Direction], limit: Option[Int], offset: Option[Int], tags: Option[String], requestOptions: Option[RequestOptions])(implicit ec: ExecutionContext): Future[GetTopSearchesResponse]

Returns the most popular of the latest 1,000 searches. For each search, also returns the number of hits.

Returns the most popular of the latest 1,000 searches. For each search, also returns the number of hits.

Value parameters

clickAnalytics

Whether to include click and conversion rates for a search.

direction

Sorting direction of the results: ascending or descending.

endDate

End date (a string in the format YYYY-MM-DD) of the period to analyze.

index

Index name to target.

limit

Number of records to return (page size).

offset

Position of the starting record. Used for paging. 0 is the first record.

orderBy

Reorder the results.

startDate

Start date (a string in the format YYYY-MM-DD) of the period to analyze.

tags

Filter analytics on the 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.

Attributes

def getUsersCount(index: String, startDate: Option[String], endDate: Option[String], tags: Option[String], requestOptions: Option[RequestOptions])(implicit ec: ExecutionContext): Future[GetUsersCountResponse]

Return the count of unique users.

Return the count of unique users.

Value parameters

endDate

End date (a string in the format YYYY-MM-DD) of the period to analyze.

index

Index name to target.

startDate

Start date (a string in the format YYYY-MM-DD) of the period to analyze.

tags

Filter analytics on the 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.

Attributes

Inherited methods

override def close(): Unit

Attributes

Definition Classes
ApiClient -> AutoCloseable
Inherited from:
ApiClient