Click Data Enrichment

Click Data Enrichment

301.Pro proposes a new tracking standard for modern digital marketing named Click Data Enrichment (CDE)

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.

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
cdelocaldayMonDay of Week 3 Letter Name (Mon,Tue…)
cdelocalhour12Hour in 24-hour format (0-23)
cdelocalminute54Minute 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
cdedevicetypedesktopDevice type (desktop, mobile, tablet)
cdedeviceosmacOSDevice 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
cderefererhost301.ProReferer domain
cderefererpath/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 (cdesource, cdemedium, 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 intoonevalue.
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 cdemedium and cdecontent 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? cdelocalday=Mon& cdelocalhour=12& cdelocalminute=54& cde_latitude=40.7128& cde_longitude=74.0060& cde_language=en-US& cdedeviceos=macOS& cdedevicetype=mobile& cde_continent=NA& cde_country=US& cde_region=Arizona& cde_city=Gilbert& cde_human=99& cderefererhost=301.Pro& cderefererpath=sample.com& cde_shortlink=cde& cde_source=googleads& cde_medium=ppc& cde_campaign=v3release& cde_term=click+tracking& cde_content=logolink