Bedingungen Onboarding-Leitfaden Technische Implementierungsanleitung Technische Dokumentation Fehlerbehebung

AWS Marketplace Analyseservice für den Handel

Mit dem AWS Marketplace Commerce Analytics Service können Sie programmgesteuert auf Produkt- und Kundendaten zugreifen. AWS Marketplace Nachdem Sie sich für den Service registriert haben, können Sie über das SDK auf Ihre Nutzungs-, Abonnement- und Abrechnungsberichte zugreifen. AWS

Commerce Analytics Service Overview.

Die Daten, die Sie mit den SDK-Tools anfordern, werden Ihnen AWS-Konto als Datensätze zugestellt. Die meisten Datensets entsprechen den gleichen Daten, wie die textbasierten Berichte, die auf dem AWS Marketplace Management Portal verfügbar sind. Sie können Datensätze für ein bestimmtes Datum anfordern, und die Daten werden an den bereitgestellten Amazon S3 S3-Bucket geliefert. Die Benachrichtigung über die Datenlieferung erfolgt durch den Amazon Simple Notification Service (Amazon SNS).

Bedingungen

Diese Allgemeinen Geschäftsbedingungen für den AWS Marketplace Commerce Analytics-Service (diese „CAS-Bedingungen“) enthalten die für Ihre Nutzung und Ihren Zugriff auf den AWS Marketplace Commerce Analytics-Service („CA Service“) spezifischen Bedingungen und gelten ab dem Tag, an dem Sie auf die Schaltfläche oder das Kontrollkästchen „Ich stimme zu“ klicken, das zusammen mit diesen CAS-Bedingungen angezeigt wird, oder, falls früher, wenn Sie Angebote von CA Service nutzen. Diese CAS-Bedingungen sind eine Ergänzung zu den Allgemeinen Geschäftsbedingungen für AWS Marketplace Verkäufer (die „AWS Marketplace Verkäuferbedingungen“) zwischen Ihnen und Amazon Web Services, Inc. („AWS“, „wir“, „uns“ oder „unser“), deren Bedingungen hiermit Bestandteil dieser Vereinbarung sind. Im Falle eines Widerspruchs zwischen diesen CAS-Bedingungen und den AWS Marketplace -Verkäuferbedingungen gelten die Bedingungen dieser CAS-Bedingungen, jedoch nur in dem Umfang und ausschließlich in Bezug auf Ihre Nutzung des CA-Service. Großgeschriebene Begriffe, die hier verwendet, aber hier nicht definiert werden, haben die in den AWS Marketplace Verkäuferbedingungen festgelegten Bedeutungen.

