LEADCONDUIT INTEGRATION
IPQualityScore | Proxy & VPN Detection
Proactively prevent fraud via a simple API that provides over 25 data points for risk analysis, geo location, and IP intelligence.
SPECIFICATION
Fields & configuration
The exact fields LeadConduit uses, appends, and the configuration options available for this integration.
Appended Fields
IPQualityScore will append the following data to your lead.
| Appended Field | Description |
|---|---|
Outcome | Integration outcome (success, failure, or error) |
Reason | If outcome is error, the error reason |
Proxy | True if the IP address is suspected to be a proxy |
Host | Hostname of the IP address |
Isp | ISP if one is known, otherwise "N/A" |
Organization | Organization if one is known. Can be parent company or sub company of the listed ISP. |
Asn | Autonomous System Number |
Country Code | Two character country code |
City | City |
Region | State or region |
Timezone | Timezone |
Latitude | Latitude |
Longitude | Longitude |
Is Crawler | True if the IP address is associated with a confirmed crawler from a mainstream search engine |
Connection Type | Classification of the IP address connection type as "Residential", "Corporate", "Education", "Mobile", or "Data Center" |
Recent Abuse | True if there has been any recently verified abuse for this IP address. Abuse could be a confirmed chargeback, compromised device, fake app install, or similar malicious behavior within the past few days. |
Abuse Velocity | How frequently the IP address is engaging in abuse across the IPQS threat network. Values can be "high", "medium", "low", or "none". |
Bot Status | True if bots or non-human traffic have recently used this IP address to engage in automated fraudulent behavior |
Vpn | True if the IP address is suspected of being a VPN connection |
Tor | True if the IP address is suspected of being a TOR connection |
Active Vpn | True if the IP address is an active connection of a popular VPN service |
Active Tor | True if the IP address is an active TOR exit |
Mobile | True if the user agent is a mobile browser. (will always be false if user agent is not provided) |
Fraud Score | The overall fraud score of the user based on the IP, user agent, language, and any other optionally passed variables |
Request Id | Unique request identifier |
Operating System | Operating system name and version or "N/A" |
Browser | Browser name and version or "N/A" |
Device Brand | Brand name of the device or "N/A" |
Device Model | Model name of the device or "N/A" |
Fields
The following fields are used by this integration and automatically added to your flow when missing.
| Field | Description |
|---|---|
Ip Address | IP Address |
Custom Input Variables
The following are configuration options (typically not collected with lead data).
| Variable | Description |
|---|---|
| Proxy Detection Strictness | Numeric value 0-3 for how in depth (strict) the query will be. Higher values take longer to process and may provide a higher false-positive rate. |
| Proxy Detection User Language | Optional user language header |
| Proxy Detection Fast | Set to true if to perform a faster lookup with slightly reduced accuracy |
| Proxy Detection Mobile | Set to true if the lead is from a mobile device |
| Proxy Detection Allow Public Access Points | Set to true if to skip certain checks for IP addresses from education and research institutions, schools, and some corporate connections. |
| Proxy Detection Lighter Penalties | Set to true if to use lower detection rates and Fraud Scores for mixed quality IP addresses |
| Timeout Seconds | Produce an "error" outcome if the server fails to respond within this number of seconds (default: 360) |
GETTING STARTED
Add IPQualityScore in three steps
Add the integration
Find IPQualityScore in your LeadConduit flow and add it as a step, no IT or code required.
Map your fields
Match your lead data to IPQualityScore's fields. Required fields are added to your flow automatically when missing.
Route & go live
Match your lead data to IPQualityScore's fields. Required fields are added to your flow automatically when missing.
Start routing leads with IPQualityScore
Connect IPQualityScore to your lead flow in minutes, or tell us what else you need and we'll support it.
