domain: developers.google.com/google-ads/api · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Identify the conversions requiring adjustment using either the original GCLID and conversion date-time or a unique order ID if one was set at conversion time.
Determine the adjustment type: RETRACTION removes the conversion entirely; RESTATEMENT changes the value; ENHANCEMENT adds additional signals.
Construct a ConversionAdjustment object with the gclidDateTimePair or orderId, adjustment_type, adjustment_date_time, and (for RESTATEMENT) a new restatement_value.
Call ConversionAdjustmentUploadService.uploadConversionAdjustments with partial_failure enabled.
Inspect partial_failure_error and the ConversionAdjustmentResult list in the response for per-row success or failure status.
Allow up to 24 hours for adjustments to be reflected in reporting.
Known gotchas
Enhancements are used for improved bidding signals (e.g. adding hashed user identifiers to a conversion) and do not change the reported conversion count or value.
The adjustment_date_time must be after the original conversion_date_time and within the conversion action's attribution window.
Retractions are permanent — once a conversion is retracted it cannot be re-uploaded under the same GCLID and date-time combination.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?