透過 Amazon Selling Partner 提供的資料 API - AWS 方案指引
報告 API資料資訊站 API

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

透過 Amazon Selling Partner 提供的資料 API

Amazon Selling Partner API （SP-API） 是以 REST為基礎API，可協助 Amazon 賣家和廠商以程式設計方式存取訂單、寄件、付款等資料。這些資料API可以提高銷售效率、減少人力需求，並改善對客戶的回應時間。本指南著重於您可以透過 Selling Partner API for Reports （報告 API） 和 Selling Partner API for Data Kiosk （Data Kiosk ） 存取的資料API。

報告 API

來自 報告的資料API旨在協助您在 Amazon Marketplace 上管理您的業務。分析報告提供有關產品、客戶和整體效能的寶貴洞見，例如：

  • 銷售績效 – 分析銷售資料可協助您識別趨勢和客戶購買模式。您可以使用此資訊來最佳化您的銷售策略。

  • 產品效能 – 分析產品資料可協助您識別哪些產品銷售良好，哪些產品銷售不佳。您可以使用此資訊來最佳化您的產品方案。

  • 客戶行為 – 分析客戶資料可協助您了解客戶的偏好和需求。您可以使用此資訊來個人化您的行銷和銷售策略。

下表說明每個品牌分析報告。下列報告可供具有 Brand Analytics 銷售合作夥伴API角色並在 Amazon Brand Registry 中註冊的 Amazon 賣家和廠商使用。

報告 描述 參數
市場購物籃分析報告 提供結帳時最常購買的項目資料，以及客戶購物籃 （購物車） 中的項目 您可以針對不同的報告期間 （DAY、MONTH、 WEEK或 ） 請求報告QUARTER。資料會跨這些期間提供。
Amazon Search Terms 報告 包含最常選取的 Amazon 標準識別號碼 （ASINs） 的資料，依搜尋關鍵字和市場部門排序 您可以針對不同的報告期間 （DAY、MONTH、 WEEK或 ） 請求報告QUARTER。請求無法跨越多個報告期間。
重複購買報告 包含銷售合作夥伴項目重複購買數量的資料 您可以針對不同的報告期間 （WEEK、 MONTH或 ） 請求報告QUARTER。資料可以跨越多個報告期間。

下表說明每個廠商零售分析和賣方零售分析報告。

報告 描述 可用性 參數
快速零售分析庫存報告 包含ASIN層級的庫存資料，彙總為每小時精細度 供應商 只能請求報告。資料可以跨越多個日期範圍期間，包括當天。
快速零售分析流量報告 包含客戶流量至廠商項目詳細資訊頁面的資料，每小時精細度 供應商 只能請求報告。資料可以跨越多個日期範圍期間。
快速零售分析銷售報告 包含ASIN層級的銷售資料，彙總為每小時的精細程度 供應商 只能請求報告。資料可以跨越多個日期範圍期間。
供應商銷售報告 包含在目錄層級和ASIN層級報告的關鍵零售銷售指標 （例如已訂購和已運送的營收和單位） 供應商

可針對不同的 請求報告：

  • 報告期間 （DAY、WEEKMONTH、QUARTER、 或 YEAR）

  • 經銷商檢視 （MANUFACTURING 或 SOURCING）

  • 銷售程式 （RETAIL、 BUSINESS或 FRESH）
Net Pure 產品利潤報告 包含 Amazon 淨純產品利潤的資料，用於銷售供應商的項目，在目錄層級和ASIN層級報告 供應商 您可以針對不同的報告期間 （DAY、WEEK、QUARTER、 MONTH或 ） 請求報告YEAR。
供應商流量報告 包含主要零售流量指標，例如在目錄層級和ASIN層級報告之概觀檢視 供應商 您可以針對不同的報告期間 （DAY、WEEK、QUARTER、 MONTH或 ） 請求報告YEAR。
供應商預測報告 包含前瞻平均值、前 70 個、前 80 個和前 90 個每週客戶需求預測，在最近每週預測產生日期的ASIN層級報告 供應商 您可以為不同的銷售計劃 （RETAIL 或 FRESH） 請求報告。
供應商庫存報告 包含目錄層級和ASIN層級報告的庫存和操作運作狀態指標 （例如可銷售的現有單位和廠商確認率） 供應商

