Daily Usage data feed
This data feed provides detailed daily usage information for your products, including customer usage metrics, estimated revenue, and pricing details. The data helps you track how customers are using your products and calculate estimated revenue based on usage patterns.
The Daily Usage data feed is refreshed every 24 hours.
The following table lists and describes the items in the data feed.
Column |
Description |
|---|---|
valid_from |
The first date that the value for the primary key is valid for in relation to values for other fields. |
insert_date |
The date a record was inserted into the data feed. |
update_date |
The date the record was last updated. |
delete_date |
The date the record was soft deleted. |
usage_feed_id |
The unique identifier of the usage record. This is a per-seller salted hash that ensures data privacy while maintaining record uniqueness. |
usage_date |
The customer usage date, without the time component. The time is omitted because usage is aggregated for each day. |
product_id |
The friendly ID of the product. Can be used to join to the |
agreement_id |
The unique identifier of the agreement. If present, this always starts with |
end_user_account_id |
The account that actually used the product, represented by the globally unique identifier (GUID) of the end user's account. Can be used to join to the Account data feed. This is a per-seller salted hash, not the raw AWS account ID. |
payer_account_id |
The account that is expected to pay for usage of the product, represented by the globally unique identifier (GUID) of the payer's account. Can be used to join to the Account data feed. This is a per-seller salted hash, not the raw AWS account ID. |
region |
The AWS region where the buyer usage occurred. |
dimension_key |
The dimension key configured by the seller when publishing the offer. |
usage_unit |
A classification for the usage units, describing the type of usage measurement. |
usage_quantity |
The usage value for the AWS service or usage type associated with the billing record. The value is provided with up to 2 decimal places. |
pricing_currency |
The currency of estimated revenue. |
estimated_revenue_in_pricing_currency |
The estimated revenue calculated using the |
recipient_account_id |
The account of the seller that is receiving the data in the feeds. |
offer_id |
The friendly ID of the offer. This will match the offer_id of the purchase agreement when available. Can be used to join to the Offer and Offer target data feeds. For consistency, this field is always non-null. |
usage_rate_per_unit_in_pricing_currency |
The usage rate per unit that can be multiplied by the |
charge_item_description |
The complete charge item description, typically formatted as offer_term_description|region|dimension_description for usage-based charges. |
Daily Usage data feed example
The following shows an example of the Daily Usage data feed with key columns. For readability, some columns are not shown.
| usage_date | product_id | agreement_id | region | dimension_key | usage_unit | usage_quantity | pricing_currency | estimated_revenue_in_pricing_currency | offer_id | usage_rate_per_unit_in_pricing_currency | charge_item_description |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 2025-01-15 | prod-abcd1234efgh5678 | agmnt-wxyz9876abcd5432 | us-east-1 | USE1_InputTokenCount | units | 24.00 | USD | 12.00 | offer-mnop5432qrst7890 | 0.500000 | AWS Marketplace software usage|us-east-1|Million Input Tokens |
| 2025-01-15 | prod-ijkl9876mnop1234 | agmnt-stuv5432wxyz9876 | us-west-2 | USE1_InputTokenCount | units | 1000.00 | USD | 5.50 | offer-abcd9876efgh5432 | 0.005500 | AWS Marketplace software usage|us-west-2|API Calls |