What is an Engagement?

An engagement is any trackable event that ties a potential customer’s action to a collaborator. The classic example is a visitor arriving at your site through an affiliate link, but engagements cover a much wider range of interactions: an existing customer watching a course lesson made by an instructor, a reader landing on a blog post written by a partner, a coupon code being applied at checkout. If a measurable thing happens on your site and you can tie it to a collaborator, Siren can record it as an engagement.

Engagements are the connective tissue between customer behavior and collaborator credit. Without them, conversions would have nowhere to attach.

Example: a site visit

Click A visitor arrives through a collaborator's referral link

Engagement Siren creates an engagement if one doesn't already exist

Points The engagement gets points from the program's settings

Customers can trigger many engagements

A customer’s journey can include many engagements with different collaborators or repeated interactions with the same one. Each engagement carries the point value defined by the program it belongs to.

A visitor might click an affiliate’s link, return a week later through a different collaborator’s coupon code, then finally check out. By the time they convert, multiple collaborators have engagements on file, and the program structure decides which ones win.

A multi-engagement journey

Click A A visitor arrives through collaborator A's referral link

First engagement Siren creates an engagement for collaborator A

Coupon B Later, the same visitor applies collaborator B's coupon

Second engagement Siren creates a separate engagement for collaborator B

Purchase The visitor completes checkout and a transaction is created

Conversions The program structure decides who wins credit

Reset All engagements clear for the next customer journey

This is what makes multi-touch attribution possible. If you want every collaborator who contributed along the way to share in the reward, see the multi-touch sales attribution recipe.

Engagement triggers

Different programs use different engagement triggers depending on what behavior you want to reward. Site visits and coupon usage are the most common, but Siren also supports course completions, lesson completions, blog post visits, form submissions, and manual attribution for cases where you need to assign credit by hand. See Site Visited and the related trigger pages for the full list.

For developers: This concept maps to the EngagementsTriggered event. See the events reference for the full pipeline.