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.
Everflow Integrations Fraud Detection page for adding IPQualityScore
Everflow Manage Integrations IPQualityScore modal with the Enabled toggle and API Key field

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.
Everflow IPQualityScore modal with Min Fraud Score, Action, and Offers selector
Everflow offer Attribution tab with IPQualityScore detection enabled and Min Fraud Score 75

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.

How the Scoring Decision Is Made

When a click comes in on an Offer with IPQualityScore enabled, Everflow calls the IPQS API and sends the following data points for analysis:

  • IP address
  • User-Agent
  • Offer ID
  • Affiliate ID
  • Transaction ID
  • Source ID
  • HTTP Accept-Language

Everflow then evaluates the response and enforces your block or Fail Traffic setting if any of the following are true:

  • The IPQS fraud score is greater than your configured fraud score (desktop or mobile).
  • The IP is identified as a Tor exit node.
  • The IP is identified as a proxy.
Privacy Everflow does not store the IPQS API results anywhere. The response is used only to make the block-or-allow decision and is then discarded.
The Everflow integration evaluates both IP and User-Agent. When viewing results directly in the IPQS dashboard, only the IP is tested, so the two views may not always match exactly.

Scope & Limits

All offer URLs: When IPQualityScore is enabled on an Offer, it applies to all of that Offer's URLs. Reaching your IPQS API limit: If you reach your API limit with IPQS, Everflow simply ignores IPQS for additional clicks. Nothing will fail and traffic continues to flow normally.