利用規約オンボーディングガイド技術的な実装ガイド技術ドキュメントトラブルシューティング

AWS Marketplace Commerce Analytics Service

AWS Marketplace Commerce Analytics Service を使用すると、AWS Marketplace を通じて製品および顧客データにプログラムでアクセスできます。サービスに登録すると、AWS SDK を通じてご利用状況、サブスクリプション、およびに請求レポートアクセスできます。

Commerce Analytics Service Overview.

SDK ツールを使用してリクエストしたデータは、データセットとして AWS アカウントに配信されます。ほとんどのデータセットは、AWS Marketplace 管理ポータルで利用可能なテキストベースのレポートと同じデータに対応します。特定の日付のデータセットをリクエストできます。データは指定先の Amazon S3 バケットに配信されます。データ配信の通知は、Amazon Simple Notiﬁcation Service (Amazon SNS) によって提供されます。

利用規約

これらの AWS Marketplace Commerce Analytics Service 規約 (これらの “CAS 規約”) は、AWS Marketplace Commerce Analytics Service (“CA サービス”) の使用およびアクセスに固有の規約を含み、「承認する」ボタンまたはこれらの CAS 規約を提示するチェックボックスをクリックした日付、あるいはそれ以前の場合は、CA サービスオファーを使用した日付の時点で効力を発します。これらの CAS 規約は、お客様と Amazon Web Services, Inc. (「AWS MarketplaceAWS」、「AWS Marketplace私たち」、「私たち」または「私たちの」 (これらの用語はこれによって統合されます)) の間のお客様と 販売者の規約 (「 販売者規約」) への付録です。これらの CAS 規約と AWS Marketplace 販売者規約の間に競合が発生した場合は、当該の競合の範囲内で、およびお客様の CA サービスの使用に関してのみ、これらの CAS 規約が適用されます。ここで使用されるがここで定義されていない大文字の用語は、AWS Marketplace 販売者規約に記述されている意味を持ちます。

CA サービスおよび CAS データ。CA サービスにアクセスする資格を持つには、既存の AWS Marketplace 販売者規約に縛られている AWS Marketplace 販売者である必要があります。CA サービス (「CAS データ」) に関連して受信する情報またはデータ、あるいはアクセス可能な情報またはデータは、サブスクライバー情報を含み、AWS Marketplace 販売者規約に記述されている制約および義務の対象です。(a) CAS データをいずれかのサードパーティーに開示せず、(b) 適用されるプライバシーポリシーまたは法律に反する方法で CAS データを使用せず、(c) AWS Marketplace 外で代替購入を行うようサブスクライバーに連絡せず、(d) 弊社、弊社の関連会社、あるいは関連会社または弊社の製品の評判を落とさず、(e) 意図される受信者が AWS Marketplace サブスクライバーであることにもとづいてあらゆる種類の通信をターゲットしない限り、CAS データを内密の取り扱いで使用して、AWS Marketplace Content に関連するマーケティングおよびその他の促進活動を改善してターゲットすることができます。
CA サービスの制限とセキュリティ。CA サービスドキュメントに記載されている方法によってのみ、CA サービスにアクセスします (またはアクセスを試みます)。CA サービスを使用中に自身のアイデンティティまたは顧客のアイデンティティを偽ったり、隠したりしてはなりません。いずれかの期間において CA サービスへのアクセスを許可された接続、通話、またはサーバーの数に関して、これを含みますが限定されず、CA サービスに使用を設定または制限する権利を単独裁量にて保有します。当該の制限に同意し、迂回することを回避しようとしません。これらの CAS 規約に違反している、または CA サービスを悪用していると確信した場合、CA サービスにアクセスする権利を制限、停止または終了する権利を保有します。
CA サービス認証情報の機密性とセキュリティ。CA サービス認証情報 (パスワード、キー、およびクライアント ID など) は、お客様が API クライアントを識別するために使用されることが目的です。認証情報を秘匿する全責任はお客様が負い、少なくとも同様の性質の機密情報を保護するために取る措置を含め、当該認証情報の開示、流布、または不正使用を避けるための合理的な措置を取ります。CA サービス認証情報をオープンソースプロジェクトに埋め込むことはできません。お客様の認証情報での CA サービスへのあらゆるアクセスの全責任はお客様が負います。
変更。AWS サイトに改訂版を掲載する、または AWS Marketplace 販売者規約にしたがった通知を提供することによって、CAS 規約を随時変更することができます。変更された規約は、掲載時に、または、E メールによって通知した場合、E メールメッセージに記載されているとおりに、発行します。これらの CAS 規約への変更の発行日後に CA サービスの使用またはアクセスを継続することで、変更された規約に縛られることに同意したものと見なされます。
ターミネーション。これらの CAS 規約およびここに付与される CAS データを使用する権限は、あらゆる理由による AWS Marketplace 販売者規約の終了により、通知の有無に関わらず、終了します。さらに、あらゆるときにあらゆる理由で CA サービスの提供を停止するか、CA サービスへのアクセスを終了する場合があります。

