Many Google Cloud Marketplace products drive customer usage of Google Cloud infrastructure and resources. You can integrate labels into your products that give Google insights into your products' impact in terms of their associated customer Google Cloud usage, which Google can use to showcase impact and guide go to market (GTM) investments.
This document describes how to set up partner consumption tracking for integrated software as a service (SaaS) products that you offer through Cloud Marketplace.
Label schema
Labels are key-value pairs that you can assign to Google Cloud resources. For more information about labels, see the Overview of labels.
When you use labels for partner consumption tracking, your labels use the following format:
goog-partner-solution = SOLUTION_URN
Request a consumption tracking label
For each product that you offer through Cloud Marketplace, you must request a label and then integrate it into your product.
To request a label for your Cloud Marketplace product, complete the Partner Consumption Tracking Initiative form. After you complete the form, you receive an automated email with the label that you must integrate with your product.
Integrate the consumption tracking label with your SaaS product
To integrate the consumption tracking label with your SaaS product, you must set up your product to add the label to Google Cloud resources as it deploys them.
You can use any of the following methods to add the consumption tracking label to the resources that your product deploys:
- Terraform
- The Google Cloud console
- Google Cloud CLI
- REST API
- Cloud Deployment Manager
We recommend that you use Terraform, an infrastructure-as-code tool created by HashiCorp, because it lets you add a default label at the Google provider level that applies to all Google Cloud resources that Terraform deploys. For more information about using default labels with Terraform, see the Google Cloud Provider Configuration Reference in the official Terraform documentation.
For information about adding labels by using the Google Cloud console, Google Cloud CLI, or the REST API, see Create resources with labels.
For information about adding labels by using Deployment Manager, see Adding labels to a deployment.