Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Mengakses data produk dan pelanggan dengan Layanan Analisis AWS Marketplace Perdagangan Dengan Layanan Analisis AWS Marketplace Perdagangan, Anda dapat mengakses data produk dan pelanggan secara terprogram. AWS Marketplace Setelah mendaftar di layanan, Anda dapat mengakses laporan penggunaan, langganan, dan penagihan Anda melalui. AWS SDKs Data yang Anda minta menggunakan alat SDK dikirimkan ke kumpulan data Anda Akun AWS sebagai. Sebagian besar kumpulan data sesuai dengan data yang sama dengan laporan berbasis teks yang tersedia di file. [Portal Manajemen AWS Marketplace](https://aws.amazon.com/marketplace/management/tour) Anda dapat meminta set data untuk tanggal tertentu, dan data dikirim ke bucket Amazon S3 yang disediakan. Anda menerima pemberitahuan pengiriman data melalui Amazon Simple Notification Service (Amazon SNS). Topik ini menyediakan syarat dan ketentuan untuk menggunakan Layanan Analisis AWS Marketplace Perdagangan. Visualisasi berikut menunjukkan cara Layanan Analisis Perdagangan mengakses data produk dan pelanggan Anda AWS Marketplace dan mengirimkannya sebagai kumpulan data ke bucket Amazon S3 Anda, memulai pemberitahuan melalui Amazon SNS. ![\[Commerce Analytics Service Overview.\]](http://docs.aws.amazon.com/id_id/marketplace/latest/userguide/images/commerce-analytics-service-overview.png) ## Syarat dan ketentuan Syarat dan Ketentuan Layanan Analisis AWS Marketplace Perdagangan ini (“**Ketentuan CAS**”) berisi syarat dan ketentuan khusus untuk penggunaan dan akses Anda ke Layanan Analisis AWS Marketplace Perdagangan (“**Layanan CA**”) dan berlaku sejak tanggal Anda mengklik tombol “Saya Terima” atau kotak centang yang disajikan dengan Ketentuan CAS ini atau, jika sebelumnya, saat Anda menggunakan penawaran Layanan CA apa pun. Ketentuan CAS ini merupakan tambahan dari Syarat dan Ketentuan untuk AWS Marketplace Penjual (“**Ketentuan AWS Marketplace Penjual**”) antara Anda dan Amazon Web Services, Inc. (” **AWS**,” “kami,” “**kami**” atau “**milik** **kami**”), ketentuan-ketentuan yang dengan ini dimasukkan di sini. Jika terjadi pertentangan antara Ketentuan CAS ini dan AWS Marketplace Persyaratan Penjual, syarat dan ketentuan dari Ketentuan CAS ini berlaku, tetapi hanya sejauh konflik tersebut dan semata-mata sehubungan dengan penggunaan Layanan CA oleh Anda. Istilah huruf kapital yang digunakan di sini tetapi tidak didefinisikan di sini akan memiliki arti yang ditetapkan dalam AWS Marketplace Ketentuan Penjual. 1. **Layanan CA dan Data CAS.** Agar memenuhi syarat untuk mengakses Layanan CA, Anda harus menjadi AWS Marketplace Penjual yang terikat oleh Ketentuan AWS Marketplace Penjual yang ada. Informasi dan data yang Anda terima atau miliki akses sehubungan dengan Layanan CA (“**Data CAS**”) merupakan Informasi Pelanggan dan tunduk pada batasan dan kewajiban yang ditetapkan dalam Ketentuan AWS Marketplace Penjual. Anda dapat menggunakan Data CAS secara rahasia untuk meningkatkan dan menargetkan pemasaran dan kegiatan promosi lainnya yang terkait dengan AWS Marketplace Konten Anda asalkan Anda tidak (a) mengungkapkan Data CAS kepada pihak ketiga mana pun; (b) menggunakan Data CAS apa pun dengan cara apa pun yang tidak sesuai dengan kebijakan atau hukum privasi yang berlaku; (c) menghubungi pelanggan untuk memengaruhi mereka untuk melakukan pembelian alternatif di luar AWS Marketplace; (d) meremehkan kami, afiliasi kami, atau salah satu dari mereka atau produk kami masing-masing; atau (e) komunikasi target dalam bentuk apa pun atas dasar penerima yang dimaksud menjadi AWS Marketplace pelanggan. 1. **Keterbatasan dan Keamanan Layanan CA.** Anda hanya akan mengakses (atau mencoba mengakses) layanan CA dengan cara yang dijelaskan dalam dokumentasi CA Service. Anda tidak akan salah mengcitrakan atau menutupi identitas Anda atau identitas klien Anda saat menggunakan Layanan CA. Kami berhak, atas kebijakan kami sendiri, untuk menetapkan dan mbucketlakukan batasan penggunaan Layanan CA oleh Anda, termasuk, tetapi tidak terbatas pada, sehubungan dengan jumlah koneksi, panggilan, dan server yang diizinkan untuk mengakses Layanan CA selama periode waktu tertentu. Anda setuju, dan tidak akan berusaha untuk menghindari keterbatasan tersebut. Kami berhak untuk membatasi, menangguhkan, atau menghentikan hak Anda untuk mengakses Layanan CA jika kami yakin bahwa Anda mungkin melanggar Ketentuan CAS ini atau menyalahgunakan Layanan CA. 1. **Kerahasiaan dan Keamanan Kredensi Layanan CA.** Kredensi Layanan CA (seperti kata sandi, kunci, dan klien IDs) dimaksudkan untuk digunakan oleh Anda untuk mengidentifikasi klien API Anda. Anda sepenuhnya bertanggung jawab untuk menjaga kerahasiaan kredensialnya dan akan mengambil semua tindakan yang wajar untuk menghindari pengungkapan, deployment, atau penggunaan yang tidak sah atas mandat tersebut, termasuk, minimal, langkah-langkah yang Anda ambil untuk melindungi informasi rahasia Anda sendiri yang sifatnya serupa. CA Service kredensials mungkin tidak tertanam pada proyek open source. Anda sepenuhnya bertanggung jawab atas setiap dan semua akses ke Layanan CA dengan kredensialnya. 1. **Modifikasi.** Kami dapat mengubah Ketentuan CAS ini kapan saja dengan memposting versi revisi di AWS Situs atau memberi Anda pemberitahuan sesuai dengan Ketentuan AWS Marketplace Penjual. Ketentuan yang dimodifikasi akan menjadi efektif saat posting atau, jika kami memberi tahu Anda melalui email, sebagaimana tercantum dalam pesan email. Dengan terus menggunakan atau mengakses Layanan CA setelah tanggal efektif modifikasi apa pun terhadap Ketentuan CAS ini, Anda setuju untuk terikat dengan ketentuan yang diubah. 1. **Pengakhiran.** Ketentuan CAS ini dan hak untuk menggunakan Data CAS yang diberikan di sini akan berakhir, dengan atau tanpa notifikasi kepada Anda setelah penghentian AWS Marketplace Penjual Syarat untuk alasan apapun. Selain itu, kami dapat berhenti menyediakan Layanan CA atau menghentikan akses Anda ke Layanan CA kapan saja tanpa alasan apa pun. ## Memulai Untuk informasi selengkapnya tentang Layanan Analisis AWS Marketplace Perdagangan, termasuk informasi orientasi, implementasi teknis, dan pemecahan masalah, lihat topik berikut. **Topics** + [Syarat dan ketentuan](#terms-and-conditions) + [Memulai](#commerce-analytics-service-getting-started) + [Orientasi ke AWS Marketplace Layanan Analisis Perdagangan](on-boarding-guide.md) + [Menggunakan Layanan Analisis AWS Marketplace Perdagangan dengan AWS CLI dan AWS SDK untuk Java](technical-implementation-guide.md) + [Menghasilkan kumpulan data dengan menggunakan Layanan Analisis AWS Marketplace Perdagangan](technical-documentation.md) + [Memecahkan Masalah Layanan Analisis AWS Marketplace Perdagangan](cas-troubleshooting.md) # Orientasi ke AWS Marketplace Layanan Analisis Perdagangan Dengan Layanan Analisis AWS Marketplace Perdagangan, Anda dapat mengakses data produk dan pelanggan secara terprogram. AWS Marketplace Untuk memulai dengan Layanan Analisis AWS Marketplace Perdagangan, Anda harus mengonfigurasi Akun AWS dan Layanan AWS menggunakan Layanan Analisis AWS Marketplace Perdagangan. Bagian ini menunjukkan cara mengonfigurasi Akun AWS dan Layanan AWS menggunakan Layanan Analisis AWS Marketplace Perdagangan. **Untuk menggunakan Layanan Analisis AWS Marketplace Perdagangan** + [Langkah 1: Akun AWS Siapkan izin Anda](#permissions-for-commerce-analytics) + [Langkah 2: Buat bucket Amazon S3 tujuan](#create-a-destination-amazon-s3-bucket) + [Langkah 3: Konfigurasikan topik Amazon SNS untuk pemberitahuan respons](#create-an-amazon-sns-topic-for-response-notifications) + [Langkah 4: Mendaftar di program Layanan Analisis Perdagangan](#enroll-in-the-commerce-analytics-service-program) + [Langkah 5: Verifikasi konfigurasi Anda](#verify-your-configuration) ## Langkah 1: Akun AWS Siapkan izin Anda AWS Marketplace **sangat** merekomendasikan penggunaan peran AWS Identity and Access Management (IAM) untuk masuk ke akun Portal Manajemen AWS Marketplace daripada menggunakan kredenal akun root Anda. Lihat[Kebijakan dan izin untuk penjual AWS Marketplace](detailed-management-portal-permissions.md)untuk izin IAM tertentu untuk AWS Marketplace Izin Layanan Commerce Analytics Dengan membuat pengguna individu untuk orang yang mengakses akun Anda, Anda dapat memberikan setiap pengguna satu set kredensi keamanan yang unik. Anda juga dapat memberikan izin yang berbeda untuk setiap pengguna . Jika perlu, Anda dapat mengubah atau mencabut izin pengguna kapan saja. ## Langkah 2: Buat bucket Amazon S3 tujuan Layanan analitik Perdagangan mengirimkan data yang Anda minta ke bucket Amazon S3 yang Anda tentukan. Jika Anda sudah memiliki sebuah bucket Amazon S3 untuk digunakan, lanjutkan ke langkah berikutnya. Jika Anda tidak memiliki bucket Amazon S3 atau Anda ingin membuat bucket Amazon S3 khusus untuk data ini, [lihat Bagaimana cara membuat Bucket Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/UG/CreatingaBucket.html). ## Langkah 3: Konfigurasikan topik Amazon SNS untuk pemberitahuan respons Layanan Commerce Analytics memberikan notifikasi responss menggunakan Amazon SNS. Layanan menerbitkan pesan untuk topik ini untuk mbucketitahu Anda saat set data Anda tersedia atau jika terjadi kesalahan. Jika Anda sudah memiliki topik Amazon SNS untuk tujuan ini, lanjutkan ke langkah berikutnya. Jika Anda tidak memiliki topik Amazon SNS yang dikonfigurasi untuk layanan ini, konfigurasikan topik ini sekarang. Untuk petunjuk, lihat[Buat Topik](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html). Catat topik Amazon Resource Name (ARN) untuk topik yang Anda buat, karena ARN diperlukan untuk memanggil layanan. ## Langkah 4: Mendaftar di program Layanan Analisis Perdagangan Layanan Analytics Commerce mengakses Amazon S3 bucket dan Amazon SNS topik setelah Anda mengkonfigurasi layanan dengan ARN untuk topik dan nama bucket. **Untuk mengaktifkan akses** 1. Masuk ke [Portal Manajemen AWS Marketplace](https://aws.amazon.com/marketplace/management/)dengan yang Akun AWS Anda gunakan untuk mengelola AWS Marketplace produk Anda. 1. Pastikan Anda memiliki [izin IAM yang diperlukan](https://docs.aws.amazon.com/marketplace/latest/userguide/commerce-analytics-service.html#technical-implementation-guide) untuk mendaftar di Layanan Analisis AWS Marketplace Perdagangan. 1. Navigasikan ke [Halaman pendaftaran Layanan Analitik Perdagangan](https://aws.amazon.com/marketplace/management/cas/enroll). 1. Masukkan nama bucket Amazon S3 dan ARN topik Amazon SNS, dan pilih **Daftar**. 1. Pada halaman izin, pilih **Izinkan**. 1. Pada Portal Manajemen AWS Marketplace, catat **Nama Peran ARN** dalam pesan sukses. Anda perlu ARN untuk menghubungi layanan ini. **catatan** Orientasi ke Layanan Analisis Perdagangan menciptakan peran IAM dalam Anda. Akun AWS Peran IAM memungkinkan AWS Marketplace untuk menulis ke bucket Amazon S3 dan mempublikasikan pemberitahuan ke topik Amazon SNS. AWS Marketplace menggunakan akun 452565589796 untuk melakukan tindakan terkait ini dengan peran IAM ini. ## Langkah 5: Verifikasi konfigurasi Anda Langkah terakhir adalah memverifikasi bahwa konfigurasi Anda bekerja seperti yang diharapkan. **Untuk menguji konfigurasi EFA dan NCCL Anda** 1. Unduh, instal, dan konfigurasikan [Antarmuka Baris AWS Perintah](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html) (AWS CLI). 1. Menggunakan AWS CLI, jalankan perintah ini. ``` 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}" ``` + Untuk`--data-set-publication-date`, ganti`{TODAY'S DATE}`dengan tanggal saat ini menggunakan format ISO-8601,`YYYY-MM-DDT00:00:00Z`, tempat`YYYY`adalah tahun empat digit,`MM`adalah bulan dua digit, dan`DD`adalah hari dua digit. + Untuk`--role-name-arn`, ganti`{YOUR-ROLE-NAME-ARN}`dengan ARN peran yang Anda terima dari proses pendaftaran di[Langkah 4: Mendaftar di program Layanan Analisis Perdagangan](#enroll-in-the-commerce-analytics-service-program). + Untuk *--destination-s3-bucket-name, ganti \$1amzn-s3-demo-bucket\$1 dengan nama* *bucket Amazon S3* yang Anda buat. [Langkah 2: Buat bucket Amazon S3 tujuan](#create-a-destination-amazon-s3-bucket) + Untuk *— sns-topic-arn*, ganti *\$1YOUR-SNS-TOPIC-ARN\$1* dengan topik Amazon SNS yang Anda buat. [Langkah 3: Konfigurasikan topik Amazon SNS untuk pemberitahuan respons](#create-an-amazon-sns-topic-for-response-notifications) Jika Anda menerima tanggapan termasuk respons *dataSetRequestId* dari layanan, Anda telah menyelesaikan proses on-boarding. Responnya berhasil terlihat seperti ini: ``` { "dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab" } ``` # Menggunakan Layanan Analisis AWS Marketplace Perdagangan dengan AWS CLI dan AWS SDK untuk Java Dengan Layanan Analisis AWS Marketplace Perdagangan, Anda dapat mengakses data produk dan pelanggan secara terprogram. AWS Marketplace Layanan Analisis AWS Marketplace Perdagangan disediakan melalui [AWS SDK](https://aws.amazon.com/tools/). Anda menggunakan [AWS CLI](https://aws.amazon.com/cli/)dan [AWS SDK untuk Java](https://aws.amazon.com/sdk-for-java/)untuk berinteraksi dengan Layanan Analisis Perdagangan. Bagian ini menunjukkan kepada Anda cara menerapkan Layanan Analytics Commerce dengan menggunakan AWS CLI dan SDK for Java. **Topics** + [Kebijakan IAM untuk Layanan Analisis Perdagangan](#aws-marketplace-commerce-analytics-iam-permissions) + [Membuat Permintaan dengan AWS CLI](#making-requests-with-aws-cli) + [Membuat permintaan dengan AWS SDK untuk Java](#making-requests-with-aws-java-sdk) ## Kebijakan IAM untuk Layanan Analisis Perdagangan Untuk memungkinkan pengguna Anda menggunakan Layanan Analisis Perdagangan, izin berikut diperlukan. Gunakan kebijakan izin IAM berikut untuk mendaftar di Layanan Analisis AWS Marketplace Perdagangan. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iam:ListRoles", "iam:CreateRole", "iam:CreatePolicy", "iam:AttachRolePolicy", "aws-marketplace-management:viewReports" ], "Resource": "*" } ] } ``` ------ Gunakan kebijakan izin IAM berikut untuk memungkinkan pengguna membuat permintaan ke Layanan Analisis AWS Marketplace Perdagangan. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "marketplacecommerceanalytics:GenerateDataSet", "Resource": "*" } ] } ``` ------ Untuk informasi selengkapnya, lihat [Membuat Kebijakan dalam konsol IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-json-editor) di *Panduan Pengguna IAM*. ## Membuat Permintaan dengan AWS CLI Untuk memulai, unduh aplikasi [AWS CLI](https://aws.amazon.com/cli/). AWS CLI Contoh berikut membuat permintaan untuk dataset **Langganan Per Jam/Bulanan** untuk 1 Oktober 2017. Dataset ini diterbitkan ke**bucket demo**Buket Amazon S3 menggunakan awalan**prefiks**, dan pesan notifikasi dikirim ke**topik demo**Topik 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" ``` Permintaan ini mengembalikan sebuah identifier yang unik untuk setiap permintaan. Anda dapat menggunakan pengenal ini untuk mengkorelasikan permintaan dengan notifikasi diterbitkan untuk topik Amazon SNS Anda. Contoh berikut adalah contoh pengenal ini. ``` { "dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab" } ``` ## Membuat permintaan dengan AWS SDK untuk Java Untuk memulai, unduh[AWS SDK Java](https://aws.amazon.com/sdk-for-java/). AWS SDK untuk Java Contoh berikut membuat permintaan untuk dataset **Langganan Per Jam/Bulanan** untuk 1 Oktober 2015. Dataset ini diterbitkan ke**bucket demo**Buket Amazon S3 menggunakan awalan**prefiks**, dan pesan notifikasi dikirim ke**topik demo**Topik 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 AWS SDK untuk Java. *

* 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); } } ``` Anda harus mengharapkan hasil yang mirip dengan contoh ini. ``` =============================================================== 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 ``` # Menghasilkan kumpulan data dengan menggunakan Layanan Analisis AWS Marketplace Perdagangan Setelah mendaftar di Layanan Analisis AWS Marketplace Perdagangan, Anda dapat mengakses laporan penggunaan, langganan, dan penagihan Anda melalui dan. AWS CLI AWS SDK untuk Java Data yang Anda minta menggunakan alat SDK dikirimkan ke kumpulan data Anda Akun AWS sebagai. Sebagian besar kumpulan data sesuai dengan data yang sama dengan laporan berbasis teks yang tersedia di file. [Portal Manajemen AWS Marketplace](https://aws.amazon.com/marketplace/management/tour) Untuk informasi selengkapnya, lihat [Mengakses data produk dan pelanggan dengan Layanan Analisis AWS Marketplace Perdagangan](commerce-analytics-service.md). Bagian ini memberikan informasi tentang parameter, respons, dan output yang terkait dengan kumpulan data yang dihasilkan oleh Layanan Analisis Perdagangan. **Topics** + [Parameter `GenerateDataSet`](#generate-data-set-parameters) + [Respons](#responses) + [Output](#outputs) ## Parameter `GenerateDataSet` Layanan Analisis AWS Marketplace Perdagangan memperlihatkan satu metode`GenerateDataSet`, yang dapat Anda gunakan untuk meminta kumpulan data yang akan dipublikasikan ke bucket Amazon S3 Anda. Tabel berikut mencantumkan parameter untuk`GenerateDataSet`. **Parameter basis data** | **Bidang** | **Deskripsi** | | --- | --- | | Tipe Set Data | Dataset ini akan dikembalikan sebagai hasil dari permintaan. | | Tanggal Publikasi Data Set | Tanggal set data diterbitkan. Untuk set data harian, berikan tanggal dengan granularitas tingkat hari untuk hari yang diinginkan. Untuk set data bulanan, berikan tanggal dengan granularitas tingkat bulan untuk bulan yang diinginkan. Nilai hari diabaikan. | | ARN Nama Peran | ARN peran dengan kebijakan izin terlampir yang menyediakan layanan dengan akses ke sumber daya Anda. | | Nama Bucket Amazon S3 Bucket | Nama (nama ramah, bukan ARN) bucket Amazon S3 tujuan. Dataset Anda dipublikasikan ke lokasi ini. | | Prefiks Amazon S3 Tujuan | (Opsional) prefiks Amazon S3 untuk set data diterbitkan, mirip dengan path direktori dalam sistem file standar. Sebagai contoh, jika diberikan nama bucket`mybucket`dan prefiks`myprefix/mydatasets`, file output diterbitkan untuk`s3://amzn-s3-demo-bucket/myprefix/mydatasets/outputfile`. Jika struktur direktori prefiks tidak ada, ini dibuat. Jika tidak ada prefiks yang disediakan, set data diterbitkan ke Amazon S3 bucket root. | | Topik SNS ARN | ARN untuk topik Amazon SNS yang diberitahu saat set data telah diterbitkan atau jika terjadi kesalahan. | ## Respons Layanan AWS Marketplace Commerce Analytics mengembalikan dua tanggapan. Yang pertama sinkron, yang segera dikembalikan, dan yang kedua adalah asynchronous, yang dikembalikan menggunakan Amazon SNS. Responnya sinkron serupa dengan contoh ini. **Adalah parameter ditetapkan?** | **Bidang** | **Deskripsi** | | --- | --- | | ID Permintaan Set Data | Sebuah identifier unik yang mewakili permintaan khusus untuk layanan. Pengenal ini dapat digunakan untuk mengkorelasikan permintaan dengan notifikasi pada topik Amazon SNS. | Respon asynchronous diposting sebagai dokumen JSON diformat untuk topik Amazon SNS Anda dan mirip dengan contoh ini. **Parameter basis data** | **Bidang** | **Deskripsi** | | --- | --- | | Lokasi Set Data S3 | Nama bucket dan kunci untuk set data disampaikan. | | Lokasi Data Set Meta Data S3 | Nama bucket dan kunci untuk file metadata set data terkirim. | | ID Permintaan Set Data | Sebuah identifier unik yang mewakili permintaan khusus untuk layanan. Pengenal ini dapat digunakan untuk mengkorelasikan permintaan dengan notifikasi pada topik Amazon SNS. | | Sukses | “Benar” jika operasi berhasil; “palsu” jika tidak. | | Pesan | (Opsional) Jika terjadi kesalahan (misalnya, “Sukses” adalah “palsu”), pesan ini berisi informasi tentang kegagalan. | **Contoh respons asinkron berformat 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 } ``` ## Output Setelah permintaan berhasil, set data yang diminta dikirim ke bucket Amazon S3 Anda sebagai file.csv. File metadata yang diformat JSON diterbitkan ke lokasi yang sama dengan file set data. File metadata menyediakan informasi yang berguna tentang set data dan parameter permintaan asli. File metadata memiliki nama yang sama dengan file set data, tetapi diakhiri dengan ekstensi .meta.json. Tabel berikut mencantumkan kolom metadata dalam file.csv. **Kolom metadata** | **Bidang** | **Deskripsi** | | --- | --- | | ID Permintaan Set Data | Sebuah identifier unik yang mewakili permintaan khusus untuk layanan. Pengenal ini dapat digunakan untuk mengkorelasikan permintaan dengan notifikasi pada topik Amazon SNS. | | Rentang Liputan Set Data | Mendefinisikan awal date/time and end date/time untuk rentang cakupan data. Tanggal ini dalam format ISO 8601. | | Parameter Permintaan Set Data | Asli permintaan parameter untukGenerateDataSetmetode. | | Lokasi Set Data S3 | Nama bucket dan kunci untuk set data disampaikan. | | Lokasi Data Set Meta Data S3 | Nama bucket dan kunci untuk file metadata set data terkirim. | Berikut ini adalah contoh dari isi metadata JSON-diformat. ``` { "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" } } ``` Untuk daftar lengkap kumpulan data yang tersedia, termasuk tanggal ketersediaan, lihat dokumentasi [AWS SDK](https://docs.aws.amazon.com/cli/latest/reference/marketplacecommerceanalytics/generate-data-set.html#options). # Memecahkan Masalah Layanan Analisis AWS Marketplace Perdagangan Anda dapat memecahkan masalah dengan Layanan Analisis AWS Marketplace Perdagangan, yang secara terprogram menyediakan data produk dan pelanggan. AWS Marketplace Anda mungkin perlu memecahkan masalah Layanan Analisis Perdagangan ketika Anda mengalami kesalahan atau masalah konfigurasi lainnya. Bagian berikut memandu Anda melalui proses pemecahan masalah, yang mencakup langkah-langkah untuk mendiagnosis dan menyelesaikan masalah umum dengan Layanan Analisis Perdagangan. **Saya tidak dapat mengakses layanan karena masalah daftar izin.** Jika Anda belum terdaftar sebagai penjual AWS Marketplace, kunjungi [Portal Manajemen AWS Marketplace](https://aws.amazon.com/marketplace/management)untuk mendaftar. Jika Anda telah terdaftar sebagai penjual AWS Marketplace, hubungi tim [https://aws.amazon.com/marketplace/management/contact-us/](https://aws.amazon.com/marketplace/management/contact-us/). **Saya tidak dapat meminta kumpulan data untuk tanggal di masa lalu, meskipun dokumentasi SDK mengatakan itu harus tersedia untuk tanggal ini.** Meskipun set data terdaftar tersedia untuk tanggal tertentu di masa kemudian, kami hanya memiliki data sejak Anda bergabung AWS Marketplace. Jika Anda yakin bahwa ini salah, hubungi[https://aws.amazon.com/marketplace/management/contact-us/](https://aws.amazon.com/marketplace/management/contact-us/)Tim. **Ketika saya menelepon layanan, saya menerima pesan kesalahan “Tidak dapat terhubung ke URL titik akhir: https://marketplacecom merceanalytics.eu-central-1.amazonaws.com/”** Layanan Analisis AWS Marketplace Perdagangan hanya tersedia di Wilayah AS Timur (Virginia N.). Anda harus melakukan semua panggilan ke Layanan Analitik Perdagangan ke`us-east-1`Endpoint. Jika Anda menggunakan AWS CLI, tambahkan `--region` tanda "untuk setiap panggilan dan tentukan Wilayah AWS as`us-east-1`, seperti yang ditunjukkan pada contoh berikut. ``` 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 ``` **Saya ingin menggunakan bucket Amazon S3 atau topik Amazon SNS yang berbeda dari yang saya pilih ketika saya melalui proses on-boarding.** Saat mendaftar di Layanan Analisis AWS Marketplace Perdagangan, Anda menentukan bucket Amazon S3 dan topik Amazon SNS. Proses orientasiing mengkonfigurasi izin IAM Anda untuk mengizinkan akses layanan hanya ke sumber daya tertentu ini. Untuk menggunakan sumber daya yang berbeda, Anda perlu mengubah kebijakan IAM Anda: 1. Masuk ke Konsol Manajemen AWS dan buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Pilih**Peran**Di sisi kiri konsol IAM. 1. Pilih **MarketplaceCommerceAnalyticsRole**. 1. Perluas**Peran Inline**bagian, jika belum diperluas. 1. Temukan kebijakan dengan nama yang dimulai *oneClick\$1MarketplaceCommerceAnalyticsRole*dan pilih **Edit Kebijakan**. 1. Dalam dokumen kebijakan, temukan bagian yang menentukan tindakan yang terkait dengan layanan yang ingin Anda ubah. Misalnya, untuk mengubah keranjang Amazon S3 Anda, temukan bagian yang meliputi tindakan yang dimulai dengan**s3:**dan mengubah masing-masing**Sumber Daya**Pilihan untuk menentukan bucket Amazon S3 baru. [Untuk informasi tambahan tentang kebijakan IAM, lihat panduan berikut: \$1policies.html https://docs.aws.amazon.com/IAM/ latest/UserGuide/access](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) **Saya mendapatkan `AccessDeniedException` kesalahan ketika saya memanggil `GenerateDataSet` tindakan** Hal ini dapat terjadi jika pengguna Anda tidak memiliki izin yang diperlukan untuk menelepon`GenerateDataSet`. Prosedur berikut menguraikan langkah-langkah yang diperlukan untuk membuat kebijakan IAM dengan izin tersebut menggunakan konsol IAM dan menambahkan izin ke pengguna, grup, atau peran Anda. **Cara menggunakan editor kebijakan JSON untuk membuat kebijakan** 1. Masuk ke Konsol Manajemen AWS dan buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Pada panel navigasi di sebelah kiri, pilih **Kebijakan**. Jika ini pertama kalinya Anda memilih **Kebijakan**, akan muncul halaman **Selamat Datang di Kebijakan Terkelola**. Pilih **Memulai**. 1. Di bagian atas halaman, pilih **Buat kebijakan**. 1. Di bagian **Editor kebijakan**, pilih opsi **JSON**. 1. Masukkan dokumen kebijakan JSON berikut: ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "marketplacecommerceanalytics:GenerateDataSet", "Resource": "*" } ] } ``` 1. Pilih **Berikutnya**. **catatan** Anda dapat beralih antara opsi editor **Visual** dan **JSON** kapan saja. Namun, jika Anda melakukan perubahan atau memilih **Berikutnya** di editor **Visual**, IAM dapat merestrukturisasi kebijakan Anda untuk mengoptimalkannya bagi editor visual. Untuk informasi selengkapnya, lihat [Restrukturisasi kebijakan](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_policies.html#troubleshoot_viseditor-restructure) dalam *Panduan Pengguna IAM*. 1. Pada halaman **Tinjau dan buat**, masukkan **Nama kebijakan** dan **Deskripsi** (opsional) untuk kebijakan yang Anda buat. Tinjau **Izin yang ditentukan dalam kebijakan ini** untuk melihat izin yang diberikan oleh kebijakan Anda. 1. Pilih **Buat kebijakan** untuk menyimpan kebijakan baru Anda. Untuk memberikan akses dan menambahkan izin bagi pengguna, grup, atau peran Anda: + Pengguna dan grup di AWS IAM Identity Center: Buat rangkaian izin. Ikuti instruksi di [Buat rangkaian izin](https://docs.aws.amazon.com//singlesignon/latest/userguide/howtocreatepermissionset.html) dalam *Panduan Pengguna AWS IAM Identity Center *. + Pengguna yang dikelola di IAM melalui penyedia identitas: Buat peran untuk federasi identitas. Ikuti instruksi dalam [Buat peran untuk penyedia identitas pihak ketiga (federasi)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-idp.html) dalam *Panduan Pengguna IAM*. + Pengguna IAM: + Buat peran yang dapat diambil pengguna Anda. Ikuti instruksi dalam [Buat peran untuk pengguna IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html) dalam *Panduan Pengguna IAM*. + (Tidak disarankan) Lampirkan kebijakan langsung ke pengguna atau tambahkan pengguna ke grup pengguna. Ikuti petunjuk dalam [Menambahkan izin ke pengguna (konsol)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) dalam *Panduan Pengguna IAM*. **Masalah saya tidak tercantum di sini.** Hubungi Tim [https://aws.amazon.com/marketplace/management/contact-us/](https://aws.amazon.com/marketplace/management/contact-us/).