Skip to main content

Referrers, deep links and cross-navigation events

Page referrer information on Web

Along with page view events, the tracker tracks the URL of the referring page that linked to the current page. The URL is tracked in the atomic event properties, under the page_referrer property.

Table ColumnTypeDescriptionExample values
page_referrertextReferrer URLhttp://www.snowplow.io/

Deep links are URLs or hyperlinks that take users directly to a particular location within a mobile app. They are received by the mobile operating system and passed to the related app.

This event is manually tracked when the deep link is received in the app.

deep_link_received

Event
Represents a deep-link received in the app.
Schema URIiglu:com.snowplowanalytics.mobile/deep_link_received/jsonschema/1-0-0
Tracker compatibility
Web: Mobile: Tracked automatically:
Example
{
"url": "https://example.com/notes/123",
"referrer": "https://snowplow.io"
}
Schema
PropertyDescription
url
string
Required. URL in the received deep-link
referrer
string
Optional. Referrer URL, source of this deep-link
Warehouse query
select
unstruct_event_com_snowplowanalytics_mobile_deep_link_received_1_0_0
from
PIPELINE_NAME.events events
where
events.collector_tstamp > timestamp_sub(current_timestamp(), interval 1 hour)
and events.event = 'unstruct'
and events.event_name = 'deep_link_received'
and events.event_vendor = 'com.snowplowanalytics.mobile'

Context entity attached to screen view events

This context entity is attached to the first screen view event automatically after tracking the deep link received event.

deep_link

Entity
Entity that indicates a deep-link has been received and processed.
Schema URIiglu:com.snowplowanalytics.mobile/deep_link/jsonschema/1-0-0
Tracker compatibility
Web: Mobile: Tracked automatically:
Example
{
"url": "https://example.com/notes/123",
"referrer": "https://snowplow.io"
}
Schema
PropertyDescription
url
string
Required. URL in the received deep-link
referrer
string
Optional. Referrer URL, source of this deep-link

How to track?

Link click tracking feature in the JavaScript tracker enables automatic capturing of link click events as the user clicks on links on the page.

link_click

Event
Schema for a link click event
Schema URIiglu:com.snowplowanalytics.snowplow/link_click/jsonschema/1-0-1
Tracker compatibility
Web: Mobile: Tracked automatically:
Example
{}
Schema
PropertyDescription
elementId
string
Optional.
elementClasses
array
Optional.
elementTarget
string
Optional.
targetUrl
string
Required.
elementContent
string
Optional.
Warehouse query
select
unstruct_event_com_snowplowanalytics_snowplow_link_click_1_0_1
from
PIPELINE_NAME.events events
where
events.collector_tstamp > timestamp_sub(current_timestamp(), interval 1 hour)
and events.event = 'unstruct'
and events.event_name = 'link_click'
and events.event_vendor = 'com.snowplowanalytics.snowplow'

How to track?

See the link click tracking documentation for the JavaScript tracker.

Cross-domain tracking on Web

The JavaScript Tracker can add an additional parameter named “_sp” to the querystring of outbound links. This process is called “link decoration”. The _sp value includes the domain user ID for the current page and the time at which the link was clicked (according to the device's clock).

When the _sp parameter is present in the page URL, enrichment uses it to assign two properties to events: refr_domain_userid with the user identifier and refr_tstamp with the timestamp of the click on the link.

How to track?

See the documentation for cross-domain tracking on the JavaScript tracker for instructions.