← Back to listings

AdShield

Script

Stop paying for bot clicks. Detect fraud by cross-referencing visitor signals with Shopify converter data, then export clean exclusion CSVs ready to upload to Meta Ads Manager.

★★★★★50 reviewsv1.000
Works with:Python 3.8+ShopifyMeta Ads ManagerTelegrammacOS LaunchAgent
$49
One-time purchase · Lifetime access
Lifetime Access: yours forever
Instant Delivery: download immediately
Commercial License: business use
Pay
stripe
Product Details:
TypeScript
CategoryMarketing
Version1.0
LicenseOne-time
Creatormasses.ai

About

Stop paying for bot clicks. Detect fraud by cross-referencing visitor signals with Shopify converter data, then export clean exclusion CSVs ready to upload to Meta Ads Manager.

Bot detection engine with tunable signals
Shopify converter sync to separate real customers from bots
Weekly report with Telegram delivery
IP exclusion CSV exporter in Meta Ads Manager format
Whitelist management — never flag a real customer twice
Tracking endpoint + LaunchAgent for continuous visitor logging
57/57 tests passing
Full tuning guide for your specific ad account

Core Capabilities

Score visitor IPs across multiple bot signals with tunable thresholds
Cross-reference flagged IPs against Shopify converter list
Whitelist confirmed customers so they never appear in exclusions
Generate weekly fraud report with rate, flagged IPs, and candidates
Export exclusion CSV in Meta Ads Manager upload format
Purge stale records older than configurable retention window
Track individual IP score history over time
Continuous logging via tracking endpoint + LaunchAgent

What's Included

adshield.py
6-command CLI: status, report, export, whitelist, score, purge.
Shopify converter sync
Pulls your converter list to distinguish real buyers from bot traffic.
Bot detection engine
Tunable scoring across multiple signals. Adjust thresholds without code changes.
Weekly report generator
Formatted summary with fraud rate, top flagged IPs, and exclusion candidate count. Delivered to Telegram.
IP exclusion CSV
Meta Ads Manager format. Upload directly to Audiences as an exclusion list.
Whitelist management
Flag a real customer once — they stay whitelisted forever across all future reports.
57-test suite
Full coverage of detection engine, export logic, whitelist, and dedup.

Requirements

Python 3.8+
Shopify store (for converter sync)
Meta Ads Manager access (for uploading exclusion lists)
Telegram bot token (for weekly reports)
macOS, Linux, or Windows (WSL)