本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 面向 AWS Marketplace 卖家的其他计划、工具和助手 AWS Marketplace 为您提供了可用于销售和管理产品的卖家工具。您可以使用这些工具深入了解自己的客户群，帮助更好地了解自己的销售情况。本主题提供有关这些工具的信息以及指向其他资源的链接。 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management/) 是在 AWS Marketplace 上销售产品的主要工具。利用 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management/tour) 中提供的进入市场活动，您可以管理产品，增加渠道收入。有关更多信息，请参阅 [AWS Marketplace 管理门户](user-guide-for-sellers.md#aws-marketplace-management-portal)。 AWS Marketplace 提供以下其他卖家工具： + **AWS Marketplace 管理门户 中的更多资源** – 如果您打开 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management/) 并登录，则可以在主页的 **Marketplace 资源**部分看到指向其他资源的链接。例如，要在产品发布前 90 天内和发布后 90 天内获得营销支持，您可以在 **Marketplace 资源**下查看 AWS Marketplace 管理门户 主页上的 [为期 180 天的 GTM Academy](product-marketing.md#gtm-academy) 链接。 + **AWS Marketplace Commerce Analytics Service **– 使用 AWS Marketplace Commerce Analytics Service，您可以通过 AWS Marketplace 以编程方式访问产品和客户数据。在注册服务之后，您可以通过 AWS 开发工具包查看自己的使用情况、订阅以及账单报告。有关更多信息，请参阅 [使用 AWS Marketplace 商务分析服务访问产品和客户数据](commerce-analytics-service.md)。 + **AWS Marketplace 现场演示计划（FDP）**– FDP 支持 AWS 现场团队（内部批准的 AWS 员工）通过 AWS Marketplace 免费使用某些产品和解决方案。有关更多信息，请参阅 [AWS Marketplace 现场演示计划](field-demonstration-program.md)。 + **卖家报告、数据源和控制面板** - AWS Marketplace 提供用于收集和分析产品销售信息的工具。有关更多信息，请参阅 [中的卖家报告、数据源和控制面板 AWS Marketplace](reports-and-data-feed.md)。 有关更多信息，请参阅以下主题。 **Topics** + [使用 AWS Marketplace 商务分析服务访问产品和客户数据](commerce-analytics-service.md) + [AWS Marketplace 现场演示计划](field-demonstration-program.md) + [AWS 合作伙伴助理](partner-assistant.md) + [什么是指定记录卖家（DSOR）计划？](designated-seller-of-record.md) # 使用 AWS Marketplace 商务分析服务访问产品和客户数据 借助 AWS Marketplace 商务分析服务，您可以通过 AWS Marketplace以编程方式访问产品和客户数据。注册该服务后，您可以通过访问使用情况、订阅和账单报告 AWS SDKs。您使用开发工具包工具请求的数据，将以数据集的形式交付到您的 AWS 账户 。大多数数据集对应的数据与 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management/tour) 上提供的基于文本的报告相同。您可以请求特定日期的数据集，该数据将交付到所提供的 Amazon S3 存储桶。您可以通过 Amazon Simple Notification Service（Amazon SNS）接收数据传输通知。本主题提供使用 AWS Marketplace 商务分析服务的条款和条件。 以下可视化流程显示了 Commerce Analytics Service 如何在 AWS Marketplace 中访问您的产品和客户数据，并将其作为数据集传输到您的 Amazon S3 存储桶，并通过 Amazon SNS 启动通知。 ![\[Commerce Analytics Service Overview.\]](http://docs.aws.amazon.com/zh_cn/marketplace/latest/userguide/images/commerce-analytics-service-overview.png) ## 条款和条件 这些 AWS Marketplace 商业分析服务条款和条件（这些 “**CAS 条款**”）包含特定于您使用和访问 AWS Marketplace 商务分析服务（“**CA 服务**”）的条款和条件，自您点击这些 CAS 条款中显示的 “我接受” 按钮或复选框之日起生效，或者如果更早的话，则在您使用任何 CA 服务产品时生效。**这些 CAS 条款是您与 Amazon Web Services, Inc.（“**AWS**”、“**我们**” 或 “**我们**的”）之间的《**AWS Marketplace 卖家**条款和条件》（“卖家条款”）的附录，其条款特此纳入此处。 AWS Marketplace **在这些 CAS 条款与 AWS Marketplace 卖家条款发生冲突时，这些 CAS 条款的条款和条件适用，但仅限于发生此类冲突和使用 CA 服务的场合。此处使用但未定义的大写术语应具有卖方条款中 AWS Marketplace 规定的含义。 1. **CA 服务和 CAS 数据。**要获得加州服务的访问资格，您必须是受现有 AWS Marketplace 卖家条款约束的 AWS Marketplace 卖家。您收到或可以访问的与 CA 服务相关的信息和数据（“C **AS 数据**”）构成订阅者信息，并受 AWS Marketplace 卖方条款中规定的限制和义务的约束。您可以在保密的基础上使用 CAS 数据来改进和定位与您的 AWS Marketplace 内容相关的营销和其他促销活动，前提是您不要 (a) 向任何第三方披露 CAS 数据；(b) 以任何不符合适用的隐私政策或法律的方式使用任何 CAS 数据；(c) 联系订阅者以影响他们进行其他购买 AWS Marketplace；(d) 贬低我们、我们的关联公司或他们或我们各自的任何产品；或 (e) 基于预期接收者是目标接收者的任何形式的目标通信 AWS Marketplace 订阅者。 1. **CA 服务限制和安全性。**您仅通过 CA 服务文档中所述的方法访问（或尝试访问）CA 服务。在使用 CA 服务时，您不会歪曲或掩盖您的身份或您的客户身份。我们保留权利对您使用 CA 服务设置和实施限制 (由我们自行决定)，包括但不限于在任何时间段内允许访问 CA 服务的连接、调用和服务器数。您同意并且不会尝试绕过这些限制。如果我们认为您可能违反了这些 CAS 条款或滥用了 CA 服务，我们保留权利限制、暂停或终止您访问 CA 服务的权利。 1. **CA 服务凭证保密性和安全性。**CA 服务凭证（例如密码、密钥和客户端 IDs）旨在供您用来识别您的 API 客户端。应由您全权负责保证您的凭证的机密性，并采取一切合理的措施以避免泄露、传播或未经授权使用此类凭证，至少包括您为保护自己的类似性质的机密信息而采取的措施。CA 服务凭证不得嵌入在开源项目中。应由您全权负责使用您的凭证对 CA 服务进行的任何和所有访问。 1. **修改。**我们可以随时修改这些 CAS 条款，方法是在 AWS 网站上发布修订版或根据 AWS Marketplace 卖家条款向您发出通知。修改的条款将在发布后生效，或者如果我们通过电子邮件通知您，则在电子邮件中指定的日期生效。在对这些 CAS 条款进行的任何修改的生效日期后，一经继续使用或访问 CA 服务，即表示您同意受修改的条款的约束。 1. **终止。**在由于任何原因终止您的 AWS Marketplace 卖家条款后，这些 CAS 条款以及在此处授予的 CAS 数据使用权利将会终止，可能会通知您，也可能不会。此外，我们可能还会随时由于任何原因或无任何理由停止提供 CA 服务或终止您对 CA 服务的访问。 ## 开始使用 有关 AWS Marketplace 商务分析服务的更多信息，包括入门、技术实施和故障排除信息，请参阅以下主题。 **Topics** + [条款和条件](#terms-and-conditions) + [开始使用](#commerce-analytics-service-getting-started) + [加入 AWS Marketplace 商务分析服务](on-boarding-guide.md) + [将 AWS Marketplace 商务分析服务与 AWS CLI 和一起使用 适用于 Java 的 AWS SDK](technical-implementation-guide.md) + [使用 AWS Marketplace Commerce Analytics Service 生成数据集](technical-documentation.md) + [对 AWS Marketplace 商务分析服务进行故障排除](cas-troubleshooting.md) # 加入 AWS Marketplace 商务分析服务 借助 AWS Marketplace 商务分析服务，您可以通过 AWS Marketplace以编程方式访问产品和客户数据。要开始使用 AWS Marketplace 商务分析服务，您必须配置 AWS 账户 和 AWS 服务 才能使用 AWS Marketplace 商务分析服务。这些部分向您展示如何配置 AWS 账户 和 AWS 服务 使用 AWS Marketplace 商务分析服务。 **使用 AWS Marketplace 商务分析服务** + [第 1 步：设置 AWS 账户 您的权限](#permissions-for-commerce-analytics) + [第 2 步：创建目标 Amazon S3 存储桶](#create-a-destination-amazon-s3-bucket) + [第 3 步：配置用于响应通知的 Amazon SNS 主题](#create-an-amazon-sns-topic-for-response-notifications) + [第 4 步：注册到 Commerce Analytics Service 计划](#enroll-in-the-commerce-analytics-service-program) + [第 5 步：验证您的配置](#verify-your-configuration) ## 第 1 步：设置 AWS 账户 您的权限 AWS Marketplace **强烈**建议使用 AWS Identity and Access Management (IAM) 角色登录， AWS Marketplace 管理门户 而不是使用您的根账户证书。请参阅 [AWS Marketplace 卖家的政策和权限](detailed-management-portal-permissions.md) 以了解 AWS Marketplace Commerce Analytics Service 权限的特定 IAM 权限。在为访问您的账户的人员创建单独的用户时，您可授予每个用户一组独特的安全凭证。您还可向每个用户授予不同的权限。如有必要，您可随时更改或撤销用户的权限。 ## 第 2 步：创建目标 Amazon S3 存储桶 Commerce Analytics Service 将请求的数据传输到您指定的 Amazon S3 存储桶。如果您已有 Amazon S3 存储桶可供使用，请继续到下一个步骤。 如果您没有 Amazon S3 存储桶，或者希望为此数据专门创建新 Amazon S3 存储桶，请参阅[如何创建 Amazon S3 存储桶](https://docs.aws.amazon.com/AmazonS3/latest/UG/CreatingaBucket.html)。 ## 第 3 步：配置用于响应通知的 Amazon SNS 主题 Commerce Analytics Service 使用 Amazon SNS 传输响应通知。在您的数据集可用或者出错时，该服务发布消息到此主题来通知您。如果您已有 Amazon SNS 主题用于此用途，请继续到下一步。 如果您没有为此服务配置 Amazon SNS 主题，请立即配置一个。有关说明，请参阅[创建监视器](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html)。 记录您所创建主题的 Amazon 资源名称（ARN），因为调用服务时需要此 ARN。 ## 第 4 步：注册到 Commerce Analytics Service 计划 在您使用主题的 ARN 和 Amazon S3 存储桶名称配置服务之后，Commerce Analytics Service 会访问该存储桶和 Amazon SNS 主题。 **启用访问** 1. 使用 AWS 账户 您用来管理 AWS Marketplace 商品的，登录到。[AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management/) 1. 确保您拥有注册到 AWS Marketplace Commerce Analytics Service 所[必须的 IAM 权限](https://docs.aws.amazon.com/marketplace/latest/userguide/commerce-analytics-service.html#technical-implementation-guide)。 1. 导航到 [Commerce Analytics Service 注册页面](https://aws.amazon.com/marketplace/management/cas/enroll)。 1. 输入 Amazon S3 存储桶名称和 Amazon SNS 主题 ARN，然后选择**注册**。 1. 在权限页面上，选择**允许**。 1. 在 AWS Marketplace 管理门户，在成功消息中记录**角色名称 ARN**。您将需要使用该 ARN 来调用服务。 **注意** 加入商务分析服务会在您 AWS 账户的 IAM 角色中创建。IAM 角色 AWS Marketplace 允许写入 Amazon S3 存储桶并向亚马逊 SNS 主题发布通知。 AWS Marketplace 使用账户 452565589796 与此 IAM 角色执行这些关联的操作。 ## 第 5 步：验证您的配置 最后一步是验证您的配置是否按预期运行。 **测试配置** 1. 下载、安装和配置 [AWS 命令行界面](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html)（AWS CLI）。 1. 使用 AWS CLI，运行此命令。 ``` aws marketplacecommerceanalytics generate-data-set \ --data-set-type "customer_subscriber_hourly_monthly_subscriptions" \ --data-set-publication-date "{TODAY'S-DATE}" \ --role-name-arn "{YOUR-ROLE-NAME-ARN}" \ --destination-s3-bucket-name "{amzn-s3-demo-bucket}" \ --destination-s3-prefix "TEST_PREFIX" \ --sns-topic-arn "{YOUR-SNS-TOPIC-ARN}" ``` + 对于 `--data-set-publication-date`，使用 ISO-8601 格式 (`YYYY-MM-DDT00:00:00Z`) 的当前日期替换 `{TODAY'S DATE}`，其中 `YYYY` 是四位数的年份，`MM` 是两位数的月份，`DD` 是两位数的天。 + 对于 `--role-name-arn`，请将 `{YOUR-ROLE-NAME-ARN}` 替换为您在[第 4 步：注册到 Commerce Analytics Service 计划](#enroll-in-the-commerce-analytics-service-program)中的注册过程中收到的角色 ARN。 + 对于 *--destination-s3-bucket-name*，将 *\$1amzn-s3-demo-bucket\$1* 替换为您在[第 2 步：创建目标 Amazon S3 存储桶](#create-a-destination-amazon-s3-bucket)中创建的 Amazon S3 存储桶的名称。 + 对于 *— sns-topic-arn*，将 *\$1YOUR-SNS-TOPIC-ARN\$1* 替换为您在中创建的亚马逊 SNS 主题。[第 3 步：配置用于响应通知的 Amazon SNS 主题](#create-an-amazon-sns-topic-for-response-notifications) 如果您收到来自该服务的回复，包括*dataSetRequest身份证*回复，则说明您已完成入职流程。成功的响应类似于以下内容： ``` { "dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab" } ``` # 将 AWS Marketplace 商务分析服务与 AWS CLI 和一起使用 适用于 Java 的 AWS SDK 借助 AWS Marketplace 商务分析服务，您可以通过 AWS Marketplace以编程方式访问产品和客户数据。 AWS Marketplace 商务分析服务通过 [AWS 软件开发工具包](https://aws.amazon.com/tools/)提供。您可以使用 [AWS CLI](https://aws.amazon.com/cli/) 和 [适用于 Java 的 AWS SDK](https://aws.amazon.com/sdk-for-java/) 与 Commerce Analytics Service 进行交互。这些部分向您展示了如何使用 AWS CLI 和适用于 Java 的 SDK 来实现商务分析服务。 **Topics** + [Commerce Analytics Service 的 IAM 策略](#aws-marketplace-commerce-analytics-iam-permissions) + [使用提出请求 AWS CLI](#making-requests-with-aws-cli) + [向提出请求 适用于 Java 的 AWS SDK](#making-requests-with-aws-java-sdk) ## Commerce Analytics Service 的 IAM 策略 要允许您的用户使用 Commerce Analytics Service，需要以下权限。 使用以下 IAM 权限策略注册 AWS Marketplace 商务分析服务。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iam:ListRoles", "iam:CreateRole", "iam:CreatePolicy", "iam:AttachRolePolicy", "aws-marketplace-management:viewReports" ], "Resource": "*" } ] } ``` ------ 使用以下 IAM 权限策略允许用户向 AWS Marketplace Commerce Analytics Service 提出请求。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "marketplacecommerceanalytics:GenerateDataSet", "Resource": "*" } ] } ``` ------ 有关更多信息，请参阅《IAM 用户指南》**中的[在 IAM 控制台中创建策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-json-editor)。 ## 使用提出请求 AWS CLI 首先，请下载 [AWS CLI](https://aws.amazon.com/cli/)。以下 AWS CLI 示例请求获取 2017 年 10 月 1 日的 “**每小时/每月订阅**” 数据集。此数据集将使用前缀 **demo-prefix** 发布到 **demo-bucket** Amazon S3 存储桶，而通知消息将传输到 **demo-topic** Amazon SNS 主题。 ``` aws marketplacecommerceanalytics generate-data-set \ --data-set-type "customer_subscriber_hourly_monthly_subscriptions" \ --data-set-publication-date "2017-10-01T00:00:00Z" \ --role-name-arn "arn:aws:iam::123412341234:role/MarketplaceCommerceAnalyticsRole" \ --destination-s3-bucket-name "demo-bucket" \ --destination-s3-prefix "demo-prefix" \ --sns-topic-arn "arn:aws:sns:us-west-2:123412341234:demo-topic" ``` 此请求返回对每个请求唯一的标识符。您可以使用此标识符将请求与发布到 Amazon SNS 主题的通知关联。以下是此标识符的示例。 ``` { "dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab" } ``` ## 向提出请求 适用于 Java 的 AWS SDK 要开始，请下载 [AWS Java SDK](https://aws.amazon.com/sdk-for-java/)。以下 适用于 Java 的 AWS SDK 示例请求获取 2015 年 10 月 1 日的 “**每小时/每月订阅**” 数据集。此数据集将使用前缀 **demo-prefix** 发布到 **demo-bucket** Amazon S3 存储桶，而通知消息将传输到 **demo-topic** Amazon SNS 主题。 ``` /* * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). * You may not use this file except in compliance with the License. * A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either * express or implied. See the License for the specific language governing * permissions and limitations under the License. */ import java.text.DateFormat; import java.text.ParseException; import java.text.SimpleDateFormat; import java.util.Date; import java.util.TimeZone; import com.amazonaws.AmazonClientException; import com.amazonaws.AmazonServiceException; import com.amazonaws.auth.AWSCredentials; import com.amazonaws.auth.profile.ProfileCredentialsProvider; import com.amazonaws.regions.Region; import com.amazonaws.regions.Regions; import com.amazonaws.services.marketplacecommerceanalytics.AWSMarketplaceCommerceAnalyticsClient; import com.amazonaws.services.marketplacecommerceanalytics.model.GenerateDataSetRequest; import com.amazonaws.services.marketplacecommerceanalytics.model.GenerateDataSetResult; /** * This sample demonstrates how to make basic requests to the AWS Marketplace Commerce * Analytics service using the 适用于 Java 的 AWS SDK. *

* Prerequisites: Follow the on-boarding guide: {URL OR SOMETHING} *

* Fill in your AWS access credentials in the provided credentials file * template, and be sure to move the file to the default location * (~/.aws/credentials) where the sample code will load the credentials from. *

* WARNING: To avoid accidental leakage of your credentials, DO NOT keep * the credentials file in your source directory. *

* http://aws.amazon.com/security-credentials */ public class MarketplaceCommerceAnalyticsSample { public static void main(String[] args) throws ParseException { /* * The ProfileCredentialsProvider will return your [default] * credential profile by reading from the credentials file located at * (~/.aws/credentials). */ AWSCredentials credentials = null; try { credentials = new ProfileCredentialsProvider().getCredentials(); } catch (Exception e) { throw new AmazonClientException("Cannot load the credentials from the credential profiles " + "file. Make sure that your credentials file is at the correct " + "location (~/.aws/credentials), and is in valid format.", e); } AWSMarketplaceCommerceAnalyticsClient client = new AWSMarketplaceCommerceAnalyticsClient(credentials); Region usEast1 = Region.getRegion(Regions.US_EAST_1); client.setRegion(usEast1); System.out.println("==============================================================="); System.out.println("Getting Started with AWS Marketplace Commerce Analytics Service"); System.out.println("===============================================================\n"); // Create a data set request with the desired parameters GenerateDataSetRequest request = new GenerateDataSetRequest(); request.setDataSetType("customer_subscriber_hourly_monthly_subscriptions"); request.setDataSetPublicationDate(convertIso8601StringToDateUtc("2014-06-09T00:00:00Z")); request.setRoleNameArn("arn:aws:iam::864545609859:role/MarketplaceCommerceAnalyticsRole"); request.setDestinationS3BucketName("awsmp-goldmine-seller"); request.setDestinationS3Prefix("java-sdk-test"); request.setSnsTopicArn("arn:aws:sns:us-west-2:864545609859:awsmp-goldmine-seller-topic"); System.out.println( String.format("Creating a request for data set %s for publication date %s.", request.getDataSetType(), request.getDataSetPublicationDate())); try { // Make the request to the service GenerateDataSetResult result = client.generateDataSet(request); // The Data Set Request ID is a unique identifier that you can use to correlate the // request with responses on your Amazon SNS topic System.out.println("Request successful, unique ID: " + result.getDataSetRequestId()); } catch (AmazonServiceException ase) { System.out.println("Caught an AmazonServiceException, which means your request made it " + "to the AWS Marketplace Commerce Analytics service, but was rejected with an " + "error response for some reason."); System.out.println("Error Message: " + ase.getMessage()); System.out.println("HTTP Status Code: " + ase.getStatusCode()); System.out.println("AWS Error Code: " + ase.getErrorCode()); System.out.println("Error Type: " + ase.getErrorType()); System.out.println("Request ID: " + ase.getRequestId()); } catch (AmazonClientException ace) { System.out.println("Caught an AmazonClientException, which means the client encountered " + "a serious internal problem while trying to communicate with the AWS Marketplace" + "Commerce Analytics service, such as not being able to access the " + "network."); System.out.println("Error Message: " + ace.getMessage()); } } private static Date convertIso8601StringToDateUtc(String dateIso8601) throws ParseException { TimeZone utcTimeZone = TimeZone.getTimeZone("UTC"); DateFormat utcDateFormat = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ssX"); utcDateFormat.setTimeZone(utcTimeZone); return utcDateFormat.parse(dateIso8601); } } ``` 您应该预期看与此示例类似的结果。 ``` =============================================================== Getting Started with AWS Marketplace Commerce Analytics Service =============================================================== Creating a request for data set customer_subscriber_hourly_monthly_subscriptions for publication date Sun Jun 08 17:00:00 PDT 2014. Request successful, unique ID: c59aff81-6875-11e5-a6d8-fd5dbcaa74ab ``` # 使用 AWS Marketplace Commerce Analytics Service 生成数据集 在 AWS Marketplace Commerce Analytics Service 中注册后，您可以通过 AWS CLI 和 适用于 Java 的 AWS SDK 查看自己的使用情况、订阅以及账单报告。您使用开发工具包工具请求的数据，将以数据集的形式交付到您的 AWS 账户。大多数数据集对应的数据与 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management/tour) 上提供的基于文本的报告相同。有关更多信息，请参阅 [使用 AWS Marketplace 商务分析服务访问产品和客户数据](commerce-analytics-service.md)。以下各节提供了与 Commerce Analytics Service 生成的数据集相关的参数、响应和输出的信息。 **Topics** + [`GenerateDataSet` 参数](#generate-data-set-parameters) + [响应](#responses) + [输出](#outputs) ## `GenerateDataSet` 参数 AWS Marketplace Commerce Analytics Service 公开了一个方法 `GenerateDataSet`，您可以使用该方法请求将数据集发布到 Amazon S3 存储桶。下表中列出了 `GenerateDataSet` 的参数。 **数据集参数** | **字段** | **描述** | | --- | --- | | 数据集类型 | 此数据集将作为请求的结果返回。 | | 数据集发布日期 | 发布数据集的日期。 对于每日数据集，请为所需日期提供具有天级别粒度的日期。 对于每月数据集，请为所需月份提供具有月级别粒度的日期。忽略天值。 | | 角色名称 ARN | 角色的 ARN，该角色附加了用于向服务提供对您资源的访问权限的权限策略。 | | 目标 Amazon S3 存储桶名称 | 目标 Amazon S3 存储桶的名称（易于识别的名称，而非 ARN）。您的数据集将发布到此位置。 | | 目标 Amazon S3 前缀 | （可选）已发布数据集的 Amazon S3 前缀，类似于标准文件系统中的目录路径。 例如，如果给定存储桶名称 `mybucket` 以及前缀 `myprefix/mydatasets`，则输出文件将发布到 `s3://amzn-s3-demo-bucket/myprefix/mydatasets/outputfile`。 如果前缀目录结构不存在，则会自动创建。 如果没有提供前缀，数据集将发布到 Amazon S3 存储桶根。 | | SNS 主题 ARN | 在发布数据集或者出现错误时，需要通知的 Amazon SNS 主题的 ARN。 | ## 响应 AWS Marketplace Commerce Analytics Service 返回两个响应。第一个是立即返回的同步响应，第二个是使用 Amazon SNS 返回的异步响应。同步响应类似于此示例。 **数据集参数** | **字段** | **描述** | | --- | --- | | 数据集请求 ID | 表示对服务的特定请求的唯一标识符。此标识符可用于将请求与 Amazon SNS 主题上的通知关联。 | 异步响应是 JSON 格式的文档，发布到 Amazon SNS 主题，与此示例类似。 **数据集参数** | **字段** | **描述** | | --- | --- | | 数据集 S3 位置 | 已交付数据集的存储桶名称和密钥。 | | 数据集元数据 S3 位置 | 已交付数据集元数据文件的存储桶名称和密钥。 | | 数据集请求 ID | 表示对服务的特定请求的唯一标识符。此标识符可用于将请求与 Amazon SNS 主题上的通知关联。 | | 成功 | 如果操作成功，则为 True；否则为 False。 | | 消息 | （可选）如果出现错误（例如，“Success”为“False”），此消息将包含有关故障的信息。 | **JSON 格式的异步响应示例** ``` {     "dataSetS3Location":{    "bucketName":"demo-bucket",  "key":"demo-prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.csv" }, "dataSetMetaDataS3Location":{   "bucketName":"demo-bucket",   "key":"demo-prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.meta.json" }, "dataSetRequestId":"f65b7244-6862-11e5-80e2-c5127e17c023", "success":true } ``` ## 输出 成功请求之后，请求的数据集将以 .csv 文件的格式交付到您的 Amazon S3 存储桶。JSON 格式的元数据文件将发布到与数据集文件相同的位置。元数据文件提供了有关数据集和原始请求参数的有用信息。元数据文件与数据集文件具有相同名称，但以扩展名 .meta.json 结尾。下表列出了 .csv 文件中的元数据字段。 **元数据字段** | **字段** | **描述** | | --- | --- | | 数据集请求 ID | 表示对服务的特定请求的唯一标识符。此标识符可用于将请求与 Amazon SNS 主题上的通知关联。 | | 数据集覆盖范围 | 定义数据覆盖范围的开始日期/时间和结束日期/时间。这些日期采用 ISO 8601 格式。 | | 数据集请求参数 | GenerateDataSet 方法的原始请求参数。 | | 数据集 S3 位置 | 已交付数据集的存储桶名称和密钥。 | | 数据集元数据 S3 位置 | 已交付数据集元数据文件的存储桶名称和密钥。 | 以下是 JSON 格式元数据内容的示例。 ``` { "dataSetRequestId": "43d7137b-8a94-4042-a09d-c41e87f371c1", "dataSetCoverageRange": { "startDateTime": "2014-06-08T00:00:00.000Z", "endDateTime": "2014-06-08T23:59:59.000Z" }, "dataSetRequestParameters": { "sellerAccountId": "123412341234", "dataSetType": "customer_subscriber_hourly_monthly_subscriptions", "dataSetPublicationDate": "2014-06-09T00:00:00.000Z", "roleNameArn": "arn:aws:iam::123412341234:role/MarketplaceCommerceAnalyticsRole", "destinationS3BucketName": "demo-bucket", "destinationS3Prefix": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions", "snsTopicArn": "arn:aws:sns:us-west-2:123412341234:demo-topic" }, "dataSetS3Location": { "bucketName": "demo-bucket", "key": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.csv" }, "dataSetMetaDataS3Location": { "bucketName": "demo-bucket", "key": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.meta.json" } } ``` 有关可用数据集的完整列表（包括可用日期），请参阅 [AWS SDK 文档](https://docs.aws.amazon.com/cli/latest/reference/marketplacecommerceanalytics/generate-data-set.html#options)。 # 对 AWS Marketplace 商务分析服务进行故障排除 您可以使用 AWS Marketplace 商务分析服务解决问题，该服务以编程方式提供来自 AWS Marketplace的产品和客户数据。当您遇到错误或其他配置问题时，您可能需要对 Commerce Analytics Service 进行故障排除。以下各节将指导您完成故障排除流程，包括诊断和解决 Commerce Analytics Service 常见问题的步骤。 **由于允许列表问题，我无法访问服务。** 如果您尚未在上注册为卖家 AWS Marketplace，请[AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management)访问注册。如果您已经注册为卖家 AWS Marketplace，请联系[https://aws.amazon.com/marketplace/management/contact-us/](https://aws.amazon.com/marketplace/management/contact-us/)团队。 **我无法请求过去某个日期的数据集，即使开发工具包文档说明此日期应该可用。** 即使过去特定日期的数据集列出为可用，但我们只有自您加入 AWS Marketplace日期之后的数据。如果您仍认为这是一个错误，请联系 [https://aws.amazon.com/marketplace/management/contact-us/](https://aws.amazon.com/marketplace/management/contact-us/)团队。 **当我调用服务时，我收到错误消息 “无法连接到终端节点 URL： https://marketplacecommerceanalytics.eu-central-1.amazonaws.com/”** AWS Marketplace 商务分析服务仅在美国东部（弗吉尼亚北部）地区提供。您必须将对 Commerce Analytics Service 的所有调用针对 `us-east-1` 端点。 如果您使用的是 AWS CLI，请在每个调用中添加 “`--region`标志并指定 AWS 区域 为`us-east-1`，如以下示例所示。 ``` aws marketplacecommerceanalytics generate-data-set \ --data-set-type "customer_subscriber_hourly_monthly_subscriptions" \ --data-set-publication-date "2016-04-21T00:00:00Z" \ --role-name-arn "arn:aws:iam::138136086619:role/MarketplaceCommerceAnalyticsRole" \ --destination-s3-bucket-name "marketplace-analytics-service" \ --destination-s3-prefix "test-prefix" \ --sns-topic-arn "arn:aws:sns:eu-central-1:138136086619:Marketplace_Analytics_Service_Notice" \ --region us-east-1 ``` **我希望使用与完成信息载入过程时所选的不同 Amazon S3 存储桶或 Amazon SNS 主题。** 注册 AWS Marketplace 商业分析服务时，您指定了 Amazon S3 存储桶和亚马逊 SNS 主题。载入过程会将您的 IAM 权限配置为仅允许服务访问这些特定资源。要使用不同的资源，您需要修改您的 IAM 策略： 1. 登录 AWS 管理控制台 并打开 IAM 控制台，网址为[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)。 1. 在 IAM 控制台的左侧，选择**角色**。 1. 选择 **MarketplaceCommerceAnalyticsRole**。 1. 如果尚未展开**内联角色**部分，请展开该部分。 1. 找到名称以 *oneClick\$1MarketplaceCommerceAnalyticsRole* 开头的策略，然后选择**编辑策略**。 1. 在策略文档中，找到指定与所要修改服务相关的操作的部分。例如，要更改 Amazon S3 存储桶，找到包含以 **s3:** 开头的操作的部分，更改相应的**资源**部分或者指定新的 Amazon S3 存储桶。 有关 IAM 策略的更多信息，请参阅以下指南：[https://docs.aws.amazon.com/IAM/latest/UserGuide/access\$1policies.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) **在调用 `GenerateDataSet` 操作时，我收到 `AccessDeniedException` 错误** 如果您的用户没有调用 `GenerateDataSet` 所需的权限，则会出现此情况。以下过程概述了使用 IAM 控制台创建具有这些权限的 IAM 策略以及向您的用户、组或角色添加权限所需的步骤。 **使用 JSON 策略编辑器创建策略** 1. 登录 AWS 管理控制台 并打开 IAM 控制台，网址为[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)。 1. 在左侧的导航窗格中，选择**策略**。 如果这是您首次选择**策略**，则会显示**欢迎访问托管式策略**页面。选择**开始使用**。 1. 在页面的顶部，选择**创建策略**。 1. 在**策略编辑器**部分，选择 **JSON** 选项。 1. 输入以下 JSON 策略文档： ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "marketplacecommerceanalytics:GenerateDataSet", "Resource": "*" } ] } ``` 1. 选择**下一步**。 **注意** 您可以随时在**可视化**和 **JSON** 编辑器选项卡之间切换。不过，如果您进行更改或在**可视化**编辑器中选择**下一步**，IAM 可能会调整策略结构以针对可视化编辑器进行优化。有关更多信息，请参阅*《IAM 用户指南》*中的[调整策略结构](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_policies.html#troubleshoot_viseditor-restructure)。 1. 在**查看并创建**页面上，为您要创建的策略输入**策略名称**和**描述**（可选）。查看**此策略中定义的权限**以查看策略授予的权限。 1. 选择**创建策略**可保存新策略。 要提供访问权限，请为您的用户、组或角色添加权限： + 中的用户和群组 AWS IAM Identity Center： 创建权限集合。按照《AWS IAM Identity Center 用户指南》**中[创建权限集](https://docs.aws.amazon.com//singlesignon/latest/userguide/howtocreatepermissionset.html)的说明进行操作。 + 通过身份提供商在 IAM 中托管的用户： 创建适用于身份联合验证的角色。按照《IAM 用户指南》**中[针对第三方身份提供商创建角色（联合身份验证）](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-idp.html)的说明进行操作。 + IAM 用户： + 创建您的用户可以担任的角色。按照《IAM 用户指南》**中[为 IAM 用户创建角色](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html)的说明进行操作。 + （不推荐使用）将策略直接附加到用户或将用户添加到用户组。按照《IAM 用户指南》**中[向用户添加权限（控制台）](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console)中的说明进行操作。 **此处未列出我的问题。** 联系 [https://aws.amazon.com/marketplace/management/contact-us/](https://aws.amazon.com/marketplace/management/contact-us/)团队。 # AWS Marketplace 现场演示计划 AWS Marketplace 现场演示计划 (FDP) 允许 AWS 现场团队（内部批准的 AWS 员工）免费使用某些产品和解决方案。 AWS Marketplace 获批 AWS 员工的例子可能包括解决方案架构师以及销售和营销专业人员。FDP 允许这些员工演示产品在融入教育和客户工作负载方面的能力。 支持以下产品类型： + [Amazon 机器映像 (AMIs)](ami-products.md) + [容器](container-based-products.md) + [机器学习算法和模型包 (SageMaker AI)](machine-learning-products.md) + [数据集 (AWS Data Exchange)](https://docs.aws.amazon.com/data-exchange/latest/userguide/what-is.html) **注意** 对于 AWS Data Exchange 产品，FDP 仅适用于公开优惠为 0 美元（免费）的产品。 对于启用了订阅验证的 AWS Data Exchange 产品，提供商需要批准订阅请求。有关订阅验证的更多信息，请参阅《AWS Data Exchange 用户指南》**中的[针对订阅用户的订阅验证](https://docs.aws.amazon.com/data-exchange/latest/userguide/subscription-verification-sub.html)。 当您注册为 AWS Marketplace 卖家时，您将自动注册加入 FDP 计划。要选择退出，请向 [AWS Marketplace 卖家运营](https://aws.amazon.com/marketplace/management/contact-us/)团队提交支持请求。 # AWS 合作伙伴助理 AWS Partner Assistant是基于人工智能的生成式聊天机器人，适用于 AWS Partner s 它可以从合作伙伴中心和 AWS Marketplace 管理门户 (AMMP) 访问，并使用 Amazon Q Business，该业务根据注册合作伙伴专有的文档进行培训。 **注意** 要访问 AWS 合作伙伴助手，合作伙伴必须将其 AWS 合作伙伴中心账户与其 AWS 账户关联起来。有关更多信息，请参阅[AWS 合作伙伴中心*入门指南中的将AWS 合作伙伴 AWS Marketplace *平台账户与卖家账户关联起来](https://docs.aws.amazon.com/partner-central/latest/getting-started/account-linking.html)。 聊天机器人提供与 AWS 服务、 AWS Marketplace 卖家指导以及 AWS 合作伙伴网络激励、福利和计划相关的各种主题的实时答案和文档摘要。如果聊天机器人无法提供响应，它会建议您如何向支持团队提交工单。您也可通过聊天界面内的点赞和点踩按钮提供反馈，助力提升聊天机器人的准确性和服务质量。 以下是与 AWS 合作伙伴助手的典型互动： 1. 提问：从 P AWS artner Central 或 AMMP 打开聊天机器人，然后使用日常语言提问。 1. AWS 合作伙伴助手处理请求：聊天机器人使用自然语言处理 (NLP) 来解释您的查询。 1. AWS Partner Assistant 生成响应：聊天机器人会返回相关响应，其中包括其他资源。 1. 提供反馈：聊天机器人提示您提交反馈。 ## 优势与功能 AWS Partner Assistant 提供自助服务选项，可改善对信息的访问。 + 即时答案：合作伙伴通常必须 AWS 直接联系寻求帮助，但 AWS 合作伙伴助手随时可用。 + 答案精准：合作伙伴可以及时收到实事求是的信息，响应差异极小。 + 自助服务支持：缩短查找相关资源所需的时间。 + 高级响应：提供自然、直观、类似人类的响应。 + 上下文理解：提供有关复杂主题的更多信息。 + 自学系统：通过互动持续学习，不断优化响应内容，扩充知识库。 + 可扩展支持：能够同时处理大量查询请求。 ## 如何使用 AWS 合作伙伴助手 1. 登录 [AWS 合作伙伴中心](https://partnercentral.awspartner.com/)或 [AMMP](https://aws.amazon.com/marketplace/management/signin)。 1. 访问聊天机器人： 1. 选择右下角的紫色悬浮图标。 1. 从建议的提示中选择一项，或开始在文本字段中键入您的问题。 1. 聊天机器人会返回含信息来源及链接的回应。 1. 从合作伙伴中心访问聊天机器人： 1. 选择**支持**菜单。 1. 从下拉列表中选择 “**与 AWS 合作伙伴助手即时聊天**”。 1. （可选）从支持工单访问聊天机器人。在提交支持请求之前，请选择 “**询问 AWS 合作伙伴助手**” 以立即获得答案。 1. 从 AMMP 访问聊天机器人： 1. 在 “**联系我们**” 页面中，选择 “**询问 AWS 合作伙伴助手**”。 1. （可选）从支持工单访问聊天机器人。提交支持工单前，先从**联系我们**页面选择**提交支持请求**，再选择**咨询 AWS Partner Assistant**，以获取即时回复。 1. （可选）提供反馈： 1. 每次收到响应后，可选择提交反馈：若响应满足需求，选择**点赞**； 1. 若响应无帮助，选择**点踩**。 1. 如果您选择**点踩**，请在文本框中补充详细说明，或者从下拉列表中选择最贴合“响应无帮助”的原因选项。 1. 也可通过聊天机器人窗口左下角的**反馈**按钮为使用体验评分：选择**反馈**打开含评分量表的弹出窗口。也可在文本字段中填写其他意见或反馈。 ## Partner Assistant 常见问题 以下是 AWS 合作伙伴助理的常见问题。 ### 什么是 AWS 合作伙伴助理？ AWS Partner Assistant 是一款由人工智能驱动的生成式聊天机器人，可帮助合作伙伴查找信息并回答问题。 ### 如何访问 AWS 合作伙伴助手？ AWS 合作伙伴助手适用于 AWS 合作伙伴和 Marketplace 卖家，但 Marketplace 买家不可用。您可以通过 AWS 合作伙伴中心或 M AWS arketplace 管理门户 (AMMP) 从任何页面访问聊天机器人。 ### AWS 合作伙伴助手是否随时可用？ 可以。 ### AWS 合作伙伴助手支持哪些语言？ 目前，P AWS artner Assistant 仅支持英语，但在 future 版本中将支持其他语言。 ### AWS 合作伙伴助理能做什么？ 聊天机器人提供有关 AWS 服务、 AWS Marketplace 卖家指导以及 AWS Partner 计划、激励措施和福利的实时答案和文档摘要。其数据来源于仅合作伙伴可访问的专属已发布内容库。 ### 我能问 AWS 合作伙伴助理什么？ 聊天机器人提供有关 AWS 服务、Marketpl AWS ace 卖家指南以及 AWS 合作伙伴网络计划、激励措施和福利的实时答案和文档摘要。其数据来源于仅合作伙伴可访问的专属已发布内容库。 ### 哪些问题我不应该问 AWS 合作伙伴助理？ 对于需要进行深入故障排除、账户验证或访问敏感数据的问题，请直接联系 AWS 客户支持。 ### AWS 合作伙伴助理能否提供个性化回复？ 目前， AWS 合作伙伴助手仅提供一般信息和指导。无法生成创意内容或执行具体任务。如果 AWS 合作伙伴助理无法充分回答您的问题，请提交支持请求或提交反馈。以下为补充示例： | **可咨询示例** | **不可咨询示例** | | --- | --- | | 在哪里可以查询我的层级续期日期？ | 我的层级续期日期是什么时候？ | | 如何注册一个路径？ | 帮助我们注册软件路径。 | | 如何申请 MSP 计划？ | 我能否申请 MSP 计划？ | **注意** 对于账户相关的问题，合作伙伴必须通过现有的 [AWS 支持渠道](https://aws.amazon.com/contact-us/)解决。 ### 合作伙伴能否使用 AWS 合作伙伴助手来更改其账户或服务？ 不能，但该工具可指导您如何进行这些更改，或者为您对接能够提供相关帮助的支持团队。 ### AWS 合作伙伴助理如何处理机密信息？ AWS Partner Assistant 旨在保护用户隐私和数据，但我们不建议共享敏感信息。 ### 如果 AWS 合作伙伴助理不理解我的问题会怎样？ 如果 P AWS artner Assistant 无法回答你的问题，请尝试重新措辞。此外，它也会引导您联系支持团队获取协助。这种情况下，建议您单击“点踩”并补充相关背景信息提交反馈，这将帮助我们提升聊天机器人的性能。您也可选择从常见分类的下拉列表中提交结构化反馈。 ### 如果 AWS 合作伙伴助理没有回复，我该怎么办？ 尝试刷新页面或重新启动应用程序。如果问题仍未解决，请向支持团队反馈该问题。 ### 如果 AWS 合作伙伴助理提供的信息不正确，我该怎么办？ 如果您认为 P AWS artner Assistant 为您提供了不正确的信息，请在会话结束时使用竖起大拇指选项提供反馈。 ### 如果我不想使用 AWS 合作伙伴助手，我能否将其关闭？ AWS 合作伙伴助手是一项可选功能。如果您不想使用它，可联系支持团队处理。 # 什么是指定记录卖家（DSOR）计划？ 借助指定记录卖家（DSOR）计划，独立软件供应商（ISV）能够授权 AWS 合作伙伴在 AWS Marketplace 上创建和管理软件即服务（SaaS）列表。这些授权合作伙伴可以充当 ISV 与其客户之间的中介，为 ISV 提供额外的软件上市渠道，助力其拓展渠道业务规模。 **注意** DSOR 计划仅限受邀者参加。合作伙伴可发送邮件至 [awsmp-dsor@amazon.com](mailto:awsmp-dsor@amazon.com) 申请加入。 ## 使用 DSOR 的优势 当 ISV 使用 DSOR 计划时，他们可以： + 通过 DSOR 合作伙伴网络扩大业务覆盖范围。 + 通过 AWS Marketplace 合作伙伴简化计费与开票流程。 + 依托成熟的渠道合作伙伴开拓新市场。 + 维持现有合同要求不变。 + 直接与 DSOR 合作伙伴协作，打造额外收入来源。 ## DSOR 模式 DSOR 计划提供了两种模式来满足不同的业务需求： **渠道模式** 渠道模式允许 DSOR 合作伙伴借助渠道合作伙伴专属优惠（CPPO）工具，使其下游渠道合作伙伴能够在 AWS Marketplace 上开展销售。如果 ISV 已有成熟的渠道合作关系，此模式尤为适用。 **注意** 从运营角度来看，DSOR CPPO 的工作原理类似于传统的 CPPO。有关 CPPO 资源的更多信息，请参阅[以 AWS Marketplace 渠道合作伙伴的身份创建专属优惠](channel-partner-offers.md)。 **直接模式** 直接模式允许 DSOR 合作伙伴代表 ISV 创建和管理产品列表。合作伙伴使用 AWS Marketplace 专属优惠直接与 AWS 客户进行交易。 这两种 DSOR 模式均面向具有以下需求的 ISV 而设计： + 将 DSOR 合作伙伴纳入其 AWS Marketplace 交易，以拓展渠道规模。 + 利用现有的分销运营工作流与流程。 ## DSOR 的工作原理 DSOR 流程运作方式如下： 1. ISV 授权 DSOR 合作伙伴为其管理和创建产品列表（合同）。 1. DSOR 合作伙伴创建受限的 SaaS 产品列表。 1. 客户或渠道合作伙伴在 AWS Marketplace 上查看和购买 ISV 重新上架的产品。 1. ISV 向客户交付 SaaS 产品。 1. AWS Marketplace 处理计费、收款和付款。 ## 使用 DSOR 的注意事项 当 ISV 决定使用 DSOR 计划时，应考虑以下事项： + 确保 DSOR 合作伙伴了解 ISV 的产品和定价策略。 + 与 DSOR 合作伙伴建立清晰的沟通渠道以获取更新和支持。 + 明确制定关于上架费用承担、专属优惠的优选途径以及向客户交付 SaaS 产品的治理规则。 + 仔细审查并充分理解与 DSOR 合作伙伴之间的收益分成模式。 + 准备好向 DSOR 合作伙伴提供持续的产品更新和支持。