Trackingplan Documentation
Trackingplan Documentation
Warnings & Updates

Warnings & Updates

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

Warnings & Updates

Trackingplan detects and sends you real-time alerts about all updates or issues in your tracking. These are the different types of warnings that Trackingplan will automatically notify you about and that we will see in more detail throughout this section:

📉
Traffic Warnings
  • Missing Events
  • Traffic Drops
  • Traffic Peaks
  • Custom Thresholds
⏱️
Real-Time Traffic Anomalies
  • Real‑time traffic drops
  • Real‑time traffic peaks
  • Real‑time hit‑to‑user ratio drops
  • Real‑time hit‑to‑user ratio peaks
📊
KPI Warnings
  • Missing KPI values
  • KPI value drops
  • KPI value peaks
  • Custom Thresholds
📖
Specification Warnings
  • Missing Properties
    • Conditionally Missing Properties
  • Type Collision
  • Validation Errors
    • Validation Enum Warnings
    • Validation Regex Warnings
    • Validation Function Warnings
    • Campaign Validation Warnings
  • Recommended Specs Warnings
☝🏻
For problems related to specification warnings, you’ll be redirected to our Debug Warning View to help you identify the values that may have caused the appearance of your warnings.
🏗️
Destination Implementation Warnings
  • Google Analytics Implementation Warnings

Traffic Warnings

💡
Trackingplan automatically detects abnormal variations in your event traffic. Whether these are related to an implementation bug, an actual unexpected user behavior, or an intended code change, Trackingplan will flag any significant traffic change to monitor your events in production.

Let’s see what type of traffic warnings you’ll be able to automatically spot:

Missing Events

Trackingplan will notify you if any event in your tracking plan vanishes completely and has no traffic at all for a full day. If this scenario is detected, you will see a missing event warning in Trackingplan’s Digests and your Dashboard the day thereafter.

image

Just by clicking on the warning, you’ll have access to your Warning Management View, where you’ll be able to dive deep into your warnings and understand them better.

In there, you’ll also be provided with a Daily Traffic Chart to see the event’s traffic evolution at a glance and instantly understand its impact.

image

You can also add any relevant information to track its progress for seamless collaboration within your team. To deactivate missing event warnings, simply navigate to your Warning Settings.

image

Traffic Drops

At Trackingplan, we know the traffic in your events might also change significantly during weekdays or weekends, special dates, or other factors like campaigning. For this reason, we monitor event traffic according to your user traffic.

image
🚨
For example, an add_to_cart event might trigger 0.1-1% of the registered daily users. However, if this suddenly drops to 0.05% only, we will notify you so that you can discard any possible issues. The root cause might be a bug in the funnel, a redesign, or can be even related to business or marketing activities. For example, campaigning might change your typical user behavior significantly and result in Trackingplan flagging unexpected hit drops if the conversion or behavior of these new users is different.

Our model learns from your historical traffic to take into account your typical user behavior, i.e. how often they trigger each event and with what daily and weekly variance. For this reason, our monitoring will improve over time to adapt as much as possible to your tracking changes.

image

You can always deactivate traffic drop warnings or set the tolerances at which they trigger, choosing between low, medium, or high tolerance levels. Learn more about Traffic Warning Tolerances here.

image

Traffic Peaks

Oppositely, at Trackingplan we also know that there are certain events whose increase can be negative (e.g.: abandoned_cart). That's why we also support and alert you about anomalous traffic peaks.

image
image
☝🏻
To monitor traffic peaks, you’ll need to manually activate the warning for the events, campaigns, landings, or other acquisition dimensions whose increase may be deemed as negative or relevant for your business. Simply navigate to your Warning Settings to activate them.
image

Similar to Traffic Drops, you can deactivate traffic peak warnings at any time or adjust their trigger threshold by selecting low, medium, or high tolerance levels. Learn more about Traffic Warning Tolerances here.

image

Custom Thresholds

