View a markdown version of this page

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

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

透過 Amazon Selling Partner API 提供的資料

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

報告 API

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

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

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

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

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

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

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

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

您可以針對不同的 請求報告：

  • 報告期間 (DAY、WEEK、QUARTER、 MONTH或 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、WEEK、QUARTER、 MONTH或 YEAR)

  • 經銷商檢視 (MANUFACTURING 或 SOURCING)

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

Data Kiosk 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 (PARENT、 CHILD或 ) 彙總的銷售和流量資料SKU。

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

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

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

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

供應商分析資料

在 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 – 產品的履行網路股票保存單位 (FNSKU)。

  • msku – 產品的商家股票保存單位 (MSKU)。

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

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