         | Did this page help you? Yes No Tell us about it... |
Usage Report
The purpose of the usage report is to help you understand the specific usage details that resulted in the revenue collected for each individual customer the previous month. You can use this report to understand the usage patterns of your product and the associated AWS costs.
Like the revenue report, this report is available in comma-separated value (CSV) format on or around the fifteenth day of each month. We don't generate a usage report if none of your customers used your product or generated any revenue for you during the previous month.
Each row of the report represents a single revenue item related to a customer's activity with a single DevPay product. For example, a row might represent the revenue from a sign-up charge, a monthly charge, or a specific AWS service usage dimension (such as data transfer in or data transfer out). Only dimensions related to a customer's use during the month are included in the report. For example, if your product uses Amazon EC2, but the customer didn't transfer any data in or out during the previous month, the report has no rows for data transfer in or out for that customer.
If a customer cancels and then resubscribes to your product in the same month, we present the revenue from each subscription period separately in that month's report. For example, if the customer cancels on January 10 and then resubscribes on January 20, the report you receive in February has one set of rows for the revenue for January 1 to January 10, and a separate set for the revenue for January 20 to January 31. The value in the Customer Since field for the second subscription period will be January 20.
To view the usage report
Go to your DevPay Activity page at http://www.amazon/com/devpayactivity.
Click View Customer Reports in the table for any of your products.
The DevPay Customer Reports page is displayed.
In the Customer Revenue and Usage Reports section of the page, select the time period for the report, click Usage, and click Download Report.
You're prompted to save the CSV report to the location of your choice.
The following table describes each of the columns presented in the report in the order they appear. All values in the report (except column names) are enclosed in quotation marks.
| Column Name | Description |
|---|---|
|
Customer Email |
The customer's e-mail address. Type: String with 64 characters maximum length Example: |
|
Billing Period |
The billing month the report covers. Type: Date with format MMM-YYYY Example: |
|
Application |
The name of the DevPay product (important if you have multiple DevPay products). Type: String with 80 characters maximum length Example: |
|
Customer Since |
The date the customer signed up for the product (and if the product has
up-front fees at sign-up, this is the date the customer's sign-up payment
succeeded). If the customer's status is Type: Date with format DD-MMM-YY Example: |
|
Amazon Web Service |
The underlying AWS service. The field has a value only when
Type is Type: String with 32 characters maximum Example: |
|
Type |
The type of charge. Type: String with 32 characters maximum Valid values:
|
|
Usage Dimension |
If the Type column's value is The values shown in this field are the same values displayed when you generate an AWS Usage Report for your AWS developer account (creating an AWS Usage Report is one of the options you have when you log in to your AWS developer account). Type: String with 256 characters maximum length Example: |
|
Usage Amount |
The amount the customer used of the specified dimension. Type: Number with 24 characters maximum length Example: |
|
Usage Unit |
The unit of measure for the specified dimension. Type: String with 30 characters maximum length Example: |
|
Revenue Billed |
The revenue we billed the customer for the specified dimension,
regardless of whether the customer has actually paid the bill. If the
Type column's value is Type: Currency rounded to two decimal places Example: |
|
Costs |
If the Type is Note that data transfer out is a special case. Because it has a tiered cost structure, the value used to determine its cost is the cost-per-unit across the tiers. For example, let's say that data transfer out costs $0.10 for the first gigabyte used by all your customers, and $0.20 for the remaining gigabytes used by all your customers. If you have three customers, and they each use 0.5 GB, then the total amount of data transfer out is 1.5 GB. Therefore, the cost-per-unit is: [(0.5 GB * $0.10/GB) + (0.5 GB * $0.10/GB) + (0.5 GB * $0.20/GB)] / 1.5 GB = $0.2 / 1.5 GB = $0.13 per GB. Because it is a debit, this value is always negative. Type: Currency rounded to two decimal places Example: |
Example Usage Report
Customer Email,Customer Name,Billing Period,Application,Customer Status,Customer Since,Cancellation Date,Revenue Billed,AWS Costs,DevPay Fee,Refunds Issued,RevenueCollectedCurrBillPeriod,RevenueCollectedPrevBillPeriod "joesmith@example.com","FEB-2008","My Product A","27-FEB-08","AmazonS3","Usage","DataTransfer-In-Bytes",".0049798339605331","GB",".01","0" "joesmith@example.com","FEB-2008","My Product A","27-FEB-08","AmazonS3","Usage","DataTransfer-Out-Bytes",".0037920186296105","GB",".01","0" "joesmith@example.com","FEB-2008","My Product A","27-FEB-08","AmazonS3","Usage","Requests-Tier1","12310","Requests",".25","-.12" "joesmith@example.com","FEB-2008","My Product A","27-FEB-08","AmazonS3","Usage","Requests-Tier2","12737","Requests",".03","-.01" "joesmith@example.com","FEB-2008","My Product A","27-FEB-08","AmazonS3","Usage","TimedStorage-ByteHrs",".00030796040363353","GB-Mo",".01","0" "joesmith@example.com","FEB-2008","My Product A","27-FEB-08","","DevPayFee","","","","0","-.31" "janedoe@example.com","FEB-2008","My Product B","21-FEB-08","AmazonS3","Usage","DataTransfer-In-Bytes",".00011754874140024","GB",".01","0" "janedoe@example.com","FEB-2008","My Product B","21-FEB-08","AmazonS3","Usage","DataTransfer-Out-Bytes",".00035172142088413","GB",".01","0" "janedoe@example.com","FEB-2008","My Product B","21-FEB-08","AmazonS3","Usage","Requests-Tier1","893","Requests",".02","-.01" "janedoe@example.com","FEB-2008","My Product B","21-FEB-08","AmazonS3","Usage","Requests-Tier2","22178","Requests",".04","-.02" "janedoe@example.com","FEB-2008","My Product B","21-FEB-08","AmazonS3","Usage","TimedStorage-ByteHrs",".000010993909733049","GB-Mo",".01","0" "janedoe@example.com","FEB-2008","My Product B","21-FEB-08","","Subscription","","","","3.45","0" "janedoe@example.com","FEB-2008","My Product B","21-FEB-08","","DevPayFee","","","","0","-.7" "markcooper@example.com","FEB-2008","My Product C","24-FEB-08","","OneTimeFee","","","","1","0" "markcooper@example.com","FEB-2008","My Product C","24-FEB-08","","Subscription","","","",".1","0" "markcooper@example.com","FEB-2008","My Product C","24-FEB-08","","DevPayFee","","","","0","-.6" "samanthajones@example.com","FEB-2008","My Product D","27-DEC-07","AmazonEC2","Usage","BoxUsage","409","Hrs","57.26","-40.9" "samanthajones@example.com","FEB-2008","My Product D","27-DEC-07","AmazonEC2","Usage","DataTransfer-In-Bytes",".017763266339898","GB",".01","0" "samanthajones@example.com","FEB-2008","My Product D","27-DEC-07","AmazonEC2","Usage","DataTransfer-Out-Bytes",".03164594899863","GB",".01","-.01" "samanthajones@example.com","FEB-2008","My Product D","27-DEC-07","","Subscription","","","","5","0" "samanthajones@example.com","FEB-2008","My Product D","27-DEC-07","","DevPayFee","","","","0","-2.17"
Related Topics
