Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
AWS Marketplace Service d'analyse du commerce
Le service AWS Marketplace Commerce Analytics vous permet d'accéder par programme aux données sur les produits et les clients via. AWS Marketplace Une fois inscrit au service, vous pouvez accéder à vos rapports d'utilisation, d'abonnement et de facturation via le AWS SDK.
Les données que vous demandez à l'aide SDK des outils vous sont fournies sous Compte AWS forme de jeux de données. La plupart des ensembles de données correspondent aux mêmes données que les rapports à base de texte disponibles sur Portail de gestion AWS Marketplace
Conditions générales
Les présentes conditions générales du service AWS Marketplace Commerce Analytics (les « CASConditions ») contiennent les conditions générales spécifiques à votre utilisation et à votre accès au service AWS Marketplace Commerce Analytics (« Service CA ») et entrent en vigueur à la date à laquelle vous cliquez sur le bouton « J'accepte » ou sur la case à cocher associée aux présentes CAS conditions ou, si cela est antérieur, lorsque vous utilisez une offre de service CA. Les présentes CAS conditions constituent un addendum aux conditions générales pour AWS Marketplace les vendeurs (les « conditions du AWS Marketplace vendeur ») entre vous et Amazon Web Services, Inc. (» AWS, » nous », « notre » ou « notre »), dont les termes sont incorporés aux présentes. En cas de conflit entre les présentes CAS conditions et les conditions du AWS Marketplace vendeur, les conditions générales des CAS présentes conditions s'appliquent, mais uniquement dans la mesure d'un tel conflit et uniquement en ce qui concerne votre utilisation du service CA. Les termes en majuscules utilisés dans le présent document mais non définis dans le présent document ont le sens indiqué dans les conditions du AWS Marketplace vendeur.
-
Services et CAS données CA. Pour bénéficier de l'accès au service CA, vous devez être un AWS Marketplace vendeur lié par les conditions de AWS Marketplace vente en vigueur. Les informations et données que vous recevez ou auxquelles vous avez accès dans le cadre du service CA (« CASDonnées ») constituent des informations sur les abonnés et sont soumises aux restrictions et obligations énoncées dans les conditions du AWS Marketplace vendeur. Vous pouvez utiliser les CAS données de manière confidentielle pour améliorer et cibler les activités marketing et autres activités promotionnelles liées à votre AWS Marketplace contenu à condition de ne pas (a) divulguer des CAS données à des tiers ; (b) utiliser des CAS données d'une manière incompatible avec les politiques ou lois de confidentialité applicables ; (c) contacter un abonné pour l'inciter à effectuer un autre achat en dehors de AWS Marketplace ; (d) nous dénigrer, nos filiales ou l'un de leurs produits respectifs ; ou (e) cibler communications de toute nature sur la base du le destinataire prévu étant un AWS Marketplace abonné.
-
Limitations du service CA et sécurité. Vous n'accéderez (ou ne tenterez d'accéder) au Service CA que par les moyens décrits dans la documentation du Service CA. Vous ne déformerez pas et ne masquerez pas votre identité ou l'identité de votre client lors de l'utilisation du Service CA. Nous nous réservons le droit, à notre seule discrétion, de définir et d'imposer des limites à votre utilisation du Service CA, notamment, sans s'y limiter, en ce qui concerne le nombre de connexions, d'appels et de serveurs autorisés à accéder au Service CA au cours d'une période donnée. Vous acceptez ces limitations et n'essayerez pas de les contourner. Nous nous réservons le droit de restreindre, de suspendre ou de résilier votre droit d'accès au service CA si nous pensons que vous enfreignez les présentes CAS conditions ou que vous utilisez le service CA de manière abusive.
-
Confidentialité des informations d'identification du Service CA et sécurité. Les informations d'identification de CA Service (telles que les mots de passe, les clés et le clientIDs) sont destinées à être utilisées par vous pour identifier votre API client. Vous êtes seul responsable de la confidentialité de vos informations d'identification et vous vous engagez à prendre toutes les mesures raisonnables pour éviter la divulgation, la diffusion ou l'utilisation non autorisée de ces informations d'identification, notamment, au minimum, les mesures que vous prenez pour protéger vos propres informations confidentielles de même nature. L'intégration des informations d'identification du Service CA à des projets open source n'est pas autorisée. Vous êtes seul responsable de tout accès au Service CA avec vos informations d'identification.
-
Modification. Nous pouvons modifier les CAS présentes conditions à tout moment en publiant une version révisée sur le AWS site ou en vous informant conformément aux conditions du AWS Marketplace vendeur. Les dispositions modifiées entreront en vigueur au moment de la publication ou, si nous vous envoyons une notification par e-mail, à la date indiquée dans l'e-mail. En continuant à utiliser ou à accéder au service CA après la date d'entrée en vigueur de toute modification apportée aux CAS présentes conditions, vous acceptez d'être lié par les conditions modifiées.
-
Résiliation. Les présentes CAS conditions et les droits d'utilisation des CAS données accordés ici seront résiliés, avec ou sans préavis, en cas de résiliation de vos conditions de AWS Marketplace vente pour quelque raison que ce soit. En outre, nous pouvons arrêter de fournir le Service CA ou résilier votre accès à ce service à tout moment, pour quelque raison que ce soit.
Guide d'intégration
Vous devez configurer votre Compte AWS et AWS services utiliser le service AWS Marketplace Commerce Analytics.
Pour utiliser le service d'analyse AWS Marketplace du commerce
Configurez votre Compte AWS avec des autorisations
AWS Marketplace recommande vivement d'utiliser les rôles AWS Identity and Access Management (IAM) pour vous connecter au Portail de gestion AWS Marketplace plutôt que d'utiliser les informations d'identification de votre compte root. Consultez Stratégies et autorisations pour les vendeurs AWS Marketplace les IAM autorisations spécifiques pour les autorisations du service AWS Marketplace Commerce Analytics. En créant différents utilisateurs pour les personnes accédant à votre compte, vous pouvez attribuer à chaque utilisateur un ensemble spécifique d'informations d'identification de sécurité. Vous pouvez également accorder des autorisations différentes à chaque utilisateur . Au besoin, vous pouvez modifier ou révoquer les autorisations d'un utilisateur à tout moment.
Création d'un compartiment Amazon S3 de destination
Le service Commerce Analytics fournit les données que vous demandez à un compartiment Amazon S3 que vous spécifiez. Si vous avez déjà un compartiment Amazon S3 à utiliser, passez à l'étape suivante.
Si vous n'avez pas de compartiment Amazon S3 ou si vous souhaitez créer un compartiment Amazon S3 spécifiquement pour ces données, consultez Comment créer un compartiment S3.
Configuration d'une SNS rubrique Amazon pour les notifications de réponse
Le service Commerce Analytics envoie des notifications de réponse via AmazonSNS. Le service publie des messages dans cette rubrique pour vous avertir lorsque vos ensembles de données sont disponibles ou si une erreur s'est produite. Si vous avez déjà créé un SNS sujet Amazon à cet effet, passez à l'étape suivante.
Si aucune SNS rubrique Amazon n'est configurée pour ce service, configurez-en une dès maintenant. Pour obtenir des instructions, consultez la section Création d'un sujet.
Enregistrez le sujet Amazon Resource Name (ARN) pour le sujet que vous avez créé, car il ARN est nécessaire pour appeler le service.
S'inscrire au programme Commerce Analytics Service
Le service Commerce Analytics accède au compartiment Amazon S3 et à la SNS rubrique Amazon une fois que vous avez configuré le ARN service avec le sujet et le nom du compartiment.
Pour activer cet accès :
-
Connectez-vous à l'appareil Portail de gestion AWS Marketplace
Compte AWS que vous utilisez pour gérer vos AWS Marketplace produits. -
Assurez-vous de disposer des IAMautorisations nécessaires pour vous inscrire au service AWS Marketplace Commerce Analytics.
-
Accédez à la page d'inscription de Commerce Analytics Service
. -
Entrez le nom du compartiment Amazon S3 et le SNS sujet AmazonARN, puis choisissez S'inscrire.
-
Sur la page des autorisations, choisissez Allow (Autoriser).
-
Sur le Portail de gestion AWS Marketplace, enregistrez le nom du rôle ARN dans le message de réussite. Vous en avez besoin ARN pour appeler le service.
Note
L'intégration au service d'analyse du commerce crée un IAM rôle dans votre Compte AWS. Le IAM rôle permet AWS Marketplace d'écrire dans le compartiment Amazon S3 et de publier des notifications sur le SNS sujet Amazon. AWS Marketplace utilise le compte 452565589796 pour effectuer les actions associées à ce rôle. IAM
Vérification de votre configuration
La dernière étape consiste à vérifier que votre configuration fonctionne comme prévu.
Pour tester votre configuration
-
Téléchargez, installez et configurez l'interface de ligne de AWS commande (AWS CLI).
-
À l'aide AWS CLI de, exécutez cette commande.
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 "{DOC-EXAMPLE-BUCKET}" \ --destination-s3-prefix "TEST_PREFIX" \ --sns-topic-arn "{YOUR-SNS-TOPIC-ARN}"
-
Pour
--data-set-publication-date
, remplacez{TODAY'S DATE}
par la date actuelle en utilisant le format ISO -8601YYYY-MM-DDT00:00:00Z
, oùYYYY
est l'année à quatre chiffres,MM
le mois à deux chiffres etDD
le jour à deux chiffres. -
Pour
--role-name-arn
, remplacez{YOUR-ROLE-NAME-ARN}
par le ARN rôle que vous avez reçu lors du processus d'inscription dansS'inscrire au programme Commerce Analytics Service. -
Pour --destination-s3-bucket-name, remplacez {DOC- EXAMPLE -BUCKET} par le nom du compartiment Amazon S3 dans lequel vous l'avez créé. Création d'un compartiment Amazon S3 de destination
-
Pour — sns-topic-arn, remplacez {YOUR- - SNS TOPIC -ARN} par le SNS sujet Amazon dans lequel vous avez crééConfiguration d'une SNS rubrique Amazon pour les notifications de réponse.
Si vous recevez une réponse du service, y compris la réponse d'dataSetRequestidentification, cela signifie que vous avez terminé le processus d'intégration. Une réponse de réussite ressemble à ceci :
{ "dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab" }
Guide de mise en œuvre technique
Le service d'analyse AWS Marketplace du commerce est fourni par le biais du AWSSDK
IAMpolitiques relatives au service d'analyse du commerce
Pour permettre à vos utilisateurs d'utiliser le service Commerce Analytics, les autorisations suivantes sont requises.
Utilisez la politique IAM d'autorisation suivante pour vous inscrire au service AWS Marketplace Commerce Analytics.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iam:ListRoles", "iam:CreateRole", "iam:CreatePolicy", "iam:AttachRolePolicy", "aws-marketplace-management:viewReports" ], "Resource": "*" } ] }
Utilisez la politique IAM d'autorisation suivante pour permettre à un utilisateur de faire des demandes au service AWS Marketplace Commerce Analytics.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "marketplacecommerceanalytics:GenerateDataSet", "Resource": "*" } ] }
Pour plus d'informations, consultez la section Création de politiques dans la IAM console dans le guide de IAM l'utilisateur.
Faire des demandes auprès du AWS CLI
Pour commencer, téléchargez AWS CLI
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"
Cette demande renvoie un identifiant propre à chaque demande. Vous pouvez utiliser cet identifiant pour corréler les demandes avec les notifications publiées dans votre SNS rubrique Amazon. Voici un exemple de cet identifiant.
{ "dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab" }
Envoi de demandes avec l' AWS SDK for Java
Pour commencer, téléchargez le AWSJava SDK
/* * 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); } }
Vous devriez obtenir des résultats similaires à cet exemple.
=============================================================== 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
Documentation technique
Le service propose une méthode qui vous permet de demander que des ensembles de données soient publiés dans votre compartiment Amazon S3. GenerateDataSet
Le tableau suivant répertorie les paramètres pour GenerateDataSet
.
Paramètres de l'ensemble de données | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Champ | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Type d'ensemble de données | Cet ensemble de données est renvoyé comme résultat de la demande. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Date de publication de l'ensemble de données |
Date à laquelle un ensemble de données a été publié. Pour les ensembles de données quotidiens, indiquez une date avec un niveau de granularité jour pour le jour voulu. Pour les ensembles de données mensuels, indiquez une date avec un niveau de granularité mensuel pour le mois voulu. La valeur jour est ignorée. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Nom du rôle ARN | Le ARN rôle auquel est attachée une politique d'autorisation qui permet au service d'accéder à vos ressources. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Nom du compartiment Amazon S3 de destination | Le nom (le nom convivial, pas leARN) du compartiment Amazon S3 de destination. Vos ensembles de données sont publiés dans cet emplacement. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Préfixe Amazon S3 de destination |
(Facultatif) Le préfixe Amazon S3 pour le jeu de données publié, similaire à un chemin de répertoire dans les systèmes de fichiers standard. Par exemple, avec le nom de compartiment Si le préfixe de la structure de répertoires n'existe pas, il est créé automatiquement. Si aucun préfixe n'est fourni, l'ensemble de données est publié sur la racine du compartiment Amazon S3. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SNSRubrique ARN |
Le ARN SNS sujet correspondant à Amazon qui est notifié lorsque le jeu de données a été publié ou en cas d'erreur. |
Réponses
Le service d'analyse du AWS Marketplace commerce renvoie deux réponses. Le premier est synchrone, qui est renvoyé immédiatement, et le second est asynchrone, qui est renvoyé via Amazon. SNS La réponse synchrone est similaire à cet exemple.
Paramètres des ensemble de données | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Champ | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ID de demande d'ensemble de données | Identifiant unique qui représente une demande spécifique au service. Cet identifiant peut être utilisé pour corréler une demande avec des notifications sur le SNS sujet Amazon. |
La réponse asynchrone est publiée sous forme de document JSON formaté dans votre SNS rubrique Amazon et est similaire à cet exemple.
Paramètres de l'ensemble de données | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Champ | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Emplacement S3 d'ensemble de données | Nom de compartiment et de clé pour l'ensemble de données diffusé. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Data Set Meta Data Emplacement S3 | Nom de compartiment et de clé pour le fichier de métadonnées de l'ensemble de données diffusé. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ID de demande d'ensemble de données | Identifiant unique qui représente une demande spécifique au service. Cet identifiant peut être utilisé pour corréler une demande avec des notifications sur le SNS sujet Amazon. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Réussite | « True » si l'opération a abouti, « false » dans le cas contraire. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Message | (Facultatif) Si une erreur s'est produite (par exemple, si « Success » a la valeur « false »), ce message contient des informations sur la défaillance. |
Exemple de JSON réponse asynchrone formatée
{ "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
Une fois la demande réussie, l'ensemble de données demandé est envoyé dans votre compartiment Amazon S3 sous forme de fichier .csv. Un fichier de métadonnées JSON au format -formaté est publié au même emplacement que le fichier du jeu de données. Le fichier de métadonnées fournit des informations utiles sur l'ensemble de données et les paramètres de la demande d'origine. Le fichier de métadonnées porte le même nom que le fichier de l'ensemble de données, mais se termine par l'extension . meta.json. Le tableau suivant répertorie les champs de métadonnées dans le fichier .csv.
Champs de métadonnées | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Champ | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ID de demande d'ensemble de données | Identifiant unique qui représente une demande spécifique au service. Cet identifiant peut être utilisé pour corréler une demande avec des notifications sur le SNS sujet Amazon. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Data Set Coverage Range | Définit la date/heure de début et de fin de la plage de couverture des données de date/heure. Ces dates sont au format ISO 8601. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Paramètres de demande d'ensemble de données | Paramètres de la demande d'origine à la méthode GenerateDataSet . |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Emplacement S3 d'ensemble de données | Nom de compartiment et de clé pour l'ensemble de données diffusé. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Data Set Meta Data Emplacement S3 | Nom de compartiment et de clé pour le fichier de métadonnées de l'ensemble de données diffusé. |
Voici un exemple de contenu de métadonnées JSON formaté.
{ "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" } }
Pour obtenir la liste complète des ensembles de données disponibles, y compris les dates de disponibilité, consultez la AWSSDKdocumentation.
Résolution des problèmes
Cette section décrit les solutions aux problèmes que vous pouvez rencontrer lors de l'utilisation du service AWS Marketplace Commerce Analytics.
Je ne peux pas accéder au service en raison d'un problème de liste d'autorisations.
Si vous n'êtes pas encore inscrit en tant que vendeur sur le AWS Marketplace, rendez-vous Portail de gestion AWS Marketplace
Je ne peux pas demander de jeux de données pour une date antérieure, même si la SDK documentation indique qu'ils devraient être disponibles pour cette date.
Même si des ensembles de données sont indiqués comme étant disponibles pour certains jours passés, nous ne disposons que des données pour les dates ultérieures à votre date d'inscription à AWS Marketplace. Si vous pensez qu'il s'agit d'une erreur, contactez l'équipe responsable des opérations vendeur AWS Marketplace
Lorsque j'appelle le service, je reçois le message d'erreur « Impossible de me connecter au point de terminaison URL : https://marketplacecommerceanalytics.eu-central-1.amazonaws.com/ »
Le service d'analyse AWS Marketplace du commerce est disponible uniquement dans la région de l'est des États-Unis (Virginie du Nord). Vous devez effectuer tous les appels de Commerce Analytics Service au point de terminaison us-east-1
.
Si vous utilisez le AWS CLI, ajoutez le --region
drapeau « » à chaque appel et spécifiez le « Région AWS as »us-east-1
, comme indiqué dans l'exemple suivant.
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
Je souhaite utiliser un bucket Amazon S3 ou un SNS topic Amazon différent de ceux que j'ai sélectionnés lors du processus d'intégration.
Lors de votre inscription au service AWS Marketplace Commerce Analytics, vous avez spécifié un compartiment Amazon S3 et une SNS rubrique Amazon. Le processus d'intégration configure vos IAM autorisations pour autoriser le service à accéder uniquement à ces ressources spécifiques. Pour utiliser différentes ressources, vous devez modifier votre IAM politique :
-
Connectez-vous à la IAM console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/iam/
. -
Choisissez Rôles sur le côté gauche de la IAM console.
-
Choisissez MarketplaceCommerceAnalyticsRole.
-
Développez la section Inline Roles (Rôles en ligne), si ce n'est pas déjà fait.
-
Recherchez la politique dont le nom commence par oneClick_MarketplaceCommerceAnalyticsRoleet choisissez Modifier la politique.
-
Dans le document de stratégie, recherchez la section qui spécifie les actions relatives au service que vous souhaitez modifier. Par exemple, pour modifier votre compartiment Amazon S3, recherchez la section qui inclut les actions commençant par s3 : et modifiez leur sélection de ressources respective pour spécifier votre nouveau compartiment Amazon S3.
Pour plus d'informations sur IAM les politiques, consultez le guide suivant : https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html
Je reçois une erreur AccessDeniedException
lorsque j'appelle l'option GenerateDataSet
Cela peut se produire si votre utilisateur n'a pas les autorisations nécessaires pour appelerGenerateDataSet
. La procédure suivante décrit les étapes nécessaires pour créer une IAM politique avec ces autorisations à l'aide de la IAM console et pour ajouter les autorisations à vos utilisateurs, groupes ou rôles.
Pour utiliser l'éditeur JSON de stratégie pour créer une stratégie
Connectez-vous à la IAM console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/iam/
. -
Dans le panneau de navigation de gauche, sélectionnez Policies (Politiques).
Si vous sélectionnez Politiques pour la première fois, la page Bienvenue dans les politiques gérées s'affiche. Sélectionnez Mise en route.
-
En haut de la page, sélectionnez Créer une politique.
-
Dans la section Éditeur de politiques, choisissez l'JSONoption.
-
Entrez le document JSON de politique suivant :
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "marketplacecommerceanalytics:GenerateDataSet", "Resource": "*" } ] }
-
Choisissez Suivant.
Note
Vous pouvez basculer entre les options Visual et celles de JSONl'éditeur à tout moment. Toutefois, si vous apportez des modifications ou si vous choisissez Suivant dans l'éditeur visuel, vous IAM pouvez restructurer votre politique afin de l'optimiser pour l'éditeur visuel. Pour plus d'informations, consultez la section Restructuration des politiques dans le guide de IAM l'utilisateur.
-
Sur la page Vérifier et créer, tapez un Nom de politique et une Description (facultative) pour la politique que vous créez. Vérifiez les Autorisations définies dans cette politique pour voir les autorisations accordées par votre politique.
-
Choisissez Create policy (Créer une politique) pour enregistrer votre nouvelle politique.
Pour activer l’accès, ajoutez des autorisations à vos utilisateurs, groupes ou rôles :
-
Utilisateurs et groupes dans AWS IAM Identity Center :
Créez un jeu d’autorisations. Suivez les instructions de la rubrique Création d’un jeu d’autorisations du Guide de l’utilisateur AWS IAM Identity Center .
-
Utilisateurs gérés IAM par le biais d'un fournisseur d'identité :
Créez un rôle pour la fédération d’identité. Suivez les instructions de la section Création d'un rôle pour un fournisseur d'identité tiers (fédération) dans le guide de IAM l'utilisateur.
-
IAMutilisateurs :
-
Créez un rôle que votre utilisateur peut assumer. Suivez les instructions de la section Création d'un rôle pour un IAM utilisateur dans le Guide de IAM l'utilisateur.
-
(Non recommandé) Attachez une politique directement à un utilisateur ou ajoutez un utilisateur à un groupe d’utilisateurs. Suivez les instructions de la section Ajouter des autorisations à un utilisateur (console) dans le guide de IAM l'utilisateur.
-
Mon problème n'est pas répertorié ici.
Contactez l'équipe responsable des opérations vendeur AWS Marketplace