{"id":357016,"date":"2026-08-31T07:48:18","date_gmt":"2026-08-31T07:48:18","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/clickpatrol-click-fraud-protection\/"},"modified":"2026-09-01T09:31:54","modified_gmt":"2026-09-01T09:31:54","slug":"clickpatrol-click-fraud-protection","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/clickpatrol-click-fraud-protection\/","author":23350361,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.2.7","stable_tag":"1.2.7","tested":"7.1","requires":"5.2","requires_php":"7.4","requires_plugins":null,"header_name":"ClickPatrol Click Fraud Protection","header_author":"ClickPatrol","header_description":"Official ClickPatrol loader. Classify PPC click fraud and bot traffic on Google Ads, Meta, Microsoft Ads and more after you save your UID.","assets_banners_color":"366171","last_updated":"2026-09-01 09:31:54","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/docs.clickpatrol.com\/google-tag-manager\/","header_author_uri":"https:\/\/clickpatrol.com\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":112,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.2.6":{"tag":"1.2.6","author":"clickpatrol","date":"2026-08-31 07:59:32","revision":3673601},"1.2.7":{"tag":"1.2.7","author":"clickpatrol","date":"2026-09-01 09:31:54","revision":3675783}},"upgrade_notice":{"1.2.7":"<p>Directory screenshots replaced. Plugin behaviour is unchanged.<\/p>","1.2.6":"<p>Directory review: external service disclosure and unique clickpatrol_cfp prefixes.<\/p>","1.2.5":"<p>Plugin URI and Author URI are now different pages.<\/p>","1.2.4":"<p>Tested up to WordPress 7.0.<\/p>","1.2.3":"<p>Copy now covers all connected ad networks, not only Google Ads.<\/p>","1.2.2":"<p>Readme now matches the longer directory searches for Google Ads and PPC click fraud.<\/p>","1.2.1":"<p>Display name and tags updated for the WordPress.org directory. Submit with this name so the slug can include click-fraud.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3673601,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3673601,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3673590,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3673601,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3673601,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.2.6","1.2.7"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":3674001,"resolution":"1","location":"assets","locale":"","width":1920,"height":1080},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":3674001,"resolution":"2","location":"assets","locale":"","width":1920,"height":1080},"screenshot-3.jpg":{"filename":"screenshot-3.jpg","revision":3674001,"resolution":"3","location":"assets","locale":"","width":1920,"height":1080}},"screenshots":{"1":"Settings \u2192 ClickPatrol. Create an account, then paste your UID to turn the measurement script on.","2":"After you save a UID, public pages load ClickPatrol. Use the same UID as the Google Tag Manager tag.","3":"Optional extras match the official GTM tag. All stay off until you enable them."}},"plugin_section":[],"plugin_tags":[368,4270,157374,985,322],"plugin_category":[35],"plugin_contributors":[278434],"plugin_business_model":[],"class_list":["post-357016","plugin","type-plugin","status-publish","hentry","plugin_tags-advertising","plugin_tags-click-fraud","plugin_tags-fraud-detection","plugin_tags-google-ads","plugin_tags-ppc","plugin_category-advertising","plugin_contributors-clickpatrol","plugin_committers-clickpatrol"],"banners":{"banner":"https:\/\/ps.w.org\/clickpatrol-click-fraud-protection\/assets\/banner-772x250.png?rev=3673601","banner_2x":"https:\/\/ps.w.org\/clickpatrol-click-fraud-protection\/assets\/banner-1544x500.png?rev=3673601","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/clickpatrol-click-fraud-protection\/assets\/icon.svg?rev=3673590","icon":"https:\/\/ps.w.org\/clickpatrol-click-fraud-protection\/assets\/icon.svg?rev=3673590","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/clickpatrol-click-fraud-protection\/assets\/screenshot-1.jpg?rev=3674001","caption":"Settings \u2192 ClickPatrol. Create an account, then paste your UID to turn the measurement script on."},{"src":"https:\/\/ps.w.org\/clickpatrol-click-fraud-protection\/assets\/screenshot-2.jpg?rev=3674001","caption":"After you save a UID, public pages load ClickPatrol. Use the same UID as the Google Tag Manager tag."},{"src":"https:\/\/ps.w.org\/clickpatrol-click-fraud-protection\/assets\/screenshot-3.jpg?rev=3674001","caption":"Optional extras match the official GTM tag. All stay off until you enable them."}],"raw_content":"<!--section=description-->\n<p>ClickPatrol Click Fraud Protection is the official WordPress plugin for ClickPatrol. After you paste your UID, it loads the ClickPatrol measurement script so paid traffic can be classified as legitimate or suspicious.<\/p>\n\n<p>That classification is what ClickPatrol uses to spot click fraud, bots, and other invalid ad clicks. It is not limited to Google Ads. The same site tag feeds the networks you connect in the ClickPatrol dashboard, including Google Ads, Meta, Microsoft Ads, LinkedIn, TikTok, Pinterest and DV360. How protection is applied differs per network and is configured in the account, not inside this plugin.<\/p>\n\n<p>The plugin does not change your page content. It does not load the script until an administrator saves a UID.<\/p>\n\n<p>Use it when you want PPC click fraud classified on WordPress without editing theme files, including Google Ads click fraud, or when you need the same ClickPatrol tag you would otherwise add in Google Tag Manager.<\/p>\n\n<h4>What the loader sends<\/h4>\n\n<ul>\n<li>UID, current page query string, page URL, first-party visitor id, first-party session id<\/li>\n<li>Optional: restore a Google Ads GCLID from a <code>vd<\/code> parameter (Safari\/ITP)<\/li>\n<li>Optional: extend the lifetime of existing first-party advertising cookies, per provider, all off by default<\/li>\n<\/ul>\n\n<h4>Account and pricing<\/h4>\n\n<p>A <a href=\"https:\/\/clickpatrol.com\/\">ClickPatrol<\/a> account is required. Create one at <a href=\"https:\/\/dashboard.clickpatrol.com\/register\">dashboard.clickpatrol.com\/register<\/a>. Plans live on <a href=\"https:\/\/clickpatrol.com\/pricing\/\">clickpatrol.com\/pricing<\/a>. A 7-day trial is available there. A card is required for verification only (a one-time \u20ac0.01 charge). You are not billed during the trial.<\/p>\n\n<h4>Highlights<\/h4>\n\n<ul>\n<li>Official WordPress loader for the ClickPatrol measurement script<\/li>\n<li>Settings page explains how to create an account, find pricing, book a demo, and copy the UID<\/li>\n<li>UID is saved in WordPress; no theme edit required<\/li>\n<li>Works behind page caches because the query string is read in the browser<\/li>\n<li>First-party <code>cp_visitor_id<\/code> (400 days) and <code>cp_session_id<\/code> (1 day)<\/li>\n<li>Reloads on history changes so SPA-style page transitions still send a hit<\/li>\n<\/ul>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects to ClickPatrol to classify advertising traffic on public pages. That classification is needed so the site owner's ClickPatrol account can mark paid clicks as legitimate or suspicious.<\/p>\n\n<p>It sends the ClickPatrol UID, current page URL, page query string (this can include advertising parameters such as gclid or UTM values), first-party visitor id, and first-party session id every time a public page loads after an administrator has saved a UID in Settings \u2192 ClickPatrol. The ClickPatrol host also receives the visitor IP address, user agent and referrer as part of that request. Nothing is sent until a UID is saved. After history changes the same request is sent again.<\/p>\n\n<p>The measurement script is loaded from https:\/\/trck-002.clckptrl.com\/. That host is operated by ClickPatrol.<\/p>\n\n<p>Optional settings, all off by default: if GCLID recovery is enabled, the plugin may write a <code>_gcl_aw<\/code> cookie from a <code>vd<\/code> URL parameter. If a cookie-extend group is enabled, the plugin may rewrite the max-age of cookies that already exist for that provider.<\/p>\n\n<p>This service is provided by ClickPatrol: <a href=\"https:\/\/clickpatrol.com\/term-condition\/\">terms of use<\/a>, <a href=\"https:\/\/clickpatrol.com\/privacy-policy\/\">privacy policy<\/a>.<\/p>\n\n<p>You should mention ClickPatrol in your own site privacy policy. A suggested paragraph is available under Tools \u2192 Privacy after this plugin is active. That text is an example, not legal advice.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate the plugin.<\/li>\n<li>Open <strong>Settings \u2192 ClickPatrol<\/strong>.<\/li>\n<li>Create a ClickPatrol account if you do not have one: <a href=\"https:\/\/dashboard.clickpatrol.com\/register\">register<\/a>.<\/li>\n<li>Copy <strong>Your Unique ID<\/strong> from the dashboard: Integration \u2192 Google Tag Manager.<\/li>\n<li>Paste the UID, save, and open a public page. Add <code>?source=f<\/code> to force a test classification.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20a%20clickpatrol%20account%3F\"><h3>Do I need a ClickPatrol account?<\/h3><\/dt>\n<dd><p>Yes. This plugin only loads the measurement script. Classification, blocking, and reporting happen in your ClickPatrol account. Create an account at <a href=\"https:\/\/dashboard.clickpatrol.com\/register\">dashboard.clickpatrol.com\/register<\/a>. Plans: <a href=\"https:\/\/clickpatrol.com\/pricing\/\">clickpatrol.com\/pricing<\/a>.<\/p><\/dd>\n<dt id=\"where%20do%20i%20find%20my%20uid%3F\"><h3>Where do I find my UID?<\/h3><\/dt>\n<dd><p>Sign in at <a href=\"https:\/\/dashboard.clickpatrol.com\/\">dashboard.clickpatrol.com<\/a>. Open <strong>Integration<\/strong>, then the <strong>Google Tag Manager<\/strong> tab, and copy <strong>Your Unique ID<\/strong>. The same ID is used for this plugin.<\/p><\/dd>\n<dt id=\"which%20ad%20platforms%20does%20this%20cover%3F\"><h3>Which ad platforms does this cover?<\/h3><\/dt>\n<dd><p>The plugin classifies visits on your WordPress site. ClickPatrol can use that classification on the networks you connect in the dashboard, including Google Ads, Meta, Microsoft Ads, LinkedIn, TikTok, Pinterest and DV360. The plugin does not log in to those networks itself. How blocking or exclusion works differs per network and lives in the ClickPatrol account.<\/p><\/dd>\n<dt id=\"can%20i%20use%20this%20for%20ppc%20click%20fraud%2C%20not%20only%20google%20ads%3F\"><h3>Can I use this for PPC click fraud, not only Google Ads?<\/h3><\/dt>\n<dd><p>Yes. PPC click fraud on Meta, Microsoft Ads and the other connected networks uses the same site classification. Google Ads click fraud is one of those cases, not the only one.<\/p><\/dd>\n<dt id=\"does%20this%20replace%20google%20tag%20manager%3F\"><h3>Does this replace Google Tag Manager?<\/h3><\/dt>\n<dd><p>It replaces the ClickPatrol GTM <strong>tag<\/strong> on WordPress. It does not replace your GTM container, GA4 tags, or audience wiring. If you already fire the official ClickPatrol GTM tag on this site, keep this plugin off.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20change%20my%20website%20content%3F\"><h3>Does the plugin change my website content?<\/h3><\/dt>\n<dd><p>No. It enqueues one local loader script. That loader then requests the ClickPatrol measurement script.<\/p><\/dd>\n<dt id=\"is%20clickpatrol%20a%20substitute%20for%20legal%20advice%20on%20gdpr%20or%20ccpa%3F\"><h3>Is ClickPatrol a substitute for legal advice on GDPR or CCPA?<\/h3><\/dt>\n<dd><p>No. ClickPatrol publishes a <a href=\"https:\/\/clickpatrol.com\/privacy-policy\/\">privacy policy<\/a> and <a href=\"https:\/\/clickpatrol.com\/term-condition\/\">terms of use<\/a>. Your own compliance depends on your setup, consent tools, and counsel.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.2.7<\/h4>\n\n<ul>\n<li>Replace directory screenshots so the listing no longer serves the cropped first set.<\/li>\n<li>Tested up to WordPress 7.1.<\/li>\n<\/ul>\n\n<h4>1.2.6<\/h4>\n\n<ul>\n<li>Document the ClickPatrol measurement host, the data sent, and the terms of use and privacy policy links.<\/li>\n<li>Prefix PHP, JS and option names with clickpatrol_cfp so they stay unique.<\/li>\n<\/ul>\n\n<h4>1.2.5<\/h4>\n\n<ul>\n<li>Split Plugin URI (install docs) from Author URI (clickpatrol.com) so Plugin Check accepts the headers.<\/li>\n<\/ul>\n\n<h4>1.2.4<\/h4>\n\n<ul>\n<li>Tested up to WordPress 7.0 so the listing stays eligible in directory search.<\/li>\n<\/ul>\n\n<h4>1.2.3<\/h4>\n\n<ul>\n<li>Listing and settings copy now name Meta, Microsoft Ads, LinkedIn, TikTok, Pinterest and DV360. Google Ads is one connected network, not the only one.<\/li>\n<li>Re-sanitize UID and flags on read, and lock both options to manage_options.<\/li>\n<\/ul>\n\n<h4>1.2.2<\/h4>\n\n<ul>\n<li>Readme: name the Google Ads click fraud and PPC click fraud queries once, in plain language.<\/li>\n<\/ul>\n\n<h4>1.2.1<\/h4>\n\n<ul>\n<li>Directory listing: display name, short description, and five existing tags aimed at click-fraud and Google Ads search.<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>Settings page: account signup, pricing, demo, dashboard, and UID location.<\/li>\n<li>Optional GTM extras: GCLID recovery from <code>vd<\/code>, cookie lifetime extension per provider (all off).<\/li>\n<li>Loader also fires after history changes and back-forward cache restores.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Enqueue a local loader file instead of an empty script handle.<\/li>\n<li>Send <code>u<\/code>, <code>visitor_id<\/code>, and <code>session_id<\/code> so the request matches the official GTM tag.<\/li>\n<li>Document the ClickPatrol host, data, terms, and privacy policy.<\/li>\n<li>Add a suggested privacy-policy paragraph and uninstall cleanup.<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Fixed text domain mismatch by aligning folder, header, and function calls to <code>clickpatrol-tag<\/code>.<\/li>\n<li>Moved translators comment to the exact line above the placeholder string.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Coding standards: replaced heredoc, added translators comment, updated \"Tested up to\".<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Official ClickPatrol loader. Classify PPC click fraud and bot traffic on Google Ads, Meta, Microsoft Ads and more after you save your UID.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/357016","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=357016"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/clickpatrol"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=357016"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=357016"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=357016"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=357016"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=357016"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=357016"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}