Managing Engagement Activity via API
Understanding how customers engage with your campaigns is essential for improving performance. Optimove captures engagement metrics such as opens, clicks, bounces, unsubscribes, etc. These metrics can be used for segmentation, campaign analysis, and reporting.
Engagement metrics appear in multiple areas within Optimove. It can be used as a criterion in Target Groups and is also available in Mission Control, including funnel widgets and channel performance popups.
For campaigns sent via Optimove’s native execution channels, engagement metrics are collected automatically. For campaigns executed through third-party vendors, engagement data must be reported via the Engagement Metrics API to ensure full visibility and reporting consistency.
To learn how to apply this data for segmentation and targeting, see:
Using Engagement Activity
Scheduled Campaigns
Native Channels
Insert:
Native channels automatically report their engagement metrics, including OptiMail, OptiMobile, OptiText, and others.
Read:
Use this API endpoint to retrieve customer-level engagement data for scheduled campaigns in native channels: 📄Campaign Engagement Metrics
Note:
This endpoint is a newer version of a previous API. It supports both scheduled and triggered campaigns. The older version will be deprecated.
Third-Party Channels
Insert:
Use this events API to report customer-level engagement for campaigns executed by third-party vendors. This enables segmentation and reporting within Optimove. 📄 New: Campaign Engagement Metrics
Note:
The current endpoint supporting scheduled campaigns is: 📄 Submit Campaign Engagement Metrics
We recommend that you use the newest endpoint, since the current version will no longer be supported starting January 2026.
Triggered Campaigns
Native Channels
Insert:
Engagement activity is reported automatically for triggered campaigns executed through native channels.
Read:
Use this API endpoint to retrieve customer-level engagement data for triggered campaigns:
Third-Party Channels (NEW)
Insert:
Use this events API to report engagement activity for triggered campaigns executed by third-party vendors. This path supports both scheduled and triggered campaign updates.
📄 New: Campaign Engagement Metrics
Read: Engagement data is retrieved only from channels that have reported metrics. Use this endpoint to access customer-level engagement for triggered campaigns.