Cookie extractor enrichment - ClaraVista-IT/snowplow GitHub Wiki

HOME > SNOWPLOW SETUP GUIDE > Step 3: Setting up Enrich > Configurable enricments > Cookie extractor enrichment

JSON Schema iglu:com.snowplowanalytics.snowplow/cookie_extractor_config/jsonschema/1-0-0
Compatibility r72+, Scala Stream Collector only
Data provider None

One powerful attribute of having Snowplow event collection on your own domain (e.g. events.snowplowanalytics.com) is the ability to capture first-party cookies set by other services on your domain such as ad servers or CMSes; these cookies are stored as HTTP headers in the Thrift raw event payload by the Scala Stream Collector.

This community-contributed enrichment lets you specify cookies that you want to extract if found; each extracted cookie will end up a single derived context in the JSON Schema [org.ietf/http_cookie/jsonschema/1-0-0] http-cookie-schema.

{
	"schema": "iglu:com.snowplowanalytics.snowplow/cookie_extractor_config/jsonschema/1-0-0",
	"data": {
		"name": "cookie_extractor_config",
		"vendor": "com.snowplowanalytics.snowplow",
		"enabled": true,
		"parameters": {
			"cookies": ["sp"]
		}
	}
}

This default configuration is capturing the Scala Stream Collector's own sp cookie - in practice you would probably extract other more valuable cookies available on your company domain.