Siren

Siren's Vocabulary, Translated

Siren generalizes beyond classic affiliate tracking, so it uses some terms other tools don't. Each one below, in plain language, with a link to the deeper docs when you want them.

Core concepts

The building blocks you'll use to design any incentive program in Siren.

Program

Also called: Affiliate program, Commission structure

A reward rule that fires on a single transaction.

A named configuration that pays a reward when a specific event happens. Programs hold their own commission rate, attribution model, and filters. Most things other affiliate plugins call a 'program' or 'commission setting' end up as a program in Siren.

What are Programs?

Distributor

Also called: Bonus pool, Scheduled payout

A reward rule that fires on a schedule, not per-transaction.

A named configuration that pays out based on aggregated performance over a time window. Think monthly top-performer bonuses, quarterly revenue shares, or milestone pools. Where a program asks 'what just happened?', a distributor asks 'what happened this month?'

What are Distributors?

Program group

Also called: Mutual exclusion group

A set of programs where only one is allowed to pay per conversion.

When two programs could both fire on the same sale, putting them in a program group tells Siren to pick one winner using an attribution rule (first touch, last touch, top score, and so on). Useful when you have a VIP tier and a standard tier and don't want both paying out on the same order.

What are Program Groups?

Recipe

Also called: Preset, Template

A pre-built program configuration you install with one click.

A fully resolved JSON config bundling one or more programs, program groups, and distributors. Recipes are what most Siren users start from instead of designing programs from scratch. Customize the rates and apply it to your site in a single step.

Browse all recipes

People

Siren generalizes beyond 'affiliate' so the same system can run affiliate, instructor, royalty, revenue-share, vendor, and referral programs.

Collaborator

Also called: Affiliate, Partner, Instructor, Vendor

Anyone who can earn from a program.

The generic term for a person or organization eligible to earn. Affiliates, course instructors, marketplace vendors, revenue-share partners, and internal sales reps are all collaborators. What's different between them is which programs they're enrolled in, not their type.

Enrollment

Also called: Assignment, Enrolled in

A collaborator being attached to a specific program.

A collaborator only earns from programs they're enrolled in. One collaborator can be enrolled in many programs, which is how Siren handles 'VIP affiliates on a 30% program' and 'standard affiliates on a 10% program' as the same thing wearing different hats.

Tracking & attribution

How Siren links activity back to the collaborator who earned credit for it.

Engagement

Also called: Interaction, Touchpoint

A tracked moment when a collaborator did something meaningful.

A referral-link click, a coupon use, a product owned by a creator when it sells, a course being completed. Each of these is an engagement type. Programs fire based on which engagement types they're configured to listen for.

Opportunity

Also called: Customer record, Attribution chain

The thread Siren uses to tie visits, clicks, and purchases to the same person.

Each visitor gets an opportunity ID. When that visitor later buys something or submits a form, Siren walks back through the opportunity's engagements to figure out which collaborator earns credit. Most attribution decisions happen at the opportunity level.

Conversion

Also called: Qualifying event, Trigger

The event that actually awards a commission.

A conversion is whatever you've told the program counts. A sale, a form submission, a lesson completion, a subscription renewal. Once one fires, Siren creates a commission record for the winning collaborator.

Attribution model

Also called: Incentive resolver, Conflict resolver

The rule Siren uses to pick who wins when multiple people could earn credit.

Some programs credit whoever touched the customer most recently (last-click). Others credit the first person in the chain (first-touch). Some split credit evenly across everyone who contributed, and others weight it by how much each person did. Each program picks a rule, and program groups can override it when programs overlap.

Payouts

Once a conversion fires, these are the records you pay from.

Commission

Also called: Reward record, Line item payout

The calculated amount owed to a collaborator for a single conversion.

A program creates a commission when its conditions are met on a transaction. Commissions start as 'pending' and move to 'approved' (ready to pay) or 'rejected' after any refund or review window passes.

