Click Data Enrichment

← Back to Features

Proposal

301.Pro proposes a new tracking standard for modern digital marketing named Click Data Enrichment (CDE). While UTM parameters have served marketers for several decades, CDE parameters use self-explanatory naming and significantly expand the available localized tracking information extending the traditional UTM framework from 5 to 18 parameters. This specification provides comprehensive click tracking by incorporating temporal, geospatial, referral, and behavioral data points alongside traditional campaign tracking elements.

Important Local vs. Server Date Time Distinctions

CDE captures each visitor’s local time, unlike server-side time tracking which records everything in a single time zone. For example, if 100 users worldwide visit your website simultaneously, server logs show identical timestamps, but CDE records each visitor’s localized time. This lets you optimize marketing based on when your audience is most engaged in their time zone, improving conversion rates through time-aware targeting.

Local (to the user) Date Time Data

These parameters capture time-based information from the user’s local timezone, enabling time-sensitive content delivery and analytics:

ParameterExampleDescription
cde_local_dayMonDay of Week 3 Letter Name (Mon,Tue…)
cde_local_hour12Hour in 24-hour format (0-23)
cde_local_minute54Minute of the hour (0-59)

Device Data

These parameters capture information from the user’s device, language, type, etc.:

ParameterExampleDescription
cde_languageen-USLanguage preference from the Accept-Language header
cde_device_typedesktopDevice type (desktop, mobile, tablet)
cde_device_osmacOSDevice operating system (iOS, Android, Windows, MacOS, Linux)

Location Data

Location parameters provide geographic context for each interaction, enabling region-specific routing and analytics:

ParameterExampleDescription
cde_latitude40.7128Geographic Latitude
cde_longitude74.0060Geographic Longitude
cde_continentNATwo-letter continent code: Africa (AF), Antarctica (AN), Asia (AS), Europe (EU), North America (NA), Oceania (OC), South America (SA), Intercontinental (IC), Outer Space/Satellite (OS)
cde_countryUSCountry
cde_regionNew YorkState or Province name
cde_cityNew York CityCity name

Human vs Bot Detection

This parameter helps identify legitimate human traffic versus automated bot interactions:

ParameterExampleDescription
cde_human99Human likelihood score (1-99). Higher values indicate increased likelihood of human interaction, while lower values suggest potential bot activity.

Referring Data

Referer (famously misspelled) parameters track where traffic originates from, providing insight into traffic sources:

ParameterExampleDescription
cde_referer_host301.ProReferer domain
cde_referer_path/Referer URL path
cde_shortlink/cdeProLink or Shortlink used for redirection

Campaign Tracking (UTM Compatible)

These parameters provide backward compatibility with UTM tracking while extending functionality:

ParameterExampleDescription
cde_sourcegoogleadsIdentifies which site sent the traffic (replaces utm_source). This is a required parameter.
cde_mediumppcIdentifies what type of link was used, such as email or pay-per-click advertising (replaces utm_medium).
cde_campaignv3releaseIdentifies a specific product promotion or strategic campaign (replaces utm_campaign).
cde_termclick+trackingIdentifies search terms (replaces utm_term).
cde_contentlogolinkIdentifies what specifically was clicked to bring the user to the site, such as a banner ad or a text link. Often used for A/B testing and content-targeted ads (replaces utm_content).

Implementation Notes

The following guidelines ensure proper implementation of CDE parameters across all platforms and use cases:

Implementation GuidelineDescription
URL-Safe ParametersAll CDE parameters are designed to be URL-safe and should be properly encoded when used in URLs.
Backward CompatibilityThe system maintains backward compatibility with traditional UTM parameters while extending functionality.
DateTime StandardsDateTime parameters follow international standards (ISO 8601) for consistency across regions.
Location SupportLocation parameters support global tracking with standardized continent codes.
Human DetectionThe human detection score provides a quantitative measure for traffic quality assessment.

Best Practices

Follow these best practices to maximize the effectiveness of your CDE parameter implementation:

Best PracticeDetails
Include Essential ParametersAlways include essential UTM-compatible parameters (cde_source, cde_medium, cde_campaign) for basic tracking.
Use Lowercase ValuesUse lowercase values for CDE parameters for better cross system matching.
Connect Multiple WordsUse underscore to connect multiple words into_one_value.
Handle Special CharactersUse URL encoding for parameters containing special characters or spaces. Try to avoid spaces when possible, replacing spaces with an_underscore or a plus+sign.
Implement ValidationImplement server-side validation for parameter formats, especially for numerical values.
Consider PrivacyConsider privacy regulations when collecting and storing location data.
Document Custom ValuesDocument any custom values used for cde_medium and cde_content parameters.

Example Implementation

Below is a comprehensive example URL showing all available CDE parameters in use. Each parameter is shown with its example value which can be treated as a default value for documentation purposes. This demonstrates how parameters from different categories can be combined in a single implementation:

https://example.com/landing-page?
DateTime
cde_local_day=Mon&
cde_local_hour=12&
cde_local_minute=54
Device
cde_language=en-US&
cde_device_os=macOS&
cde_device_type=mobile
Location
cde_latitude=40.7128&
cde_longitude=74.0060&
cde_continent=NA&
cde_country=US&
cde_region=Arizona&
cde_city=Gilbert
Human Detection
cde_human=99
Referring
cde_referer_host=301.Pro&
cde_referer_path=sample.com&
cde_shortlink=cde
Campaign (UTM Compatible)
cde_source=googleads&
cde_medium=ppc&
cde_campaign=v3release&
cde_term=click+tracking&
cde_content=logolink