オンボーディングガイド

AWS Marketplace Commerce Analytics Service を使用するために、AWS アカウントと AWS のサービスを設定する必要があります。

AWS Marketplace Commerce Analytics Service を使用するには

権限付きで AWS アカウントをセットアップ.
送信先の Amazon S3 バケットを作成する.
レスポンス通知用の Amazon SNS トピックを設定する.
Commerce Analytics Service プログラムに登録する.
設定を確認する.

権限付きで AWS アカウントをセットアップ

AWS Marketplace では、AWS Marketplace 管理ポータルへのサインインにルートアカウント認証情報を使用せずに AWS Identity and Access Management (IAM) ロールを使用することを強くお勧めします。AWS Marketplace Commerce Analytics Service のアクセス許可の、特定の IAM のアクセス許可については、「AWS Marketplace 販売者のポリシーとアクセス許可」を参照してください。お客様のアカウントにアクセスする人に対して個別ユーザーを作成することにより、ユーザーそれぞれに一意の認証情報を設定することができます。さらに、各ユーザーにそれぞれ異なるアクセス権限を付与することもできます。必要な場合には、いつでもユーザーのアクセス許可を変更、または無効にすることができます。

送信先の Amazon S3 バケットを作成する

Commerce Analytics Service により、リクエストしたデータが、指定した Amazon S3 バケットに配信されます。既に Amazon S3 バケットをお持ちで使用できる場合は、次のステップに進みます。

Amazon S3 バケットがない場合、このデータ専用の Amazon S3 バケットを作成する場合は、「S3 バケットを作成する方法」を参照してください。

Commerce Analytics Service は、Amazon SNS を使用してレスポンス通知を配信します。このサービスでは、データセットが利用可能になったり、エラーが発生したりしたときに、このトピックにメッセージを発行して通知します。既にこの目的で Amazon SNS トピックをお持ちの場合は、次のステップに進みます。

このサービスに対して Amazon SNS トピックを設定していない場合は、この時点で設定します。手順については、「トピックの作成」を参照してください。

作成したトピックの Amazon リソースネーム (ARN) をメモしておきます。サービスを呼び出すときに ARN が必要になります。

Commerce Analytics Service プログラムに登録する

トピックの ARN およびバケットの名前を使用してサービスを設定すると、Commerce Analytics Service は Amazon S3 バケットと Amazon SNS トピックにアクセスします。

そのアクセスを有効にするには

AWS Marketplace 管理ポータルに、AWS Marketplace 製品を管理するために使用する AWS アカウントでログインします。
AWS Marketplace Commerce Analytics Service に登録するために必要な IAM 権限があることを確認してください。
Commerce Analytics Service 登録ページに移動します。
Amazon S3 バケット名および Amazon SNS トピック ARN を入力し、[登録] を選択します。
[permissions (権限)] ページの [Allow (許可)] を選択します。
AWS Marketplace 管理ポータルで、成功メッセージである [Role Name ARN] を記録します。サービスを呼び出すには ARN が必要です。

注記

