Attribution of committed use discount fees and credits

Committed use discounts (CUDs) provide a discount in exchange for your commitment to spend a minimum amount or use a minimum level of resources for a product for a specified term.

Attribution refers to how resource benefits shared at the Cloud Billing account level are divided among account-level resources, such as projects. Attribution for a subscription, such as your committed use discount subscription, determines how fees and credits are applied to your Cloud Billing account and spread across the account's projects that are eligible to consume them. This is reflected in how the fees and credits appear in Cloud Billing cost management interfaces, such as the usage cost export or the Cloud Console.

Types of commitment attribution

Attribution impacts how your committed use discount fees and credits are applied to the projects in your Cloud Billing account, which is reflected in the cost management interfaces. The following are ways in which they can be applied.

Unattributed

When unattributed, the subscription fees and credits are applied to your Cloud Billing account's projects, as they consume eligible usage. Any subscription fees that are not attributed to a project are charged at the Cloud Billing account level.

This type of attribution can affect the predictability of a project's adjusted costs after applying the commitment fees and credits because of the timing or order of consumption relative to other eligible projects.

Proportional attribution

Proportional attribution applies the credits and, where appropriate, the subscription fees from your spend-based committed use discounts to the projects in your Cloud Billing account, directly in proportion to the amount of total eligible usage consumed by each project.

For example, if project A consumed $75 worth of usage and project B consumed $25, project A would be covered by up to 75% of available credit and project B would be covered by up to 25%.

Any subscription fees that are not attributed to a project are charged at the Cloud Billing account level.

Proportional attribution helps you understand the actual cost of a given project that is consuming the discount by clearly disclosing the following:

  • The project's portion of the total commitment fee
  • The project's SKU-based usage cost
  • The project's eligible CUD credit

Compute Engine discount sharing

Discount sharing is only available for Compute Engine resource-based committed use discounts purchased at the project level. When discount sharing is enabled, the benefit of the commitment is shared at the Cloud Billing account level based on the resource consumption. This enables all projects with eligible resource usage to consume that commitment's credits and fees. These are not tied to the amount spent, rather the amount of the resource used.

For more information, see Understanding discount sharing and Turning on committed use discount sharing.

Choose proportional attribution for spend-based commitments

To keep your project costs predictable, starting from August 2021, the following automatically have proportional attribution enabled when you purchase spend-based commitments:

  • You have an existing Cloud Billing account that has no spend-based commitments.
  • You create a new Cloud Billing account and purchase spend-based commitments.

If your Cloud Billing account existed and you purchased spend-based commitments before or during August 2021, you can request that your account switches to proportional attribution.

Enable proportional attribution

If you purchased spend-based commitments before or during August 2021, they might be unattributed. You can request that your billing account switches to proportional attribution, which converts your existing spend-based commitments. To do so, submit the requested information in the proportional attribution opt-in form.

It's not possible to disable proportional attribution once it's enabled.

If you're uncertain whether or not your spend-based commitments purchased before or during August 2021 are using proportional attribution, submit the requested information in the proportional attribution opt-in form to verify it is enabled.

View attribution in your reports

You can view the allocation of your committed use discount fees and charges for both unattributed and proportional attribution in your billing reports.

To view the Cloud Billing reports for your Cloud Billing account:

  1. Sign in to the Google Cloud Console.

    Sign in to Cloud Console

  2. Open the console Navigation menu (), and then select Billing.

    If you have more than one Cloud Billing account, do one of the following:

    • To manage Cloud Billing for the current Cloud project, select Go to linked billing account.
    • To locate a different Cloud Billing account, select Manage billing accounts and choose the account for which you'd like to see reports.
  3. In the Billing navigation menu, select Reports.

For more information on viewing your billing reports, see View your billing reports and cost trends.

Reports for proportional attribution

When you navigate to the reports page, group by Project, and filter by SKU, each project displays the subscription fees specifically attributed to it. Any remaining subscription fees that are not associated with a project are unattributed and assigned to Charges not specific to a project.

View attribution in your exported data

You can view the allocation of your committed use discount fees and charges for both unattributed and proportional attribution in the Cloud Billing BigQuery usage cost export.

For more information about exporting your cost data to BigQuery, see Export Cloud Billing data to BigQuery.

Proportional attribution in exported data

When viewing your exported data in BigQuery, each project consuming credit has a line item corresponding to its proportion of the subscription fee, alongside a line item that represents the usage and credit consumed for that project.

If there is any unconsumed credit, where you didn't consume as much as you committed to, then the remaining subscription fees are assigned to Costs not specific to a project and not attributed to any projects. The total charges for the SKU remain the same, divided between fees that are assigned proportionally to related projects and unattributed fees that are assigned to Costs not specific to a project.