翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Commerce Analytics Service AWS Marketplace へのオンボーディング
AWS Marketplace Commerce Analytics Service を使用すると、 を通じて製品と顧客データにプログラムでアクセスできます AWS Marketplace。Commerce Analytics Service AWS Marketplace の使用を開始するには、Commerce Analytics Service を使用する AWS のサービス ように AWS アカウント と AWS Marketplace を設定する必要があります。これらのセクションでは、Commerce Analytics Service を使用する AWS のサービス ように AWS アカウント と AWS Marketplace を設定する方法について説明します。
**Commerce Analytics Service 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 Commerce Analytics Service のアクセス許可の、特定の IAM のアクセス許可については、「[AWS Marketplace 販売者のポリシーとアクセス許可](detailed-management-portal-permissions.md)」を参照してください。お客様のアカウントにアクセスする人に対して個別 ユーザーを作成することにより、 ユーザーそれぞれに一意の認証情報を設定することができます。さらに、各 ユーザーにそれぞれ異なるアクセス権限を付与することもできます。必要な場合には、いつでも ユーザーのアクセス許可を変更、または無効にすることができます。
## ステップ 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 およびバケットの名前を使用してサービスを設定すると、Commerce Analytics Service は Amazon S3 バケットと Amazon SNS トピックにアクセスします。
**そのアクセスを有効にするには**
1. AWS Marketplace 製品の管理 AWS アカウント に使用する [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. [permissions (権限)] ページの [**Allow (許可)**] を選択します。
1. で AWS Marketplace 管理ポータル、成功メッセージに**ロール名 ARN** を記録します。サービスを呼び出すには ARN が必要です。
**注記**
Commerce Analytics Service へのオンボーディングにより、 に IAM ロールが作成されます AWS アカウント。IAM ロールにより、 AWS Marketplace は Amazon S3 バケットに書き込み、Amazon 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` で、`{TODAY'S DATE}` を ISO-8601 形式を使用して現在の日付 `YYYY-MM-DDT00:00:00Z` に置き換えます。`YYYY` は 4 桁の年、`MM` は 2 桁の月、`DD` は 2 桁の日を表します。
+ `--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 を、[ステップ 3: レスポンス通知用の Amazon SNS トピックを設定する](#create-an-amazon-sns-topic-for-response-notifications) で作成した Amazon SNS トピックに置き換えます。****
dataSetRequestId レスポンスが含まれているレスポンスをサービスから受信した場合は、オンボーディングプロセスが正常に完了しています。**正常な応答は次のようになります。
```
{
"dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab"
}
```