Overview
Once an auction has been resolved, the result be a number of winning bids.
These can then be shown to the end-user, who might see and interact with them. It’s important to keep track of these events, so that:
- Autobidding campaigns will work correctly.
- Marketplace owners and vendors can analyze the performance of campaigns.
Event tracking
There are 3 types of events Topsort keeps track of: Impressions, clicks and purchases.
Impressions and clicks can be related to winning bids by providing a bid ID. Impressions and clicks without a bid ID are considered organic by Topsort’s systems.
Impressions
Impression events should be created when a listing, banner or brand becomes visible to the end-user.
Clicks
Click events should be created when an end-user clicks on a listing, banner or brand.
Purchases
Purchase events should be created when an end-user purchases products. One purchase event can contain several products.
Purchases should also contain the opaque user ID so we can attribute them to the same user.
Reports
Reports of tracked events can be viewed in the UI and retrieved via the API.
Handling errors
On successful event requests, you will receive a 204 No Content response. If there is an error, you will receive a 4xx or 5xx response.
Pay attention to the response body for more information on the error.
We only store events that are returns 2xx responses. If you for instance have an array of 200 events and one fails, none will be recorded.