📚 Documentation

Learn how to integrate AdFraudX with your tracking platform. Simple step-by-step guides that anyone can follow.

🚀 Quick Start

AdFraudX helps you detect fraudulent clicks so you can see which traffic is real and which is fake. Here's how it works:

How AdFraudX Works

  1. You create a campaign in AdFraudX and get a tracking URL
  2. You use that URL in your tracking platform (like Bemob)
  3. When someone clicks your ad, the click goes through AdFraudX first
  4. AdFraudX analyzes the click to detect if it's from a bot, VPN, proxy, or other fraud indicators
  5. AdFraudX forwards the click to your advertiser (all clicks are forwarded)
  6. You see the results in your dashboard - which clicks were detected as fraud and which were safe
📊 Important: AdFraudX detects fraud but does not block traffic. All clicks are forwarded to your advertiser. You can then review the fraud detection results in your dashboard to make informed decisions about your traffic sources.
💡 What You Need:
  • An AdFraudX account (free signup available)
  • A tracking platform account (like Bemob)
  • 5 minutes to set it up

🔗 Integration Guides

Choose your tracking platform below to see step-by-step instructions:

📱 Bemob Integration Guide

Follow these simple steps to connect AdFraudX with Bemob:

Step 1: Create a Campaign in AdFraudX

  1. Log in to your AdFraudX account
  2. Go to "Campaigns" in the menu
  3. Click "Create New Campaign"
  4. Enter your campaign name (e.g., "My Bemob Campaign")
  5. Enter your advertiser's URL (the final destination URL)
  6. Click "Save Campaign"

✅ You'll get a tracking URL that looks like:

https://adfraudx.com/track/abc123def456...

Step 2: Copy Your Tracking URL

  1. In your AdFraudX campaign, find the "Tracking URL"
  2. Click the "Copy" button next to it
  3. Keep this URL handy - you'll need it in Bemob
⚠️ Important: This is your AdFraudX tracking URL. You'll use this in Bemob instead of your advertiser's URL directly.

Step 3: Set Up Campaign in Bemob

  1. Log in to your Bemob account
  2. Go to "Campaigns" → "Create Campaign"
  3. Fill in your campaign details (name, traffic source, etc.)
  4. In the "Landing Page URL" or "Offer URL" field:
  5. Paste your AdFraudX tracking URL (the one you copied in Step 2)
  6. Save your Bemob campaign
💡 Tip: The AdFraudX URL will forward clicks to your advertiser automatically. You don't need to enter the advertiser URL separately.

Step 4: Set Up Postback URL (For Conversions)

To track conversions and detect conversion fraud, you need to set up postbacks. Here's how the flow works:

🔄 Postback Flow:
  1. Advertiser sends conversion → AdFraudX
  2. AdFraudX detects if the original click was fraud
  3. AdFraudX forwards conversion → Bemob (your tracking platform)

Part A: Set Up Your Bemob Postback URL in AdFraudX

  1. In your AdFraudX account, go to "Settings"
  2. Find the "Postback URL" field
  3. Enter your Bemob postback URL with macros. This is where AdFraudX will forward conversions. Example:
https://your-bemob-domain.com/postback?clickid={clickid}&payout={payout}
  1. Click "Save Settings"
  2. AdFraudX will generate a postback URL for you to give to your advertiser

Part B: Give AdFraudX Postback URL to Your Advertiser

  1. After saving, AdFraudX will show you a "Postback URL to Give Advertiser"
  2. This URL will look like:
https://adfraudx.com/postback/pb_your_unique_token_here?click_id={clickid}&amount={payout}
  1. Copy this URL
  2. Give this URL to your advertiser (not Bemob)
  3. Tell your advertiser to use this as their postback URL
⚠️ Important:
  • You enter your Bemob postback URL in AdFraudX Settings
  • You give the AdFraudX postback URL to your advertiser
  • The advertiser sends conversions to AdFraudX, and AdFraudX forwards them to Bemob
📝 Macros Explained:

AdFraudX supports all common macro formats. You can use any of these:

  • #macro# - Hash format (e.g., #s2#, #price#)
  • {macro} - Curly braces (e.g., {clickid}, {payout})
  • [macro] - Square brackets (e.g., [s2], [amount])
  • <macro> - Angle brackets (e.g., <clickid>, <price>)

Example Bemob Postback URL:

  • https://bemob.com/postback?clickid={clickid}&payout={payout}
  • https://bemob.com/postback?clickid=#s2#&amount=#price#
  • https://bemob.com/postback?clickid=[s2]&amount=[price]

