本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 加入 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*，将 *{amzn-s3-demo-bucket}* 替换为您在[第 2 步：创建目标 Amazon S3 存储桶](#create-a-destination-amazon-s3-bucket)中创建的 Amazon S3 存储桶的名称。
+ 对于 *— sns-topic-arn*，将 *{YOUR-SNS-TOPIC-ARN}* 替换为您在中创建的亚马逊 SNS 主题。[第 3 步：配置用于响应通知的 Amazon SNS 主题](#create-an-amazon-sns-topic-for-response-notifications)
如果您收到来自该服务的回复，包括*dataSetRequest身份证*回复，则说明您已完成入职流程。成功的响应类似于以下内容：
```
{
"dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab"
}
```