Skip to content

Campaign rules

Rules decide which leads a campaign accepts, which buyers receive them, what each buyer pays and what each source earns.

Campaigns8 min read193 viewsUpdated

This article explains how rules decide which leads your campaign accepts, which buyers are sent each lead, and what each buyer pays and each source earns.

What a rule is made of

A rule is one decision with its own conditions and, optionally, its own amounts. One rule can hold many conditions.

Part What it does
Action What happens to leads that match, and to leads that do not
Conditions The tests a lead must pass, grouped into rule sets
Amounts Optional. What the buyer pays and what the source earns when this rule decides
Response code Optional, on lead filter rules. Returned to the supplier when the rule rejects a lead

Actions

Action Matching leads Other leads
Reject matching leads Rejected Passed to the next rule
Only accept matching leads Accepted Rejected. This is an allow list.
Accept matching leads Accepted straight away, usually to set a price Passed to the next rule
Reject matching, accept the rest Rejected Accepted. No rule below it ever runs.

On a buyer delivery rule, accepted means the buyer is sent the lead and rejected means it is not, so rules there read as Send if or Don't send if.

Rule sets and conditions

A condition is a field, an operator and a value, for example state is one of CA, NY. Operators cover text, number and list comparisons, plus date, age, length, the hour and weekday a lead arrived, and comparing one field with another.

Conditions sit inside a rule set, joined by all or any, with one level of brackets. That lets one rule set say "state is CA and (debt over 10000 or credit over 700)".

A rule can hold several rule sets. A lead matches the rule when it matches any one of them. The first rule set that matches is the one that decides, and its amounts are the ones that apply.

Value lists

A long list of values, such as excluded states or zip codes, can be kept as a saved value list instead of being typed into every rule. Edit the list once and every rule that uses it follows. Value lists live in the Rule library, on the Value lists tab.

Where rules run

A campaign's Rules tab groups rules by where they run. A lead meets them in this order:

  1. Lead filters, when the lead arrives: first Every lead, then By supplier, then By traffic source. A rejection here stops the lead before any buyer sees it.
  2. Buyer delivery, during distribution, for each buyer: whether that buyer is sent the lead. A buyer with no delivery rule is sent every lead it is otherwise eligible for.
  3. Buyer pricing, for each buyer: what that buyer pays. A buyer with no pricing rule pays its usual price.

Each place has its own ordered list. A buyer's rules also appear on that buyer's own Rules tab. The rules editor is available to admins.

The first rule that decides wins

Rules run top to bottom in their list. A rule that does not decide hands the lead to the next rule. The first rule that decides a lead wins, and only that rule's amounts apply. If no rule decides, the lead passes.

This is the most common reason an amount does not apply: a rule higher in the same list decided first. Put narrow rules above broad ones. Drag a rule to change its position.

The two amounts: Buyer revenue and Source payout

A rule can set two amounts. Which ones you see depends on where the rule runs:

Where the rule runs Buyer revenue Source payout
A buyer What the buyer pays for the lead What the supplier or traffic source earns on that sale
A supplier or traffic source Not offered What that source earns for the lead

Source payout can be Fixed or % of price. A percentage is a share of what the buyer pays for that sale, so it becomes an amount only once a price is known. Percentages above 100 are refused. The lead timeline shows both figures, for example "Source Payout $10.50, 10% of $105.00". If the sale is later re-priced, for example by a CPA confirmation or a return, the percentage is applied again to the new price.

An empty amount means no rule set one, so the source's or buyer's normal pricing applies. An amount of 0 means the rule pays nothing.

A buyer pricing rule works in tiers. Each tier is a rule set with its own price, the first tier that matches sets the price, and an optional Fallback applies when no tier matches. A tier can pay Fixed, Value of a field, % of a field or Per unit of a field.

Example: a different supplier payout per buyer

A supplier normally earns 19 per lead. It should earn 22.50 when a higher-paying buyer takes a lead from a postcode starting with 1, and 16 when the fallback buyer takes it. Other suppliers keep their own price.

Rule Runs on Conditions Amount
High payout The higher-paying buyers, as one shared rule postcode begins with 1 and supplier is that supplier Source payout 22.50
Fallback The fallback buyer supplier is that supplier Source payout 16
Default Nothing to set up The supplier's own price, 19

