The following table lists and describes standard application metrics that you can query to
monitor trends for all the transactional SMS messages that are associated with an Amazon Pinpoint project.
To query data for these metrics, use the Application 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 a query.
Note that these metrics don't provide data about SMS messages that were sent by campaigns. They provide data about transactional SMS messages only. To query data for messages that were sent by one or more campaigns, use a campaign metric or an application metric for campaigns.
| Metric | Kpi-name | Description |
|---|---|---|
Average price per message, grouped by country |
|
The average cost of sending each message, for each country or region that messages were sent to. The price is shown in thousandths of a United States cent. For example, if the value of this attribute is 645, then we charged you 0.645¢ to send the message (645 / 1000 = 0.645¢ = $0.00645). This metric is calculated as the total cost of all the messages that were sent to recipients in each country or region, divided by the number of messages that were sent to recipients in each of those countries and regions. The query results for this metric are grouped by country or region, in ISO 3166-1 alpha-2 format. |
Average price per message part, grouped by country |
|
The average cost of sending each message part, for each country or region that messages were sent to. A message part is a portion of an SMS message. The price is shown in thousandths of a United States cent. For example, if the value of this attribute is 645, then we charged you 0.645¢ to send the message (645 / 1000 = 0.645¢ = $0.00645). This metric is calculated as the total cost of all the message parts that were sent to recipients in each country or region, divided by the number of message parts that were sent to recipients in each of those countries and regions. The query results for this metric are grouped by country or region, in ISO 3166-1 alpha-2 format. |
Deliveries |
|
The number of messages that were delivered to recipients. |
Deliveries, grouped by country |
|
The number of messages that were delivered to recipients, for each country or region that messages were sent to. The query results for this metric are grouped by country or region, in ISO 3166-1 alpha-2 format. |
Deliveries, grouped by date |
|
The number of messages that were delivered to recipients, for each day in the specified date range. The query results for this metric are grouped by calendar day, in extended ISO 8601 format. |
Delivery errors |
|
The number of times that an error occurred while attempting to deliver the messages, for each type of error that occurred. The query results for this metric are grouped by error code, for each type of error that occurred. |
Delivery rate |
|
The percentage of messages that were delivered to recipients. This metric is calculated as the number of messages that were sent and delivered to recipients, divided by the number of messages that were sent. |
Delivery rate, grouped by date |
|
The percentage of messages that were delivered to recipients, for each day in the specified date range. This metric is calculated as the number of messages that were sent and delivered to recipients, divided by the number of messages that were sent, for each day in the specified date range. The query results for this metric are grouped by calendar day, in extended ISO 8601 format. |
Message parts delivered |
|
The number of message parts that were delivered. A message part is a portion of an SMS message. If an SMS message contains more characters than the SMS protocol allows, Amazon Pinpoint splits the message into as many message parts as necessary to send the message to a recipient. |
Message parts delivered, grouped by country |
|
The number of message parts that were delivered, for each country or region that messages were sent to. A message part is a portion of an SMS message. The query results for this metric are grouped by country or region, in ISO 3166-1 alpha-2 format. |
Message parts sent |
|
The number of message parts that were sent. A message part is a portion of an SMS message. If an SMS message contains more characters than the SMS protocol allows, Amazon Pinpoint splits the message into as many message parts as necessary to send the message to a recipient. |
Message parts sent, grouped by country |
|
The number of message parts that were sent, for each country or region that messages were sent to. A message part is a portion of an SMS message. The query results for this metric are grouped by country or region, in ISO 3166-1 alpha-2 format. |
Messages sent |
|
The number of messages that were sent. |
Messages sent, grouped by country |
|
The number of messages that were sent, for each country or region that messages were sent to. The query results for this metric are grouped by country or region, in ISO 3166-1 alpha-2 format. |
Messages sent, grouped by date |
|
The number of messages that were sent, for each day in the specified date range. The query results for this metric are grouped by calendar day, in extended ISO 8601 format. |
Total price, grouped by country |
|
The total cost of sending the messages, for each country or region that messages were sent to. The price is shown in thousandths of a United States cent. For example, if the value of this attribute is 645, then we charged you 0.645¢ to send the message (645 / 1000 = 0.645¢ = $0.00645). The query results for this metric are grouped by country or region, in ISO 3166-1 alpha-2 format. |
