improving acrolinx scores

Author: Qian Wen

articles/marketplace/partner-center-portal/azure-app-metered-billing.md

@@ -1,41 +1,40 @@
 ---
-title: Metered billing for Managed applications using the marketplace metering service | Azure Marketplace
+title: Metered billing for managed applications using the marketplace metering service | Azure Marketplace
 description: This documentation is a guide for ISVs publishing Azure applications with flexible billing models. 
-author: MaggiePucciEvans 
-manager: evansma
-ms.author: evansma 
+author: qianw211
+ms.author: dsindona 
 ms.service: marketplace 
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: conceptual
-ms.date: 01/24/2020
+ms.date: 04/22/2020
 ---
 
 # Managed application metered billing 
 
-With the Marketplace metering service, you can create Managed application plans for Azure Application offers in the commercial marketplace program that are charged according to non-standard units. Before publishing this offer, you define the billing dimensions such as bandwidth, tickets, or emails processed. Customers then pay according to their consumption of these dimensions, with your system informing Microsoft via the Marketplace metering service API of billable events as they occur.
+With the Marketplace metering service, you can create managed application plans for Azure Application offers that are charged according to non-standard units. Before publishing this offer, you define the billing dimensions such as bandwidth, tickets, or emails processed. Customers then pay according to their consumption of these dimensions.  Your system will inform Microsoft via the Marketplace metering service API of billable events as they occur.
 
 ## Prerequisites for metered billing
 
-In order for a Managed application plan to use metered billing, it must:
+In order for a managed application plan to use metered billing, it must:
 
 * Meet all of the offer requirements as outlined in [Create an Azure application offer](create-new-azure-apps-offer.md).
 * Configure **Pricing** for charging customers the per-month cost for your service. Price can be zero if you don't want to charge a fixed fee and instead rely entirely on metered billing.
-* Set **Billing dimensions** for the metering events the customer will pay for in addition to the flat rate.
+* Set **Billing dimensions** for the metering events the customer will pay for on top of the flat rate.
 * Integrate with the [Marketplace metering service APIs](./marketplace-metering-service-apis.md) to inform Microsoft of billable events.
 
 ## How metered billing fits in with pricing
 
 When it comes to defining the offer along with its pricing models, it is important to understand the offer hierarchy.
 
-* Each Azure Application offer can have Solution template or Managed application plans.
-* Metered billing is implemented only with Managed application plans.
-* Each Managed application plan has a pricing model associated with it. 
+* Each Azure Application offer can have Solution template or managed application plans.
+* Metered billing is implemented only with managed application plans.
+* Each managed application plan has a pricing model associated with it. 
 * Pricing model has a monthly recurring fee, which can be set to $0.
 * In addition to the recurring fee, the plan can also include optional dimensions used to charge customers for usage not included in the flat rate. Each dimension represents a billable unit that your service will communicate to Microsoft using the [Marketplace metering service API](marketplace-metering-service-apis.md).
 
 ## Sample offer
 
-As an example, Contoso is a publisher with an Managed application service called Contoso Analytics (CoA). CoA allows customers to analyze large amount of data for reporting and data warehousing. Contoso is registered as a publisher in Partner Center for the commercial marketplace program to publish offers to Azure customers. There are two plans associated with CoA, outlined below:
+As an example, Contoso is a publisher with a managed application service called Contoso Analytics (CoA). CoA allows customers to analyze large amount of data for reporting and data warehousing. Contoso is registered as a publisher in Partner Center for the commercial marketplace program to publish offers to Azure customers. There are two plans associated with CoA, outlined below:
 
 * Base plan
     * Analyze 100 GB and generate 100 reports for $0/month
@@ -46,36 +45,36 @@ As an example, Contoso is a publisher with an Managed application service called
     * Beyond the 1000 GB, pay $100 for every 1 TB
     * Beyond the 1000 reports, pay $0.5 for every report
 
-An Azure customer subscribing to CoA service will be able to analyze and generate reports per month based on the plan selected. Contoso measures the usage up to the included quantity without sending any usage events to Microsoft. When customers consume more than the included quantity, they do not have to change plans or do anything different. Contoso will measure the overage beyond the included quantity and start emitting usage events to Microsoft for additional usage using the [Marketplace metering service API](./marketplace-metering-service-apis.md). Microsoft in turn will charge the customer for the additional usage as specified by the publisher.
+An Azure customer subscribing to CoA service can analyze and generate reports per month based on the plan selected. Contoso measures the usage up to the included quantity without sending any usage events to Microsoft. When customers consume more than the included quantity, they do not have to change plans or do anything different. Contoso will measure the overage beyond the included quantity and start emitting usage events to Microsoft for additional usage using the [Marketplace metering service API](./marketplace-metering-service-apis.md). Microsoft in turn will charge the customer for the additional usage as specified by the publisher.
 
 ## Billing dimensions
 
-Billing dimensions are used to communicate to the customer on how they will be billed for using the software, and also to communicate usage events to Microsoft. They are defined as follows:
+Billing dimensions are used to communicate to the customer on how they will be billed for using the software.  These dimensions are also used to communicate usage events to Microsoft. They are defined as follows:
 
 * **Dimension identifier**: the immutable identifier referenced while emitting usage events.
