Skip to main content

Cross Navigation Enrichment

This enrichment parses the extended cross navigation format in _sp querystring parameter and attaches the cross_navigation context to an event.

The _sp parameter can be attached by our Web (see cross-domain tracking) and mobile trackers and contains user, session and app identifiers (e.g., domain user and session IDs, business user ID, source app ID). The information to include in the parameters is configurable in the trackers. This is useful for tracking the movement of users across different apps and platforms.

The extended cross navigation format can be described by _sp={domainUserId}.{timestamp}.{sessionId}.{subjectUserId}.{sourceId}.{platform}.{reason}

If this enrichment isn't enabled, Enrich parses _sp querystring parameter according to the old format, _sp={domainUserId}.{timestamp}

Configuration

Testing with Micro

Unsure if your enrichment configuration is correct or works as expected? You can easily test it using Snowplow Micro on your machine. Follow the Micro usage guide to set up Micro and configure it to use your enrichment.

Input

This enrichment extracts _sp querystring parameter from the following inputs:

  • The page_url field from the Snowplow event
  • The referer uri extracted from corresponding HTTP header in the raw event

Output

This enrichment adds a new derived context to the enriched event with this schema.

Also, it continues to populate refr_domain_userid and refr_dvce_tstamp enriched event fields as before.