Step 5: Test Your Setup

  1. In Bemob, click on your campaign to generate a test link
  2. Click the test link yourself
  3. Go back to AdFraudX → "Clicks" or "Dashboard"
  4. You should see your test click appear within a few seconds
  5. Check if it shows as ✅ Safe or ❌ Fraud
🎉 That's it! Your setup is complete. AdFraudX will now analyze every click and detect fraud. Check your dashboard to see the results.

❓ Common Questions

Q: What macro formats does AdFraudX support?

A: AdFraudX supports all common macro formats:

  • #macro# - Hash format (e.g., #s2#, #price#)
  • {macro} - Curly braces (e.g., {clickid}, {payout})
  • [macro] - Square brackets (e.g., [s2], [amount])
  • <macro> - Angle brackets (e.g., <clickid>, <price>)

You can use any format that your tracking platform uses. AdFraudX will recognize and handle all of them.

Q: Do I need to change anything in my advertiser's settings?

A: No! Your advertiser doesn't need to know about AdFraudX. Everything works behind the scenes. All clicks are forwarded to your advertiser as normal.

Q: Does AdFraudX block fraudulent clicks?

A: No. AdFraudX detects fraud but does not block traffic. All clicks are forwarded to your advertiser. You can then review the fraud detection results in your dashboard to see which clicks were detected as fraud (bots, VPNs, proxies, etc.) and make informed decisions about your traffic sources.

Q: Can I see which clicks were detected as fraud?

A: Yes! Go to your AdFraudX dashboard and click on "Clicks" or "Advanced Stats". You'll see all clicks with fraud indicators showing which ones were detected as bots, VPNs, proxies, datacenters, or other fraud types.

📱 Affise Integration Guide

Follow these simple steps to connect AdFraudX with Affise:

Step 1: Create a Campaign in AdFraudX

  1. Log in to your AdFraudX account
  2. Go to "Campaigns" in the menu
  3. Click "Create New Campaign"
  4. Enter your campaign name (e.g., "My Affise Campaign")
  5. Enter your advertiser's URL (the final destination URL)
  6. Click "Save Campaign"

✅ You'll get a tracking URL that looks like:

https://adfraudx.com/track/abc123def456...

Step 2: Copy Your Tracking URL

  1. In your AdFraudX campaign, find the "Tracking URL"
  2. Click the "Copy" button next to it
  3. Keep this URL handy - you'll need it in Affise
⚠️ Important: This is your AdFraudX tracking URL. You'll use this in Affise instead of your advertiser's URL directly.

Step 3: Set Up Campaign in Affise

  1. Log in to your Affise account
  2. Go to "Offers" → "Create Offer" or edit an existing offer
  3. Fill in your offer details (name, description, etc.)
  4. In the "Landing Page URL" or "Offer URL" field:
  5. Paste your AdFraudX tracking URL (the one you copied in Step 2)
  6. Save your Affise offer
💡 Tip: The AdFraudX URL will forward clicks to your advertiser automatically. You don't need to enter the advertiser URL separately.

Step 4: Set Up Postback URL (For Conversions)

To track conversions and detect conversion fraud, you need to set up postbacks. Here's how the flow works:

🔄 Postback Flow:
  1. Advertiser sends conversion → AdFraudX
  2. AdFraudX detects if the original click was fraud
  3. AdFraudX forwards conversion → Affise (your tracking platform)

Part A: Set Up Your Affise Postback URL in AdFraudX

  1. In your AdFraudX account, go to "Settings"
  2. Find the "Postback URL" field
  3. Enter your Affise postback URL with macros. This is where AdFraudX will forward conversions. Example:
https://your-affise-domain.com/postback?clickid={clickid}&payout={payout}
  1. Click "Save Settings"
  2. AdFraudX will generate a postback URL for you to give to your advertiser

Part B: Give AdFraudX Postback URL to Your Advertiser

  1. After saving, AdFraudX will show you a "Postback URL to Give Advertiser"
  2. This URL will look like:
https://adfraudx.com/postback/pb_your_unique_token_here?click_id={clickid}&amount={payout}
  1. Copy this URL
  2. Give this URL to your advertiser (not Affise)
  3. Tell your advertiser to use this as their postback URL
⚠️ Important:
  • You enter your Affise postback URL in AdFraudX Settings
  • You give the AdFraudX postback URL to your advertiser
  • The advertiser sends conversions to AdFraudX, and AdFraudX forwards them to Affise
📝 Macros Explained:

AdFraudX supports all common macro formats. You can use any of these:

  • #macro# - Hash format (e.g., #s2#, #price#)
  • {macro} - Curly braces (e.g., {clickid}, {payout})
  • [macro] - Square brackets (e.g., [s2], [amount])
  • <macro> - Angle brackets (e.g., <clickid>, <price>)

