ProgramGroupConversionTriggered

Program groups enforce mutual exclusivity: when a customer is eligible for conversions under multiple programs in the same group, only one program can award credit. When the conversion pipeline detects this situation, it fires ProgramGroupConversionTriggered to announce which program won and which programs lost.

The event is identified as program_group_conversion_triggered and lives in the Siren\Conversions\Core\Events namespace.

What does this event carry?

The event provides the winning Program, an array of losing Program models, the opportunityId, and the Transaction.

use Siren\Conversions\Core\Events\ProgramGroupConversionTriggered;

public function handle(Event $event): void
{
    $winner = $event->getWinningProgram();
    $losers = $event->getLosingPrograms();
    $opportunityId = $event->getOpportunityId();
    $transaction = $event->getTransaction();
}

How is the winner determined?

The program group’s resolution strategy decides which program wins. The two strategies are newest engagement wins and oldest engagement wins. If a customer clicked affiliate links for two programs in the same group, the resolution strategy looks at when each engagement was created and picks the winner accordingly.

What happens to the losing programs?

Listeners use this event to clean up engagements on the losing programs. Because mutual exclusivity is enforced at the group level, the losing programs’ engagements for this opportunity are invalidated so they cannot produce conversions. Only the winning program proceeds through the rest of the conversion flow.

This cleanup is important for accurate reporting. Without it, engagements on losing programs would remain active and could appear in dashboards as unconverted activity, misrepresenting the collaborator’s performance.

See the Conversion Events overview for how this event fits into the full conversion pipeline.