IPQualityScore Setup Guide

IPQualityScore (IPQS) is the Preads Platform's recommended primary provider for real-time IP intelligence. It offers the most comprehensive set of fraud signals and infrastructure flags, combined with a generous ecosystem for starting and scaling networks.

🚀 Quick Activation

The integration is pre-built into the platform's core. Follow these steps to activate your security layer.

1. Obtain API Credentials

  1. Register for an account at IPQualityScore.com.
  2. Navigate to your Dashboard → API → API Keys.
  3. Copy your Private Key.

2. Configure in Admin Panel

Navigate to Admin → Security → Anti-Cheat → API Keys.

  • API Key: Paste your private key into the IPQualityScore field.
  • Enabled: Toggle the switch to ON.
  • Strictness Level: Set to 1 (Balanced) for optimal results.
  • Test Connection: Click the Test API button to verify connectivity. Success will be indicated by a green notification.

📊 Detection Capabilities

IPQualityScore identifies high-risk infrastructure through a weighted analysis of multiple data points.

Standard Infrastructure Flags

The platform automatically maps the following IPQS signals into the unified audit system:

  • VPN Detection: Identifies users behind virtual private network tunnels.
  • Proxy Detection: Captures HTTP, SOCKS, and specialized mobile proxies.
  • TOR Exit Node: Real-time identification of anonymous onion routing.
  • Datacenter/Hosting: Identifies non-residential ranges (AWS, Google Cloud, DigitalOcean, etc.).

Fraud Scoring

The provider returns a normalized Fraud Score (0-100) which is used by the platform's automated decision engine:

  • 0-20: Considered low risk (Residential/Mobile).
  • 21-59: Flagged as suspicious; subject to behavioral analysis.
  • 60+: Treated as high-risk/critical; subject to automated block/flag actions.

⚙️ Technical Configuration

Strictness Level

The strictness parameter (0-2) controls the aggressiveness of the IPQS scoring engine:

  • Level 0: Low sensitivity; maximizes acceptance.
  • Level 1 (Default): Optimized balance; recommended for most networks.
  • Level 2: High sensitivity; recommended during heavy fraud attacks.

API Synergy & Caching

  • HTTP Request: The platform performs a non-blocking GET request with a 5-second timeout to ensure minimal latency.
  • Database Caching: Results are cached in the ip_intelligence table for the duration of the configured Cache TTL (default 24h), reducing your monthly IPQS credit consumption by up to 95%.

💰 Operational Scale

Feature Details
Free Tier 5,000 monthly credits (No credit card required).
Scale Strategy Ideal as the Primary provider in your fallback chain.
Verification Built-in connection sandboxing in the Admin UI.

Configure AbuseIPDB Provider →