Event Fingerprint Enrichment

Summary

This enrichment allows for a customized approach to setting an event ID by allowing you to select parameters to be hashed into a unique identifier.

Overview

This enrichment generates a fingerprint for the event using a hash of client-set fields. This is helpful when deduplicating events.

This is the field which this enrichment will augment: event_fingerprint.

The input values for this enrichment are taken from all the querystring fields and the body (if present) except those extracted from excludedParameters in event_fingerprint_enrichment.json. That is all the properties of the RawEvent produced by the adapter (tracker protocol) used are taken into account.

If you’d like to get help setting up this enrichment please contact us at support@snowplowanalytics.com

Example

The following shows an example of the enrichement configuration which would use all the parameters except the event id (event_id mapped to eid) and the device sent timestamp (dvce_sent_tstamp mapped to stm).

{
  "schema": "iglu:com.snowplowanalytics.snowplow/event_fingerprint_config/jsonschema/1-0-0",
  "data": {
    "name": "event_fingerprint_config",
    "vendor": "com.snowplowanalytics.snowplow",
    "enabled": true,
    "parameters": {
      "excludeParameters": [
        "eid",
        "stm"
      ],
      "hashAlgorithm": "MD5"
    }
  }
}