CA-Services und CAS-Daten. Um sich für den Zugang zum CA Service zu qualifizieren, müssen Sie ein Verkäufer sein, der an die bestehenden AWS Marketplace AWS Marketplace Verkäuferbedingungen gebunden ist. Informationen und Daten, die Sie im Zusammenhang mit dem CA Service erhalten oder auf die Sie Zugriff haben („CAS-Daten“), stellen Abonnenteninformationen dar und unterliegen den in den AWS Marketplace Verkäuferbedingungen festgelegten Einschränkungen und Verpflichtungen. Sie dürfen CAS-Daten vertraulich verwenden, um Marketing- und andere Werbeaktivitäten im Zusammenhang mit Ihren AWS Marketplace Inhalten zu verbessern und zielgerichtet zu gestalten, vorausgesetzt, dass Sie (a) CAS-Daten nicht an Dritte weitergeben; (b) CAS-Daten in einer Weise verwenden, die nicht mit den geltenden Datenschutzrichtlinien oder Gesetzen vereinbar ist; (c) einen Abonnenten kontaktieren, um ihn zu einem alternativen Kauf außerhalb des zu bewegen AWS Marketplace; (d) uns, unsere verbundenen Unternehmen oder eines ihrer oder unsere jeweiligen Produkte herabzusetzen; oder (e) zielgerichtete Mitteilungen jeglicher Art auf der Grundlage, dass der beabsichtigte Empfänger ein AWS Marketplace Abonnent.
CA-Service – Einschränkungen und Sicherheit. Sie greifen nur über die in der CA-Service-Dokumentation beschriebenen Wege auf den CA-Service zu (oder versuchen, darauf zuzugreifen). Sie werden Ihre Identität oder die Identität Ihres Kunden bei der Nutzung des CA-Service nicht falsch darstellen oder verbergen. Wir behalten uns das Recht vor, nach unserem alleinigen Ermessen Beschränkungen für Ihre Nutzung des CA-Service festzulegen und durchzusetzen, einschließlich, aber nicht beschränkt auf, die Anzahl der Verbindungen, Aufrufe und Server, die für den Zugriff auf den CA-Service während eines beliebigen Zeitraums zugelassen sind. Sie erklären sich damit einverstanden und werden nicht versuchen, solche Einschränkungen zu umgehen. Wir behalten uns das Recht vor, Ihr Recht für den Zugriff auf den CA-Service einzuschränken, auszusetzen oder zu beenden, wenn wir glauben, dass Sie gegen diese CAS-Bedingungen verstoßen oder den CA-Service missbrauchen.
Vertraulichkeit und Sicherheit von CA-Service-Anmeldeinformationen. CA-Service-Anmeldeinformationen (z. B. Passwörter, Schlüssel und Client-IDs) werden von Ihnen verwendet, um Ihren API-Client zu identifizieren. Sie sind allein dafür verantwortlich, Ihre Anmeldeinformationen vertraulich zu behandeln und werden alle angemessenen Maßnahmen ergreifen, um die Offenlegung, Verbreitung oder unbefugte Nutzung solcher Anmeldeinformationen zu verhindern, einschließlich mindestens der Maßnahmen, die Sie zum Schutz Ihrer eigenen vertraulichen Informationen ähnlicher Art ergreifen. CA Service-Anmeldeinformationen dürfen nicht in Open-Source-Projekte eingebettet sein. Sie sind allein verantwortlich für jeglichen Zugriff auf den CA-Service mit Ihren Anmeldeinformationen.
Änderungen. Wir können diese CAS-Bedingungen jederzeit ändern, indem wir eine überarbeitete Version auf der AWS-Website veröffentlichen oder Sie gemäß den AWS Marketplace Verkäuferbedingungen darüber informieren. Die geänderten Bedingungen werden mit der Veröffentlichung oder, wenn wir Sie per E-Mail benachrichtigen, wie in der E-Mail-Nachricht angegebenen, wirksam. Durch die weitere Nutzung oder den Zugriff auf den CA-Service nach Inkrafttreten der Änderungen dieser CAS-Bedingungen erklären Sie sich mit den geänderten Bedingungen einverstanden.
Kündigung. Diese CAS-Bedingungen und die hierin eingeräumten Nutzungsrechte an CAS-Daten enden mit oder ohne Benachrichtigung an Sie mit der Kündigung Ihrer AWS Marketplace -Verkäuferbedingungen aus irgendeinem Grund. Darüber hinaus können wir die Bereitstellung der CA-Services einstellen oder Ihren Zugang zu den CA-Services jederzeit und ohne Angabe von Gründen beenden.

Onboarding-Leitfaden

Sie müssen Ihr AWS-Konto Land konfigurieren AWS-Services , um den AWS Marketplace Commerce Analytics Service nutzen zu können.

Um den AWS Marketplace Commerce Analytics Service zu nutzen

Richten Sie Ihre AWS-Konto Berechtigungen ein.
Einen Amazon S3-Ziel-Bucket erstellen.
Konfigurieren Sie ein Amazon SNS SNS-Thema für Antwortbenachrichtigungen.
Anmelden bei dem Commerce Analytics Service-Programm.
Überprüfen Ihrer Konfiguration.

Richten Sie Ihre AWS-Konto Berechtigungen ein

AWS Marketplace empfiehlt dringend, AWS Identity and Access Management (IAM-) Rollen für die Anmeldung zu verwenden, AWS Marketplace Management Portal anstatt die Anmeldeinformationen Ihres Root-Kontos zu verwenden. Spezifische IAM-Berechtigungen Richtlinien und Berechtigungen für AWS Marketplace -Verkäufer für AWS Marketplace Commerce Analytics Service-Berechtigungen finden Sie unter. Da Sie für jede Person mit Zugriff auf Ihr Konto einen eigenen -Benutzer erstellen, können Sie auch jedem -Benutzer eindeutige Anmeldeinformationen zuordnen. Damit können Sie den einzelnen -Benutzern auch unterschiedliche Berechtigungen erteilen. Bei Bedarf lassen sich die Berechtigungen für einen -Benutzer jederzeit ändern oder aufheben.

