Skip to content

Sub-ID Validity Check

What it detects

Section titled “What it detects”

Fraudulent publishers sometimes pass malformed, missing, or excessively unique sub IDs to obscure traffic origin or game attribution. The Sub-ID Validity Check enforces format rules and uniqueness limits, blocking clicks and conversions that fail to meet your sub ID standards.

How it works

Section titled “How it works”

Integr8 validates the sub_id parameter on each incoming request against the rules you configure:

  • Format rules: You can require numeric-only sub IDs and enforce minimum/maximum length constraints.
  • Uniqueness limit: You can cap the number of unique sub IDs allowed per publisher. Sub IDs beyond the limit are grouped under a unified placeholder value, and the original sub ID is stored in invalid_sub_id.

The filter applies to both clicks and conversions.

Configuration

Section titled “Configuration”

Navigate to Offers > Fraud Detection Groups > select a filter group > Sub-ID Validity Check.

Parameter Default Description
accept_only_numbers false When enabled, only numeric sub IDs are accepted
min_length 1 Minimum character length for a valid sub ID
max_length 50 Maximum character length for a valid sub ID. Hard limit is 50 characters
max_unique_sub_ids 500 Maximum number of unique sub IDs per publisher. Set to 0 to disable
unified_sub_id_name (empty) Replacement sub ID value used when max unique sub IDs is exceeded

Setting max_unique_sub_ids to a non-zero value enables the uniqueness cap. The value must be either 0 (disabled) or greater than 20; values between 1 and 20 are rejected by the API. Sub IDs beyond the limit are renamed to unified_sub_id_name in reports. The original value is preserved in invalid_sub_id for auditing.

What happens when triggered

Section titled “What happens when triggered”

When a sub ID fails format validation:

  • The click or conversion is rejected with fraud_reason: invalid_sub_id.

When the unique sub ID cap is exceeded:

  • The click is still attributed, but the sub ID is replaced with the unified placeholder value.
  • The original sub ID is stored in invalid_sub_id for review in reports.
Section titled “Related filters”