Clicked Object IDs After Search
search
ACL
About this method
You are currently reading the JavaScript API client v4 documentation. Check our migration guide to learn how to upgrade from v3 to v4. You can still access the v3 documentation.
You are currently reading the Ruby API client v2 documentation. Check our migration guide to learn how to upgrade from v1 to v2. You can still access the v1 documentation.
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 format: hexadecimal string [a-f0-9] length: 32 characters. |
Response
No response