Einen Amazon S3-Ziel-Bucket erstellen

Der Commerce Analytics Service übermittelt die von Ihnen angeforderten Daten an einen von Ihnen angegebenen Amazon S3 S3-Bucket. Wenn Sie bereits über einen Amazon S3 S3-Bucket verfügen, den Sie verwenden können, fahren Sie mit dem nächsten Schritt fort.

Wenn Sie keinen Amazon S3-Bucket haben oder einen Amazon S3-Bucket speziell für diese Daten erstellen möchten, finden Sie weitere Informationen unter Wie erstelle ich einen S3-Bucket?.

Der Commerce Analytics Service liefert Antwortbenachrichtigungen mithilfe von Amazon SNS. Mit dem Service werden Nachrichten zu diesem Thema veröffentlicht, damit Sie benachrichtigt werden, wenn Ihre Datensets verfügbar sind oder wenn ein Fehler aufgetreten ist. Wenn Sie zu diesem Zweck bereits ein Amazon SNS SNS-Thema haben, fahren Sie mit dem nächsten Schritt fort.

Wenn Sie kein Amazon SNS SNS-Thema für diesen Service konfiguriert haben, konfigurieren Sie jetzt eines. Anweisungen finden Sie unter Thema erstellen.

Notieren Sie sich das Thema Amazon Resource Name (ARN) für das von Ihnen erstellte Thema, da der ARN für den Aufruf des Service erforderlich ist.

Anmelden bei dem Commerce Analytics Service-Programm

Der Commerce Analytics Service greift auf den Amazon S3-Bucket und das Amazon SNS SNS-Thema zu, nachdem Sie den Service mit dem ARN für das Thema und den Namen des Buckets konfiguriert haben.

So ermöglichen Sie den Zugriff

Melden Sie sich AWS Marketplace Management Portalmit dem an, mit dem AWS-Konto Sie Ihre AWS Marketplace Produkte verwalten.
Stellen Sie sicher, dass Sie über die erforderlichen IAM-Berechtigungen verfügen, um sich beim AWS Marketplace Commerce Analytics Service zu registrieren.
Navigieren Sie zur Commerce Analytics Service-Anmeldeseite.
Geben Sie den Amazon S3 S3-Bucket-Namen und das Amazon SNS SNS-Thema ARN ein und wählen Sie Enroll aus.
Wählen Sie auf der Seite mit den Berechtigungen die Option Allow (Erlauben) aus.
Notieren Sie auf dem AWS Marketplace Management Portal den Rollennamen ARN in der Erfolgsmeldung. Sie benötigen den ARN, um den Dienst anzurufen.

Anmerkung

Durch das Onboarding in den Commerce Analytics Service entsteht eine IAM-Rolle in Ihrem. AWS-Konto Die IAM-Rolle ermöglicht es AWS Marketplace , in den Amazon S3 S3-Bucket zu schreiben und Benachrichtigungen zum Amazon SNS SNS-Thema zu veröffentlichen. AWS Marketplace verwendet das Konto 452565589796, um die zugehörigen Aktionen mit dieser IAM-Rolle auszuführen.

Überprüfen Ihrer Konfiguration

Der letzte Schritt besteht darin, zu überprüfen, ob Ihre Konfiguration wie erwartet funktioniert.

So testen Sie die Konfiguration

Laden Sie die AWS-Befehlszeilenschnittstelle (AWS CLI) herunter und installieren und konfigurieren Sie sie.

Führen Sie diesen Befehl mit dem aus. 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}"

