Flow Rules

Flow rules decide which destination a visitor receives when they open a campaign domain.

Think of flows as lanes in a road. A rule is the sign above each lane: country == "FR" sends visitors from France into one lane, while is_mobile == true can send mobile visitors into another. The tracker checks the enabled flows in order and uses the first flow whose rule matches the visitor.

Use flow rules when different visitors should receive different landing pages or redirects inside the same campaign.

How Flow Selection Works

When a visitor opens a campaign domain, tracker follows this sequence:

Important behavior:

• Disabled and deleted flows are skipped.
• Flows are checked by their order in the campaign.
• A blank rule means the flow can match all traffic.
• The first matching flow wins.
• The default flow is used only when no normal flow matches.
• The default flow can still be used even if its own rule would not match.

Available Rule Fields

Use the following fields in flow rules.

Text values must be wrapped in double quotes.

country == "FR"

Boolean values use lowercase true or false.

is_mobile == true

null means the tracker could not recognize that specific field for the visitor, or the field does not exist in the visitor data. It does not mean you should type an empty string in the rule. For a normal catch-all flow, leave the whole rule field blank instead.

Common Operators

Use parentheses when a rule mixes and and or. This makes the rule easier to read and prevents surprises.

Country Rules

Use country when visitors from different countries should see different offers or landing pages.

Country values are two-letter country codes, such as FR, US, UA, PL, or DE.

Country detection requires IP2Location to be configured. If country targeting is unavailable, the tracker will not allow country-based rules to be saved.

Device, Browser, and OS Rules

Use browser, device, and operating-system fields when the landing page works better for a specific visitor environment.

The exact browser, device, and operating-system values come from the visitor's user agent. If you are unsure which value the tracker detects, check the reporting data for real traffic first, then use the same spelling in the rule.

Common detected values:

Use this table as a starting point, not as a complete catalog. Desktop devices often appear as "Other" or "Mac", while Android devices can appear as a specific model, a Samsung model code, or a generic device family.

Percentage Splits With roll

Use roll when you want to split traffic between flows.

For each visit, the tracker assigns a random number from 1 to 100. You can use that number to create percentage-style routing.

Example 50/50 split:

Example 70/30 split:

You can also combine roll with targeting:

country == "FR" and roll <= 50

This rule matches about half of France traffic.

Blank Rules and Catch-All Flows

A blank rule means the flow can receive any visitor.

Use a blank rule carefully. Because the tracker selects the first matching flow, a blank-rule flow placed above more specific flows can catch traffic before those specific flows are checked.

Recommended order:

1. Specific flows first.
2. Broad flows after specific flows.
3. Catch-all flow last.
4. Default flow selected on the campaign.

Example:

Show Only Once Per Visitor

Show only once per visitor changes how repeat visits are handled.

When this option is enabled, the tracker can skip the flow after the same visitor has already seen it. This is useful when you want repeat visitors to move through several landing pages instead of seeing the same one every time.

Example rotation:

For a first visit from France, the visitor can receive Landing A. On a later visit, the tracker can skip Landing A and try Landing B. If both one-time flows were already shown, the France fallback remains available.

Practical Examples

Send France Traffic to a Local Landing

Set the global landing as the campaign default flow.

Send Mobile and Desktop Traffic to Different Pages

This is useful when you have separate mobile and desktop landing pages.

Exclude Bot Traffic From Main Landings

You can also set a default flow for unmatched traffic.

Split One Country Between Two Offers

This keeps the split inside France traffic only.

Checklist Before Saving Rules

Before saving or reordering flows, check the following:

• Text values are wrapped in double quotes.
• Boolean values are lowercase: true or false.
• Country codes use two uppercase letters.
• Specific rules are above broad rules.
• Blank-rule catch-all flows are near the end.
• A campaign default flow is selected.
• The default flow is enabled and not deleted.
• Rules using country are used only when IP2Location is configured.

Troubleshooting