

# Dashboards for marketing
<a name="marketing-dashboards"></a>

AWS Marketplace provides multiple dashboards to help you track your marketing data.

**Topics**
+ [Customer agreements dashboard](customer-agreements-dashboard.md)
+ [Listing performance dashboard](listing-performance-dashboard.md)
+ [Search performance dashboard](search-performance-dashboard.md)
+ [Understanding Buy with AWS dashboards](buy-with-aws-dashboard.md)

# Customer agreements dashboard
<a name="customer-agreements-dashboard"></a>

The Customer agreements dashboard provides an overview of the agreements and customers who subscribe to your products in AWS Marketplace. The dashboard provides data on your new and active agreements, plus customer trends and profiles.

**Note**  
To unlock this dashboard, you must enroll the [AWS Marketplace Seller Prime](https://pages.awscloud.com/aws-marketplace-seller-prime.html) program.
To open this dashboard, sign in to the [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/), choose **Insights**, **Marketing**, and then choose the **Customer agreements** tab.

For more information about using the AWS Marketplace dashboards, see [Seller dashboards](dashboards.md), earlier in this section.

**Topics**
+ [Section 1: Filters](#customer-agreements-filters)
+ [Section 2: Date filter deep dive](#customer-agreements-date-deep-dive)
+ [Section 3:  Public and private offer agreements](#customer-agreements-public-private-agreements)
+ [Section 4:  Customer metrics](#section-5-customer-metrics)

## Section 1: Filters
<a name="customer-agreements-filters"></a>

You can use the following filters to refine your agreements data. 


|  Control name  |  Description  | 
| --- | --- | 
|  Product title  |  The title of the product.  | 
|  Date filter  |  Includes data for the past 30, 60, and 90 days, the trailing 12 months (TTM), and year to date (YTD). Choose custom to define a specific start and end date.  | 
|  Customer industry  |  The industry that AWS defines for a customer who subscribed a seller product.  | 
|  Customer segment  |  The segment that AWS defines for a customer who subscribed a seller product. Customer segments include: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/marketplace/latest/userguide/customer-agreements-dashboard.html)  | 

For more information about filtering, see [Filtering data on Quick](https://docs.aws.amazon.com/quicksight/latest/user/adding-a-filter.html) in the *Amazon Quick User Guide*.

## Section 2: Date filter deep dive
<a name="customer-agreements-date-deep-dive"></a>

This date filter applies to all the metrics on the customer agreement dashboards.  

For example, when you use the default year-to-date filter value, the follpwing metrics appear:


|  Metric  |  Description  | 
| --- | --- | 
|  Public offer agreement count  |  Number of agreements with public offer as offer visibility that have at least 1 active day within YTD.  | 
|  Private offer agreement count  |  Number of agreements with private offer as offer visibility that have at least 1 active day within YTD.  | 
|  New public offer agreement count  |  Number of agreements with public offer as offer visibility that have acceptance date within YTD.  | 
|  New private offer agreement count  |  Number of agreements with private offer as offer visibility that have acceptance date within YTD.  | 
|  Active customers  |  Number of unique customers, identified as subscriber AWS account ID, that have at least 1 active agreement within YTD. Active agreement is defined as an agreement with at least 1 active day during the time period.  | 
|  New paying customers  |  Number of unique customers, identified as subscriber AWS account ID, who have their first billing month within YTD.  | 

## Section 3:  Public and private offer agreements
<a name="customer-agreements-public-private-agreements"></a>

This section of the dashboard displays an overview of your agreements. Key performance indicators (KPIs) include the number of public offer agreements, the number of private offer agreements, the number of new public offer agreements, and the number of new private offer agreements. You can see the year-over-year or period-over-period changes in volume and percentage. You can update the date range by updating the date filter in the filter section. 

 An *agreement* is a contract signed between a proposer (the product or service owner) and an accepter (the customer) to start using a product. 

**Note**  
New agreement metrics include active, expired, cancelled, and terminated agreements.

 The following table lists and describes the agreement statuses. 


|  Status  |  Description  | 
| --- | --- | 
|  Active  |  Some or all of the terms of the agreement are in-force.  | 
|  Expired  |  The agreement ended on its pre-agreed end date.  | 
|  Canceled  |  The acceptor chooses to end the agreement prior to its end date.  | 
|  Terminated  |  The agreement ended before its pre-agreed end date due to an  AWS-initiated termination event, such as a payment failure.  | 
|  Renewed  |  The agreement was renewed into a new agreement using functionality such as auto-renewal.  | 
|  Replaced  |  The agreement was replaced using a replacement offer.  | 

## Section 4:  Customer metrics
<a name="section-5-customer-metrics"></a>

This section of the dashboard provides customer trends for a specified date range. KPIs include the number of active customers and the number of new paying customers.
+ **Monthly trend** – Provides the monthly view for the number of active customers and the number of new paying customers based on the filter within the chart. 
+ **Customer metrics** – Provides data on the number of active customers and the number of new paying customers, based on the chosen metric filter. You can select a customer segment or an industry to understand how each contributes to the total customer metric.

**Note**  
Agreements have a given status. For information about the statuses, see the [ table in the previous section](#customer-agreements-public-private-agreements).

The following table lists and describes the metrics.


|  Metrics  |  Description  | 
| --- | --- | 
|  Public offer agreements  | The number of agreements identified as agreement IDs with public offer visibility; the length of the agreement has at least one day of overlap with the selected date range; the length is identified between the agreement start date and agreement end date. | 
|  Private offer agreements  | The number of agreements identified as agreement IDs with private offer visibility; the length of the agreement has at least one day of overlap with the selected date range; the length is identified between agreement start date and agreement end date.  | 
|  New public offer agreements  | The number of agreements identified as agreement ID with public offer visibility; the agreement acceptance date falls within the selected date range.  | 
|  New private offer agreements  |  The number of agreements identified as agreement IDs with private offer visibility; the agreement acceptance date falls within the selected date range.  | 
|  Active customers  | The number of customers identified as subscriber AWS account IDs with at least 1 active agreement; the length of agreement has at least one day overlap with the selected date range  | 
| New paying customers  |  The number of customers identified as subscriber AWS account IDs that have their first billing month within the selected date range.  | 

 For more information about agreements and revenue, see [Agreements and renewals dashboard](agreements-renewals-dashboard.md) and   [Billed revenue dashboard](billed-revenue-dashboard.md), both in this section. 

# Listing performance dashboard
<a name="listing-performance-dashboard"></a>

The listing performance dashboard provides an overview of, and detailed data about, your AWS Marketplace listings. The dashboard provides data about traffic volumes and the steps that your customers take to subscribe to your products. The dashboard also provides a detailed breakdown of traffic by marketing channels.

**Note**  
To unlock this dashboard, you must enroll the [AWS Marketplace Seller Prime](https://pages.awscloud.com/aws-marketplace-seller-prime.html) program.
To open this dashboard, sign in to the [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/), choose **Insights**, **Marketing**, and then choose the **Listing performance** tab.

For more information about using the AWS Marketplace dashboards, see [Seller dashboards](dashboards.md), earlier in this section.

**Topics**
+ [Section 1: Filters](#listing-section-1-filters)
+ [Section 2: Date filter deep dive](#date-filter-deep-dive)
+ [Section 3:  Summary metrics](#listing-summary-metrics)
+ [Section 4:  Monthly trend and funnel conversion](#monthly-trend-funnel)
+ [Section 5: Traffic trend by channel](#traffic-trend-by-channel)
+ [Section 6: Monthly traffic and agreement metrics](#monthly-traffic-agreement)
+ [Section 7: Web traffic sources for unique visitors](#traffic-sources-unique-visitors)
+ [Section 8: Web traffic source breakdown](#traffic-source-breakdown)

## Section 1: Filters
<a name="listing-section-1-filters"></a>

You can use the following filters to refine your data.


|  Control name  |  Description  | 
| --- | --- | 
|  Product title  |  The title of the product.  | 
|  Date  |  Includes the past 30, 60, and 90 days, the trailing 12 months (TTM), and year to date (YTD). You can choose custom to define a specific start and end date.  | 

For more information about filtering, see [Filtering data on Quick](https://docs.aws.amazon.com/quicksight/latest/user/adding-a-filter.html) in the *Quick User Guide*.

## Section 2: Date filter deep dive
<a name="date-filter-deep-dive"></a>

 This date filter applies to all the metrics on the listing performance dashboards.  

 For example, when you use the default year-to-date filter value, the following metrics appear: 


|  Metric  |  Description  | 
| --- | --- | 
|  Unqiue visitors  |  Number of unique individuals who have visited AWS Marketplace listing pages in YTD.  | 
|  New public offer agreements  |  Number of agreements with public offer as offer visibility that have at least 1 active day within YTD.  | 
|  New unique visitors  |  Number of unique individuals who have visited AWS Marketplace listing pages for the first time in YTD.  | 
|  Return unique visitors  |  Number of unique individuals who have visited AWS Marketplace listing pages who had previously visited before the beginning of the selected year and visited again in YTD.  | 

## Section 3:  Summary metrics
<a name="listing-summary-metrics"></a>

This section of the dashboard displays a summary visualization of your traffic and public offer agreements. Key peformance indicatrs (KPIs) include the number of unique visitors, the number of new public offer agreements, the number of new unique visitors, and the number of return unique visitors. You can see the year-over-year or period-over-period changes in volume and percentage. You can update the date range by updating the date criteria in the date field in the filter section. 


|  Metrics  |  Description  | 
| --- | --- | 
|  Unique visitors  |  Number of unique individuals who have visited AWS Marketplace listing pages.  | 
|  Agreement  |  A contract signed between a proposer (product or service owner) and an accepter (customer) to start using a product.  | 
|  New public offer agreements  |  Number of agreements with public offer as offer visibility that have acceptance date within the selected date range. include status being active, expired, cancelled, and terminated. | 
|  Status  | Active - Some or all of the terms of the agreement are in-force. Expired - The agreement ended on its pre-agreed end date. Canceled - The acceptor chooses to end the agreement prior to its end date. Terminated - The agreement ended before its pre-agreed end date due to an AWS-initiated termination event, such as a payment failure. Renewed - The agreement was renewed into a new agreement using functionality such as auto-renewal. Replaced - The agreement was replaced using a replacement offer.  | 

## Section 4:  Monthly trend and funnel conversion
<a name="monthly-trend-funnel"></a>

This section of the dashboard provides traffic and agreement trends for a specified date range. Key performance indicators include the number of unique visitors and the number of new agreements, referring to the new public offer agreements. ** Unique visitor by month -** provides the monthly view for the number of unique visitors. The total of monthly unique visitors can be more than the total unique visitors in the summary metric section as one unique visitor can visit multiple months. **New agreements by month -** provides the monthly view for the number of new public offer agreements. **Funnel conversion -** provides the step-by-step conversion view. It includes listing page, procurement page, configuration page and fulfillment page. You can select unique visitors, page views and unique accounts as what the bars show as. When you hover over each bar, you can see the conversion percentage defined as the current bar’s value as a percentage of previous bar. 


|  Metrics  |  Description  | 
| --- | --- | 
|  Unique visitors  |  Number of unique individuals who have visited AWS Marketplace listing pages.  | 
|  Page views  |  Number of visits to a AWS Marketplace listing page.  | 
|  Unique accounts  |  Number of unique AWS account ID associated with a visitor. This metric is only applicable after a visitor authenticates.  | 

## Section 5: Traffic trend by channel
<a name="traffic-trend-by-channel"></a>

This section of the dashboard provides a deep dive into monthly traffic trend. You can select unique visitors and page views as what the bars show as. You can select a single channel or multiple ones in the channel filter to see the monthly trend for the selected channel(s). 

## Section 6: Monthly traffic and agreement metrics
<a name="monthly-traffic-agreement"></a>

This section of the dashboard provides a monthly view for unique visitors, new agreements, conversion rate and total agreements. Conversion rate is defined as new agreements divided by unique visitors for each month. 

The data in the table represents an entire month, even if you select date range for a partial month. For example, if you filter the data to display the period from January 15, 2024 to March 15, 2024, the table will still include the complete monthly data for January 1, 2024 through March 31, 2024. 

The data in the table is sorted by **Month**, with the most recent month displayed first. You can choose to sort the table by any of the available columns by clicking on the corresponding column header with the option to sort the data in either ascending or descending order. 

## Section 7: Web traffic sources for unique visitors
<a name="traffic-sources-unique-visitors"></a>

This section of the dashboard provides deep dives into unique visitors by marketing sources. The categories include seller organic discovery, seller-led marketing campaigns, AWS organic discovery, and AWS-led campaigns. Those categories are identified by the tracking codes associated with the visitor or visit.


|  Traffic source  |  Description  | 
| --- | --- | 
|  Seller organic discovery  | Unique visitors who arrive at your listings through calls to action and points of discovery on your website or in-app notifications.  | 
|  Seller-led marketing campaigns  | Unique visitors who arrive at your listings through your paid advertising or promotional channels.  | 
|  AWS organic discovery  | Unique visitors who arrive at your listings through AWS channels, such as organic AWS website traffic, AWS console(s) search, and AWS Marketplace search.  | 
|  AWS marketing campaigns  | Unique visitors who arrive at your listings through AWS-led campaigns and paid promotions.  | 

## Section 8: Web traffic source breakdown
<a name="traffic-source-breakdown"></a>

Web traffic source breakdown table provides the granular breakdown of marketing activities that drive the traffic.
+ **Traffic source** - Includes AWS-led and seller-led as two main categories.
+ **Traffic type** - Includes seller organic discovery, seller-led marketing campaigns, AWS organic discovery and AWS-led marketing campaigns.
+ **Channel** - Includes the various marketing tactics, which are paid display, paid search, paid social media, email, organic, internal site traffic external links and other.
+ **Publisher** - Refers to the entity where the campaign is published, including Facebook, Google, LinkedIn, AWS, Seller-led. and others.
+ **Promotion** - Refers to the specific campaign for which a dedicated tracking code has been generated. An example can be `psm_linked_post_free-trial-global-ver-a`.


|  Metrics  |  Description  | 
| --- | --- | 
|  Attributed agreements  |  Total agreements contributed by the visits for each promotion.  | 
|  Conversion rate  |  Attributed agreements divided by unique visitors for each promotion.  | 

# Search performance dashboard
<a name="search-performance-dashboard"></a>

The **Search performance** dashboard provides metrics on how your AWS Marketplace listings perform in the AWS Marketplace search experience. You use the dashboard to improve the discoverability and performance of your listings. The dashboard tracks the number of impressions, clicks, and click through rates. It also tracks the top keywords that you supply, and that customers use, and it offers keyword suggestions based on common customer searches.

The insights from the dashboard can help you refine your product listings to improve visibility, match your keywords with customer preferences, and drive more qualified traffic to your business on AWS Marketplace.  

To open the dashboard, start the AWS Marketplace Management Portal and go to the **Insights** tab.

For more information about controlling access to the dashboard, see [Seller dashboards](dashboards.md), earlier in this section.

## Section 1: Accessing the dashboard
<a name="search-performace-access"></a>

 To unlock this dashboard, you must be a member of the [AWS Marketplace Seller Prime Program](https://pages.awscloud.com/aws-marketplace-seller-prime.html). 

After you enroll in the Seller Prime program, system administrators for seller accounts can use the **Insights** tab in the AWS Marketplace Management Portal to start the **Search performance** dashboard.

System administrators can also create an AWS Identity and Access Management (IAM) policy to provide access for specific dashboards to other users in the seller company. 

**Note**  
 As of September 2023, we no longer support access to seller dashboards enabled by legacy IAM permissions. Use the new Amazon Resource Name (ARN) format as shown in the following examples to update your IAM permissions. 

 For more information about creating policies, see [Creating IAM policies](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html), in the *AWS Identity and Access Management User Guide*. 

### Using policies to control access
<a name="search-performance-access-policies"></a>

Use one of the following policies to provide access to the listing performance dashboard.

The following example provides access to all current and future AWS Marketplace resources, including dashboards and reports, regardless of current or future data feeds.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
    {
    "Effect": "Allow",
    "Action": [
    "aws-marketplace:GetSellerDashboard"
    ],
    "Resource": "arn:aws:aws-marketplace:us-east-1:111122223333:AWSMarketplace/*"
    }
    ]
    }
```

------

The following example provides access to the **Search performance** dashboard by including its ARN.  

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
    {
    "Effect": "Allow",
    "Action": [
    "aws-marketplace:GetSellerDashboard"
    ],
    "Resource": "arn:aws:aws-marketplace:us-east-1:111122223333:AWSMarketplace/ReportingData/Marketing_V1/Dashboard/SearchPerformance_V1"
    }
    ]
    }
```

------

## Section 2: Filters
<a name="search-perf-filters"></a>

 This section of the dashboard provides the following filters. Use them to refine your data. 


| Control name | Description | 
| --- | --- | 
| Product title |  The title of the product. This filter affects the impressions, clicks, click-through rate, and **AWS Marketplace search keyword recommendations**. It doesn’t affect the **Top searched keywords by product category** table.  | 
| Date filter |  You can filter on the past 30, 60, and 90 days, the trailing 12 months (TTM), and the year to date (YTD). You can choose **Custom** to use specific start and end date. This filter affects the impressions, clicks, and click-through rate. it doesn’t affect the **AWS Marketplace search keyword recommendations** or **Top searched keywords by product category** tables.  | 

 For more information about filtering, see [Filtering data on Amazon QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/adding-a-filter.html), in the *Amazon QuickSight User Guide*. 

## Section 3: AWS Marketplace search performance
<a name="search-performance"></a>

This section of the dashboard displays key performance indicators (KPIs) about the discoverability and performance of your AWS Marketplace listings. The dashboard provides KPIs for the number of impressions, the number of clicks, and the click-through rate. 

 You can see year-over-year or period-over-period changes in volume and percentage. You can also change date ranges. 


| Metric | Description | 
| --- | --- | 
| Impressions | The number of times your listings appear in the top 20 search results on AWS Marketplace. | 
| Clicks | The number of times users click your listings from the AWS Marketplace search results. | 
| Click-through rate (CTR) | The ratio between the number of clicks and the number of impressions. A measure of how effective your listings are at engaging customers from the search results. | 

## Section 4: Monthly trend for impressions, clicks, and click-through rate
<a name="impressions-click-throughs"></a>

 This section of the dashboard provides monthly trends for a given date range. It provides KPIs for the number of impressions, the number of clicks, and the click-through rate. 

## Section 5: AWS Marketplace search keyword recommendations
<a name="keyword-recommendations"></a>

 This section of the dashboard provides a table that lists your current keywords, plus recommended keywords for each of your listings. 


| Column names | Description | 
| --- | --- | 
| Product title | The title of the product. The link takes you to the product overview page in the AWS Marketplace Management Portal, where you can manage and edit your listings. | 
| Current keywords | The keywords you provided in the Update product information section of the AWS Marketplace Management Portal.  | 
| Top performing keywords | The keywords that appear in the top five customer searches for your product.  | 
| AWS-recommended keywords | The keywords that customers use the most when searching for similar products. | 
| Estimated traffic gain % | The potential traffic gain if you adopt the recommended keywords. Not affected by the date filter. | 

**Note**  
While keywords are important, other factors can affect search results.  
Listing optimization   
 Optimize other parts of your listing, such as short and long descriptions. 
Consider offering features such as free trials to enhance your listing's appeal. 
Matching keywords with listings and target customers  
As much as possible, match your listings with frequently used keywords.
Use only the keywords relevant to your products and their features. Otherwise, your listings may appear in a larger number of searches, but fewer users will choose them. 
Understanding keyword variations  
Remember that similar terms, such as "git" and "gitops" may be treated as the same search term.
Evaluate the relevance of any variations and adjust your keywords accordingly.
Updating keywords  
In the AWS Marketplace Management Portal, open the **Products** menu and select a product category.
Choose the link to your product, choose the **Product information** tab, and navigate to the **Provide product information** page. 
Scroll down to the **AWS Marketplace discoverability** section, find **Keywords for AWS Marketplace search results**, and adjust your keywords. 

## Section 6: Top searched keywords by product category
<a name="top-keywords-by-product-category"></a>

The top five customer search keywords in each product category for products similar to yours. Other product and date filters on this dashboard don't affect this data.

# Understanding Buy with AWS dashboards
<a name="buy-with-aws-dashboard"></a>

The **Buy with AWS** dashboard provides an overview of the web traffic, engagements, and agreements created by the customers who choose your **Buy with AWS** call-to-action buttons and visit your **Buy with AWS** procurement page on AWS Marketplace.

For information about accessing the dashboard, see [Seller dashboards](dashboards.md), earlier in this guide.

**Topics**
+ [Section 1: Filters](#buy-with-aws-filters)
+ [Section 2: Summary metrics](#buy-with-aws-summary-metrics)
+ [Section 3: Total clicks and trend data for page views and total agreements](#buy-with-aws-clicks-views)
+ [Section 4: AWS sign-in page drop-off rate](#buy-with-aws-drop-off-rate)
+ [Section 5: Engagement on the Buy with AWS procurement page](#buy-with-aws-engagements)
+ [Section 6: Trend data for engagement metrics on the Buy with AWS procurement page](#buy-with-aws-procurement-page-trends)

## Section 1: Filters
<a name="buy-with-aws-filters"></a>

 This section provides the following data filters. 


|  Filter name  |  Description  | 
| --- | --- | 
| Product title | The title of the product.  | 
| Product ID | The friendly unique identifiers for the software products. | 
| Date filter | Filter by the past 30, 60, or 90 days, the trailing 12 months, or the year to date. Choose Custom to enter other start and end dates.  | 

For more information about filtering, see [Filtering data on Quick](https://docs.aws.amazon.com/quicksight/latest/user/adding-a-filter.html) in the *Quick User Guide*. 

## Section 2: Summary metrics
<a name="buy-with-aws-summary-metrics"></a>

This section displays information about the **Buy with AWS** call-to-action buttons and the **Buy with AWS** procurement page.

The following table lists and describes the metrics. To update the date range, change the date criteria in the **Filters** section.


|  Metric  |  Description  | 
| --- | --- | 
| Total button clicks  | The total number of clicks on the call-to-action buttons, such as Buy with AWS, on the seller website.  | 
| Number of Buy with AWS page views  | The total number of visits to the Buy with AWS procurement page. This includes repeat visits. | 
| Total agreements from Buy with AWS page  | The total number of agreements created on the Buy with AWS procurement page.   | 

## Section 3: Total clicks and trend data for page views and total agreements
<a name="buy-with-aws-clicks-views"></a>

This section provides monthly or weekly trends for a specified date range. The following table lists and describes the KPIs:


| Metric | Description | 
| --- | --- | 
| **Total button clicks** | The total clicks on the call-to-action buttons on the seller website. | 
| **Page views** | The total page visits to the **Buy with AWS** procurement page. Use the **Display data by** list to choose between monthly and weekly views. | 
| **Total agreements** | The total agreements created on the **Buy with AWS** procurement page. Use the **Display data by** list to choose between monthly and weekly views. | 

## Section 4: AWS sign-in page drop-off rate
<a name="buy-with-aws-drop-off-rate"></a>

This section displays the drop-off rate for the AWS sign-in page. The rate is the ratio of users who signed in and created agreements to the number of users who only signed in. Use the **Display data by** list to filter by week or month.

## Section 5: Engagement on the Buy with AWS procurement page
<a name="buy-with-aws-engagements"></a>

This section provides summary metrics and trend data for a specified date range. The following table lists and describes the metrics. Use the date field in the filter section to update the date range.


| Metric | Description | 
| --- | --- | 
| Total number of unique visitors | The total number of unique procurement page users. | 
| Bounce rate | The ratio of users who sign in and leave after viewing one site page to those who visit more than one page. | 
| Average user dwell time in minutes | The time between when the user signed in and when that user left the page. | 

## Section 6: Trend data for engagement metrics on the Buy with AWS procurement page
<a name="buy-with-aws-procurement-page-trends"></a>

The charts display monthly or weekly trends for the metrics in [section 5](#buy-with-aws-engagements). Use the **Display data by** list to choose between monthly and weekly views.  