Ersetzen Sie für --data-set-publication-date den Teil {TODAY'S DATE} durch das aktuelle Datum im ISO-8601-Format, YYYY-MM-DDT00:00:00Z, wobei YYYY das vierstellige Jahr MM der zweistellige Monat und DD der zweistellige Tag ist.
Für--role-name-arn, {YOUR-ROLE-NAME-ARN} ersetzen Sie es durch den ARN der Rolle, die Sie im Rahmen des Registrierungsprozesses in erhalten haben. Anmelden bei dem Commerce Analytics Service-Programm
Ersetzen Sie für --destination-s3-bucket-name {YOUR-S3-BUCKET} durch den Amazon S3-Bucket, in dem Sie ihn erstellt haben. Einen Amazon S3-Ziel-Bucket erstellen
Ersetzen Sie für —sns-topic-arn {YOUR-SNS-TOPIC-ARN} durch das Amazon SNS SNS-Thema, in dem Sie es erstellt haben. Konfigurieren Sie ein Amazon SNS SNS-Thema für Antwortbenachrichtigungen

Wenn Sie vom Service eine Antwort mit der SetRequestDaten-ID erhalten, haben Sie den Onboarding-Prozess abgeschlossen. Eine erfolgreiche Antwort sieht wie folgt aus:



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

Technische Implementierungsanleitung

Der AWS Marketplace Commerce Analytics Service wird über das AWS-SDK bereitgestellt. In diesem Handbuch wird veranschaulicht, wie Sie mithilfe der AWS CLI und dem AWS SDK for Java mit dem Service interagieren.

IAM-Richtlinien für den Commerce Analytics Service

Damit Ihre Benutzer den Commerce Analytics Service nutzen können, sind die folgenden Berechtigungen erforderlich.

Verwenden Sie die folgende IAM-Berechtigungsrichtlinie, um sich für den AWS Marketplace Commerce Analytics-Dienst zu registrieren.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iam:ListRoles",
                "iam:CreateRole",
                "iam:CreatePolicy",
                "iam:AttachRolePolicy",
                "aws-marketplace-management:viewReports"
            ],
            "Resource": "*"
        }
    ]
}

Verwenden Sie die folgende IAM-Berechtigungsrichtlinie, um es einem Benutzer zu ermöglichen, Anfragen an den AWS Marketplace Commerce Analytics-Service zu stellen.


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

Weitere Informationen finden Sie im IAM-Benutzerhandbuch unter Richtlinien in der IAM-Konsole erstellen.

Anfragen stellen mit dem AWS CLI

Laden Sie zunächst das AWS CLI herunter. Im folgenden AWS CLI Beispiel wird eine Anfrage für den Datensatz Stunden-/Monatsabonnements für den 1. Oktober 2017 gestellt. Dieser Datensatz wird mit dem Präfix demo-prefix im Amazon S3 S3-Bucket veröffentlicht, und die Benachrichtigung wird an das Amazon SNS SNS-Thema zum Demotopic gesendet.



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"

Diese Anforderung gibt eine eindeutige Kennung für jede Anforderung zurück. Sie können diese Kennung verwenden, um Anfragen mit Benachrichtigungen zu korrelieren, die zu Ihrem Amazon SNS SNS-Thema veröffentlicht wurden. Im Folgenden finden Sie ein Verwendungsbeispiel dieser Kennung.



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

Erstellen von Anfragen mit der AWS SDK for Java

Laden Sie zunächst das AWS Java SDK herunter. Im folgenden AWS SDK for Java Beispiel wird eine Anfrage für den Datensatz Stunden-/Monatsabonnements für den 1. Oktober 2015 gestellt. Dieser Datensatz wird mit dem Präfix demo-prefix im Amazon S3 S3-Bucket veröffentlicht, und die Benachrichtigung wird an das Amazon SNS SNS-Thema zum Demotopic gesendet.