Commerce Analytics Service へのオンボーディングにより、AWS アカウントに IAM ロールが作成されます。IAM ロールにより、AWS Marketplace は Amazon S3 バケットへの書き込みと Amazon SNS トピックへの通知の公開を許可されます。AWS Marketplace は 452565589796 というアカウントを使用して、この IAM ロールに関連するアクションを実行します。

設定を確認する

最後のステップは、設定が正常に動作しているかどうかを確認することです。

設定をテストするには

AWS Command Line Interface (AWS CLI) をダウンロードして、インストールおよび設定します。

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 "{YOUR-S3-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} を Commerce Analytics Service プログラムに登録するの登録プロセスで取得したロールの ARN に置き換えます。
--destination-s3-bucket-name では、{YOUR-S3-BUCKET} を、送信先の Amazon S3 バケットを作成するで作成した Amazon S3 バケットに置き換えてください。
--sns-topic-arn では、{YOUR-SNS-TOPIC-ARN} を、レスポンス通知用の Amazon SNS トピックを設定するで作成した Amazon SNS トピックに置き換えます。

dataSetRequestId レスポンスが含まれているレスポンスをサービスから受信した場合は、オンボーディングプロセスが正常に完了しています。正常な応答は次のようになります。



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

技術的な実装ガイド

AWS Marketplace Commerce Analytics Service は AWS SDK 経由で提供されています。このガイドでは、AWS CLI および AWS SDK for Java を使用してサービスを操作する方法を説明します。

Commerce Analytics Service の IAM ポリシー

ユーザーが Commerce Analytics Service を使用できるようにするには、以下の権限が必要です。

以下の IAM アクセス許可ポリシーを使用して AWS Marketplace Commerce Analytics Service に登録します。


{
    "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 にリクエストを送信できるようにします。


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "marketplacecommerceanalytics:GenerateDataSet",
            "Resource": "*"
        }
    ]
}

詳細については、「IAM ユーザーガイド」の「IAM コンソールでのポリシーの作成」を参照してください。

AWS CLI によるリクエストの作成

開始するには、AWS CLIをダウンロードします。次の AWS CLI の例では、2017 年 10 月 1 日の時間単位または月単位のサブスクリプションのデータセットをリクエストします。このデータセットはプレフィックス demo-prefix を使用して Amazon S3 バケット demo-bucket に発行され、通知メッセージは Amazon SNS トピック demo-topic に配信されます。



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"
}

AWS SDK for Java によるリクエストの作成

開始するには、AWS Java SDK をダウンロードします。次の AWS SDK for Java の例では、2015 年 10 月 1 日の時間単位または月単位のサブスクリプションのデータセットをリクエストします。このデータセットはプレフィックス demo-prefix を使用して Amazon S3 バケット demo-bucket に発行され、通知メッセージは Amazon SNS トピック demo-topic に配信されます。



