Track Result Click

Record when a user clicks a search result.

POST /api/v3/{customerId}/{engineId}/search/pushstat/clicklog

Track Result Click

cURL

curl --request POST \
  --url https://api.cludo.com/api/v3/{customerId}/{engineId}/search/pushstat/clicklog \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sw": "<string>",
  "qid": "<string>",
  "clurl": "<string>",
  "cli": "<string>",
  "title": "<string>",
  "sz": "<string>",
  "ua": "<string>",
  "refurl": "<string>",
  "refpt": "<string>",
  "brl": "<string>",
  "pn": "<string>",
  "hn": "<string>",
  "sid": "<string>",
  "qsid": "<string>",
  "cloi": "<string>"
}
'

200

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Authorizations

SiteKeyBasicAuth

Authorization · string · header · required

SiteKey authentication. Pass the full value including the SiteKey prefix: SiteKey <base64(customerId:engineId:searchKey)>. Example: SiteKey dGVzdDoxMjM0NTY3Ojk4NzY1.

Path Parameters

customerId · integer · required

Must match the customer id used in the search that produced qid.

engineId · integer · required

Must match the engine id in the same search request path.

Body

application/json

Definition of the log source. Use 'searchresult' for regular clicks and 'banner' for banner clicks.

ls · enum<string>

searchresult for organic SERP clicks; banner when the user clicked a promotional banner.

Available options: searchresult, banner

sw · string

The search query.

qid · string

A unique string used as the ID of the query.

clurl · string

The URL of the result that was clicked.

cli · string

The rank of the clicked item in the result list.

title · string

The title of the result that was clicked.

sz · string

The pixel resolution of the visitor's screen (e.g. 1920x1080).

ua · string

The browser user-agent.

refurl · string

The URL of the page that referred the user to the search results.

refpt · string

The title of the page that referred the user to the search results.

brl · string

The browser language.

pn · string

The page number of the results the user was viewing.

hn · string

The hostname of the page the query originated from.

sid · string

The session ID (cookie or generated) to stitch multiple events per visit.

qsid · string

A unique string used as the ID of the query session.

cloi · string

The ID of the banner that was clicked.

dt · enum<string>

The device class for analytics segmentation.

Available options: mobile, tablet, desktop

Response

200

application/json

Result click event recorded.

Success response containing the server-generated tracking ID.

id · string

Unique identifier for the recorded tracking event.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"