Trackingplan will always propose predefined alerts based on your business type, but you can also set up custom daily thresholds above or below any threshold you have to be alerted only when the conditions you specify are met.

image
image

This warning is customizable per event.

image
💡
You can also activate these same traffic warnings for Acquisition (Campaigns, Landings, Referrers, Mediums, Sources, and Pages). To do that, hover over the item you want to track its traffic closely and click on Customize Warnings.
image

Real-Time Traffic Anomalies

With Real‑Time Traffic Anomalies, you can catch important traffic issues as they happen.

Many teams—performance and acquisition, campaign managers, and daily watchers—cannot wait until the next day to know whether an event or campaign failed. Real-time monitoring lets you react immediately by analyzing ongoing trends and notifying you about unexpected deviations.

To give you full flexibility, you can activate Real-Time Traffic Anomalies on an event-by-event basis, meaning you can choose to configure only the events that matter most to you. Simply click on Warning Settings to get started.

image

You’ll find the configuration to enable Real-Time Traffic Anomalies right at the top of your Warning Settings.

image

By activating it, the following modal will appear.

image

Here, you’ll have the possibility to configure the desired tolerance levels for drops and peaks, and decide whether to apply user-volume normalization. Let’s break it down:

  • Traffic drop tolerances: You can choose between five tolerance levels to control how sensitive your real-time alerts are:
    • Disabled: No traffic drop warnings will be triggered for this event.
    • Max (Fewer Warnings): Alerts will only be triggered in extreme cases, minimizing notifications.
    • High (Lenient): Alerts trigger only for significant deviations. Ideal for less critical events, such as optional user interactions, where minor fluctuations are not important.
    • Medium: Offers a balanced approach, reducing false positives while still catching meaningful anomalies.
    • Low (Strict): Best for critical events, where even small deviations matter.
    • Min (More Warnings): Alerts trigger even for smaller variations, ideal when you want maximum coverage and to catch every possible deviation.
☝🏻

Pro tip: Stricter tolerances generate more alerts; looser tolerances reduce noise. Use the Detection Forecast to preview how your chosen tolerance level will behave and adjust it to fit your needs.

image
  • Traffic peak tolerances: Same as above, but applied to unexpected traffic spikes.
☝🏻

You could also choose to disable peak alerts entirely and only receive notifications for anomalous traffic drops. Adjust the settings to fit your needs, experiment with different tolerances, and find the configuration that works best for your team!

image
  • Normalization: Normalization adjusts traffic anomalies by taking user volume into account. This helps reduce false alerts caused by normal changes in traffic, like campaigns or seasonal events.
    • On (normalized by user volume): Recommended for detecting integration issues. The system compares event traffic to user volume, so expected traffic increases (e.g., from marketing campaigns or Black Friday sales) don’t trigger false alerts.
    • Off (raw event traffic): Recommended for detecting business-related anomalies. Uses raw event traffic, ignoring user volume, so you can spot unusual patterns that affect your business metrics.
☝🏻

Pro tip: Choose On if you want to catch technical or implementation problems, and Off if you’re more interested in business-level traffic changes.

Detection Forecast

To make it easier to understand, our Detection Forecast will update dynamically as you adjust your tolerance levels. This helps you instantly see what would trigger an alert and what wouldn’t.

  • Green line: Your actual hits
  • Grey band: Upper and lower thresholds, which will shift as you modify tolerances

Think of it as a sandbox for your alerts—you can experiment with different settings, see the effects instantly, and get recommendations to fine-tune your real-time warnings just the way you like them.

image

Real-Time Notifications

Once configured, these warnings behave like any other in Trackingplan. If an anomaly is detected, a warning will be generated and displayed in your dashboard, where you will be able to dig deeper to debug it, and later check whether the issue persists or has been resolved.

💡

But Trackingplan was built so you can focus on your work while still being protected. That’s why Real-Time Traffic Anomalies lets you choose who receives notifications, keeping you informed about important issues without being glued to your dashboard.