/*
* 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 AWS SDK for Java.
* <p>
* <b>Prerequisites:</b> Follow the on-boarding guide: {URL OR SOMETHING}
* <p>
* 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.
* <p>
* <b>WARNING:</b> To avoid accidental leakage of your credentials, DO NOT keep
* the credentials file in your source directory.
* <p>
* 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

技術ドキュメント

このサービスでは、1 つのメソッド GenerateDataSet が公開されます。このメソッドを使用すると、Amazon S3 バケットに発行するデータセットをリクエストできます。次の表に GenerateDataSet のパラメータの一覧を示します。

データセットのパラメータ
フィールド	説明
Data Set Type	このデータセットはリクエストの結果として返されます。
Data Set Publication Date	データセットの発行日。日別データセットでは、該当日の日付が日単位の粒度で提供されます。月別データセットでは、該当月の日付が月単位の粒度で提供されます。日付の値は無視されます。
Role Name ARN	ロールの ARN の後に、リソースへのアクセス権を持つサービスを提供するアクセス権限ポリシーが続いています。
Destination Amazon S3 Bucket Name	送信先 Amazon S3 バケットの名前 (ARN ではなくフレンドリ名)。データセットはこの場所に発行されます。
Destination Amazon S3 Prefix	(オプション) データセットの発行先である Amazon S3 のプレフィックス。標準ファイルシステムのディレクトリパスに似ています。たとえば、バケットの名前が `mybucket` であり、プレフィックスが `myprefix/mydatasets` の場合、出力ファイルは `s3://DOC-EXAMPLE-BUCKET/myprefix/mydatasets/outputfile` に発行されます。プレフィックスのディレクトリ構造が存在しない場合は作成されます。プレフィックスを指定しないと、データセットの発行先は Amazon S3 バケットのルートになります。
SNS トピックの ARN	データセットの発行時またはエラーの発生時に通知先となる Amazon SNS トピックの ARN。

レスポンス

AWS Marketplace Commerce Analytics Service の 2 つのレスポンスが返されます。1 つ目は同期で即座に返され、2 つ目は非同期でこれは Amazon SNS を使用して返されます。同期のレスポンスは次の例のようになります。

データセットパラメータ
フィールド	説明
Data Set Request ID	サービスに対する特定のリクエストを表す一意の識別子。この識別子を使用して、リクエストを Amazon SNS トピックへの通知と関連付けることができます。

非同期レスポンスが JSON 形式のドキュメントとして Amazon SNS トピックに書き込まれ、次の例のようになります。

データセットのパラメータ
フィールド	説明
Data Set S3 Location	配信されたデータセットのバケット名とキー。
Data Set Meta Data S3 Location	配信されたデータセットのメタデータファイルのバケット名とキー。
Data Set Request ID	サービスに対する特定のリクエストを表す一意の識別子。この識別子を使用して、リクエストを Amazon SNS トピックへの通知と関連付けることができます。
成功	オペレーションが成功した場合は「true」、それ以外の場合は「false」。
Message	(オプション) エラーが発生した場合 (「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
 }

[Outputs] (出力)

リクエストが成功すると、リクエストしたデータセットは .csv ファイルとして Amazon S3 バケットに配信されます。JSON 形式のメタデータファイルは、データセットファイルと同じ場所に発行されます。メタデータファイルは、データセットや元のリクエストのパラメータに関する有用な情報を提供します。メタデータファイル名は、データセットファイル名と同じですが、拡張子が .meta.json となります。次の表は、.csv ファイルのメタデータフィールドの一覧です。

メタデータフィールド
フィールド	説明
Data Set Request ID	サービスに対する特定のリクエストを表す一意の識別子。この識別子を使用して、リクエストを Amazon SNS トピックへの通知と関連付けることができます。
Data Set Coverage Range	データ範囲の開始日時と終了日時を定義します。これらの日時は ISO 8601 形式です。
Data Set Request Parameters	`GenerateDataSet` メソッドへの元のリクエストパラメータ。
Data Set S3 Location	配信されたデータセットのバケット名とキー。
Data Set Meta Data S3 Location	配信されたデータセットのメタデータファイルのバケット名とキー。

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 ドキュメントを参照してください。

トラブルシューティング

このセクションでは、AWS Marketplace Commerce Analytics Service の使用時に発生する可能性のある問題の解決策について説明します。

許可リストの問題のため、サービスにアクセスできません。

AWS Marketplace で販売者として登録されていない場合は、AWS Marketplace 管理ポータルから登録します。AWS Marketplace に販売者として登録済みの場合は、AWS Marketplace Seller Operations チームまでお問い合わせください。

過去の日付のデータセットをリクエストできません。ただし、SDK ドキュメントでは、この日付のデータが利用可能となっています。

過去の特定の日付に関するデータセットが利用可能であると記載されていても、利用できるのは AWS Marketplace に参加した時点以降のデータのみです。エラーが発生したと思われる場合は、AWS Marketplace Seller Operations チームまでお問い合わせください。

このサービスを呼び出すと、「Could not connect to the endpoint URL: https://marketplacecommerceanalytics.eu-central-1.amazonaws.com/」というエラーメッセージが表示されます。

AWS Marketplace Commerce Analytics Service は米国東部 (バージニア北部) リージョンでのみ利用できます。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 Commerce Analytics Service への登録時に、Amazon S3 バケットと Amazon SNS トピックを指定しています。オンボーディングプロセスでは、サービスがこれらの特定のリソースにのみアクセスできるように IAM 権限を設定します。別のリソースを使用するには、IAM ポリシーを変更する必要があります。

AWS Management Console にサインインして、IAM コンソール (https://console.aws.amazon.com/iam/) を開きます。
IAM コンソールの左側にある [ロール] を選択します。
[MarketplaceCommerceAnalyticsRole] を選択します。
[Inline Roles (インラインロール)] セクションが展開されていない場合は展開します。
oneClick_MarketplaceCommerceAnalyticsRole で始まる名前のポリシーを探し、[Edit Policy] を選択します。
そのポリシードキュメントで、変更するサービスに関連するアクションが指定されているセクションを見つけます。例えば、Amazon S3 バケットを変更するには、s3: で始まるアクションが含まれているセクションを見つけ、各リソースの選択肢を新しい Amazon S3 バケットに変更します。

IAM ポリシーの詳細については、「https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html」を参照してください。

GenerateDataSet アクションを呼び出すと、AccessDeniedException エラーが表示される

これは、GenerateDataSet を呼び出すために必要なアクセス許可がユーザーにない場合に発生することがあります。以下の手順は、IAM コンソールを使用してこれらの権限を持つ IAM ポリシーを作成し、ユーザー、グループ、またはロールにアクセス許可を追加するために必要な手順の概要を示しています。

JSON ポリシーエディタを使用してポリシーを作成するには

AWS Management Console にサインインして、IAM コンソール (https://console.aws.amazon.com/iam/) を開きます。
左側のナビゲーションペインで、[ポリシー] を選択します。

初めて [ポリシー] を選択する場合には、[管理ポリシーにようこそ] ページが表示されます。[Get Started] (今すぐ始める) を選択します。
ページの上部で、[ポリシーの作成] を選択します。
[ポリシーエディタ] セクションで、[JSON] オプションを選択します。

次の JSON ポリシードキュメントを入力します。


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "marketplacecommerceanalytics:GenerateDataSet",
      "Resource": "*"
    }
  ]
}

[Next] (次へ) をクリックします。

注記
いつでも [Visual] と [JSON] エディタオプションを切り替えることができます。ただし、[Visual] エディタで [次] に変更または選択した場合、IAM はポリシーを再構成して visual エディタに合わせて最適化することがあります。詳細については、IAM ユーザーガイドの「ポリシーの再構成」を参照してください。
[確認と作成] ページで、作成するポリシーの [ポリシー名] と [説明] (オプション) を入力します。[このポリシーで定義されているアクセス許可] を確認して、ポリシーによって付与されたアクセス許可を確認します。
[Create Policy] (ポリシーの作成) をクリックして、新しいポリシーを保存します。

アクセスを提供するには、ユーザー、グループ、またはロールにアクセス許可を追加します。

AWS IAM Identity Center のユーザーとグループ:

アクセス許可セットを作成します。「AWS IAM Identity Center ユーザーガイド」の「シークレットの作成と管理」の手順に従ってください。
ID プロバイダーを通じて IAM で管理されているユーザー:

ID フェデレーションのロールを作成する。詳細については、「IAM ユーザーガイド」の「サードパーティー ID プロバイダー (フェデレーション) 用のロールの作成」を参照してください。
IAM ユーザー:
- ユーザーが設定できるロールを作成します。手順については、「IAM ユーザーガイド」の「IAM ユーザー用ロールの作成」を参照してください。
- (非推奨) ポリシーをユーザーに直接アタッチするか、ユーザーをユーザーグループに追加します。「IAM ユーザーガイド」の「ユーザー (コンソール) へのアクセス許可の追加」の指示に従います。

ここに記載されていない問題。

AWS Marketplace Seller Operations チームまでお問い合わせください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

販売者ツールキット

AWS Marketplace フィールドデモンストレーションプログラム