Amazon Pinpoint campaign metrics

The following table lists and describes standard campaign metrics that you can query to assess the performance of an individual campaign. To query data for these metrics, use the Campaign metrics resource of the Amazon Pinpoint API. The kpi-name column in the table indicates the value to use for the kpi-name parameter in your query.

Metric	Kpi-name	Description
Bounce rate	hard-bounce-rate	For all campaign runs, the percentage of email messages that couldn't be delivered to recipients. This metric measures only hard bounces—that is, messages in which the recipient's email address had a permanent issue that prevented the message from being delivered. This metric is calculated as the number of bounced email messages that were sent by all the campaign runs, divided by the number of email messages that were sent by all of those campaign runs.
Bounce rate, grouped by campaign run	hard-bounce-rate-grouped-by-campaign-activity	For each campaign run, the percentage of email messages that couldn't be delivered to recipients. This metric measures only hard bounces—that is, messages in which the recipient's email address had a permanent issue that prevented the message from being delivered. This metric is calculated as the number of bounced email messages that were sent by a campaign run, divided by the number of email messages that were sent by the campaign run. The query results for this metric are grouped by campaign activity ID (CampaignActivityId), which is a string that uniquely identifies a campaign run.
Delivery rate	successful-delivery-rate	For all campaign runs, the percentage of messages that were delivered to recipients. This metric is calculated as the number of messages that were sent by all the campaign runs and delivered to recipients, divided by the number of messages that were sent by all of those campaign runs.
Delivery rate, grouped by campaign run	successful-delivery-rate-grouped-by-campaign-activity	For each campaign run, the percentage of messages that were delivered to recipients. This metric is calculated as the number of messages that were sent by a campaign run and delivered to recipients, divided by the number of messages that were sent by the campaign run. The query results for this metric are grouped by campaign activity ID (CampaignActivityId), which is a string that uniquely identifies a campaign run.
Delivery rate, grouped by date	successful-delivery-rate-grouped-by-date	For all campaign runs, the percentage of messages that were delivered to recipients during each day in the specified date range. This metric is calculated as the number of messages that were sent by all the campaign runs and delivered to recipients, divided by the number of messages that were sent by all of those campaign runs, for each day in the specified date range. The query results for this metric are grouped by calendar day, in extended ISO 8601 format.
Email open rate	email-open-rate	For all campaign runs, the percentage of email messages that were opened by recipients. This metric is calculated as the number of email messages that were sent by all the campaign runs and opened by recipients, divided by the number of email messages that were sent by all of those campaign runs and delivered to recipients.
Email open rate, grouped by campaign run	email-open-rate-grouped-by-campaign-activity	For each campaign run, the percentage of email messages that were opened by recipients. This metric is calculated as the number of email messages that were sent by a campaign run and opened by recipients, divided by the number of email messages that were sent by the campaign run and delivered to recipients. The query results for this metric are grouped by campaign activity ID (CampaignActivityId), which is a string that uniquely identifies a campaign run.
Emails opened, grouped by campaign run	direct-email-opens-grouped-by-campaign-activity	For each campaign run, the number of email messages that were opened by recipients. The query results for this metric are grouped by campaign activity ID (CampaignActivityId), which is a string that uniquely identifies a campaign run.
Endpoint deliveries	unique-deliveries	For all campaign runs, the number of unique endpoints that messages were delivered to.
Endpoint deliveries, grouped by campaign run	unique-deliveries-grouped-by-campaign-activity	For each campaign run, the number of unique endpoints that messages were delivered to. The query results for this metric are grouped by campaign activity ID (CampaignActivityId), which is a string that uniquely identifies a campaign run.
Endpoint deliveries, grouped by date	unique-deliveries-grouped-by-date	For all campaign runs, the number of unique endpoints that messages were delivered to, for each day in the specified date range. The query results for this metric are grouped by calendar day, in extended ISO 8601 format.
Links clicked, grouped by campaign run	clicks-grouped-by-campaign-activity	For each campaign run, the number of times that recipients clicked links in the email message. If a single recipient clicked multiple links in the message, or clicked the same link more than once, each click is included in the count. The query results for this metric are grouped by campaign activity ID (CampaignActivityId), which is a string that uniquely identifies a campaign run.
Messages delivered, grouped by campaign run	successful-deliveries-grouped-by-campaign-activity	For each campaign run, the number of messages that were delivered to recipients. This metric is calculated as the number of messages that were sent by a campaign run, minus the number of messages that couldn't be delivered to recipients of the run due to a hard bounce. The query results for this metric are grouped by campaign activity ID (CampaignActivityId), which is a string that uniquely identifies a campaign run.
Messages sent, grouped by campaign run	attempted-deliveries-grouped-by-campaign-activity	For each campaign run, the number of messages that were sent. The query results for this metric are grouped by campaign activity ID (CampaignActivityId), which is a string that uniquely identifies a campaign run.
Push open rate	push-open-rate	For all campaign runs, the percentage of push notifications that were opened by recipients. This metric is calculated as the number of push notifications that were sent by all the campaign runs and opened by recipients, divided by the number of push notifications that were sent by all of those campaign runs and delivered to recipients.
Push open rate, grouped by campaign run	push-open-rate-grouped-by-campaign-activity	For each campaign run, the percentage of push notifications that were opened by recipients. This metric is calculated as the number of push notifications that were sent by a campaign run and opened by recipients, divided by the number of push notifications that were sent by the campaign run and delivered to recipients. The query results for this metric are grouped by campaign activity ID (CampaignActivityId), which is a string that uniquely identifies a campaign run.
Total push opened, grouped by campaign run	direct-push-opens-grouped-by-campaign-activity	For each campaign run, the number of push notifications that were opened by recipients. The query results for this metric are grouped by campaign activity ID (CampaignActivityId), which is a string that uniquely identifies a campaign run.
Total SMS spend	sms-spend	For all campaigns, the total amount of money, in milicents, spent on sending SMS.