/*
* 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);
}
}

Sie können mit Ergebnissen ähnlich wie in diesem Beispiel rechnen.



===============================================================
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

Technische Dokumentation

Der Service bietet eine MethodeGenerateDataSet, mit der Sie die Veröffentlichung von Datensätzen in Ihrem Amazon S3 S3-Bucket anfordern können. In der folgenden Tabelle sind die Parameter für GenerateDataSet aufgelistet.

Dataset-Parameter
Feld	Beschreibung
Dataset-Typ	Dieser Dataset wird als Ergebnis der Anforderung zurückgegeben.
Dataset-Veröffentlichungsdatum	Das Datum, an dem ein Dataset veröffentlicht wurde. Für tägliche Datasets geben Sie ein Datum mit Granularität auf Tagesebene für den gewünschten Tag an. Für monatliche Datensets geben Sie ein Datum mit Granularität auf Monatsebene für den gewünschten Monat an. Der Wert für den Tag wird ignoriert.
Rollennamen-ARN	Der ARN der Rolle mit einer angefügten Berechtigungsrichtlinie, die dem Service Zugriff auf Ihre Ressourcen gewährt.
Name des Amazon S3 S3-Ziel-Buckets	Der Name (der benutzerfreundliche Name, nicht der ARN) des Amazon S3-Ziel-Buckets. Ihre Datensets werden an diesem Speicherort veröffentlicht.
Amazon S3 S3-Zielpräfix	(Optional) Das Amazon S3 S3-Präfix für den veröffentlichten Datensatz, ähnlich einem Verzeichnispfad in Standarddateisystemen. Beispiel: Bei Wahl des Bucket-Namens `mybucket` und des Präfixes `myprefix/mydatasets` wird die Ausgabedatei in `s3://DOC-EXAMPLE-BUCKET/myprefix/mydatasets/outputfile` veröffentlicht. Wenn die Präfix-Verzeichnisstruktur nicht vorhanden ist, wird sie erstellt. Wenn kein Präfix angegeben wird, wird der Datensatz im Amazon S3 S3-Bucket-Root veröffentlicht.
SNS-Thema-ARN	Der ARN für das Amazon SNS SNS-Thema, das benachrichtigt wird, wenn der Datensatz veröffentlicht wurde oder wenn ein Fehler auftritt.

Antworten

Der AWS Marketplace Commerce Analytics Service gibt zwei Antworten zurück. Die erste ist synchron, was sofort zurückgegeben wird, und die zweite ist asynchron, die über Amazon SNS zurückgegeben wird. Die synchrone Antwort ähnelt diesem Beispiel.

Dataset-Parameter
Feld	Beschreibung
Dataset-Anforderungs-ID	Eine eindeutige Kennung für eine bestimmte Anforderung des Services. Diese Kennung kann dazu dienen, eine Anforderung mit Benachrichtigungen über das Amazon SNS-Thema zu korrelieren.

Die asynchrone Antwort wird als Dokument im JSON-Format zu Ihrem Amazon SNS SNS-Thema veröffentlicht und ähnelt diesem Beispiel.

Dataset-Parameter
Feld	Beschreibung
S3-Speicherort des Dataset	Der Bucket-Name und Schlüssel für den gelieferten Dataset.
S3-Speicherort der Dataset-Metadaten	Der Bucket-Name und Schlüssel für den gelieferte Dataset-Metadatendatei.
Dataset-Anforderungs-ID	Eine eindeutige Kennung für eine bestimmte Anforderung des Services. Diese Kennung kann dazu dienen, eine Anforderung mit Benachrichtigungen über das Amazon SNS-Thema zu korrelieren.
Herzlichen Glückwunsch	True, wenn die Operation erfolgreich war, „false“, wenn dies nicht der Fall ist.
Fehlermeldung	(Optional) Wenn ein Fehler aufgetreten ist (d. h. „Success“ ist „false“), enthält diese Meldung Informationen über den Fehler.

Beispiel einer asynchronen Antwort im JSON-Format



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

Nach einer erfolgreichen Anfrage wird der angeforderte Datensatz als CSV-Datei an Ihren Amazon S3 S3-Bucket übermittelt. Eine Metadatendatei im JSON-Format wird im selben Verzeichnis wie die Datenset-Datei veröffentlicht. Die Metadatendatei bietet nützliche Informationen über das Dataset und die ursprünglichen Anforderungsparameter. Die Metadatendatei hat den gleichen Namen wie das Dataset, aber mit der Erweiterung .meta.json. Die folgende Tabelle listet die Metadatenfelder in der CSV-Datei auf.

Metadaten-Felder
Feld	Beschreibung
Dataset-Anforderungs-ID	Eine eindeutige Kennung für eine bestimmte Anforderung des Services. Diese Kennung kann dazu dienen, eine Anforderung mit Benachrichtigungen über das Amazon SNS-Thema zu korrelieren.
Dataset-Gültigkeitsbereich	Definiert Startdatum/-zeit und Enddatum/-zeit des Datengültigkeitsbereichs. Diese Daten befinden sich im ISO 8601-Format.
Dataset-Anforderungsparameter	Die ursprünglichen Anforderungsparameter für die `GenerateDataSet`-Methode.
S3-Speicherort des Dataset	Der Bucket-Name und Schlüssel für den gelieferten Dataset.
S3-Speicherort der Dataset-Metadaten	Der Bucket-Name und Schlüssel für den gelieferte Dataset-Metadatendatei.

Es folgt ein Beispiel für in JSON formatierte Metadateninhalte.



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

Eine vollständige Liste der verfügbaren Datensets, einschließlich Verfügbarkeitsdaten, finden Sie in der AWS SDK-Dokumentation.

Fehlerbehebung

In diesem Abschnitt werden Lösungen für Probleme beschrieben, die bei der Nutzung des AWS Marketplace Commerce Analytics Service auftreten können.

Ich kann wegen eines Problems mit der Zulassungsliste nicht auf den Service zugreifen.

Wenn Sie noch nicht als Verkäufer registriert sind AWS Marketplace, besuchen Sie die Seite, AWS Marketplace Management Portalum sich zu registrieren. Wenn Sie sich bereits am als Verkäufer registriert haben AWS Marketplace, wenden Sie sich an das AWS Marketplace Seller Operations Team.

Ich kann keine Datensätze für ein Datum in der Vergangenheit anfordern, obwohl sie laut der SDK-Dokumentation für dieses Datum verfügbar sein sollten.

Obwohl Datensets als für bestimmte Daten in der Vergangenheit verfügbar aufgelistet werden, verfügen wir nur über Daten, seit Sie AWS Marketplace beigetreten sind. Wenn Sie der Meinung sind, dass es sich hierbei um einen Fehler handelt, wenden Sie sich an das AWS Marketplace Seller Operations-Team.

Beim Aufruf des Service erhalte ich eine Fehlermeldung, die besagt: "Es konnte keine Verbindung mit dem Endpunkt hergestellt werden, URL: https://marketplacecommerceanalytics.eu-central-1.amazonaws.com/".

Der AWS Marketplace Commerce Analytics Service ist nur in der Region USA Ost (Nord-Virginia) verfügbar. Alle Aufrufe des Commerce Analytics Service müssen an den Endpunkt us-east-1 gerichtet werden.

Wenn Sie den verwenden AWS CLI, fügen Sie jedem Anruf die --region Markierung "hinzu und geben Sie das AWS-Region als anus-east-1, wie im folgenden Beispiel gezeigt.



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

Ich möchte einen anderen Amazon S3-Bucket oder ein anderes Amazon SNS SNS-Thema verwenden als die, die ich beim Onboarding-Prozess ausgewählt habe.

Bei der Registrierung für den AWS Marketplace Commerce Analytics Service haben Sie einen Amazon S3-Bucket und ein Amazon SNS SNS-Thema angegeben. Der Onboarding-Prozess konfiguriert Ihre IAM-Berechtigungen so, dass der Service nur auf diese spezifischen Ressourcen zugreifen kann. Um verschiedene Ressourcen zu verwenden, müssen Sie Ihre IAM-Richtlinie ändern:

Melden Sie sich bei der an AWS Management Console und öffnen Sie die IAM-Konsole unter https://console.aws.amazon.com/iam/.
Wählen Sie Roles (Rollen) links in der IAM-Konsole.
Wählen Sie MarketplaceCommerceAnalyticsRole.
Erweitern Sie den Bereich Inline Roles (Inline-Rollen), sofern er nicht bereits erweitert ist.
Suchen Sie die Richtlinie, deren Name mit beginnt, oneClick_MarketplaceCommerceAnalyticsRoleund wählen Sie Richtlinie bearbeiten aus.
Suchen Sie im Richtliniendokument nach dem Bereich, der Aktionen bezüglich des Service angibt, den Sie ändern möchten. Um beispielsweise Ihren Amazon S3 S3-Bucket zu ändern, suchen Sie den Abschnitt, der die Aktionen enthält, die mit s3: beginnen, und ändern Sie die entsprechende Ressourcenauswahl, um Ihren neuen Amazon S3 S3-Bucket anzugeben.

Weitere Informationen zu IAM-Richtlinien finden Sie im folgenden Leitfaden: https://docs.aws.amazon.com/IAM/latest/ /access_policies.html UserGuide

Ich erhalte den Fehler AccessDeniedException, wenn ich die Aktion GenerateDataSet aufrufe.

Dies kann passieren, wenn Ihr Benutzer nicht über die zum Anrufen GenerateDataSet erforderlichen Berechtigungen verfügt. Im folgenden Verfahren werden die Schritte beschrieben, die erforderlich sind, um mithilfe der IAM-Konsole eine IAM-Richtlinie mit diesen Berechtigungen zu erstellen und die Berechtigungen Ihren Benutzern, Gruppen oder Rollen hinzuzufügen.

So verwenden Sie den JSON-Richtlinieneditor zum Erstellen einer Richtlinie

Melden Sie sich bei der an AWS Management Console und öffnen Sie die IAM-Konsole unter https://console.aws.amazon.com/iam/.
Wählen Sie im Navigationsbereich auf der linken Seite Policies (Richtlinien).

Wenn Sie zum ersten Mal Policies (Richtlinien) auswählen, erscheint die Seite Welcome to Managed Policies (Willkommen bei verwalteten Richtlinien). Wählen Sie Get Started.
Wählen Sie oben auf der Seite Create policy (Richtlinie erstellen) aus.
Wählen Sie im Bereich Policy editor (Richtlinien-Editor) die Option JSON aus.

Geben Sie folgendes JSON-Richtliniendokument ein:


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

Wählen Sie Weiter aus.

Anmerkung
Sie können jederzeit zwischen den Editoroptionen Visual und JSON wechseln. Wenn Sie jedoch Änderungen vornehmen oder im Visual-Editor Weiter wählen, strukturiert IAM Ihre Richtlinie möglicherweise um, um sie für den visuellen Editor zu optimieren. Weitere Informationen finden Sie unter Richtlinienrestrukturierung im IAM-Benutzerhandbuch.
Geben Sie auf der Seite Prüfen und erstellen unter Richtlinienname einen Namen und unter Beschreibung (optional) eine Beschreibung für die Richtlinie ein, die Sie erstellen. Überprüfen Sie Permissions defined in this policy (In dieser Richtlinie definierte Berechtigungen), um die Berechtigungen einzusehen, die von Ihrer Richtlinie gewährt werden.
Wählen Sie Create policy (Richtlinie erstellen) aus, um Ihre neue Richtlinie zu speichern.

Um Zugriff zu gewähren, fügen Sie Ihren Benutzern, Gruppen oder Rollen Berechtigungen hinzu:

Benutzer und Gruppen in AWS IAM Identity Center:

Erstellen Sie einen Berechtigungssatz. Befolgen Sie die Anweisungen unter Erstellen eines Berechtigungssatzes im AWS IAM Identity Center -Benutzerhandbuch.
Benutzer, die in IAM über einen Identitätsanbieter verwaltet werden:

Erstellen Sie eine Rolle für den Identitätsverbund. Befolgen Sie die Anweisungen unter Erstellen einer Rolle für einen externen Identitätsanbieter (Verbund) im IAM-Benutzerhandbuch.
IAM-Benutzer:
- Erstellen Sie eine Rolle, die Ihr Benutzer annehmen kann. Folgen Sie den Anweisungen unter Erstellen einer Rolle für einen IAM-Benutzer im IAM-Benutzerhandbuch.
- (Nicht empfohlen) Weisen Sie einem Benutzer eine Richtlinie direkt zu oder fügen Sie einen Benutzer zu einer Benutzergruppe hinzu. Befolgen Sie die Anweisungen unter Hinzufügen von Berechtigungen zu einem Benutzer (Konsole) im IAM-Benutzerhandbuch.

Mein Problem ist hier nicht aufgeführt.

Wenden Sie sich an das AWS Marketplace Seller Operations--Team.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Verkäufer-Toolkit

AWS Marketplace Felddemonstrationsprogramm

AWS Marketplace Analyseservice für den Handel

Bedingungen

Onboarding-Leitfaden

Um den AWS Marketplace Commerce Analytics Service zu nutzen

Richten Sie Ihre AWS-Konto Berechtigungen ein

Einen Amazon S3-Ziel-Bucket erstellen

Konfigurieren Sie ein Amazon SNS SNS-Thema für Antwortbenachrichtigungen

Anmelden bei dem Commerce Analytics Service-Programm

So ermöglichen Sie den Zugriff

Anmerkung

Überprüfen Ihrer Konfiguration

So testen Sie die Konfiguration

Technische Implementierungsanleitung

IAM-Richtlinien für den Commerce Analytics Service

Anfragen stellen mit dem AWS CLI

Erstellen von Anfragen mit der AWS SDK for Java

Technische Dokumentation

Antworten

Outputs

Fehlerbehebung

So verwenden Sie den JSON-Richtlinieneditor zum Erstellen einer Richtlinie

Anmerkung