Termini e condizioni Guida all'onboarding Guida all'implementazione tecnica Documentazione tecnica Risoluzione dei problemi

Marketplace AWS Servizio di analisi del commercio

Il servizio Marketplace AWS Commerce Analytics ti consente di accedere in modo programmatico ai dati dei prodotti e dei clienti tramite. Marketplace AWS Dopo esserti registrato al servizio, puoi accedere ai report di utilizzo, abbonamento e fatturazione tramite l'SDK. AWS

Commerce Analytics Service Overview.

I dati richiesti utilizzando gli strumenti SDK vengono forniti ai set di dati As. Account AWS La maggior parte dei set di dati corrisponde agli stessi dati dei report testuali disponibili su. Portale di gestione Marketplace AWS Puoi richiedere set di dati per una data specifica e i dati vengono consegnati al bucket Amazon S3 fornito. La notifica della consegna dei dati viene fornita da Amazon Simple Notification Service (Amazon SNS).

Termini e condizioni

I presenti Termini e condizioni del servizio Marketplace AWS Commerce Analytics (i «Termini CAS») contengono i termini e le condizioni specifici per l'utilizzo e l'accesso al servizio Marketplace AWS Commerce Analytics («Servizio CA») e hanno effetto dalla data in cui l'utente fa clic sul pulsante «Accetto» o sulla casella di controllo presente nei presenti Termini CAS o, se precedente, quando si utilizza un'offerta di CA Service. I presenti Termini CAS sono un'aggiunta ai Termini e condizioni per Marketplace AWS i venditori (i «Termini del Marketplace AWS venditore») stipulati tra te e Amazon Web Services, Inc. (» AWS», «noi» o «nostro»), i cui termini sono qui incorporati. In caso di conflitto tra i presenti Termini CAS e i Termini del Marketplace AWS venditore, si applicano i termini e le condizioni dei presenti Termini CAS, ma solo nella misura di tale conflitto e esclusivamente per quanto riguarda l'utilizzo del Servizio CA da parte dell'utente. I termini in maiuscolo utilizzati nel presente documento ma non definiti nel presente documento avranno il significato stabilito nelle Condizioni del venditore. Marketplace AWS

Servizi CA e dati CAS. Per avere diritto all'accesso al Servizio CA, devi essere un Marketplace AWS venditore vincolato dalle Condizioni di Marketplace AWS vendita esistenti. Le informazioni e i dati che l'utente riceve o a cui ha accesso in relazione al Servizio CA («Dati CAS») costituiscono Informazioni sull'abbonato e sono soggetti alle restrizioni e agli obblighi stabiliti nei Termini di vendita. Marketplace AWS È possibile utilizzare i dati CAS in modo riservato per migliorare e indirizzare il marketing e altre attività promozionali relative ai propri Marketplace AWS contenuti, a condizione di non (a) divulgare i dati CAS a terzi; (b) utilizzare i dati CAS in alcun modo non conforme alle politiche o alla legge sulla privacy applicabili; (c) contattare un abbonato per influenzarlo a effettuare un acquisto alternativo al di fuori del Marketplace AWS; (d) denigrare noi, i nostri affiliati o dei loro prodotti o dei nostri rispettivi prodotti; o (e) indirizzare comunicazioni di qualsiasi tipo sulla base del fatto che il destinatario previsto sia un Marketplace AWS abbonato.
Limitazioni e sicurezza del servizio CA. L'utente accederà (o tenterà di accedere) al servizio CA solo con i mezzi descritti nella documentazione di CA Service. Non falsificherai o maschererai la tua identità o l'identità del tuo cliente quando utilizzi il servizio CA. Ci riserviamo il diritto, a nostra esclusiva discrezione, di stabilire e applicare limiti all'utilizzo del servizio CA da parte dell'utente, inclusi, a titolo esemplificativo, il numero di connessioni, chiamate e server autorizzati ad accedere al servizio CA in qualsiasi periodo di tempo. L'utente accetta e non tenterà di aggirare tali limitazioni. Ci riserviamo il diritto di limitare, sospendere o revocare il diritto dell'utente di accedere al Servizio CA se riteniamo che l'utente stia violando i presenti Termini CAS o stia utilizzando in modo improprio il Servizio CA.
Riservatezza e sicurezza delle credenziali del servizio CA. Le credenziali di CA Service (come password, chiavi e ID client) sono pensate per essere utilizzate dall'utente per identificare il client API. L'utente è l'unico responsabile della riservatezza delle proprie credenziali e adotterà tutte le misure ragionevoli per evitare la divulgazione, la diffusione o l'uso non autorizzato di tali credenziali, incluse, come minimo, le misure adottate per proteggere le proprie informazioni riservate di natura simile. Le credenziali di CA Service non possono essere incorporate in progetti open source. L'utente è l'unico responsabile di qualsiasi accesso al servizio CA con le proprie credenziali.
Modifica. Possiamo modificare i presenti Termini CAS in qualsiasi momento pubblicando una versione rivista sul Sito AWS o fornendoti un avviso in conformità con i Termini del Marketplace AWS venditore. I termini modificati entreranno in vigore al momento della pubblicazione o, se ti informiamo via e-mail, come indicato nel messaggio e-mail. Continuando a utilizzare o ad accedere al Servizio CA dopo la data di entrata in vigore di qualsiasi modifica ai presenti Termini CAS, l'utente accetta di essere vincolato dai termini modificati.
Cessazione. I presenti Termini CAS e i diritti di utilizzo dei Dati CAS qui concessi cesseranno, con o senza preavviso, al momento della risoluzione delle Condizioni del venditore per qualsiasi motivo. Marketplace AWS Inoltre, possiamo interrompere la fornitura dei Servizi CA o interrompere l'accesso dell'utente ai Servizi CA in qualsiasi momento, per qualsiasi motivo o senza motivo.