可針對不同的 請求報告：

  • 報告期間 （DAY、WEEKMONTH、QUARTER、 或 YEAR）

  • 經銷商檢視 （MANUFACTURING 或 SOURCING）

  • 銷售程式 （RETAIL 或 FRESH）
銷售和流量業務報告 包含賣方整個目錄的關鍵銷售績效指標 （例如訂購的產品銷售、營收、訂購的單位和宣告金額） 和頁面流量指標 （例如頁面檢視和購買方塊百分比），並依日期和 ASIN 賣方 可以請求或排程報告。資料可以提供給不同的日期範圍彙總層級 （DAY、 WEEK或 MONTH） ASIN 和彙總層級 （PARENT、 CHILD或 SKU）。

資料資訊站 API

Data Kiosk API提供以 GraphQL為基礎的動態報告套件。它可協助您產生自訂 GraphQL 查詢，並從 Amazon 的資料集存取大量資料。您可以使用它API來存取各種資料，包括：

以下是 Data Kiosk 的主要功能API：

  • GraphQL 驅動的動態報告 – API支援 GraphQL 查詢操作，協助您建立自訂查詢，以擷取所需的特定資料。

  • 大量資料存取 – 您可以透過 存取大型資料集API，以促進全面的分析和報告。

  • 靈活的資料探索 – GraphQL 型方法允許動態、臨時的資料探索。此彈性可協助您反覆查詢並擷取洞見。

  • 全面的資料涵蓋範圍 – API提供對各種賣方和供應商資料的存取，實現全面的效能分析和商業智慧。

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

注意

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

賣方銷售和流量資料

在 Data Kiosk 中API， Analytics_SalesAndTraffic_2024_04_24是銷售和流量查詢的根類型。此根類型有兩個可用的查詢：

  • salesAndTrafficByAsin 會擷取由 ASIN（CHILD、 PARENT或 ） 彙總的銷售和流量資料SKU。

  • salesAndTrafficByDate 會擷取依日期 （DAY、 WEEK或 ） 彙總的銷售和流量資料MONTH。

請注意下列有關這些查詢的事項：

  • 列舉的類型 （列舉的數字），例如 AsinGranularity和 DateGranularity，指定彙總層級。

  • 純量類型，例如日期 ，用於表示資料。

供應商分析資料

在 Data Kiosk 中API， Analytics_vendorAnalytics_2024_09_30是廠商分析查詢的根類型。此根類型有兩個可用的檢視：

  • manufacturingView 會擷取您所生產產品的指標，並依指定日期彙總。

  • sourcingView 會擷取您直接來源至 Amazon 之產品的指標，並依指定日期彙總。

您可以根據指派給您作為供應商的角色 （SOURCING 或 ），存取相關檢視及其相關指標MANUFACTURING。這些查詢包括開始和結束日期、市場識別符、彙總指標和總指標。請注意下列有關這些查詢的事項：

  • 指標使用 ManufacturingViewMetricsGroupedBy和 SourcingViewMetricsGroupedBy類型，依各種屬性 （例如 ASIN或品牌） 分組。

  • 指標類型，例如 costs、orders、 customerSatisfaction和 productAvailability，代表不同的指標群組。

  • DateGranularity 列舉會指定日期彙總的層級。

賣方經濟資料

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

在 Data Kiosk 中API， Analytics_Economics_2024_03_15是賣方經濟型查詢的根類型。特定產品的賣方經濟效益資料由 Economics類型表示。此類型包含下列關鍵層面：

  • ads – 產品在指定日期範圍內的廣告支出資料。

  • cost – 賣方為此產品提供的 Amazon 折扣成本 （每單位）。

  • fees – 在指定日期範圍內套用至產品的費用。

  • fnsku – 產品的 Fulfillment Network Stock Keeping Unit （FNSKU）。

  • msku – 產品的商家庫存保存單位 （MSKU）。

  • netProceeds – 此產品在指定日期範圍內的淨收益。

  • sales – 指定日期範圍內的產品銷售資料。