tracking_googleads_tracking_health
Google Ads URL-tracking health for the current product over a date range: how many Google paid clicks arrived, how many carried our ValueTrack URL parameters (marker _lt_campaign) vs how many were UNTAGGED (template not installed / broken), the breakage rate, whether the template is verified live, first/last untagged times, sample offending landing URLs.
Google Ads URL-tracking health for the current product over a date range: how many Google paid clicks arrived, how many carried our ValueTrack URL parameters (marker _lt_campaign) vs how many were UNTAGGED (template not installed / broken), the breakage rate, whether the template is verified live, first/last untagged times, sample offending landing URLs. Read-only; computed on the fly from stored events (no Google Ads API call). dataQuality describes how complete the figures above are and holds no metric of its own: dataQuality.cookielessPaidClicks is how many of the paid clicks arrived cookieless (the visitor declined consent) — counted INSIDE paidClicks, never added to it, because a cookieless paid click is a real click and belongs in the breakage denominator. It is broken out so breakageRate is not read as one homogeneous population. Clicks from sites running no consent banner at all are NOT counted as cookieless: nobody was ever asked there, which is not the same as being told no.
Behavior
- HTTP
GET /tracking/googleads/tracking-health
Arguments
Name | Type | Required | Description |
|---|---|---|---|
to | string | — | Range end (ISO); defaults to now |
from | string | — | Range start (ISO); defaults to 30 days ago |
Response
Field | Type | Always | Description |
|---|---|---|---|
to | string | • | End of the range these figures cover, as an instant. |
from | string | • | Start of the range these figures cover, as an instant. Echoes back the range that was asked for. |
installed | boolean | • | Whether the tracking template has been seen working live: true once at least one tagged click has arrived. |
truncated | boolean | • | Whether the sample above was cut short. True means more untagged URLs exist than are listed. |
paidClicks | number | • | Google paid clicks that arrived on the site in this range. The denominator for everything below. |
dataQuality | object | • | How complete the figures above are. Holds no metric of its own — it exists so the breakage rate is not read as one uniform population. |
breakageRate | number | • | Share of paid clicks that arrived untagged, between 0 and 1. Anything much above zero means the tracking template needs fixing. |
taggedClicks | number | • | Of those, the ones that arrived carrying our URL tracking parameters, so the campaign behind them is known. |
lastUntaggedAt | string | • | When the most recent untagged click arrived. Close to now means the breakage is still live. Null when none did. |
untaggedClicks | number | • | Of those, the ones that arrived without our parameters, so the money spent on them cannot be attributed. This is what the tracking template being missing or broken looks like. |
firstUntaggedAt | string | • | When the first untagged click of the range arrived — roughly when the breakage started. Null when none did. |
sampleUntaggedUrls | array | • | A handful of the actual landing URLs that arrived untagged, to paste into a browser while fixing the template. Real customer URLs, query strings included. |
Try it
Google Ads URL-tracking health for the current product over a date range: how many Google paid clicks arrived, how many carried our ValueTrack URL parameters (marker _lt_campaign) vs how many were UNTAGGED (template not installed / broken), the breakage rate, whether the template is verified live, first/last untagged times, sample offending landing URLs.