Api clients / Ruby / V1 / Methods

Clicked Object IDs After Search | Ruby API Client V1 (Deprecated)

This version of the Ruby API client has been deprecated in favor of the latest version of the Ruby API client.

Required API Key: any key with the search ACL
Method signature
insights.user(String userToken).clicked_object_ids_after_search(
  String eventName,
  String indexName,
  Array objectIDs,
  Array positions,
  String queryID
)

About this method

Send a click event to capture a query and its clicked items and positions.

Note that unlike clickedObjectIDs, ClickedObjectIDsAfterSearch takes a queryID. Therefore, the captured event goes towards both Personalization and Click and Conversion Analytics. ClickedObjectIDs only goes towards personalization.

You can find examples of click, conversion, and view events in the Search Analytics section.

Examples

1
2
3
4
5
6
7
8
9
10
11
12
$insights = Algolia\AlgoliaSearch\InsightsClient::create(
  'YourApplicationID',
  'YourSearchOnlyAPIKey'
);

$insights->user("user-1")->clickedObjectIDsAfterSearch(
  'your_event_name',
  'your_index_name',
  ['objectID1', 'objectID2'],
  [17, 19],
  'queryID'
);

Parameters

userToken
type: string
Required

A user identifier.

Format: alpha numeric string [a-zA-Z0-9_-]

Length: between 1 and 64 characters.

eventName
type: string
Required

Name of the event.

It's best to follow the event naming guidelines.

Format: any ASCII character except control characters.

Length: between 1 and 64 characters.

indexName
type: string
Required

Name of the index related to the click.

objectIDs
type: string[]
Required

A list of objectIDs.

Limited to 20 objectIDs.

positions
type: uint[]
Required

Position of the click in the list of Algolia search results.

The first object in the list of search results has a position of 1 (not zero), the second has a position of 2, etc. In addition, the position value must be absolute, not relative, to the result page. For example, when clicking on the 3rd record of the 2nd result page, assuming 10 results per page, the position should be 13.

queryID
type: string
Required

Algolia queryID that can be found in the search response when using clickAnalytics

format: [a-z1-9]{32}

Response

No response.

Did you find this page helpful?