Obligation

Also called: Owed amount, Account balance

What you currently owe a collaborator, rolled up from their commissions.

Obligations are how Siren tracks running balances. As commissions get approved, they raise a collaborator's obligation. When you pay them, the obligation drops.

Fulfillment

Also called: Payout, Payment record

A record that says 'we paid this collaborator this amount'.

Fulfillments close out obligations. You can record them manually, export them to your payroll system, or bulk-process them from the Siren admin.

Transparency & audit

How Siren records and surfaces what it did to a record, so you can trace a commission, investigate a dispute, or reconcile a payout without hunting through logs.

Activity feed

Also called: Record history, Audit trail

The running history of everything Siren did to a record, visible on that record's detail screen.

Every major record in Siren (collaborator, conversion, obligation, fulfillment, engagement, transaction) has an activity feed on its detail screen. The feed is a chronological timestamped log of each lifecycle event: an obligation being issued, a conversion being approved, a refund reversing a payment. The same event can appear on several records at once because lifecycle events link to every record they touch. It's the fastest way to answer 'what happened here?' without asking a developer to check logs.

Activity feeds documentation

Note

Also called: Feed entry, Activity entry

A single timestamped entry in an activity feed.

Notes are the individual records that make up an activity feed. Siren writes them automatically as lifecycle events happen. Each one carries a blueprint key (for example `obligation_issued`), rendered display text, and links to every record the event touched. Developers can also query notes directly via the `/notes` REST endpoint with a source-type + source-id filter.

Notes REST reference

Configuration internals

Terms you'll mostly run into in the developer docs, the REST API, or when working with Beacon.

Config

The structured JSON that defines a program, distributor, or recipe.

Every program and distributor has an underlying config. Recipes are one or more configs bundled together. If you've seen fields like `engagementTypes` in Siren's developer docs, those live inside a config.

Mapping

Also called: Binding, Ownership link

An explicit link between a collaborator and something they get credit for.

Mappings tell Siren 'this creator owns this product' or 'this rep owns this coupon code.' Programs that track ownership (royalties, coupon-based programs, vendor revenue shares) use mappings to decide who earns.

Integration

A WordPress plugin Siren watches for conversions.

WooCommerce, Easy Digital Downloads, LifterLMS, LearnDash, Gravity Forms, and NorthCommerce are supported integrations. Each one exposes its own engagement types (for example, LifterLMS adds course-completed and lesson-completed).

Integration feature matrix

Handoff URL

Also called: Recipe install link

A signed one-time link that applies a recipe to your Siren installation.

When you click 'Use this recipe,' Siren's website generates a signed URL. Opening it on your Siren admin applies the recipe's programs, program groups, and distributors in one step.

What Siren calls things vs. what you might expect

Quick translation table if you're coming from another affiliate tool.

Affiliate → Collaborator

Affiliates are collaborators enrolled in an affiliate-style program.

The same record type can also represent an instructor, a vendor, or a referral partner depending on which programs they're enrolled in.

Commission setting → Program

What other tools configure as 'the commission rate,' Siren models as a named program.

Instead of a global rate with per-affiliate overrides, Siren lets you have several programs with different rates and enroll collaborators in whichever applies.

Referral → Conversion + Commission

A 'referral' in other tools typically combines the tracked event and the calculated payout.

Siren separates these: the conversion is the qualifying event, and the commission is the payout record tied to a specific program and collaborator.

Tier → Separate program

What other tools call 'tiers' are usually their own programs in Siren.

A VIP tier becomes its own program with its own rate. Program groups then make sure only one tier pays per sale.

Free AI assistant

Still not sure what something means?

Ask Beacon the same way you'd ask a colleague. Every term, every feature, every recipe is in there, and it answers in plain language without making you hunt through the docs.

Works as a Custom GPT inside ChatGPT, or as an MCP server for Claude, Cursor, VS Code, JetBrains, and other MCP-compatible clients. No signup required.