Stay organized with collections
Save and categorize content based on your preferences.
This document shows how to test usage reporting for the SaaS products that you
offer through Google Cloud Marketplace.
Before you begin
To test usage reporting, your product's pricing plan must be approved by
Google. For more details, see
Submit your pricing for review.
Make sure that you use a Test Billing Account, which has 100% discounted
usage. For steps to set up a Test Billing Account, see
Create a Test Billing Account.
Verify that you've turned on Customer incremental insights reports. This
involves the following steps:
You verify your usage reporting by running a test that generates usage reports,
and then comparing the usage reports to your expected outcomes. To run the test,
do the following:
In Producer Portal, switch to a Google Cloud project that's
associated with your Test Billing Account.
From your product's Google Cloud Marketplace listing page, use your Test Billing
Account to purchase the product.
Send an initial usage report for a single, recognizable metric. This should
equal more than US$0.01, and be less than the amount of usage that you expect
for one hour of usage. For example, if your product bills per GiB per hour,
send a single usage report that's equivalent to one GiB per hour. This makes
it easier to verify that metering and billing are working as expected when
you compare against the Customer incremental insights report.
For details about how to send usage reports, including how to format reports
and usage times, see
Reporting usage to Google.
Continue to send at least one usage report per hour for at least six hours.
If you send more than one usage report per hour, this doesn't affect the
required minimum length of the test, which remains six hours.
For the duration of the testing period, create logs that contain the usage
information that you're reporting in Google Sheets or CSV format, with the
following format:
Time (UTC)
operationID
startTime
endTime
consumerId
metricName
metricValue
TIME
OPERATION_ID
START_TIME
END_TIME
project_number: PROJECT_NUMBER
METRIC_NAME
METRIC_VALUE
Provide these logs, in Google Sheets or CSV format, to your
Cloud Marketplace partner engineering team.
After you receive the Customer incremental insights report corresponding to
the time period during which you ran your tests, Google compares the values
in your report with your expected values, including the following fields:
charges
sku_id
sku_description
usage
unit
currency
external_account_id
Google sends you the results of their comparison.
Clean up after testing
After Google receives and verifies your usage from the testing period, you clean
up the resources that you created for testing by doing the following:
Stop sending usage reports for the entitlements that you created for
testing.
Cancel all entitlements that you created for testing.
Remove any Google team members that you added to your Cloud Billing
account during testing.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[],[],null,["# Test usage reporting for SaaS products\n\nThis document shows how to test usage reporting for the SaaS products that you\noffer through Google Cloud Marketplace.\n\nBefore you begin\n----------------\n\n- To test usage reporting, your product's pricing plan must be approved by\n Google. For more details, see\n [Submit your pricing for review](/marketplace/docs/partners/integrated-saas/select-pricing#submit-pricing).\n\n | **Note:** When you make a change to your product's approved pricing plans, it might take up to four business days for Google to approve the changes.\n- Make sure that you use a Test Billing Account, which has 100% discounted\n usage. For steps to set up a Test Billing Account, see\n [Create a Test Billing Account](/marketplace/docs/partners/create-test-billing-account).\n\n- Verify that you've turned on Customer incremental insights reports. This\n involves the following steps:\n\n - [Set up to receive reports](/marketplace/docs/partners/reports/set-up-reports).\n - [Turn on Customer incremental insights reports](/marketplace/docs/partners/reports/report-customer-insight#turn-on-customer-incremental-insights).\n\nRun a test to generate usage\n----------------------------\n\nYou verify your usage reporting by running a test that generates usage reports,\nand then comparing the usage reports to your expected outcomes. To run the test,\ndo the following:\n\n1. In Producer Portal, switch to a Google Cloud project that's\n associated with your Test Billing Account.\n\n2. From your product's Google Cloud Marketplace listing page, use your Test Billing\n Account to purchase the product.\n\n3. Send an initial usage report for a single, recognizable metric. This should\n equal more than US$0.01, and be less than the amount of usage that you expect\n for one hour of usage. For example, if your product bills per GiB per hour,\n send a single usage report that's equivalent to one GiB per hour. This makes\n it easier to verify that metering and billing are working as expected when\n you compare against the Customer incremental insights report.\n\n For details about how to send usage reports, including how to format reports\n and usage times, see\n [Reporting usage to Google](/marketplace/docs/partners/integrated-saas/backend-integration#for_usage-based_pricing_reporting_usage_to_google).\n4. Continue to send at least one usage report per hour for at least six hours.\n If you send more than one usage report per hour, this doesn't affect the\n required minimum length of the test, which remains six hours.\n\n5. For the duration of the testing period, create logs that contain the usage\n information that you're reporting in Google Sheets or CSV format, with the\n following format:\n\n Provide these logs, in Google Sheets or CSV format, to your\n Cloud Marketplace partner engineering team.\n6. After you receive the Customer incremental insights report corresponding to\n the time period during which you ran your tests, Google compares the values\n in your report with your expected values, including the following fields:\n\n - `charges`\n - `sku_id`\n - `sku_description`\n - `usage`\n - `unit`\n - `currency`\n - `external_account_id`\n\n Google sends you the results of their comparison.\n\nClean up after testing\n----------------------\n\nAfter Google receives and verifies your usage from the testing period, you clean\nup the resources that you created for testing by doing the following:\n\n- Stop sending usage reports for the entitlements that you created for testing.\n- Cancel all entitlements that you created for testing.\n- Remove any Google team members that you added to your Cloud Billing account during testing.\n\nRelated topics\n--------------\n\n- [Preview your product in Producer Portal](/marketplace/docs/partners/integrated-saas/test-preview), to see how it appears to Cloud Marketplace users.\n- [Preview your product's pricing](/marketplace/docs/partners/integrated-saas/test-preview-pricing)."]]
