Analytics & Attribution

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

Unknown and click attribution categories moving across a reporting baseline beside a navy analytics panel.

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.

  1. Select a mature period beyond normal conversion lag.
  2. Freeze customer, campaign and conversion filters.
  3. Run both versioned queries.
  4. Compare totals first.
  5. Compare UNKNOWN and CLICK next.
  6. Investigate any movement outside the expected reclassification.
  7. 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.

Sources

Published by Marketing That Clicks
Last reviewed October 2026.