Guida all'onboarding

È necessario configurare Account AWS e Servizi AWS utilizzare il servizio Marketplace AWS Commerce Analytics.

Per utilizzare il servizio Marketplace AWS Commerce Analytics

Configura le tue Account AWS autorizzazioni.
Crea un bucket Amazon S3 di destinazione.
Configurazione di un argomento Amazon SNS per le notifiche di risposta.
Iscriviti al programma Commerce Analytics Service.
Verifica la tua configurazione.

Configura le tue Account AWS autorizzazioni

Marketplace AWS consiglia vivamente di utilizzare i ruoli AWS Identity and Access Management (IAM) per accedere Portale di gestione Marketplace AWS anziché utilizzare le credenziali dell'account root. Vedi le autorizzazioni IAM specifiche Politiche e autorizzazioni per i venditori Marketplace AWS per le autorizzazioni del servizio Marketplace AWS Commerce Analytics. Creando singoli utenti per le persone che devono accedere al tuo account, puoi assegnare a ogni utente un set univoco di credenziali di sicurezza. Puoi anche concedere autorizzazioni diverse a ciascun utente . Se necessario, modificare o revocare le autorizzazioni di un utente in qualsiasi momento.

Crea un bucket Amazon S3 di destinazione

Il servizio Commerce Analytics fornisce i dati richiesti a un bucket Amazon S3 da te specificato. Se hai già un bucket Amazon S3 da usare, procedi al passaggio successivo.

Se non disponi di un bucket Amazon S3 o desideri creare un bucket Amazon S3 specifico per questi dati, consulta Come faccio a creare un bucket S3.

Il servizio Commerce Analytics fornisce notifiche di risposta utilizzando Amazon SNS. Il servizio pubblica messaggi su questo argomento per avvisarti quando i set di dati sono disponibili o se si è verificato un errore. Se hai già un argomento su Amazon SNS a questo scopo, procedi al passaggio successivo.

Se non hai un argomento Amazon SNS configurato per questo servizio, configurane uno ora. Per istruzioni, consulta Creare un argomento.

Registra l'argomento Amazon Resource Name (ARN) per l'argomento che hai creato, poiché l'ARN è necessario per chiamare il servizio.

Iscriviti al programma Commerce Analytics Service

Il servizio Commerce Analytics accede al bucket Amazon S3 e all'argomento Amazon SNS dopo aver configurato il servizio con l'ARN per l'argomento e il nome del bucket.

Per abilitare l'accesso