-* **Dimension name**: the display name associated with the dimension, e.g. "text messages sent".
-* **Unit of measure**: the description of the billing unit, e.g. "per text message" or "per 100 emails".
+* **Dimension name**: the display name associated with the dimension, for example "text messages sent".
+* **Unit of measure**: the description of the billing unit, for example "per text message" or "per 100 emails".
 * **Price per unit**: the price for one unit of the dimension.
 * **Included quantity for monthly term**: quantity of dimension included per month for customers paying the recurring monthly fee, must be an integer.
 
 Billing dimensions are shared across all plans for an offer. Some attributes apply to the dimension across all plans, and other attributes are plan-specific.
 
-The attributes which define the dimension itself are shared across all plans for an offer. Before you publish the offer, a change made to these attributes from the context of any plan will affect the dimension definition across all plans. Once you publish the offer, these attributes will no longer be editable. These attributes are:
+The attributes, which define the dimension itself, are shared across all plans for an offer. Before you publish the offer, a change made to these attributes from the context of any plan will affect the dimension definition across all plans. Once you publish the offer, these attributes will no longer be editable. The attributes are:
 
 * Identifier
 * Name
 * Unit of measure
 
-The other attributes of a dimension are specific to each plan and can have different values from plan to plan.  Before you publish the plan you can edit these values and only this plan will be affected. Once you publish the plan, these attributes will no longer be editable. These attributes are:
+The other attributes of a dimension are specific to each plan and can have different values from plan to plan.  Before you publish the plan, you can edit these values and only this plan will be affected. Once you publish the plan, these attributes will no longer be editable. The attributes are:
 
 * Price per unit
 * Included quantity for monthly customers 
 * Included quantity for annual customers 
 
 Dimensions also have two special concepts, "enabled" and "infinite":
 
-* **Enabled** indicates that this plan participates in this dimension.  You might want to leave this un-checked if you are creating a new plan that does not send usage events based on this dimension. Also, any new dimensions added after a plan was first published will show up as "not enabled" on the already published plan.  A disabled dimension will not show up in any lists of dimensions for a plan seen by customers.
-* **Infinite**, represented by the infinity symbol "∞", indicates that this plan participates in this dimension, but does not meter usage against this dimension. If you want to indicate to your customers that the functionality represented by this dimension is included in the plan, but with no limit on usage.  A dimension with infinite usage will show up in lists of dimensions for a plan seen by customers, with an indication that it will never incur a charge for this plan.
+* **Enabled** indicates that this plan participates in this dimension.  You might want to leave this option un-checked if you are creating a new plan that does not send usage events based on this dimension. Also, any new dimensions added after a plan was first published will show up as "not enabled" on the already published plan.  A disabled dimension will not show up in any lists of dimensions for a plan seen by customers.
+* **Infinite**, represented by the infinity symbol "∞", indicates that this plan participates in this dimension, without metered usage against this dimension. If you want to indicate to your customers that the functionality represented by this dimension is included in the plan, but with no limit on usage.  A dimension with infinite usage will show up in lists of dimensions for a plan seen by customers.  This plan will never incur a charge.
 
 >[!Note] 
 >The following scenarios are explicitly supported:  <br> - You can add a new dimension to a new plan.  The new dimension will not be enabled for any already published plans. <br> - You can publish a plan with a fixed monthly fee and without any dimensions, then add a new plan and configure a new dimension for that plan. The new dimension will not be enabled for already published plans.
@@ -84,7 +83,7 @@ Dimensions also have two special concepts, "enabled" and "infinite":
 
 ### Locking behavior
 
-Because a dimension used with the Marketplace metering service represents an understanding of how a customer will be paying for the service, all of the details for a dimension are no longer editable once you publish it.  It's important that you have your dimensions fully defined for a plan before you publish.
+A dimension used with the Marketplace metering service represents an understanding of how a customer will be paying for the service.  All details of a dimension are no longer editable once an offer is published.  Before publishing your offer, it's important that you have your dimensions fully defined.
 
 Once an offer is published with a dimension, the offer-level details for that dimension can no longer be changed:
 
@@ -107,7 +106,7 @@ The maximum number of dimensions that can be configured for a single offer is 18
 
 ## Get support
 
-If you have one of the following, you can open a support ticket.
+If one of the following cases applies, you can open a support ticket.
 
 * Technical issues with marketplace metering service API.
 * An issue that needs to be escalated because of an error or bug on your side (ex. wrong usage event).
@@ -121,7 +120,7 @@ Follow the steps below to submit your support ticket:
 4. Under "Select a problem that best describes the issue", select **metered billing**.
 5. By selecting the **Next** button, you will be directed to the **Issue details** page, where you can enter more details on your issue.
 
-See [Support for the commercial marketplace program in Partner Center](https://docs.microsoft.com/azure/marketplace/partner-center-portal/support) for more publisher support options.
+For more publisher support options, see [support for the commercial marketplace program in Partner Center](https://docs.microsoft.com/azure/marketplace/partner-center-portal/support).
 
 ## Next steps