EngagementsTriggered

After an opportunity is created, engagement trigger strategies evaluate it and decide which collaborator-program combinations should receive engagement records. Once those records are created, the system fires EngagementsTriggered to signal that new engagements exist and are ready for downstream processing.

The event is identified as engagements_triggered and lives in the Siren\Engagements\Core\Events namespace.

What does this event carry?

The event carries an array of Engagement models and a strategyId string that identifies which trigger strategy created them.

use Siren\Engagements\Core\Events\EngagementsTriggered;

$engagements = $event->getEngagements();
$strategyId = $event->getTriggerStrategyId();

This event always carries an array rather than a single engagement. A single opportunity can produce multiple engagements when a collaborator participates in more than one program. If a collaborator is enrolled in both a revenue-share program and a flat-rate bonus program, the trigger strategy creates an engagement for each, and all of them arrive together in this event.

The strategy ID tells you which trigger strategy produced these engagements. Different strategies handle different referral mechanisms (site visits, coupons, manual attribution), so the strategy ID provides context about how the attribution was determined.

What happens when it fires?

The reporting system picks up this event and updates activity period records, ensuring that dashboards and reports reflect the new engagement activity without waiting for a conversion to occur. This is what allows collaborators to see their referral traffic in real time, before any sales have happened.

Engagements created by this event exist in an active state, waiting for a conversion to award them credit. That next step happens through EngagementAwarded, which fires later when the conversion system determines which engagements deserve credit for a sale or lead.

See the Attribution Events overview for how this event fits into the full attribution pipeline.