Accedi al Portale di gestione Marketplace AWSfile Account AWS che usi per gestire i tuoi Marketplace AWS prodotti.
Assicurati di disporre delle autorizzazioni IAM necessarie per iscriverti al Marketplace AWS Commerce Analytics Service.
Vai alla pagina di registrazione al servizio Commerce Analytics.
Inserisci il nome del bucket Amazon S3 e l'argomento ARN dell'argomento Amazon SNS e scegli Enroll.
Nella pagina delle autorizzazioni, scegli Consenti.
In Portale di gestione Marketplace AWS, registrare l'ARN del nome del ruolo nel messaggio di successo. È necessario l'ARN per chiamare il servizio.

Nota

L'onboarding al Commerce Analytics Service crea un ruolo IAM nel tuo. Account AWS Il ruolo IAM consente di Marketplace AWS scrivere nel bucket Amazon S3 e pubblicare notifiche sull'argomento Amazon SNS. Marketplace AWS utilizza l'account 452565589796 per eseguire queste azioni associate a questo ruolo IAM.

Verifica la tua configurazione

L'ultimo passaggio consiste nel verificare che la configurazione funzioni come previsto.

Per testare la configurazione

Scarica, installa e configura l'interfaccia a riga di comando AWS (AWS CLI).

Usando AWS CLI, esegui questo comando.



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