image

You can send real-time alerts to specific team members, Slack or Teams channels, or leave recipients blank if you prefer:

  • Email: Notify specific team members or entire departments directly.
  • Slack or Teams: Send alerts to a channel for broader visibility. Here’s how you can do it.
  • No recipients: Leave blank to only see alerts in your Trackingplan panel. Doing this won’t trigger email/Slack notifications.
☝🏻

Note: Don’t worry about getting spammed—only one email is sent per anomaly. If the issue pops up again after being resolved, you’ll get a fresh notification after 24 hours.

KPI Warnings

💡
Trackingplan enables analysts to define a series of KPIs, making it easy for them to determine the reliability of the data they are viewing and ensure the credibility of their reports. However, if Trackingplan detects abnormal variations in your KPIs, it will automatically issue a warning.

These KPI-specific warnings are similar to the traffic warnings we’ve just seen, but are applied to your daily KPI values. Let’s see what type of KPI warnings you’ll be notified about with Trackingplan:

Missing KPI values

Trackingplan will notify you if any of your KPIs show no values for one or more days.

image

Just by clicking on the warning, you’ll have access to your Warning Management View, where you’ll be able to dive deep into your warnings and understand them better.

image

You can also add any relevant information to track its progress for seamless collaboration within your team, mute or share the warning, or even deactivate missing KPI values warnings.

Additionally, you can customize the traffic threshold and fine-tune KPI tolerance levels to control how sensitive your anomaly detection is, helping you cut through the noise and focus on what truly matters. Learn more about Traffic Warning Tolerances here.

image

KPI value drops

Trackingplan will notify you if our system detects a significant drop in your KPI values.

image

KPI value peaks

Conversely, Trackingplan will also generate a warning if it detects a significant peak in the KPI value.

image

Custom Thresholds

Trackingplan will always propose predefined alerts based on what it automatically learns from your data, but you can also set up custom daily thresholds above or below any threshold you have to be alerted only when the conditions you specify are met.

image
  • KPI Value Below Daily Limit: Triggered when the KPI value falls below a user-configured threshold.
  • KPI Value Above Daily Limit: Triggered when the KPI value exceeds a user-configured threshold.

Again, you can always explore further on the warning by clicking on it.

image
☝🏻
Moreover, Trackingplan will also flag as a warning those KPIs whose associated events have warnings.
image

Specification Warnings

💡
Trackingplan also notifies you whenever your properties, events, and user acquisition data don’t conform to the rules you have specified or that Trackingplan has automatically inferred for you.

Let’s dive into all the specification warnings you’ll be able to automatically spot:

Missing Properties

You can specify whether or not a property is required within an event. If required properties are not being tracked in event hits all the time, Trackingplan will automatically send you a warning.

image

In the case of specification warnings, the chart in your Warning Management View will show you the daily rates of specification matches vs. mismatches, including warnings triggered based on the required constraints specified.

image

This warning is customizable and you can set your tolerance percentage.

image
☝🏻

To easily spot correlations for any incomplete property—even optional ones—and understand why they're not arriving 100% of the time, Trackingplan's Find Correlations makes it simple. Learn all the details here or check out the video below:

Conditionally Missing Properties

Moreover, Trackingplan will also notify you about missing hits on the designated required pages you previously set as 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.

💡
For instance, the event page_view 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 you only if there are missing hits on those pages you’ve marked as required, allowing you to be much more precise on your requirements.

This provides you with greater control and precision in defining your tracking requirements, allowing you to focus on the most critical aspects of your data.

☝🏻
Learn more about Conditional Properties here.

Type Collision

The property is there but with a different type. Trackingplan automatically interprets which data type is being tracked and, if it detects any data type collision, a warning will be generated.

image

This warning is also customizable and you can set the tolerance percentage you want.

image

Validation errors

