Adtruth

Open-source ad fraud detection for small businesses using machine learning. Detect click fraud and bot traffic from Google Ads, Facebook Ads, and other platforms. Completely free.

Generate Convert Improve

Install / Use

/learn @papa-torb/Adtruth

About this skill

Quality Score

0/100

README

<p align="center"> <img src="docs/logos/github_banner.PNG" alt="AdTruth - Stop Fake Traffic. Start Real Growth." width="1000"> </p> <p align="center"> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" alt="License: MIT"></a> <a href="https://github.com/papa-torb/adtruth/actions"><img src="https://github.com/papa-torb/adtruth/actions/workflows/ci.yml/badge.svg?style=flat-square" alt="CI Status"></a> <img src="https://img.shields.io/badge/Bundle%20Size-12KB-brightgreen.svg?style=flat-square" alt="Bundle Size"> <a href="https://adtruth.io"><img src="https://img.shields.io/badge/Demo-Live%20→-success.svg?style=flat-square" alt="Live Demo"></a> </p> <p align="center"> <strong>Open-source ad fraud detection for small businesses</strong> </p> <p align="center"> <a href="https://adtruth.io">Live Demo</a> • <a href="#quick-start">Quick Start</a> • <a href="#adtruth-comparison-with-industry-solutions">Why Different</a> • <a href="#for-developers">Contribute</a> </p> <p align="center"> <em>Founded by <a href="https://github.com/papa-torb">Hongyi Shui</a></em> </p>

Ad Fraud Detection for Small Businesses

Detect click fraud, bot traffic, and fake conversions from Google Ads, Facebook Ads, Instagram, and TikTok. AdTruth is a free, open-source ad fraud detection tool that helps small businesses identify which advertising platforms waste their budget on fraudulent traffic.

You're spending $3,000/month on paid ads. Conversion rate: 5%.

30% of those clicks might be fake.

Not obvious bots—AI-powered ad fraud that mimics human behavior perfectly. Natural mouse movement. Human-like scrolling. They visit your page, bounce after 8 seconds. You just paid $2.50 for nothing.

Enterprise fraud detection tools (ClickCease, CHEQ, TrafficGuard) cost thousands per month.

We built AdTruth to give small businesses the same ad fraud visibility, completely free. Detect bot traffic and fraudulent clicks across all your advertising platforms. See which channels waste your budget on fake traffic and shift spending to real customers.

The Reality of Ad Fraud and Click Fraud

The Problem

30% of paid traffic is fraudulent

Bot farms generate fake clicks
AI mimics real user behavior perfectly
Click fraud costs you $1-3 per $10 spent
Platforms filter obvious bots, but sophisticated fraud slips through

Your campaigns look fine. The fraud is invisible.

</td> <td width="33%" valign="top">

The Double Cost

Two ways you're losing money

Fraud waste: $2-10K/year on bot clicks
Solution cost: $5K-50K/year for enterprise tools
Small businesses face both problems
Can't afford visibility, can't stop the bleeding

Without fraud analytics, you're flying blind.

</td> <td width="33%" valign="top">

The Solution

$0 forever with AdTruth

See fraud rates across Google, Facebook, Instagram, TikTok
Compare: "Google 11% fraud vs Instagram 63% fraud"
Shift budget from high-fraud to low-fraud platforms
12KB script—lighter than most images

One line of code. Free forever. Open source.

</td> </tr> </table> <div align="center">

Know which platforms waste your money. Shift budget to what works.

Get Started → • View Demo • Read Docs

</div>

How Fraud Works

The fraud economy: Fake websites generate clicks → Fraudsters profit → Your budget disappears → Real customers never see your ads

AdTruth reveals which platforms have higher fraud rates, so you can shift budget from high-fraud channels to low-fraud ones.

</div>

See It In Action

Calculate Your Fraud Waste (Estimated fraud rates. Real data available once you connect)

Try it yourself: adtruth.io • Enter your website to see estimated fraud rates across Google, Facebook, Instagram, and TikTok

</div>

Your Dashboard After Connection

Real-time insights:

See which platforms waste money on bots vs attract real customers
Compare your fraud rates to industry benchmarks
Get actionable recommendations

<span style="color: #1E3A8A;">How AdTruth Works</span>

1. Install → Add one line of code to your website (takes 60 seconds)

2. Collect → AdTruth automatically tracks visitor behavior and fraud signals

3. Analyze → Our ML models calculate fraud rates for each traffic source

4. Optimize → See platform-by-platform fraud rates (e.g., "Google: 11%, Instagram: 63%")

