本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 透過 Amazon Selling Partner API 提供的資料
<a name="data-sp-api"></a>

[Amazon Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/welcome) (SP-API) 是以 REST 為基礎的 API，可協助 Amazon 賣方和廠商以程式設計方式存取訂單、運送、付款等方面的資料。來自此 API 的資料可以提高銷售效率、減少人力需求，並改善對客戶的回應時間。本指南著重於您可以透過[銷售合作夥伴 API for Reports ](https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-use-case-guide)（報告 API) 和[銷售合作夥伴 API for Data Kiosk ](https://developer-docs.amazon.com/sp-api/docs/data-kiosk-workflow-guide)(Data Kiosk API) 存取的資料。

## 報告 API
<a name="data-reports-api"></a>

來自 報告 API 的資料旨在協助您在 Amazon 市集上管理您的業務。[分析報告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics)提供有關您的產品、客戶和整體效能的寶貴洞見，例如：
+ **銷售效能** – 分析銷售資料可協助您識別趨勢和客戶購買模式。您可以使用此資訊來最佳化您的銷售策略。
+ **產品效能** – 分析產品資料可協助您識別哪些產品銷售良好，哪些產品銷售不佳。您可以使用此資訊來最佳化您的產品方案。
+ **客戶行為** – 分析客戶資料可協助您了解客戶的偏好設定和需求。您可以使用此資訊來個人化您的行銷和銷售策略。

下表說明每個[品牌分析](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#brand-analytics-reports)報告。下列報告可供具有 Brand Analytics 銷售合作夥伴 API 角色並在 Amazon Brand Registry 中註冊的 Amazon 賣方和廠商使用。


****  

| 報告 | Description | Parameters | 
| --- | --- | --- | 
| [市場購物車分析報告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#market-basket-analysis-report) | 提供在結帳時最常購買的項目資料，以及客戶購物車 （購物車） 中的項目 | 您可以針對不同的報告期間 (DAY、MONTH、 WEEK或 ) 請求報告QUARTER。資料會跨這些期間提供。 | 
| [Amazon 搜尋詞彙報告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#amazon-search-terms-report) | 透過搜尋關鍵字和市場部門，包含最常選取的 Amazon 標準識別號碼 (ASINs) 的資料 | 您可以針對不同的報告期間 (DAY、MONTH、 WEEK或 ) 請求報告QUARTER。請求不能跨越多個報告期間。 | 
| [重複購買報告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#repeat-purchase) | 包含銷售合作夥伴項目重複購買數量的資料 | 您可以針對不同的報告期間 (WEEK、 MONTH或 ) 請求報告QUARTER。資料可以跨越多個報告期間。 | 

下表說明每個[廠商零售分析](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-retail-analytics-reports)和[賣方零售分析](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#seller-retail-analytics-reports)報告。


****  

| 報告 | Description | 可用性 | Parameters | 
| --- | --- | --- | --- | 
| [快速零售分析庫存報告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-inventory-report) | 包含 ASIN 層級的庫存資料，彙總為每小時精細程度 | 廠商 | 只能請求報告。資料可以跨越多個日期範圍期間，包括當天。 | 
| [快速零售分析流量報告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-traffic-report) | 包含客戶流量至廠商項目詳細資訊頁面的資料，每小時精細程度 | 廠商 | 只能請求報告。資料可以跨越多個日期範圍期間。 | 
| [快速零售分析銷售報告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-sales-report) | 包含 ASIN 層級的銷售資料，彙總為每小時精細程度 | 廠商 | 只能請求報告。資料可以跨越多個日期範圍期間。 | 
| [供應商銷售報告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-sales-report) | 包含在目錄層級和 ASIN 層級報告的關鍵零售銷售指標 （例如訂購和運送收入和單位） | 廠商 | 您可以針對不同的 請求報告：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/prescriptive-guidance/latest/strategy-gen-ai-selling-partner-api/data-sp-api.html) | 
| [Net Pure 產品利潤報告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#net-pure-product-margin-report) | 包含 Amazon 淨純產品邊界的資料，用於銷售廠商的項目，在目錄層級和 ASIN 層級報告 | 廠商 | 您可以針對不同的報告期間 (DAY、WEEK、QUARTER、 MONTH或 ) 請求報告YEAR。 | 
| [廠商流量報告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-traffic-report) | 包含主要零售流量指標，例如在目錄層級和 ASIN 層級回報的注視檢視 | 廠商 | 您可以針對不同的報告期間 (DAY、WEEK、QUARTER、 MONTH或 ) 請求報告YEAR。 | 
| [廠商預測報告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-forecasting-report) | 包含前瞻平均值、前 70 個、前 80 個和前 90 個每週客戶需求預測，在最近每週預測產生日期的 ASIN 層級報告 | 廠商 | 您可以為不同的銷售計劃請求報告 (RETAIL 或 FRESH)。 | 
| [廠商庫存報告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-inventory-report) | 包含目錄層級和 ASIN 層級報告的庫存和操作運作狀態指標 （例如可銷售的現有單位和廠商確認率） | 廠商 | 您可以針對不同的 請求報告：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/prescriptive-guidance/latest/strategy-gen-ai-selling-partner-api/data-sp-api.html) | 
| [銷售和流量商業報告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#sales-and-traffic-business-report) | 包含賣方整個目錄的關鍵銷售績效指標 （例如訂購的產品銷售、營收、訂購單位和宣告金額） 和頁面流量指標 （例如頁面檢視和購買方塊百分比），依日期和 ASIN 彙總 | 賣方 | 您可以請求或排程報告。資料可以提供給不同的日期範圍彙總層級 (DAY、 WEEK或 MONTH) 和 ASIN 彙總層級 (PARENT、 CHILD或 SKU)。 | 

## Data Kiosk API
<a name="data-kiosk-api"></a>

Data Kiosk API 提供以 [GraphQL](https://graphql.org/) 為基礎的動態報告套件。它可協助您產生自訂 GraphQL 查詢，並從 Amazon 的資料集存取大量資料。您可以使用此 API 來存取各種資料，包括：
+ [賣方銷售和流量資料](#data-kiosk-api-seller-sales-traffic-data)
+ [供應商分析資料](#data-kiosk-api-vendor-analytics-data)
+ [賣方經濟資料](#data-kiosk-api-seller-economics-data)

以下是 Data Kiosk API 的主要功能：
+ **GraphQL 支援的動態報告** – API 支援 GraphQL 查詢操作，可協助您建立自訂查詢，以擷取所需的特定資料。
+ **大量資料存取** – 您可以透過 API 存取大型資料集，以便進行全面的分析和報告。
+ **靈活的資料探**勘 – GraphQL 型方法允許動態、臨機操作的資料探勘。此彈性可協助您反覆查詢並擷取洞見。
+ **全面的資料涵蓋**範圍 – API 可讓您存取各種賣方和廠商資料，實現全面的效能分析和商業智慧。

Data Kiosk API 中的結構描述和指令提供結構化的方式來透過 GraphQL API 存取您的資料，並能夠根據您的特定需求彙總和篩選資料。透過使用 Data Kiosk API，您可以更深入地深入了解銷售、流量和分析資料。這可讓您做出明智、資料驅動的決策，以最佳化您的商業策略。

**注意**  
查詢的保留會根據請求的欄位而有所不同。結構描述中的每個欄位都會以指令標註，該`@resultRetention`指令會定義包含該欄位的查詢將保留多久。當查詢包含具有不同保留的多個欄位時，會套用最短 （最少） 保留。查詢產生的文件保留一律符合查詢的保留。

### 賣方銷售和流量資料
<a name="data-kiosk-api-seller-sales-traffic-data"></a>

在 Data Kiosk API 中， `Analytics_SalesAndTraffic_2024_04_24`是銷售和流量查詢的根類型。此根類型有兩個可用的查詢：
+ `salesAndTrafficByAsin` 會擷取 ASIN (`PARENT`、 `CHILD`或 ) 彙總的銷售和流量資料`SKU`。
+ `salesAndTrafficByDate` 會擷取依日期 (`DAY`、 `WEEK`或 ) 彙總的銷售和流量資料`MONTH`。

請注意下列有關這些查詢的事項：
+ 列舉的類型 （列舉），例如 `AsinGranularity`和 `DateGranularity`，指定彙總層級。
+ 純量類型，例如 [Date](https://the-guild.dev/graphql/scalars/docs/scalars/date)，用於表示資料。

### 供應商分析資料
<a name="data-kiosk-api-vendor-analytics-data"></a>

在 Data Kiosk API 中， `Analytics_vendorAnalytics_2024_09_30`是廠商分析查詢的根類型。此根類型有兩個可用的檢視：
+ `manufacturingView` 會擷取您所生產產品的指標，並依指定的日期彙總。
+ `sourcingView` 會擷取您直接來源至 Amazon 之產品的指標，並依指定的日期彙總。

您可以根據以廠商身分指派給您的角色 (`SOURCING` 或 )，存取相關檢視及其相關指標`MANUFACTURING`。這些查詢包括開始和結束日期、市場識別符、彙總指標和總指標。請注意下列有關這些查詢的事項：
+ 指標使用 `ManufacturingViewMetricsGroupedBy`和 `SourcingViewMetricsGroupedBy`類型，依各種屬性 （例如 ASIN 或品牌） 分組。
+ 指標類型，例如 `costs`、`orders`、 `customerSatisfaction`和 `productAvailability`，代表不同的指標群組。
+ `DateGranularity` 列舉會指定日期彙總的層級。

### 賣方經濟資料
<a name="data-kiosk-api-seller-economics-data"></a>

賣方經濟報告提供 Amazon 市場效能和財務的完整檢視。它涵蓋銷售資料、廣告支出、費用、成本和淨收益。您可以依日期和產品識別符彙總資料。

在 Data Kiosk API 中， `Analytics_Economics_2024_03_15`是賣方經濟型查詢的根類型。特定產品的賣方經濟數據由 `Economics`類型表示。此類型包含下列關鍵層面：
+ `ads` – 產品在指定日期範圍內的廣告支出資料。
+ `cost` – 賣方為此產品提供的 Amazon 折扣成本 （每單位）。
+ `fees` – 在指定日期範圍內套用至產品的費用。
+ `fnsku` – 產品的履行網路股票保存單位 (FNSKU)。
+ `msku` – 產品的商家股票保存單位 (MSKU)。
+ `netProceeds` – 此產品在指定日期範圍內的淨繼續。
+ `sales` – 指定日期範圍內產品的銷售資料。