=== ClickPurity — Click Fraud Protection ===
Contributors: clickpurity
Tags: google ads, click fraud, ppc, ad fraud, fraud protection
Requires at least: 5.0
Tested up to: 6.6
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically protects your Google Ads campaigns from click fraud — bots, VPN traffic, click farms, and competitor clicks.

== Description ==

ClickPurity analyzes every click on your Google Ads for signs of fraud using device fingerprinting, VPN/proxy detection, and behavioral patterns — then automatically excludes confirmed fraud IPs from your connected Google Ads account.

This plugin adds the ClickPurity tracking script to every page of your site. No code editing, no theme changes, no developer required.

= Features =

* Automatic device fingerprinting — catches the same device clicking from different IPs
* Real-time VPN, proxy, and bot detection
* Automatic Google Ads IP exclusion via the official Google Ads API
* Works with any WordPress theme or page builder
* Zero performance impact — the script loads asynchronously and never blocks page rendering

= Requirements =

You need an active ClickPurity account and API key. Sign up at https://clickpurity.com

== External Service Disclosure ==

This plugin connects to ClickPurity (https://clickpurity.com), a third-party click fraud detection service, in order to function. Once activated with a valid API key, every page load on your site sends the following data to ClickPurity's servers: the visitor's IP address, a device fingerprint (derived from browser/hardware characteristics, not personally identifying), the page URL, referrer, and any Google Click ID (gclid) present in the URL. This data is used exclusively to detect and block click fraud on your connected Google Ads account.

No data is sent, and no external request is made, until you enter a valid API key in Settings → ClickPurity — the plugin is fully inert on install.

ClickPurity's terms of service: https://clickpurity.com/terms
ClickPurity's privacy policy: https://clickpurity.com/privacy

== Installation ==

1. Upload the `clickpurity` folder to `/wp-content/plugins/`, or install directly through the WordPress plugins screen using the provided zip file.
2. Activate the plugin through the "Plugins" screen in WordPress.
3. Go to Settings → ClickPurity.
4. Paste your API key (found in your ClickPurity dashboard under Settings → Sites & Script).
5. Save. Protection is active immediately — no further setup needed.

== Frequently Asked Questions ==

= Will this slow down my website? =

No. The tracking script loads asynchronously, after your page content, so it has no measurable impact on page speed or Core Web Vitals.

= Do I need to change my theme or edit any files? =

No. The plugin adds the required script automatically via WordPress's standard `wp_head` hook — no file editing required.

= What happens if I deactivate the plugin? =

The tracking script stops loading immediately and your Google Ads account is no longer protected by ClickPurity until you reactivate it or install it elsewhere. Your saved API key is kept unless you fully delete (not just deactivate) the plugin.

== Changelog ==

= 1.0.0 =
* Initial release.
