CampaignStats
Provides performance metrics for campaigns, including data on opens, clicks, and delivery rates.
Select
You can filter results using the following fields:
- ConversionMetricId: The ID of the metric used for conversion statistics. This is a required filter. If no value is specified, an exception is triggered.
- StartDateTime and EndDateTime: Define the time window for the data. The window must not exceed one year. If no values are specified, the default window is the previous year.
For example:
SELECT * FROM CampaignStats
WHERE ConversionMetricId = 'conversion-metric-id'
AND StartDateTime = '2024-07-07'
AND EndDateTime = '2024-09-09'
You can further filter the results using the following fields:
- SendChannel
- CampaignId
- CampaignMessageId
The allowed filter operators are equals (=) and IN. Only one filter can be applied per attribute. The logical operator AND is the only supported way to combine multiple filters.
Note: A maximum of 100 values can be used with the IN filter.
SendChannel supports the following values:
- sms
- push-notification
For example:
SELECT * FROM CampaignStats
WHERE ConversionMetricId = 'conversion-metric-id'
AND StartDateTime = '2024-07-07'
AND EndDateTime = '2024-09-09'
AND SendChannel = 'email'
SELECT * FROM CampaignStats
WHERE ConversionMetricId = 'conversion-metric-id'
AND SendChannel IN ('email', 'sms')
AND CampaignId IN ('campaign-id-1', 'campaign-id-2')
Columns
| Name | Type | References | Description |
| AverageOrderValue | Double | The average revenue per conversion, calculated by dividing the total ConversionValue field by the total number of Conversions. This metric helps evaluate order value performance per recipient or campaign. | |
| BounceRate | Double | The percentage of messages that bounced, including email and push channels, relative to the total number of received and bounced messages. | |
| Bounced | Int | The total number of email or push messages that were not successfully delivered due to bounce errors. | |
| BouncedOrFailed | Int | The total number of messages that either bounced (email or push) or failed to deliver (SMS). | |
| BouncedOrFailedRate | Double | The percentage of bounced or failed messages compared to all received and bounced or failed messages. | |
| ClickRate | Double | The percentage of unique clicks from email or SMS messages relative to all received messages in those channels. | |
| ClickToOpenRate | Double | The percentage of unique email clicks compared to unique email opens, used to measure post-open engagement. | |
| Clicks | Int | The total number of clicks recorded across all email and SMS messages in the campaign. | |
| ClicksUnique | Int | The total number of unique recipients who clicked a link in an email or SMS message. | |
| ConversionRate | Double | The percentage of unique conversions relative to all received messages across all channels, including email, SMS, and push notifications. | |
| ConversionUniques | Int | The total number of unique conversion events attributed to the campaign. | |
| ConversionValue | Double | The total monetary value of all conversions, such as the combined total of all purchase events (for example, Placed Order). | |
| Conversions | Int | The total count of all conversion events generated by the campaign, including repeated conversions by the same recipient. | |
| Delivered | Int | The total number of messages successfully delivered across all channels, including email, SMS, and push notifications. | |
| DeliveryRate | Double | The percentage of successfully delivered messages out of all received, bounced, or failed messages. | |
| Failed | Int | The total number of SMS messages that failed to deliver due to carrier issues or other transmission errors. | |
| FailedRate | Double | The percentage of failed SMS messages relative to all received and failed SMS messages. | |
| OpenRate | Double | The percentage of unique email or push opens relative to all received email and push messages. | |
| Opens | Int | The total number of email and push message opens recorded for the campaign. | |
| OpensUnique | Int | The total number of unique recipients who opened an email or push notification. | |
| Recipients | Int | The total number of intended recipients for the campaign, including both successfully received and bounced or failed messages. | |
| RevenuePerRecipient | Double | The average revenue generated per recipient, calculated by dividing the total ConversionValue by the number of received messages. | |
| SpamComplaintRate | Double | The percentage of spam complaints submitted relative to the total number of received email messages. | |
| SpamComplaints | Int | The total number of spam complaints recorded in response to campaign messages. | |
| UnsubscribeRate | Double | The percentage of unique unsubscribes across email and SMS channels compared to all received messages. | |
| UnsubscribeUniques | Int | The total number of unique recipients who unsubscribed from receiving future campaign messages. | |
| Unsubscribes | Int | The total number of unsubscribe events recorded, including multiple unsubscribes by the same recipient if applicable. | |
| SendChannel | String | Specifies the channel used to send the message, such as email or SMS. | |
| CampaignId | String | The unique identifier for the campaign associated with these performance metrics. | |
| CampaignMessageId | String | The unique identifier for the specific campaign message used in generating this analytics data. | |
| ConversionMetricId | String | The identifier for the conversion metric used to calculate conversion-related statistics. | |
| StartDateTime | Datetime | The start date and time of the reporting interval for which the campaign analytics data is returned. | |
| EndDateTime | Datetime | The end date and time of the reporting interval for which the campaign analytics data is returned. | |
| IntervalStartDateTime | String | Specifies the start date and time for each interval within the analytics results. | |
| IntervalEndDateTime | String | Specifies the end date and time for each interval within the analytics results. |