本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 使用 Commerce Analytics Service AWS Marketplace 存取產品和客戶資料 使用 AWS Marketplace Commerce Analytics Service，您可以透過 以程式設計方式存取產品和客戶資料 AWS Marketplace。註冊服務之後，您可以透過 AWS SDKs 存取您的用量、訂閱和帳單報告。您使用 SDK 工具請求的資料會以資料集 AWS 帳戶 的形式交付至您的 。大多數資料集對應到與 上可用的文字型報告相同的資料[AWS Marketplace 管理入口網站](https://aws.amazon.com/marketplace/management/tour)。您可以為特定日期請求資料集，並將資料交付至提供的 Amazon S3 儲存貯體。您透過 Amazon Simple Notification Service (Amazon SNS) 收到資料交付通知。本主題提供使用 Commerce Analytics Service AWS Marketplace 的條款與條件。 下列視覺化顯示 Commerce Analytics Service 如何存取 中的產品和客戶資料， AWS Marketplace 並將其做為資料集交付至 Amazon S3 儲存貯體，並透過 Amazon SNS 啟動通知。 ![\[Commerce Analytics Service Overview.\]](http://docs.aws.amazon.com/zh_tw/marketplace/latest/userguide/images/commerce-analytics-service-overview.png) ## 條款與條件 這些 AWS Marketplace Commerce Analytics 服務條款與條件 （以下「**CAS 條款**」) 包含您使用和存取 AWS Marketplace Commerce Analytics 服務 (「**CA 服務**」) 的特定條款與條件，自您按一下這些 CAS 條款所呈現的「我接受」按鈕或核取方塊當日起生效，或者，如果您先前使用任何 CA 服務方案時生效。這些 CAS 條款是您與 Amazon Web Services， Inc. 之間 AWS Marketplace 賣方條款與條件 (「**AWS Marketplace 賣方條款**」) 的附錄。 (「**AWS**」、「**我們**」、「**我們**」或「**我們的**」)，其條款在此併入本文。如果這些 CAS 條款與 AWS Marketplace 賣方條款之間發生衝突，則適用這些 CAS 條款的條款和條件，但僅限於此類衝突的範圍內，且僅限於您使用 CA 服務。此處使用但未在此定義的大寫詞彙應具有 AWS Marketplace 賣方條款中規定的含義。 1. **CA 服務和 CAS 資料。**若要符合 CA 服務的存取資格，您必須是受現有 AWS Marketplace 賣方條款約束的 AWS Marketplace 賣方。您接收或有權存取的 CA 服務相關資訊和資料 (「**CAS 資料**」) 構成訂閱者資訊，並受 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. **終止。**這些 CAS 條款和此處授予的 CAS 資料使用權利將在 AWS Marketplace 賣方條款因任何原因終止時終止，無論是否通知您。此外，我們可能會基於任何原因或毫無原因，隨時停止提供 CA 服務或終止您對 CA 服務的存取權。 ## 開始使用 如需 AWS Marketplace Commerce Analytics Service 的詳細資訊，包括加入、技術實作和故障診斷資訊，請參閱下列主題。 **Topics** + [條款與條件](#terms-and-conditions) + [開始使用](#commerce-analytics-service-getting-started) + [加入 AWS Marketplace Commerce Analytics Service](on-boarding-guide.md) + [搭配 AWS CLI 和 使用 AWS Marketplace Commerce Analytics Service 適用於 Java 的 AWS SDK](technical-implementation-guide.md) + [使用 Commerce Analytics Service AWS Marketplace 產生資料集](technical-documentation.md) + [對 AWS Marketplace Commerce Analytics Service 進行故障診斷](cas-troubleshooting.md) # 加入 AWS Marketplace Commerce Analytics Service 透過 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 帳戶 使用 許可設定您的 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 Resource Name (ARN)，因為呼叫 服務需要 ARN。 ## 步驟 4：註冊 Commerce Analytics Service 計畫 在您使用儲存貯體主題和名稱的 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：驗證您的組態 最後一個步驟是驗證您的組態是否如預期般運作。 **若要測試組態** 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" } ``` # 搭配 AWS CLI 和 使用 AWS Marketplace Commerce Analytics Service 適用於 Java 的 AWS SDK 透過 AWS Marketplace Commerce Analytics Service，您可以透過程式設計方式存取產品和客戶資料 AWS Marketplace。Commerce Analytics Service 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 互動。這些章節說明如何使用適用於 Java 的 AWS CLI 和 開發套件來實作 Commerce Analytics Service。 **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 Commerce Analytics Service。 ------ #### [ 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** 發佈至**示範儲存貯**體 Amazon S3 儲存貯體，並將通知訊息傳送至**示範主題** 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 開發套件](https://aws.amazon.com/sdk-for-java/)。下列 適用於 Java 的 AWS SDK 範例會針對 2015 年 10 月 1 日的**每小時/每月訂閱**資料集提出請求。此資料集會使用字首 **demo-prefix** 發佈至**示範儲存貯**體 Amazon S3 儲存貯體，並將通知訊息傳送至**示範主題** 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 ``` # 使用 Commerce Analytics Service AWS Marketplace 產生資料集 註冊 AWS Marketplace Commerce Analytics Service 之後，您可以透過 AWS CLI 和 存取您的用量、訂閱和帳單報告 適用於 Java 的 AWS SDK。您使用 SDK 工具請求的資料會以資料集 AWS 帳戶 的形式交付至您的 。大多數資料集對應到與 上可用的文字型報告相同的資料[AWS Marketplace 管理入口網站](https://aws.amazon.com/marketplace/management/tour)。如需詳細資訊，請參閱[使用 Commerce Analytics Service 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`。 **資料集參數** | **欄位** | **Description** | | --- | --- | | 資料集類型 | 此資料集將作為請求的結果傳回。 | | 資料集發佈日期 | 資料集發佈的日期。 對於每日資料集，請提供所需日期的日層級精細程度。 對於每月資料集，請提供所需月份的月份層級精細程度日期。系統會忽略日值。 | | 角色名稱 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 Topic ARN (SNS 主題 ARN) | 發佈資料集或發生錯誤時通知的 Amazon SNS 主題 ARN。 | ## 回應 Commerce Analytics Service AWS Marketplace 會傳回兩個回應。第一個是同步，它會立即傳回，第二個是非同步，它會使用 Amazon SNS 傳回。同步回應類似於此範例。 **資料集參數** | **欄位** | **Description** | | --- | --- | | 資料集請求 ID | 代表服務特定請求的唯一識別符。此識別符可用來將請求與 Amazon SNS 主題上的通知建立關聯。 | 非同步回應會以 JSON 格式的文件發佈到您的 Amazon SNS 主題，與此範例類似。 **資料集參數** | **欄位** | **Description** | | --- | --- | | 資料集 S3 位置 | 已交付資料集的儲存貯體名稱和金鑰。 | | 資料集中繼資料 S3 位置 | 已交付資料集中繼資料檔案的儲存貯體名稱和金鑰。 | | 資料集請求 ID | 代表服務特定請求的唯一識別符。此識別符可用來將請求與 Amazon SNS 主題上的通知建立關聯。 | | 成功 | 如果操作成功，則為「True」；如果失敗，則為「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 檔案中的中繼資料欄位。 **中繼資料欄位** | **欄位** | **Description** | | --- | --- | | 資料集請求 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 Commerce Analytics Service 進行故障診斷 您可以對 Commerce Analytics Service 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：//https://marketplacecommerceanalytics.eu-central-1.amazonaws.com/」** Commerce Analytics Service 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 主題不同的 Amazon S3 儲存貯體或主題。** 註冊 AWS Marketplace Commerce Analytics Service 時，您指定了 Amazon S3 儲存貯體和 Amazon SNS 主題。加入程序會設定您的 IAM 許可，僅允許服務存取這些特定資源。若要使用不同的資源，您需要修改 IAM 政策： 1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 開啟 IAM 主控台。 1. 選擇 ** ** IAM 主控台左側的角色。 1. 選擇 **MarketplaceCommerceAnalyticsRole**。 1. 如果尚未展開，請展開**內嵌角色**區段。 1. 尋找名稱開頭為 的政策，*oneClick\$1MarketplaceCommerceAnalyticsRole*然後選擇**編輯政策**。 1. 在政策文件中，找到指定與您要修改之服務相關動作的 區段。例如，若要變更 Amazon S3 儲存貯體，請尋找包含以 **s3 開頭之動作的 區段：** ，並變更其各自**的資源**選擇以指定新的 Amazon S3 儲存貯體。 如需 IAM 政策的詳細資訊，請參閱下列指南：https：//[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 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 的 IAM 主控台。 1. 在左側的導覽窗格中，選擇 **Policies (政策)**。 如果這是您第一次選擇 **Policies (政策)**，將會顯示 **Welcome to Managed Policies (歡迎使用受管政策)** 頁面。選擇 **Get Started (開始使用)**。 1. 在頁面頂端，選擇 **Create policy (建立政策)**。 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. 選擇 **Create policy** (建立政策) 儲存您的新政策。 若要提供存取權，請新增權限至您的使用者、群組或角色： + 中的使用者和群組 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/)團隊。