google-ads-signal-enginelisted
Install: claude install-skill ongkipro/dotfiles
# Google Ads Signal Engine
An engineering operating system for reliable Google Ads conversion measurement, sitewide Google Tag (`gtag.js`) / GTM architecture, Consent Mode v2 compliance, Enhanced Conversions, Click-ID preservation, and offline CRM conversion uploads.
## Verify the API version before writing code
**Never hardcode a Google Ads API version from memory or from these notes.** Google ships a major version roughly quarterly and sunsets older ones on a published schedule; a version written down here rots fast. (These notes said `v18+` while the shipping version was `v25`.)
| Check | Where |
| --- | --- |
| Current Google Ads API version + sunset dates | `https://developers.google.com/google-ads/api/docs/release-notes` |
| gtag / Consent Mode parameters | `https://developers.google.com/tag-platform/gtagjs/reference` |
Pin it once in config, never inline across call sites.
## Core Philosophy
Smart Bidding (Target CPA, Target ROAS, Maximize Conversions) relies heavily on **conversion signal quality, value accuracy, and deduplication**. Sending incomplete or duplicated conversion data distorts bidding models and wastes ad spend.
$$\text{Google Ad Click (gclid, gbraid, wbraid)} \longrightarrow \text{Sitewide Tag / GTM + Consent Mode v2} \longrightarrow \text{Enhanced Conversions (Web & API)}$$
---
## 4 Core Questions Every Google Signal Must Answer
1. **What business action occurred?** — Correct Primary vs Secondary conversion action (`Purchase`, `Lead`, `Quali