Documentation sections
Flow setup
Step 1. Destinations
Where the traffic goes: offers and the White Page.
Flow mode
| Mode | What happens | When to choose it |
|---|---|---|
| Cloakingdefault | The filter sorts visitors: bots and moderators go to the White Page, people go to the offer. | Ads where moderation must not see the offer. |
| Tracker | Everyone goes to the offer. Clicks, conversions, costs and profit are counted, and bots are only flagged in reports. | Traffic that needs no filtering but does need money tracking. Works when connected with the PHP file, the Keitaro filter or the Binom gate. Through the JS tag and the link, such a flow filters traffic like a regular cloak. |
| Cloaking + Tracker | The filter sorts visitors, and money is tracked for the allowed traffic: sources, click price, branches, pre-landers. | When you need both protection and full tracking. |
- Below the switch, the visit path for the selected mode is drawn.
- In “Tracker” mode, platform moderators see the offer too. The White Page block is called “Reserve page” there: visitors only land on it if the flow is paused, the plan is unpaid, the address is on your IP blacklist, “Under review” mode is on or the shield is up.
- Branches, pre-landers, visitor pinning, affiliate network, prices and labels are available only in the modes with a tracker.
Traffic source
- A dropdown: “No source” (default) and your sources. The last item, Add a source, lets you create a source right here — the new source is selected immediately.
- Choosing a source:
- spreads its parameters and SubIDs into the campaign labels that make up the ad link;
- tunes the protection in step 2 to the source’s platform (Facebook, Google, TikTok, native ads or another);
- passes the click price to the flow as long as the flow has no pricing model of its own.
- If you have already changed the protection manually, you will first be asked whether to replace it (see Check strictness).
Name and project
- Flow name — required, up to 190 characters. Example in the field: “FB — Nutra — Main Flow”. Only you and your team can see it.
- Project — appears if you have projects. Projects group flows by client, offer or team and separate access. A team member with access to projects only must choose a project.
Filtering preset
Appears if you have saved presets. Pick a preset and it fills in the form:
- all audience lists with their modes: countries, devices, OS, browsers, languages, time zones, cities, regions, networks, providers, referring sites;
- the schedule;
- ten protection toggles, the clicks per IP limit, warm-up and the minimum time on page;
- the platform and strictness; the preset’s source — if the flow does not have its own yet.
The preset is applied once: the flow keeps its own copy of the rules, and editing the preset no longer changes it. To pull in a new version of the preset, select it again. A preset does not carry over shadow mode, and features not included in your plan are switched off right away.
Offer pages
This block is always expanded. On the left it says “Offers: X of Y.”; once the limit is reached, the Add offer button is disabled and the plan with more offers is shown next to it.
| Field | What it is | Default |
|---|---|---|
| Enabled | A disabled offer gets no traffic but stays in the flow. | enabled |
| Name | The offer name in reports, up to 190 characters. | “Offer (primary)”, then “Offer” for the next ones |
| Mode | Loading — the offer page opens under your ad address. Redirect (302) — the visitor is redirected, and the address bar shows the offer’s address. Frame — the page is embedded in yours. | Loading |
| URL | The offer address with http:// or https://, up to 2000 characters. Macros such as {click_id} are allowed. | — |
| Weight (%) | The offer’s share of traffic, from 1 to 100. Appears when there are two or more offers. To stop an offer from getting traffic for a while, disable it instead of setting its weight to 0. | equal split: 50/50, 34/33/33… |
| Branch | Which branch the offer belongs to (modes with a tracker). | Default branch |
- A new offer gets the “Loading” mode and the link labels of the first offer. Its “Offer link parameters” rules are empty and are set separately.
- You can remove any offer except the first. It is deleted for good when you save.
- The ad link does not depend on the number of offers: an offer is picked for each visit after all checks.
- If you choose “Frame” mode and the offer site does not allow being shown in a frame, a note appears below the address: our server will still show the page, but links inside it will open in the full tab. This does not prevent saving.
- To open an app in Google Play, put a
market://details?id=packagedeep link into the offer URL and choose the “Redirect” mode. An app store cannot be loaded or shown in a frame, and a pre-lander or the White Page cannot use such a link.
Offer link parameters
An ad platform (Facebook, Google, TikTok) adds its own labels to the link: fbclid, gclid, ttclid, utm_source and others. The affiliate network expects its own names: sub1, aff_id, s1, click_id. These names almost never match.
Rules rewrite the labels on the way to the offer: rename, set and remove parameters. Three jobs you cannot do without them:
- Get the conversion back. The network sends its postback to the identifier you gave it. Put our
{click_id}into itssub1and the postback finds the right click. The platform labels carry no id of ours — only the macro does. - Give the network its names. The platform sent
fbclid, the network readssub1— rename it, and the value arrives under the right name. - Do not leak extras. A platform label (
utm_source=facebook) that reveals the source can be removed so it does not reach the network.
Only the offer and the pre-lander see the rules. In the click log and on the White Page the labels stay as they came — which matters: a renamed fbclid on the White Page would be a tell.
Each offer and pre-lander has its own set of rules: different offers go to different affiliate networks, and their label names differ. The White Page has no rules.
Actions
| Action | What it does | Example |
|---|---|---|
| Rename | The parameter leaves under a different name, same value. | fbclid → sub1 |
| Set | The parameter gets a value. A macro or text. It may not have existed — it will appear. | aff_id = {click_id} |
| Remove | The parameter does not go to the offer. Instead of a value field, the row says “The label will not reach the offer”. | utm_source |
Rules apply top to bottom, each to the result of the previous one. Order matters: rename fbclid to sub1 first, and only then a rule on sub1 sees that value.
The block is collapsed in the offer and pre-lander card, with the number of rules in its heading. Each rule is a “visit label → action → result” row; the rows are numbered because order matters. The action is chosen with the Rename / Set / Remove switch. The “Quick add: fbclid → sub_id · aff_sub = {click_id} · − utm_source” buttons add a ready-made rule in one click. A set holds up to 20 rules. “Rename” does nothing if the visit has no such label. A value is written without spaces and without the & sign.
A full example
A visitor arrives by the flow's ad link:
https://your-landing.com/?fbclid=IwAR123&utm_source=facebook&utm_campaign=nutra_de
The offer in the flow is https://track.partner.com/click?offer=55. The flow rules:
- Rename
fbclid→sub1 - Set
aff_id={click_id} - Remove
utm_source
The offer receives:
https://track.partner.com/click?offer=55&utm_campaign=nutra_de&sub1=IwAR123&aff_id=C-01JB8Q3Z7XKP4M2R9TVN6WDY5H
Before: fbclid and utm_source. After: fbclid moved into sub1, aff_id appeared with the click id, utm_source is gone. utm_campaign was untouched by the rules and arrived as is. In the log this click still carries fbclid and utm_source.
Macros for "Set"
The value can carry visit data: {click_id} — our click id, {flow_id} — flow id, {geo} — country, {city} — city, {device} — device, {os} — OS, {browser} — browser, {isp} — provider, {ext_click_id} — external click id, {cost} — click cost, {sub1}…{sub10} — flow labels.
The rules work the same on the flow link and the PHP file. The PHP file needs its latest version: if a new one is out, a notice appears in the connection window.
Branches Professional and above
Send different visitors to different offers: by country, device, link parameter or campaign label. Visible in the modes with a tracker when there are two or more offers.
- Add a branch creates “Branch N” with the condition “Country is one of”.
- Each branch has a name (up to 120 characters), an Enabled toggle, Up and Down arrows, and a delete button. Offers of a deleted branch move to the default branch.
- A condition reads as “If [field] [operator] [values]”. When a branch has several conditions, all of them must match.
- Fields: Country, Device, OS, Browser, Provider, ASN, City, Region, Language, Referrer, Link parameter, Label (sub). For a link parameter or label, enter its name, for example
utm_sourceorsub1. - Operators: “is one of”, “is none of”, “contains”, “is set”, “is not set”.
- Values — comma-separated.
- Fields: Country, Device, OS, Browser, Provider, ASN, City, Region, Language, Referrer, Link parameter, Label (sub). For a link parameter or label, enter its name, for example
- Branches are checked from top to bottom, and the first match wins. Visitors who match none go to the offers without a branch.
- To attach an offer to a branch, pick the branch in the Branch field of the offer card. If a branch has no offers, its visitors go to the default offers.
- Limits: up to 30 branches, up to 15 conditions per branch.
Pre-landers Professional and above
Your own page before the offer: a quiz, an article, a review. A visitor allowed by the filter sees it first, and a button on it leads to the offer. The report shows how many people reached the offer.
- The card is the same as for an offer; the default mode is “Redirect”. A pre-lander takes a place in the same limit: with it, the Add offer button is disabled one offer earlier than the counter shows.
- Leads to offer — “By weight among offers” or a specific offer.
- The button on the pre-lander must point to the
{click_url}macro, for example?go={click_url}. If there are several buttons, add/2or/3to the address to open the second or third offer. - With two or more pre-landers, a “Weight (%)” field appears for them.
White Page
The page for visitors the filter did not let through to the offer. It is required. You can set it in three ways:
- With your own address — a URL field and the “Loading” or “Redirect” mode. Frame mode is not used for the White Page. Below the field are buttons with the addresses of your latest White Pages and an Order a White Page from the catalog link.
- With one of our ready-made pages — the Or let us show ours — no address list. The ready-made site opens at your ad address, and you do not need to upload it anywhere. The list shows your latest 100 ready-made pages plus, always, the one already set in the flow. If you connect with the PHP file, you need its latest version.
- With a status code — the “Status code (200/403/404)” mode: a filtered visitor gets a bare server error page, like a closed or missing address. There is no page at all, so a checking program has nothing to read. Works with the PHP file and the link; the JS tag cannot change the status code and leaves a blank page in place of the landing. Platforms with human review (Google, Facebook) usually reject such ads — the mode is for sources where a program, not a person, looks at the page.
Traffic distribution
This block appears when there are two or more offers (or pre-landers).
- Weighted rotation — each click goes to an offer at random with the set probability; at large volumes the shares converge to the set values. Weights must add up to exactly 100%. The Auto weights button splits evenly within each set: offers without a branch, the offers of each branch, pre-landers.
- Priority Professional and above — all traffic goes to the first enabled offer, the rest are kept in reserve.
- Visitor pinning, h — from 0 to 720 (modes with a tracker). A visitor who returns within this time gets the same pre-lander and the same offer. 0 — no pinning.
Possible errors
- “Flow name is required.”
- “Add at least one enabled Offer destination with a URL.”
- “Invalid URL in destinations: …” — the address must start with http:// or https://.
- “Add at least one enabled White destination — with an address or one of our ready-made pages.”
- “Weights must sum to 100” — click Auto weights.
ArtisanClo · Dashboard documentation. Questions — info@artisanclo.com or @artisanclo_support on Telegram.