Logic Operator

Control how your cloaking filters are evaluated using AND / OR logic.

✅ What is Logic Operator?

The logic_operator parameter determines how multiple targeting filters in Campaign Builder (such as country, device, OS, browser, UTM, etc.) are evaluated together.

It defines whether:

  • ALL conditions must be met (AND)
  • Any ONE condition is enough to pass (OR)

🛠️ Supported Values

  • "AND" → All filters must match for the visitor to see the offer page
  • "OR" → Matching just one filter is enough

📊 AND vs OR – Key Differences

Logic Requirement Example Match Result
AND All filters must be true ✅ country + ✅ device + ✅ OS + ✅ browser = MATCH
OR At least one filter must be true ✅ country + ❌ device + ❌ OS = MATCH

🔄 How Multi-Value Filters Work

Each filter (like country, device, OS, browser) can accept multiple values, separated by |. XCLO will evaluate whether the visitor matches at least one value in each group.

Example:

  • allow_browser = chrome|firefox|safari → A visitor using Chrome = ✅ match
  • allow_device = desktop|smartphone → A visitor on smartphone = ✅ match

But the final result depends on the logic operator:

  • AND → All filter groups must match at least one value
  • OR → Matching any one group is sufficient

💬 Plain English Analogy

  • Each filter group is a gate
  • Each gate accepts multiple keys (allowed values)
  • If a visitor has any valid key for the gate → ✅ access granted for that gate
  • With AND: All gates must open
  • With OR: One open gate is enough

🧾 Example Configuration in index.php

$rawConfig = [
  'allow_country'   => 'id|my',
  'allow_device'    => 'desktop|smartphone',
  'allow_browser'   => 'chrome|firefox',
  'allow_os'        => 'android',
  'logic_operator'  => 'AND'
];

🔍 Example Debug Output

Using AND Logic:

{
  "match": false,
  "reason": "OS not allowed"
}

Even though country, device, and browser match — OS does not → match fails.

Using OR Logic:

{
  "match": true,
  "reason": "Matched: country"
}

Only country matches, but that’s enough because logic is OR.

🎯 When to Use AND

  • High-risk campaigns (e.g., Facebook, Google, TikTok)
  • Strictly targeted CPA offers
  • Traffic where full compliance is mandatory

🎯 When to Use OR

  • Testing broad traffic sources
  • Push traffic or low-barrier campaigns
  • When exploring conversion from different segments

⚠️ Important Notes

  • Use uppercase for AND or OR
  • Do not use smart quotes (“ ”) — use plain double quotes (“)
  • Always test your config using Debug Mode before running traffic

💡 Best Practices

  • Use AND to filter only high-quality traffic
  • Use OR when you’re optimizing for volume
  • Combine with UTM logic for advanced segmentation
  • Document test results to understand which filters work best