Querying visitor information
In addition to tagging, the linkedId lets you connect an identification event with a custom identifier that is indexed by Fingerprint. This lets you filter visit history when querying the server API. Unlike tags, the linkedId is a string. Objects or non-string values are not supported.
Note
The server API returns identification events up to 30 days in the past. For information critical to your business, we recommend storing copies of this data on your own servers. Enterprise plans include unlimited server-side storage of identification events.
The table below lists common use cases and basic implementation using the Fingerprint Identification linkedId and server API visitors endpoint.
| Use Case | Implementation |
|---|---|
| Authenticated User Tracking - bulk information collection of authenticated visitors | Link user ID with visitorId upon user action i.e. login or session. Query server API by visitorId to view browser details about a specific user. |
| Form & Survey Abuse - protect forms from duplicate entries | Link survey ID with visitorId on form submission. Query server API to validate form submissions by checking a visitorId for multiple entries. |
| Coupon & Promo Abuse - protect profits from duplicate promotion abuse | Link promo code with visitorId at checkout. At checkout, query server API by visitorId and promo code to see if promo code was used by the browser in the past. |
| E-commerce Inventory Abuse - prevent illicit repeat orders made by anonymous visitors | Link order ID with visitorId at checkout. Query server API to see orders made by a visitorId. |
Important Note
Do not expose the server API key in production. You can make requests from the server side using our official Node.js wrapper. If you need to access the server API in production, it is recommended you perform authorization via auth headers instead of using the api key inside the endpoint.
Updated 4 months ago