The product click event should be triggered whenever a visitor clicks an item from the search results.
Suggested Cases
A product click event should be sent in the following situations:
- When an item is clicked from the search popup, listing page, or any other search result surface.
- When a user adds a product to the cart directly from the pop-up, without visiting the Product Detail Page (PDP):
- In this scenario, in addition to the add-to-cart event, a product-click event should also be sent if it has not already been logged.
Endpoint
Visit our Postman collection to test this request.
Request Parameters
The product click event supports the following properties:
| Attribute Name | Type | Validation | Default | Description |
|---|---|---|---|---|
| referrer | String | Required, url | - | Source URL of the referring page |
| campId | Integer | - | 999999 | The campId serves as a unique identifier. Refer to common fields for more details. |
| variationId | Integer | - | 999999 | The variationId represents the unique identifier for a specific campaign variation. Refer to common fields for more details. |
| source | String | oneof= - search-popup - search-listing - collection-listing - product-detail - other | search-listing | Source origin where the event triggered |
| integrationType | String | Required, oneof= - api - web | - | Type of integration |
| platform | String | Required, oneof= - desktop-web - mobile-web - ios - android - other | - | Platform used by the user |
| userId | String | - | default | Unique identifier of the user. It is expected to provide for user-based calculations. |
| product | List of Product | Required | - | The product clicked by the user. Refer to common fields for more details. |
| eventType | String | Required, equals=product-click | - | Type of event |
| createdAt | String | Required, formatted in RFC3339 | If omitted or invalid, it defaults to the current time | Time when the event is created. Refer to common fields for more details. |
If your integration was implemented before the Advanced Analytics September 01, 2025, release, please note that new fields have been added to the expected product payload. Following this release, the event now retrieves currentPage and related details from product-level fields instead of top-level fields. In addition, the product object has been enriched with several new fields.
For backward compatibility, you may continue sending these values at the event level. However, it is strongly recommended to update your implementation to the new product-level structure to ensure full alignment with the latest version and to benefit from more comprehensive analytics.
You can review the full list of changes on the Common Properties page.
For backward compatibility, you may continue sending these values at the event level. However, it is strongly recommended to update your implementation to the new product-level structure to ensure full alignment with the latest version and to benefit from more comprehensive analytics.
You can review the full list of changes on the Common Properties page.
Sample Request
In the example below, you see a sample request along with guidance on modifying the necessary fields. This will help you seamlessly integrate and make the most of the provided configuration.
Before usage, it is essential to modify the values such as x-auth-token and x-partner-config-key.
curl --location --request POST 'https://eurekaevent.api.useinsider.com/api/v1/events' \
--header 'x-auth-token: YOUR_AUTH_TOKEN' \
--header 'x-partner-config-key: YOUR_PARTNERID-YOUR_LOCALE' \
--header 'Content-Type: application/json' \
--data-raw '{
"referrer": "https://example.com/search-results",
"source": "search-listing",
"userId": "user-12345",
"platform": "mobile-web",
"campId": 100,
"variationId": 200,
"product": {
"id": "product-001",
"groupCode": "laptop-group-1",
"query": "laptop",
"price": 1299.99,
"convertedPrice": 1199.99,
"currency": "USD",
"preferredCurrency": "EUR",
"clickPosition": 3,
"searchPosition": 3,
"quantity": 1,
"resultCount": 25,
"itemsPerPage": 10,
"totalPages": 3,
"facets": [
{
"label": "Fiyat",
"field": "price",
"values": ["500", "2000"]
}
],
"sorting": "PriceAsc",
"currentPage": 1,
"searchSessionId": "search-session-abc123"
},
"eventType": "product-click",
"integrationType": "web",
"createdAt": "2025-11-25T10:35:00Z"
}'