Trackingplan Documentation
Trackingplan Documentation
Properties

Properties

What is Trackingplan

OverviewOverview

The Trackingplan Way

AutomonitoringAutomonitoring
EventsEventsPropertiesPropertiesUser AttributesUser AttributesPagesPagesAcquisitionAcquisitionPlatform MetricsPlatform Metrics
Automated Alert SystemAutomated Alert System
Warnings & UpdatesWarnings & UpdatesPixel MonitoringPixel MonitoringPrivacy MonitoringPrivacy MonitoringNaming Conventions MonitoringNaming Conventions MonitoringDiscover ReleasesDiscover ReleasesData ValidationData ValidationDigestsDigests

Getting Started

Installing TrackingplanInstalling Trackingplan
For WebsitesFor WebsitesWebhooksWebhooksFor AppsFor AppsFor ssGTMFor ssGTM
Post-Install Warm-UpPost-Install Warm-Up

Inside Trackingplan

DashboardDashboard
SearchSearchHealth SummaryHealth SummaryStarred ItemsStarred ItemsReportsReports
Data ExplorerData ExplorerTracks ExplorerTracks ExplorerRoot Cause AnalysisRoot Cause AnalysisPresence MapPresence MapAdvanced ReportsAdvanced ReportsSession FinderSession Finder
Privacy ReportPrivacy ReportChange HistoryChange HistorySettings & MembersSettings & Members
DestinationsDestinations

How to…

Manage WarningsManage Warnings
Mute WarningsMute WarningsDebug WarningsDebug WarningsAttributionAttributionCustomize WarningsCustomize Warnings
Ensure PrivacyEnsure Privacy

Privacy ReportPrivacy Report

Cookies & ConsentCookies & ConsentConsent Mode Consent Mode Privacy by DesignPrivacy by Design
Marketing ObservabilityMarketing Observability
Campaign ValidationCampaign ValidationPixels Summary Pixels Summary
Enhance CollaborationEnhance Collaboration
SharingSharingNotes & LabelsNotes & LabelsPersonalized DigestsPersonalized Digests
Extend detectionExtend detection
TagsTagsChrome ExtensionChrome ExtensionData Layer Audit Data Layer Audit Explore your DataExplore your DataEnvironmentsEnvironments
Multi-Account ManagementMulti-Account Management
Plans OverviewPlans OverviewJSON Export/ImportJSON Export/ImportSplit DestinationsSplit Destinations

Others

Google Spreadsheet AppGoogle Spreadsheet AppLooker Studio ConnectorLooker Studio ConnectorOmnibug ExtensionOmnibug ExtensionTrackingplan Public APITrackingplan Public APISupported Trackers Supported Trackers SDK UpdateSDK UpdateRelease NotesRelease NotesPrivacy and SecurityPrivacy and Security

Properties

☝🏻
Properties (parameters in GA4) are the metadata or the dimensions of an event. In other words, properties are the insights of each event and provide relevant information such as the time, the user, the place, or the device with which the action was performed.

Properties help you organize and analyze your data more efficiently by clearly stating what type of data is. This is why Trackingplan automatically monitors them to notify you whenever your properties don’t conform to the values inferred by our algorithm or the ones you have specified.

image

Property Type Monitoring

In this regard, while Trackingplan can automatically interpret which property type is being tracked, you can make as many manual adjustments as necessary and choose between boolean, number, string, array, object, regex, enum, or keep it unconstrained with any. If Trackingplan detects that the events sent do not conform to these specifications, a warning will be generated.

image

Property Presence Monitoring

Moreover, Trackingplan will also interpret which property presence is being tracked, but you can easily make manual adjustments between required, nullable, optional, and conditional as shown below. Let’s see this in more detail:

  • Required: If required properties are not being tracked in each of your event hits, as we see in the example below, Trackingplan will automatically send you a warning.
image
  • Nullable: If you set a property as “Nullable”, this means that emitting a property without value will not be considered a missing property in warnings and statistics. However, Trackingplan will send you a warning in case there are missing hits.
  • Optional: Setting a property as “optional” means there may be events where these are present and others that are not. In that case, Trackingplan won’t send you a warning in case no hits are tracked in the properties you’ve marked as optional.
  • Conditional: Setting a property as “conditional” can be very useful for events that occur on many different pages. In this sense, adding a conditional could allow us to differentiate between required or nullable within the very same property, depending on its value. Let’s think about an example to illustrate it.
💡
For it, we’ll use the event page_view, which is usually triggered on many different pages. By using a conditional, we can modify the property page_type and only set the ‘home page’ and the ‘checkout page’ as required, while leaving the rest as nullable. That way, Trackingplan will notify us only if there are missing hits on those pages you’ve marked as required, allowing you to be much more precise on your requirements.
image
☝🏻
Pro tip: To help you stay compliant with Google’s Consent Mode, you can also use conditionals to ensure your properties are always required as long as their consent is granted. Learn more about Google’s Consent Mode & Trackingplan here.
image

Find Correlations for Missing Properties

💡

With Trackingplan, you can easily identify correlations for any property that isn’t complete—even optional ones—helping you pinpoint where a property might be missing.

To do so, just go to any property that isn’t arriving 100% of the time and click the Find Correlations button.

image

What will this button do is find which other properties in the DataLayer, the page, or the event correlate with this issue.

image

For all the juicy details and examples, give this video a watch:

← Previous

EventsEvents

Next →

User AttributesUser Attributes