Gravity Forms Conversion Tracking

=== Gravity Forms Conversion Tracking === Contributors: tha_sun, netzstrategen Requires Plugins: gravityforms Requires at least: 6.5 Tested up to: 6.7 Requires PHP: 7.4 Stable tag: 1.0.0 License: GPL-2.0+ License URI: http://www.gnu.org/licenses/gpl-2.0

Per-form Google Ads and GA4 lead-conversion tracking for Gravity Forms text confirmations.

== Description ==

Adds a "Google Ads / GA4 Conversion Tracking" section to every Gravity Forms form's own Form Settings page (Conversion ID, Conversion Label, lead stage, value, currency). When that form is submitted and its text confirmation is shown, the plugin fires a GA4 lead event (generate_lead/qualify_lead/working_lead) plus the form's Google Ads conversion data into window.dataLayer, and, where gtag.js is present directly (e.g. via Google Site Kit without Google Tag Manager), calls gtag() directly as a fallback.

The event is always fired from the top-level page, never from inside Gravity Forms' hidden AJAX iframe — see SPEC.md for why that distinction matters (it avoids a genuine double-counting bug).

A single, generic Google Tag Manager tag (built once, manually, using GTM Data Layer Variables) can then handle Google Ads conversions for every configured form, without any further per-form GTM changes. See SPEC.md for the exact one-time GTM setup this plugin expects.

== Requirements ==

• Gravity Forms 2.5 or later — this plugin relies on the modern Form Settings API (gform_form_settings_fields).
• Either a Google Tag Manager container, or a directly embedded Google gtag.js snippet (e.g. via Google Site Kit) on the front end.

== Installation ==

1. Upload the gravityforms-conversion-tracking folder to wp-content/plugins/.
2. Activate the plugin. Gravity Forms must already be active; the plugin does nothing otherwise.
3. Open a form's Form Settings page and fill in the "Google Ads / GA4 Conversion Tracking" section. Both Conversion ID and Conversion Label must be filled in for tracking to fire for that form.
4. Complete the one-time Google Tag Manager (or gtag.js) setup described in SPEC.md.

== Changelog ==

= 1.0.0 =

• Initial release.