Per--data-set-publication-date, sostituisci {TODAY'S DATE} con la data corrente utilizzando il formato ISO-8601YYYY-MM-DDT00:00:00Z, dove YYYY è l'anno a quattro cifre, è il mese a due cifre e MM è il giorno a due cifre. DD
Per--role-name-arn, sostituiscilo {YOUR-ROLE-NAME-ARN} con l'ARN del ruolo ricevuto durante la procedura di iscrizione. Iscriviti al programma Commerce Analytics Service
Per --destination-s3-bucket-name, sostituisci {YOUR-S3-BUCKET} con il bucket Amazon S3 in cui hai creato. Crea un bucket Amazon S3 di destinazione
Per —sns-topic-arn, sostituisci {YOUR-SNS-TOPIC-ARN} con l'argomento Amazon SNS in cui hai creato. Configurazione di un argomento Amazon SNS per le notifiche di risposta

Se ricevi una risposta che include la risposta relativa all'ID dei dati dal servizio, significa che hai completato la procedura di onboarding. SetRequest Una risposta corretta ha il seguente aspetto:



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

Guida all'implementazione tecnica

Il servizio Marketplace AWS Commerce Analytics viene fornito tramite l'SDK AWS. Questa guida mostra come interagire con il servizio utilizzando AWS CLIe il AWS SDK for Java.

Politiche IAM per il servizio Commerce Analytics

Per consentire ai tuoi utenti di utilizzare il servizio Commerce Analytics, sono necessarie le seguenti autorizzazioni.

Utilizza la seguente politica di autorizzazioni IAM per registrarti al servizio Marketplace AWS Commerce Analytics.


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

Utilizza la seguente politica di autorizzazione IAM per consentire a un utente di effettuare richieste al servizio Marketplace AWS Commerce Analytics.


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

Per ulteriori informazioni, consulta Creating Policies in the IAM console nella IAM User Guide.

Effettuare richieste con AWS CLI

Per iniziare, scarica AWS CLI. L' AWS CLI esempio seguente effettua una richiesta per il set di dati Abbonamenti orari/mensili per il 1° ottobre 2017. Questo set di dati viene pubblicato nel bucket demo-bucket Amazon S3 utilizzando il prefisso demo-prefix e il messaggio di notifica viene recapitato all'argomento Amazon SNS relativo all'argomento demo.



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"

Questa richiesta restituisce un identificatore unico per ogni richiesta. Puoi utilizzare questo identificatore per correlare le richieste con le notifiche pubblicate sul tuo argomento Amazon SNS. L'esempio seguente è un esempio di questo identificatore.



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

Effettuare richieste con il AWS SDK for Java

Per iniziare, scarica l'SDK AWS Java. L' AWS SDK for Java esempio seguente effettua una richiesta per il set di dati Hourly/Monthly Subscriptions per il 1° ottobre 2015. Questo set di dati viene pubblicato nel bucket demo-bucket Amazon S3 utilizzando il prefisso demo-prefix e il messaggio di notifica viene recapitato all'argomento Amazon SNS relativo all'argomento demo.



/*
* 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 Marketplace AWS 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 Marketplace AWS 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 Marketplace AWS 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 Marketplace AWS"
+ "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);
}
}

Dovresti aspettarti risultati simili a quelli di questo esempio.



===============================================================
Getting Started with Marketplace AWS 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

Documentazione tecnica

Il servizio presenta un metodo che consente di richiedere la pubblicazione di set di dati nel bucket Amazon S3. GenerateDataSet La tabella seguente elenca i parametri per. GenerateDataSet

Parametri del set di dati
Campo	Descrizione
Tipo di set di dati	Questo set di dati verrà restituito come risultato della richiesta.
Data di pubblicazione del set di dati	Data di pubblicazione di un set di dati. Per i set di dati giornalieri, fornisci una data con granularità a livello di giorno per il giorno desiderato. Per i set di dati mensili, fornisci una data con granularità a livello di mese per il mese desiderato. Il valore del giorno viene ignorato.
Nome del ruolo ARN	L'ARN del ruolo con una politica di autorizzazioni allegata che fornisce al servizio l'accesso alle tue risorse.
Nome del bucket Amazon S3 di destinazione	Il nome (il nome descrittivo, non l'ARN) del bucket Amazon S3 di destinazione. I tuoi set di dati vengono pubblicati in questa posizione.
Prefisso Amazon S3 di destinazione	(Facoltativo) Il prefisso Amazon S3 per il set di dati pubblicato, simile a un percorso di directory nei file system standard. Ad esempio, se vengono forniti il nome del bucket `mybucket` e il prefisso`myprefix/mydatasets`, il file di output viene pubblicato su. `s3://DOC-EXAMPLE-BUCKET/myprefix/mydatasets/outputfile` Se la struttura della directory del prefisso non esiste, viene creata. Se non viene fornito alcun prefisso, il set di dati viene pubblicato nella radice del bucket Amazon S3.
SNS Topic ARN (ARN argomento SNS)	L'ARN per l'argomento Amazon SNS che viene notificato quando il set di dati è stato pubblicato o se si verifica un errore.

Risposte

Il servizio Marketplace AWS Commerce Analytics restituisce due risposte. Il primo è sincrono, che viene restituito immediatamente, mentre il secondo è asincrono, che viene restituito utilizzando Amazon SNS. La risposta sincrona è simile a questo esempio.

Parametri del set di dati
Campo	Descrizione
ID della richiesta del set di dati	Un identificatore univoco che rappresenta una richiesta specifica al servizio. Questo identificatore può essere utilizzato per correlare una richiesta con le notifiche sull'argomento Amazon SNS.

La risposta asincrona viene pubblicata come documento in formato JSON nell'argomento Amazon SNS ed è simile a questo esempio.

Parametri del set di dati
Campo	Descrizione
Posizione del set di dati S3	Il nome e la chiave del bucket per il set di dati fornito.
Posizione del set di dati Meta Data S3	Il nome e la chiave del bucket per il file di metadati del set di dati fornito.
ID della richiesta del set di dati	Un identificatore univoco che rappresenta una richiesta specifica al servizio. Questo identificatore può essere utilizzato per correlare una richiesta con le notifiche sull'argomento Amazon SNS.
Riuscito	«Vero» se l'operazione è riuscita; «falso» in caso contrario.
Messaggio	(Facoltativo) Se si è verificato un errore (ad esempio, «Success» è «falso»), questo messaggio contiene informazioni sull'errore.

Esempio di risposta asincrona in formato 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

Dopo una richiesta riuscita, il set di dati richiesto viene inviato al tuo bucket Amazon S3 come file.csv. Un file di metadati in formato JSON viene pubblicato nella stessa posizione del file del set di dati. Il file di metadati fornisce informazioni utili sul set di dati e sui parametri della richiesta originale. Il file di metadati ha lo stesso nome del file del set di dati, ma termina con l'estensione .meta.json. La tabella seguente elenca i campi di metadati nel file.csv.

Campi di metadati
Campo	Descrizione
ID della richiesta del set di dati	Un identificatore univoco che rappresenta una richiesta specifica al servizio. Questo identificatore può essere utilizzato per correlare una richiesta con le notifiche sull'argomento Amazon SNS.
Intervallo di copertura del set di dati	Definisce la data/ora di inizio e la data/ora di fine per l'intervallo di copertura dei dati. Queste date sono in formato ISO 8601.
Parametri di richiesta del set di dati	I parametri di richiesta originali del `GenerateDataSet` metodo.
Posizione del set di dati S3	Il nome e la chiave del bucket per il set di dati fornito.
Posizione del set di dati Meta Data S3	Il nome e la chiave del bucket per il file di metadati del set di dati fornito.

Di seguito è riportato un esempio di contenuto di metadati in formato JSON.



{
"dataSetRequestId": "43d7137b-8a94-4042-a09d-c41e87f371c1",
"dataSetCoverageRange": {
"startDateTime": "2014-06-08T00:00:00.000Z",
"endDateTime": "2014-06-08T23:59:59.000Z"
},
"dataSetRequestParameters": {
"sellerAccountId": "123412341234",
"dataSetType": "customer_subscriber_hourly_monthly_subscriptions",
"dataSetPublicationDate": "2014-06-09T00:00:00.000Z",
"roleNameArn": "arn:aws:iam::123412341234:role/MarketplaceCommerceAnalyticsRole",
"destinationS3BucketName": "demo-bucket",
"destinationS3Prefix": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions",
"snsTopicArn": "arn:aws:sns:us-west-2:123412341234:demo-topic"
},
"dataSetS3Location": {
"bucketName": "demo-bucket",
"key": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.csv"
},
"dataSetMetaDataS3Location": {
"bucketName": "demo-bucket",
"key": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.meta.json"
}
}

Per un elenco completo dei set di dati disponibili, comprese le date di disponibilità, consulta la documentazione dell'SDK AWS.

Risoluzione dei problemi

Questa sezione descrive le soluzioni ai problemi che potresti riscontrare utilizzando il servizio Marketplace AWS Commerce Analytics.

Non riesco ad accedere al servizio a causa di un problema relativo all'elenco degli indirizzi consentiti.

Se non sei ancora registrato come venditore su Marketplace AWS, visita la pagina dedicata Portale di gestione Marketplace AWSalla registrazione. Se ti sei già registrato come venditore su Marketplace AWS, contatta il team Marketplace AWS Operativo del venditore.

Non posso richiedere set di dati per una data precedente, anche se la documentazione dell'SDK afferma che dovrebbero essere disponibili per questa data.

Anche se i set di dati sono indicati come disponibili per determinate date in passato, abbiamo dati solo dal momento in cui ti sei iscritto. Marketplace AWS Se ritieni che si tratti di un errore, contatta il team operativo del Marketplace AWS venditore.

Quando chiamo il servizio, ricevo il messaggio di errore «Impossibile connettersi all'URL dell'endpoint: https://marketplacecommerceanalytics.eu-central-1.amazonaws.com/»

Il servizio Marketplace AWS Commerce Analytics è disponibile solo nella regione Stati Uniti orientali (Virginia settentrionale). È necessario effettuare tutte le chiamate al Commerce Analytics Service verso l'us-east-1endpoint.

Se utilizzi il AWS CLI, aggiungi il --region flag "a ogni chiamata e specifica « Regione AWS as»us-east-1, come mostrato nell'esempio seguente.



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

Voglio utilizzare un bucket Amazon S3 o un argomento Amazon SNS diverso da quelli che ho selezionato durante la procedura di onboarding.

Durante la registrazione al servizio Marketplace AWS Commerce Analytics, hai specificato un bucket Amazon S3 e un argomento Amazon SNS. Il processo di onboarding configura le autorizzazioni IAM per consentire al servizio di accedere solo a queste risorse specifiche. Per utilizzare risorse diverse, devi modificare la tua policy IAM:

Accedi AWS Management Console e apri la console IAM all'indirizzo https://console.aws.amazon.com/iam/.
Scegli Ruoli sul lato sinistro della console IAM.
Scegli MarketplaceCommerceAnalyticsRole.
Espandi la sezione Ruoli in linea, se non è già stata espansa.
Individua la politica con un nome che inizia con oneClick_MarketplaceCommerceAnalyticsRolee scegli Modifica politica.
Nel documento di policy, individua la sezione che specifica le azioni relative al servizio che desideri modificare. Ad esempio, per modificare il tuo bucket Amazon S3, individua la sezione che include le azioni che iniziano con s3: e modifica la rispettiva selezione di risorse per specificare il tuo nuovo bucket Amazon S3.

Per ulteriori informazioni sulle politiche IAM, consulta la seguente guida: https://docs.aws.amazon.com/IAM/latest/ /access_policies.html UserGuide

Ricevo un AccessDeniedException errore quando richiamo l'GenerateDataSetazione

Questo può accadere se l'utente non dispone delle autorizzazioni necessarie per effettuare una chiamataGenerateDataSet. La procedura seguente descrive i passaggi necessari per creare una policy IAM con tali autorizzazioni utilizzando la console IAM e aggiungere le autorizzazioni a utenti, gruppi o ruoli.

Come utilizzare l'editor di policy JSON per creare una policy

Accedi AWS Management Console e apri la console IAM all'indirizzo https://console.aws.amazon.com/iam/.
Nel riquadro di navigazione a sinistra, seleziona Policies (Policy).

Se è la prima volta che selezioni Policy, verrà visualizzata la pagina Benvenuto nelle policy gestite. Seleziona Inizia.
Nella parte superiore della pagina, scegli Crea policy.
Nella sezione Editor di policy, scegli l'opzione JSON.

Inserisci il documento di policy JSON seguente:


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

Seleziona Successivo.

Nota
È possibile alternare le opzioni dell'editor Visivo e JSON in qualsiasi momento. Se tuttavia si apportano modifiche o si seleziona Successivo nell'editor Visivo, IAM potrebbe ristrutturare la policy in modo da ottimizzarla per l'editor visivo. Per ulteriori informazioni, consulta Modifica della struttura delle policy nella Guida per l'utente di IAM.
Nella pagina Rivedi e crea, inserisci un valore in Nome policy e Descrizione (facoltativo) per la policy in fase di creazione. Rivedi Autorizzazioni definite in questa policy per visualizzare le autorizzazioni concesse dalla policy.
Seleziona Crea policy per salvare la nuova policy.

Per fornire l'accesso, aggiungi autorizzazioni ai tuoi utenti, gruppi o ruoli:

Utenti e gruppi in AWS IAM Identity Center:

Crea un set di autorizzazioni. Segui le istruzioni riportate nella pagina Create a permission set (Creazione di un set di autorizzazioni) nella Guida per l'utente di AWS IAM Identity Center .
Utenti gestiti in IAM tramite un provider di identità:

Crea un ruolo per la federazione delle identità. Segui le istruzioni riportate nella pagina Creating a role for a third-party identity provider (federation) (Creazione di un ruolo per un provider di identità di terze parti [federazione]) nella Guida per l'utente di IAM.
Utenti IAM:
- Crea un ruolo che l'utente possa assumere. Per istruzioni, consulta la pagina Creating a role for an IAM user (Creazione di un ruolo per un utente IAM) nella Guida per l'utente di IAM.
- (Non consigliato) Collega una policy direttamente a un utente o aggiungi un utente a un gruppo di utenti. Segui le istruzioni riportate nella pagina Aggiunta di autorizzazioni a un utente (console) nella Guida per l'utente di IAM.

Il mio problema non è elencato qui.

Contatta il team operativo Marketplace AWS del venditore.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Toolkit per venditori

Marketplace AWS Programma dimostrativo sul campo

Marketplace AWS Servizio di analisi del commercio

Termini e condizioni

Guida all'onboarding

Per utilizzare il servizio Marketplace AWS Commerce Analytics

Configura le tue Account AWS autorizzazioni

Crea un bucket Amazon S3 di destinazione

Configurazione di un argomento Amazon SNS per le notifiche di risposta

Iscriviti al programma Commerce Analytics Service

Per abilitare l'accesso

Nota

Verifica la tua configurazione

Per testare la configurazione

Guida all'implementazione tecnica

Politiche IAM per il servizio Commerce Analytics

Effettuare richieste con AWS CLI

Effettuare richieste con il AWS SDK for Java

Documentazione tecnica

Risposte

Output

Risoluzione dei problemi

Come utilizzare l'editor di policy JSON per creare una policy

Nota