Naming the supplier inside the buyer rule matters. Without it, every supplier selling to those buyers would be paid the higher rate.

Plain rules, shared rules and templates

Every rule has a role that decides where it may run:

Role Runs in Editing it changes
Plain rule One place That place only
Shared rule Any number of places Every place it runs in
Template Nowhere Nothing already made from it. Using a template makes a copy.
  • Use in other places on a rule lets you keep one shared rule across those places, or make separate copies.
  • Unlink this place gives one place its own plain rule and leaves the other places on the shared rule.
  • A rule made from a template shows From template.

The Rule library lists Templates, Shared rules and Value lists, with how many places use each.

Add a rule

  1. Go to Campaigns, open the campaign, and open the Rules tab.
  2. Find the list you need: Every lead, By supplier or By traffic source under lead filters, or a buyer under buyer rules.
  3. Click Add rule. On a buyer's pricing list, click Add pricing.
  4. Choose the action.
  5. Add the conditions for the first rule set. Click Add rule set to add another set of conditions that also matches.
  6. Set Buyer revenue and Source payout if the rule should set an amount.
  7. Enter a Rule name.
  8. Click Create rule.
  9. Drag the rule into position in its list.

Test a lead

Test a lead on the Rules page runs a lead through your rules without saving or sending anything. Paste a lead ID, pick a recent lead, or fill in the fields yourself. It shows whether the lead is accepted at intake and, for each buyer, which rule decided and at what price. You can test an unsaved draft in place of the saved rule.

Version history

Every save creates a version. Open Version history on a rule to see past versions and Restore one. A single place can also be pinned to an older version, so it stops following later edits.

Rule Health

Rule Health lists problems and tidy-ups, such as a rule testing a field the campaign does not have, a condition that can never match, a rule that an earlier one always decides first, an accept rule that sets no amount, or identical rules written out separately on several buyers.

Import rules from LeadByte or a spreadsheet

You can paste a LeadByte export or any rules spreadsheet to create rules. Common column names are recognized, each row becomes one condition, and rows are grouped into rule sets. A payout written as 20% is imported as a percentage, not as an amount of 20. When you import into several places, you choose one shared rule or a separate rule for each.

The Guide button on the Rules page explains these ideas in the app, including a section for teams coming from LeadByte.

Expected result

Your rules appear in the right lists in the order you want, Test a lead shows the verdict and price you expect for a sample lead, and Rule Health lists nothing you did not intend.

Troubleshooting

  • A rule's amount never applies. A rule above it in the same list decides first. Move the rule carrying the amount higher, or narrow the rule above it.
  • A buyer rule paid every supplier the higher rate. The rule does not name the supplier. Add a supplier condition to the same rule set.
  • Editing a rule changed other buyers. It is a shared rule. Use Unlink this place for a one-off change.
  • A template edit did not reach rules made from it. Templates are copied, never linked. Use a shared rule when places must stay in step.
  • A percentage payout is refused. Percentages run from 0 to 100 of the buyer price. Switch to Fixed for a flat amount.
  • A rule's name reads as the opposite of what it does. Some older rules kept the name they were created with. Rename it using the name the editor suggests. Reporting is not affected, because it groups on the condition, not the name.
  • One lead was rejected and you do not know why. Open the lead timeline. It names the rule that decided, more clearly than a KPI card.

Frequently asked questions

Rules run top to bottom, and the first rule that decides a lead wins. A rule higher in the same list probably decided first. Move your rule up or narrow the one above it, then check with Test a lead.

Yes. Set Source payout to % of price and enter a value from 0 to 100. It is a share of what the buyer pays for that sale, and the lead timeline shows both the percentage and the amount it came to.

Save the postcodes as a value list in the Rule library, then use that list in a rule condition. Edit the list once and every rule that uses it follows.

Required fields enforce that a value is present and has the right basic type. Rules apply your business decisions to values that already arrived.

Use a shared rule when several buyers or sources must always follow exactly the same rule, because one edit changes every place. Use a template as a starting point you copy, since later template edits never reach the copies.
Back to Help Center

Comments

No comments yet — be the first to share your thoughts.

Leave a comment

Comments are reviewed before they’re published.