5. Reallocate → Shift budget from high-fraud platforms to channels with real customers

Zero configuration. No maintenance. Just install and go.

<span style="color: #1E3A8A;">Quick Start</span>

Get started in 60 seconds • No credit card required • Free forever

Universal Installation (Works on Any Website)

Add this script before the closing </body> tag:

<script>
(function(d, s, id) {
    var js, fjs = d.getElementsByTagName(s)[0];
    if (d.getElementById(id)) return;
    js = d.createElement(s); js.id = id;
    js.src = 'https://cdn.jsdelivr.net/gh/papa-torb/adtruth@latest/dist/adtruth.min.js';
    js.onload = function() {
        AdTruth.init('YOUR_API_KEY_HERE');
    };
    fjs.parentNode.insertBefore(js, fjs);
}(document, 'script', 'adtruth-js'));
</script>

Get your free API key: Sign up at adtruth.io (takes 30 seconds)

<span style="color: #1E3A8A;">Platform-Specific Guides</span>

WordPress - ✅ TESTED

Time: 2 minutes • Difficulty: Easy • Tested: Verified working

WordPress powers 43% of all websites. We've tested and confirmed this integration works perfectly.

Quick Steps:

Install the WPCode plugin (2M+ active installations)
Go to Code Snippets → Header & Footer
Paste the AdTruth script in the Footer section
Click Save Changes

View detailed WordPress guide →

Shopify - ✅ TESTED

Time: 3 minutes • Difficulty: Easy • Tested: Verified working

Modern Shopify stores use Custom Pixels for tracking scripts. This is the recommended method.

Quick Steps:

Go to Settings → Customer Events
Click Add Custom Pixel
Name it "AdTruth Fraud Detection"
Paste the AdTruth initialization code
Click Save

View detailed Shopify guide →

Wix

Time: 2 minutes • Difficulty: Easy

Quick Steps:

Go to Settings → Custom Code in your Wix dashboard
Click + Add Custom Code
Paste the AdTruth script
Set to load on All Pages in the Body - end
Click Apply

View detailed Wix guide →

Other Platforms

We have tested integration guides for:

Squarespace - View guide
Webflow - View guide
GoDaddy Website Builder - View guide
GitHub Pages - View guide

Who AdTruth Helps

| Business Type | Common Problem | How AdTruth Helps | |---------------|----------------|-------------------------------------------------------| | E-commerce | High ad spend, low ROAS | Identify which platforms attract bots vs real shoppers | | SaaS Companies | Fake signups waste sales time | Distinguish real leads from click farm accounts | | Local Businesses | Limited budget, blind spending | See which platforms deliver real foot traffic | | Marketing Agencies | Clients blame poor results on you | Prove fraud with data, not guesswork | | Developers | Want to contribute to open source | Help build better fraud detection for everyone |

AdTruth Comparison with Industry Solutions

<table> <tr> <th width="25%">Feature</th> <th width="25%">AdTruth</th> <th width="25%">Enterprise Tools<br><sub>(ClickCease, CHEQ, etc.)</sub></th> <th width="25%">Google Analytics</th> </tr> <tr> <td><strong>Cost</strong></td> <td>✅ <strong>$0 forever</strong></td> <td>❌ $12K-50K/year</td> <td>✅ Free</td> </tr> <tr> <td><strong>Fraud Detection</strong></td> <td>✅ ML-powered, real-time</td> <td>✅ Advanced (black box)</td> <td>⚠️ Basic bot filtering only</td> </tr> <tr> <td><strong>Network Intelligence</strong></td> <td>✅ <strong>Learns from all sites</strong></td> <td>❌ Your data only</td> <td>❌ No fraud focus</td> </tr> <tr> <td><strong>Tracking Transparency</strong></td> <td>✅ <strong>100% open source</strong></td> <td>❌ Proprietary black box</td> <td>❌ Proprietary</td> </tr> <tr> <td><strong>Setup Time</strong></td> <td>✅ <strong>60 seconds</strong></td> <td>⏱️ Days to weeks</td> <td>⏱️ 5 minutes</td> </tr> <tr> <td><strong>Best For</strong></td> <td>✅ <strong>Small businesses</strong></td> <td>Large enterprises</td> <td>Basic analytics</td> </tr> </table>

The AdTruth Advantage

Enterprise-grade fraud analytics without enterprise pricing. Your traffic data helps train models that benefit the entire network. When we detect fraud patterns on one site, every other business gets better fraud scoring immediately.