本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 加入 AWS Marketplace Commerce Analytics Service
<a name="on-boarding-guide"></a>

透過 AWS Marketplace Commerce Analytics Service，您可以透過程式設計方式存取產品和客戶資料 AWS Marketplace。若要開始使用 AWS Marketplace Commerce Analytics Service，您必須設定 AWS 帳戶 和 AWS 服務 以使用 AWS Marketplace Commerce Analytics Service。這些區段說明如何設定 AWS 帳戶 和 AWS 服務 以使用 AWS Marketplace Commerce Analytics Service。

**使用 AWS Marketplace Commerce Analytics 服務**
+ [步驟 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 帳戶 使用 許可設定您的
<a name="permissions-for-commerce-analytics"></a>

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 儲存貯體
<a name="create-a-destination-amazon-s3-bucket"></a>

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 主題
<a name="create-an-amazon-sns-topic-for-response-notifications"></a>

Commerce Analytics Service 會使用 Amazon SNS 傳送回應通知。服務會將訊息發佈至此主題，以在資料集可用或發生錯誤時通知您。如果您已有用於此目的的 Amazon SNS 主題，請繼續下一個步驟。

如果您沒有為此服務設定 Amazon SNS 主題，請立即設定。如需說明，請參閱[建立主題](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html)。

為您建立的主題記錄主題 Amazon Resource Name (ARN)，因為呼叫 服務需要 ARN。

## 步驟 4：註冊 Commerce Analytics Service 計畫
<a name="enroll-in-the-commerce-analytics-service-program"></a>

在您使用儲存貯體主題和名稱的 ARN 設定服務之後，Commerce Analytics Service 會存取 Amazon S3 儲存貯體和 Amazon SNS 主題。

**啟用存取**

1. [AWS Marketplace 管理入口網站](https://aws.amazon.com/marketplace/management/) 使用 AWS 帳戶 您用來管理 AWS Marketplace 產品的 登入 。

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 才能呼叫 服務。

**注意**  
加入 Commerce Analytics Service 會在您的 中建立 IAM 角色 AWS 帳戶。IAM 角色允許 AWS Marketplace 寫入 Amazon S3 儲存貯體，並將通知發佈至 Amazon SNS 主題。 AWS Marketplace 會使用帳戶 452565589796 使用此 IAM 角色執行這些相關動作。

## 步驟 5：驗證您的組態
<a name="verify-your-configuration"></a>

最後一個步驟是驗證您的組態是否如預期般運作。

**若要測試組態**

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 格式將 取代`{TODAY'S DATE}`為目前日期，`YYYY-MM-DDT00:00:00Z`其中 `YYYY`是四位數年份， `MM` 是兩位數月份，而 `DD`是兩位數日期。
+  對於 `--role-name-arn`，請將 `{YOUR-ROLE-NAME-ARN}`取代為您從 中註冊程序取得之角色的 ARN[步驟 4：註冊 Commerce Analytics Service 計畫](#enroll-in-the-commerce-analytics-service-program)。
+  對於 *--destination-s3-bucket-name*，請以您在 中建立的 Amazon S3 儲存貯體名稱取代 *\$1amzn-s3-demo-bucket\$1*[步驟 2：建立目的地 Amazon S3 儲存貯體](#create-a-destination-amazon-s3-bucket)。
+  對於 *–sns-topic-arn*，請將 *\$1YOUR-SNS-TOPIC-ARN\$1* 取代為您在 中建立的 Amazon SNS 主題[步驟 3：為回應通知設定 Amazon SNS 主題](#create-an-amazon-sns-topic-for-response-notifications)。

如果您收到包含來自 服務的 *dataSetRequestId* 回應的回應，表示您已完成加入程序。成功的回應如下所示：

```
{
   "dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab"
}
```