Example Affise Postback URL:

  • https://affise.com/postback?clickid={clickid}&payout={payout}
  • https://affise.com/postback?clickid=#s2#&amount=#price#
  • https://affise.com/postback?clickid=[s2]&amount=[price]

Step 5: Test Your Setup

  1. In Affise, click on your offer to generate a test link
  2. Click the test link yourself
  3. Go back to AdFraudX → "Clicks" or "Dashboard"
  4. You should see your test click appear within a few seconds
  5. Check if it shows as ✅ Safe or ❌ Fraud
🎉 That's it! Your setup is complete. AdFraudX will now analyze every click and detect fraud. Check your dashboard to see the results.

❓ Common Questions

Q: What macro formats does AdFraudX support?

A: AdFraudX supports all common macro formats:

  • #macro# - Hash format (e.g., #s2#, #price#)
  • {macro} - Curly braces (e.g., {clickid}, {payout})
  • [macro] - Square brackets (e.g., [s2], [amount])
  • <macro> - Angle brackets (e.g., <clickid>, <price>)

You can use any format that your tracking platform uses. AdFraudX will recognize and handle all of them.

Q: Do I need to change anything in my advertiser's settings?

A: No! Your advertiser doesn't need to know about AdFraudX. Everything works behind the scenes. All clicks are forwarded to your advertiser as normal.

Q: Does AdFraudX block fraudulent clicks?

A: No. AdFraudX detects fraud but does not block traffic. All clicks are forwarded to your advertiser. You can then review the fraud detection results in your dashboard to see which clicks were detected as fraud (bots, VPNs, proxies, etc.) and make informed decisions about your traffic sources.

Q: Can I see which clicks were detected as fraud?

A: Yes! Go to your AdFraudX dashboard and click on "Clicks" or "Advanced Stats". You'll see all clicks with fraud indicators showing which ones were detected as bots, VPNs, proxies, datacenters, or other fraud types.

More Integration Guides Coming Soon!

We're working on step-by-step guides for:

  • Voluum
  • ThriveTracker
  • AdsBridge
  • And more...

The setup process is similar for all platforms. If you need help with a specific tracker, contact our support!

🔄 How It Works (Simple Explanation)

Here's what happens when someone clicks your ad:

The Click Journey

  1. User clicks your ad → Goes to Bemob first
  2. Bemob redirects → Sends click to AdFraudX
  3. AdFraudX analyzes → Checks for bots, VPNs, proxies, datacenters, and other fraud indicators (takes less than 1 second)
  4. AdFraudX forwards click → All clicks are forwarded to your advertiser (both safe and fraud-detected clicks)
  5. AdFraudX records results → Stores fraud detection data in your dashboard
  6. You see results → Check your AdFraudX dashboard anytime to see which clicks were detected as fraud
📊 Remember: AdFraudX detects fraud but does not block traffic. All clicks are forwarded to your advertiser. You can review the fraud detection results in your dashboard to identify problematic traffic sources.
⏱️ Speed: AdFraudX checks clicks in less than 1 second, so there's no noticeable delay for real users.

💰 Understanding Conversions

When someone converts (makes a purchase, signs up, etc.), here's what happens:

Conversion Flow

  1. User converts on your advertiser's website
  2. Advertiser sends conversion to AdFraudX (using the postback URL you gave them, with click_id and amount)
  3. AdFraudX receives conversion and matches it to the original click using the click_id
  4. AdFraudX checks: Was the original click detected as fraud?
  5. AdFraudX records: Conversion is marked as valid or fraud based on the original click's fraud detection
  6. AdFraudX forwards conversion to Bemob (using your Bemob postback URL from settings, with macros replaced with actual values)
  7. Bemob receives conversion and records it in your tracking platform
  8. You see results → Check your AdFraudX dashboard to see conversion fraud detection
📝 Important: If the original click was detected as fraud, the conversion is also marked as fraud in your dashboard. This helps you identify which conversions came from fraudulent traffic sources. All conversions are still forwarded to Bemob (your tracking platform) so you can see them in your tracking dashboard.
⚠️ Macro Formats: Make sure your postback URL uses the correct macro format that your tracking platform supports. AdFraudX supports all formats: #macro#, {macro}, [macro], and <macro>.

🆘 Need Help?

If you're stuck or have questions:

  • Check your dashboard: Most issues can be solved by checking your AdFraudX dashboard
  • Review your URLs: Make sure your tracking URL and postback URL are correct
  • Test with a real click: Sometimes the best way to test is to click your own link
  • Contact support: If nothing works, reach out to our support team