Import historical user tracking data¶
We support replaying historical user events by adding a special parameter overridetimestamp on the buy event to simulate the event date. This is then used as the datetime of an event instead of the current timestamp of the request.
To give an example: It is often requested to import the buy history of users to avoid the cold start problem and being able to start with good recommendations. You do not have to wait to build user profiles by collecting events from the day you implemented the tracking. Usually a curl input file is generated which creates buy requests that are sent to the tracking endpoint.
Ensure that user identifiers used in an import file are the same that are used in the live tracking, for example, the user login identifiers.
There must be some validation to avoid importing buy events by any user. Therefore a signature param needs to be added, which is calculated like following:
Params without a value
The order of the params to be signed is crucial. They must be sent in alphabetical order based on the parameter names to create a signature. Encodings must always contain capital letters (for example, %3A and not %3a).
If a param value is "" or "null" or "undefined" it needs to be excluded from the signing and must not be sent in the query string.
Given a license key of "8695-1828-92810-5535-4239" and a purchase of certain products, there can be the following signature values:
1 2 3 4