Overview
Publish a promotion with timing and offer details, configure promotion codes when required, and manage the customer claim lifecycle.
Prerequisites
- Content management permission
- Promotion claim operations enabled for the calling customer-facing application
Permissions required
Steps (6)
-
1
Create Promotion content and enter the offer details and active window
Create Promotion content and enter the offer details and active window.
Tips
Validation
Success criteria
-
2
Add visibility, placements, terms, call to action and media
Add visibility, placements, terms, call to action and media.
Tips
Validation
Success criteria
-
3
Create promotion codes when the offer uses code-based claiming
Create promotion codes when the offer uses code-based claiming.
Tips
Validation
Success criteria
-
4
Publish or schedule the promotion
Publish or schedule the promotion.
Tips
Validation
Success criteria
-
5
Receive customer claims through the authorized claim operations
Receive customer claims through the authorized list, create and cancel operations and track their status/event history.
Tips
Validation
Success criteria
-
6
Review claim events and promotion analytics
Review claim events and promotion analytics.
Tips
Validation
Success criteria
- Customer claim creation, cancellation, status/event history and promotion analytics are represented in EngagementHub records.
About this guide
EngagementHub gives workspace teams one governed system for news, announcements, events, promotions and coordinated campaigns. Content shares a common publishing model for titles, summaries, bodies, categories, tags, calls to action, media references, attachments, visibility, placements, related records, versions and publication state.
Editorial work moves through configurable review and approval steps before immediate or scheduled publication. The publication engine maintains schedules, expiry, feed indexing and per-viewer feed state. Events add occurrences, registration windows, capacity, waitlists, attendance, reminders and feedback. Promotions add codes, claims and claim lifecycle records. Campaigns add goals, channels, assets, stages, runs and measurable outcomes.
Audience targeting is provider-driven. EngagementHub discovers applications that advertise the audience-provider contract, loads catalogues and categories, establishes least-privilege provider access, and freezes returned members into reproducible snapshots. Secure media is delegated to the configured file-storage provider, while queued communication requests are handed to the configured notification-routing provider.
For application interoperability, EngagementHub exposes a canonical capability runtime across Handler, RCP and Bridge v2, implements the eight-operation ContextResolver contract, publishes domain events through the platform EventBus, consumes trusted project-reference and email-delivery events, and supports signed outbound webhooks with retries and delivery logs.