When a property, event, or UTM parameter has validation errors and does not conform to the values you have specified.

  • Validation enum warnings: This triggers when a value that is not within the list of predefined constants you have already specified is detected in any of your properties. Moreover, in case you’ve missed the parameter that is now causing the error in your Enum definition, you’ll be able to change the specification directly throughout your Warning Management View.
  • You can learn more about how to validate property values with Enums.

  • Validation regex warnings: It happens when a property does not match with the regular expression pattern (Regex) to which all the values seen for a property must conform.
  • Learn more about how to validate property values with regular expressions.

  • Validation function warnings: When a property does not conform to the function provided to validate an event.
  • Learn more about function validations.

  • Campaign validation warnings: When UTMs in your campaigns do not follow your campaign naming specifications.
  • Learn more about campaign validation.

Recommended Specs Warnings

💡
Trackingplan also applies event and property specifications recommended by your Analytics services and your Marketing tools, triggering Specification Warnings if these requirements aren’t correctly implemented in your sites or apps.

By now, Google Analytics 4 Recommended Events, Meta Standard Events, and TikTok Parameters and Standard Events are supported, with more coming soon. Contact support to let us know which tool you’d like to see next.

image

Destination Implementation Warnings

Each of the different destinations we integrate with has specific peculiarities and limits. Although these are usually well-documented, their integrations lack controls, making it difficult to realize when certain data isn't being collected or errors occur.

💡
This is precisely why Trackingplan automatically informs you of errors in how your providers have been implemented.
image

Google Analytics Implementation Warnings

Trackingplan will automatically implement a first set of validation functions to verify certain values and their limits within Google Analytics.

The following rules will activate automatically whenever Trackingplan detects hits for that provider:

  • URL length: This will automatically validate that the Google Analytics endpoint URL falls within the specified limits.
  • POST payload size: This will automatically validate that the size of the POST payload sent to Google Analytics is within the limits.
image

You can also disable Google Analytics Implementation Warnings through your settings at any time, and get more information about the problem on your Warning Management View.

image

Possible Warning Use Cases

  • Events Stop: If several events stop occurring with a new release of your website or app, there may be a bug in the implementation of your analytics. Trackingplan helps you identify which events have been impacted in your landings or pages so you can address them quickly.
  • Conversion Funnel Breakage: If your sales drop significantly in a short amount of time, something in your conversion funnel may be broken. Trackingplan will help you identify exactly where potential customers are leaving your funnel.
  • Source Traffic Increase: If the level of traffic from a specific source increases, Trackingplan can help you identify where and why it did so from the moment it happened.
  • Geographical Traffic Decrease: If your traffic from a specific location or country decreases, you can explore factors that may be impacting that market. With Trackingplan, you can quickly identify which geographical area has experienced a decrease in traffic.
  • Payment Gateway Drop: If the conversion rate in your payment gateway drops 10% below normal, you could be receiving bad-quality traffic, or there may be pricing issues on some products. Trackingplan gives you a roadmap to start investigating the cause.
  • User Navigation Changes: If user behavior changes and users start navigating to unexpected pages, you may need to optimize your funnel. The Trackingplan dashboard helps you identify how user behavior has changed by tracking increases and decreases in your events and properties.
☝🏻
Trackingplan will always propose predefined alerts based on your business type. However, you can also configure alerts to ensure you receive warnings only when the conditions you specify are met. Learn more about customizing warnings here.

Updates

Trackingplan will also notify you in real-time about all the changes in your tracking and will automatically monitor them so that you can ensure any update made in your analytics is implemented correctly and consistently across your organization.

  • Active new events - When new hits are reported in an event for the first time.
  • image
  • New properties - When new hits are discovered in a property for the first time.
  • image
  • New pixels - When a new pixel is reported in any of the SaaS tools used in your frontends for the first time.
  • image

← Previous

Automated Alert SystemAutomated Alert System

Next →

Pixel MonitoringPixel Monitoring