Analytics & Attribution
Yesterday’s Unknown Conversions May Become Clicks in Your Next API Report

Updated: October 2026
Google Ads API v26 introduces an explicit CLICK attribution event type for conversions that were previously included in UNKNOWN. Reporting pipelines should expect category movement even when total conversion behavior is unchanged. Rebaseline the dimension before comparing old and new extracts.
What the enum change means
An enum is a controlled category returned by the API. When click-attributed conversions move from UNKNOWN into CLICK, the composition of those categories can change at the version boundary. That does not necessarily mean more people clicked or that campaign performance improved.
Total conversions may remain stable while one reporting bucket shrinks and another appears. Any dashboard, alert or data model using the attribution-event dimension needs migration QA.
Inventory every downstream dependency
| Dependency | Check | Failure mode |
|---|---|---|
| Warehouse schema | New enum accepted | Rejected or null rows |
| Transformation | CLICK mapping added | Misclassified data |
| Dashboard | Labels and totals verified | False trend break |
| Alerting | Thresholds recalibrated | Noise or missed incident |
| Documentation | Version boundary recorded | Future misinterpretation |
Run a parallel extract
Before switching production, request the same stable date range with the old and new API versions where supported. Compare total conversions, value and the distribution of attribution event types. Save the raw responses and query definitions.
- Select a mature period beyond normal conversion lag.
- Freeze customer, campaign and conversion filters.
- Run both versioned queries.
- Compare totals first.
- Compare UNKNOWN and CLICK next.
- Investigate any movement outside the expected reclassification.
- Annotate the production cutover date.
Protect time-series continuity
Do not silently join the new CLICK series to a historical zero. Either backfill the dimension where technically and analytically valid, or mark the first supported date. For executive reporting, keep the top-line series stable and explain the attribution-category enhancement in a note.
Pair the migration with MTC’s campaign-data validation workflow and lift-measurement configuration QA.
Do not turn a classification into a causal claim
CLICK means the conversion is attributed to an ad click under the platform’s rules. It does not establish that the click caused an incremental conversion. Use experiments or another causal design for lift questions.
Update monitoring deliberately
If UNKNOWN share is a data-quality signal, reset its expected range after migration. A sharp decline may be the intended classification improvement. Alert on rejected values, missing totals or unexplained divergence—not the expected enum shift alone.
Write a version-aware data contract
Your ingestion layer should record the Google Ads API version, query date, customer timezone and selected conversion fields with every load. Downstream users can then distinguish a platform-schema change from a marketer’s campaign change. Reject unknown enum values into a monitored quarantine table instead of silently converting them to blank.
Add a unit test containing the new CLICK value and a regression test for UNKNOWN. Confirm that totals remain additive and that exports, dashboards and scheduled reports display a human-readable label.
Annotate every affected chart
Place the cutover note on the chart itself, not only in release documentation. Analysts who discover the series months later should be able to see when the category definition changed and where the migration evidence is stored.
Frequently asked questions
Will historical reports automatically change?
That depends on the query, version and retained data. Test a fixed historical range instead of assuming.
Should CLICK be merged with another category?
Preserve the raw value first. Any analytical grouping should be explicit and documented.
What is the primary QA check?
Verify total conversions and value before interpreting the category redistribution.
