Home
Integrations Library
Fraud Detection Integrations
IPQualityScore Integration
IPQualityScore Integration

SERIES:

IPQualityScore Integration

Learn to enable the IPQS integration to score user click data such as IP address, device, email, phone number and complete billing details.

Overview: The Fraud Shield

The IPQualityScore (IPQS) integration acts as a security gatekeeper for your Offers. It analyzes incoming traffic in milliseconds—checking IP addresses, device fingerprints, and user behavior—to identify high-risk clicks.

What it detects:

  • Bot Traffic: Non-human scripts attempting to generate fake clicks.
  • Proxies & VPNs: Users hiding their true location (often to bypass Geo-Targeting).
  • Click Farms: High-volume fraudulent activity from specific device IDs.

By setting a "Fraud Score Threshold," you automatically block this traffic before it reaches your landing page, saving your budget for real humans.

Critical Scope Limitation This integration analyzes CLICKS only. IPQS scores the initial click to prevent the user from reaching the site. It does not score conversion events that happen later.

Step-By-Step Guide

Step 1: Connect the Integration

First, you need to authorize Everflow to talk to your IPQS account.

1 Get Your API Key Log into your IPQS Dashboard. Navigate to Settings & Account Management -> Account Settings. Copy your API Key. 2 Add to Everflow In Everflow, go to Integrations -> Fraud Detection. Click Add. Select IPQualityScore and paste your API Key. Click Save.

Step 2: Enable & Configure Thresholds

You can enable this on a single Offer or apply it to hundreds at once.

The Logic: How Scoring Works You will define a "Minimum Fraud Score" (0 to 100).

  • 0 = Low Risk (Very Safe)
  • 100 = High Risk (Definite Fraud)

The Rule: If the incoming click has a score Equal To or Higher than your threshold, it is marked Invalid and blocked.

  • Example: You set the threshold to 85. A user clicks with a score of 90. That user is blocked.
A Single Offer Setup Go to Offers > Manage and edit your Offer. Navigate to Tab 4: Attribution. Toggle IPQualityScore Fraud Detection to On. Set your Thresholds: Min Fraud Score: For Desktop/General traffic. Min Fraud Score Mobile: For Mobile traffic (often requires a different sensitivity). B Bulk Setup (Recommended) Go to Integrations > Fraud Detection. Find IPQS and click Configure. Click Add Offers. Select multiple offers and apply your thresholds globally.

Step 3: What Happens to Blocked Traffic?

When IPQS flags a click as "Fraudulent," Everflow stops it from reaching the Destination URL. But where does it go? This depends on your Offer Settings:

  • If Fail Traffic is Enabled: The fraudulent click is redirected to your Fail Traffic Offer (monetizing the user elsewhere).
  • If Fail Traffic is Disabled: The user sees a blank page (Blocked).

Diagnostics: How to Verify Blocks

You've set it up. Now, how do you know it's working?

The Click Report
Go to Reporting -> Click. Filter the report by Invalid clicks. Look at the Error Message column. The Evidence: You will see the specific error: IP_QUALITY_SCORE_OVER_THRESHOLD.
Forensic Analysis (Advanced)

For a deeper dive, you can look up the raw click data.

Internal Error Code: 1019 Investigator: Use the Investigator tool or Flowchart to see the specific IP address that triggered the block and confirm that no conversion was attributed to it.