Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Dati disponibili tramite l'API Amazon Selling Partner L'[Amazon Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/welcome) (SP-API) è un'API basata su REST che aiuta venditori e fornitori Amazon ad accedere in modo programmatico ai propri dati su ordini, spedizioni, pagamenti e molto altro. I dati di questa API possono aumentare l'efficienza di vendita, ridurre il fabbisogno di manodopera e migliorare i tempi di risposta ai clienti. Questa guida si concentra sui dati a cui puoi accedere tramite [Selling Partner API for Reports (Reports](https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-use-case-guide) API) e [Selling Partner API for Data Kiosk (Data Kiosk](https://developer-docs.amazon.com/sp-api/docs/data-kiosk-workflow-guide) API). ## API per i report I dati dell'API Reports sono progettati per aiutarti a gestire la tua attività sul marketplace Amazon. I [report di analisi](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics) forniscono informazioni preziose sui tuoi prodotti, clienti e prestazioni complessive, come: + **Prestazioni di vendita**: l'analisi dei dati di vendita può aiutarti a identificare le tendenze e i modelli di acquisto dei clienti. Puoi utilizzare queste informazioni per ottimizzare la tua strategia di vendita. + **Prestazioni del prodotto**: l'analisi dei dati di prodotto può aiutarti a identificare quali prodotti vendono bene e quali no. È possibile utilizzare queste informazioni per ottimizzare l'offerta di prodotti. + **Comportamento dei clienti**: l'analisi dei dati dei clienti può aiutarti a comprendere le preferenze e le esigenze dei clienti. Puoi utilizzare queste informazioni per personalizzare le tue strategie di marketing e vendita. La tabella seguente illustra ogni rapporto di [analisi del marchio](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#brand-analytics-reports). I seguenti report sono disponibili per i venditori e i fornitori Amazon che hanno il ruolo di Selling Partner API di Brand Analytics e sono registrati nel Registro marche Amazon. **** | Report | Description | Parameters | | --- | --- | --- | | [Rapporto sull'analisi del paniere di mercato](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#market-basket-analysis-report) | Fornisce dati sugli articoli più comunemente acquistati in combinazione con gli articoli nel carrello (carrello) del cliente al momento del pagamento | Il rapporto può essere richiesto per diversi periodi di rendicontazione (DAYWEEK,MONTH, oQUARTER). I dati vengono forniti in tali periodi. | | [Report sui termini di ricerca di Amazon](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#amazon-search-terms-report) | Contiene dati sui numeri di identificazione standard Amazon (ASINs) selezionati più frequentemente, per parola chiave di ricerca e reparto per un marketplace | Il rapporto può essere richiesto per diversi periodi di rendicontazione (DAYWEEK,MONTH,, oQUARTER). Le richieste non possono estendersi su più periodi di rendicontazione. | | [Report sugli acquisti ripetuti](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#repeat-purchase) | Contiene dati sulla quantità di acquisti ripetuti degli articoli del partner di vendita | Il rapporto può essere richiesto per diversi periodi di rendicontazione (WEEKMONTH,, oQUARTER). I dati possono estendersi su più periodi di rendicontazione. | La tabella seguente illustra l'analisi delle vendite al dettaglio di ciascun [fornitore e il rapporto sull'analisi](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-retail-analytics-reports) della vendita [al dettaglio dei venditori](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#seller-retail-analytics-reports). **** | Report | Description | Disponibilità | Parameters | | --- | --- | --- | --- | | [Rapporto sull'inventario di Rapid Retail Analytics](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-inventory-report) | Contiene dati di inventario a livello di ASIN, aggregati con una granularità oraria | Fornitori | Il rapporto può essere solo richiesto. I dati possono coprire più intervalli di date, incluso il giorno corrente. | | [Rapporto sul traffico di Rapid Retail Analytics](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-traffic-report) | Contiene dati sul traffico dei clienti verso le pagine di dettaglio degli articoli del fornitore, con granularità oraria | Fornitori | Il rapporto può essere solo richiesto. I dati possono estendersi su più periodi di intervalli di date. | | [Rapporto sulle vendite di Rapid Retail Analytics](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-sales-report) | Contiene dati di vendita a livello di ASIN, aggregati con una granularità oraria | Fornitori | Il rapporto può essere solo richiesto. I dati possono estendersi su più periodi di intervalli di date. | | [Rapporto sulle vendite del fornitore](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-sales-report) | Contiene le principali metriche relative alle vendite al dettaglio (come ricavi e unità ordinate e spedite), riportate a livello di catalogo e a livello di ASIN | Fornitori | Il rapporto può essere richiesto per diversi:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/strategy-gen-ai-selling-partner-api/data-sp-api.html) | | [Rapporto sul margine netto del prodotto puro](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#net-pure-product-margin-report) | Contiene dati sui margini netti di prodotto puri di Amazon per la vendita di articoli del fornitore, riportati a livello di catalogo e a livello di ASIN | Fornitori | Il rapporto può essere richiesto per diversi periodi di rendicontazione (DAY,, WEEK MONTHQUARTER, o). YEAR | | [Rapporto sul traffico dei fornitori](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-traffic-report) | Contiene le metriche chiave del traffico al dettaglio, come le visualizzazioni rapide, riportate a livello di catalogo e a livello di ASIN | Fornitori | Il rapporto può essere richiesto per diversi periodi di rendicontazione (DAY,, WEEK MONTHQUARTER, o). YEAR | | [Rapporto di previsione dei fornitori](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-forecasting-report) | Contiene previsioni previsionali sulla domanda dei clienti settimanali, precedenti 70, 80 e 90 precedenti, riportate a livello di ASIN per la data di generazione settimanale più recente delle previsioni | Fornitori | Il rapporto può essere richiesto per diversi programmi di vendita (o). RETAIL FRESH | | [Rapporto sull'inventario del fornitore](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-inventory-report) | Contiene le metriche relative all'inventario e allo stato operativo (come le unità disponibili vendibili e la percentuale di conferma del fornitore), riportate a livello di catalogo e a livello di ASIN | Fornitori | Il rapporto può essere richiesto per diversi:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/strategy-gen-ai-selling-partner-api/data-sp-api.html) | | [Rapporto aziendale sulle vendite e sul traffico](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#sales-and-traffic-business-report) | Contiene le metriche chiave sulla performance di vendita (come le vendite dei prodotti ordinati, i ricavi, le unità ordinate e l'importo del reclamo) e le metriche del traffico delle pagine (come le visualizzazioni di pagina e la percentuale di acquisto) per l'intero catalogo del venditore, aggregato per data e ASIN | Venditori | Il rapporto può essere richiesto o programmato. I dati possono essere forniti per diversi livelli di aggregazione per intervalli di date (DAY,WEEK, orMONTH) e livelli di aggregazione ASIN (PARENTCHILD, o). SKU | ## API Data Kiosk L'API Data Kiosk fornisce una suite di reportistica dinamica basata su [GraphQL](https://graphql.org/). Ti aiuta a generare query GraphQL personalizzate e ad accedere a dati di massa dai set di dati di Amazon. Puoi utilizzare questa API per accedere a un'ampia gamma di dati, tra cui: + [Dati sul traffico e sulle vendite del venditore](#data-kiosk-api-seller-sales-traffic-data) + [Dati di analisi dei fornitori](#data-kiosk-api-vendor-analytics-data) + [Dati economici del venditore](#data-kiosk-api-seller-economics-data) Di seguito sono riportate le funzionalità principali dell'API Data Kiosk: + **Reporting dinamico basato su GraphQL**: l'API supporta le operazioni di query GraphQL, aiutandoti a creare query personalizzate per recuperare i dati specifici di cui hai bisogno. + Accesso di **massa ai dati: puoi accedere a** set di dati di grandi dimensioni tramite l'API, facilitando analisi e report completi. + **Esplorazione flessibile dei dati**: l'approccio basato su GraphQL consente l'esplorazione dinamica dei dati ad hoc. Questa flessibilità consente di iterare le query ed estrarre informazioni. + **Copertura completa dei dati**: l'API fornisce l'accesso a un'ampia gamma di dati di venditori e fornitori, abilitando analisi olistiche delle prestazioni e business intelligence. Gli schemi e le direttive dell'API Data Kiosk forniscono un modo strutturato per accedere ai dati tramite un'API GraphQL, con la possibilità di aggregare e filtrare i dati in base alle esigenze specifiche. Utilizzando l'API Data Kiosk, puoi ottenere informazioni più approfondite e fruibili sui dati di vendita, traffico e analisi. Questo ti consente di prendere decisioni informate e basate sui dati per ottimizzare le tue strategie aziendali. **Nota** La conservazione di una query varia in base ai campi richiesti. Ogni campo all'interno di uno schema è annotato con una `@resultRetention` direttiva che definisce per quanto tempo verrà conservata una query contenente quel campo. Quando una query contiene più campi con conservazioni diverse, viene applicata la conservazione più breve (minima). La conservazione dei documenti risultanti da una query corrisponde sempre alla conservazione della query. ### Dati sul traffico e sulle vendite del venditore Nell'API Data Kiosk, `Analytics_SalesAndTraffic_2024_04_24` è il tipo principale per le richieste relative alle vendite e al traffico. Sono disponibili due query per questo tipo di radice: + `salesAndTrafficByAsin`recupera i dati sulle vendite e sul traffico aggregati per ASIN (`PARENT`,, `CHILD` or). `SKU` + `salesAndTrafficByDate`recupera i dati sulle vendite e sul traffico aggregati per data (`DAY`,, o). `WEEK` `MONTH` Tieni presente quanto segue su queste domande: + I tipi enumerati (enum), come `AsinGranularity` e`DateGranularity`, specificano il livello di aggregazione. + I tipi scalari, come [Date](https://the-guild.dev/graphql/scalars/docs/scalars/date), vengono utilizzati per rappresentare i dati. ### Dati di analisi dei fornitori Nell'API Data Kiosk, `Analytics_vendorAnalytics_2024_09_30` è il tipo principale per le query di analisi dei fornitori. Sono disponibili due visualizzazioni per questo tipo di radice: + `manufacturingView`recupera le metriche relative ai prodotti fabbricati, aggregate in base alla data specificata. + `sourcingView`recupera le metriche sui prodotti che acquisti direttamente su Amazon, aggregate in base alla data specificata. Accedi alla visualizzazione pertinente e alle metriche associate in base al ruolo che ti è stato assegnato come fornitore (o). `SOURCING` `MANUFACTURING` Queste query includono le date di inizio e di fine, l'identificatore del marketplace, le metriche aggregate e le metriche totali. Tieni presente quanto segue su queste domande: + Le metriche sono raggruppate in base a vari attributi (come ASIN o marchio) utilizzando i tipi e. `ManufacturingViewMetricsGroupedBy` `SourcingViewMetricsGroupedBy` + I tipi di metriche, ad esempio`costs`,, e `customerSatisfaction` `orders``productAvailability`, rappresentano i diversi gruppi di metriche. + L'`DateGranularity`enum specifica il livello di aggregazione delle date. ### Dati economici del venditore Il report economico del venditore fornisce una panoramica completa della tua performance e dei tuoi dati finanziari sul marketplace Amazon. Copre i dati di vendita, la spesa pubblicitaria, le commissioni, i costi e i proventi netti. Puoi aggregare i dati per data e identificativo del prodotto. Nell'API Data Kiosk, `Analytics_Economics_2024_03_15` è il tipo principale per le query economiche dei venditori. I dati economici del venditore per un determinato prodotto sono rappresentati dal tipo. `Economics` Questo tipo include i seguenti aspetti chiave: + `ads`— I dati sulla spesa pubblicitaria per il prodotto entro l'intervallo di date specificato. + `cost`— Il costo al netto di Amazon fornito dal venditore per questo prodotto (per unità). + `fees`— Le commissioni applicate al prodotto entro l'intervallo di date specificato. + `fnsku`— La Fulfillment Network Stock Keeping Unit (FNSKU) del prodotto. + `msku`— La Merchant Stock Keeping Unit (MSKU) del prodotto. + `netProceeds`— I proventi netti di questo prodotto entro l'intervallo di date specificato. + `sales`— I dati di vendita del prodotto entro l'intervallo di date specificato.