經驗賣家 · 商品管理實作

我們是經營歐盟多個國家站點的 Amazon 賣家。最近整理商品的 variation family 與 variation theme,是希望讓符合規則的變體共享評論,讓買家在同一家族比較選項,同時簡化廣告管理,減少分散投放和重複管理帶來的不必要支出。同一件商品要在多個國家站點分別整理,這些重複工作對我們尤其有感。
這次我們用 SP-API 處理,感受很直接。讀出現有資料、列出要改的欄位、先做預檢,再逐項提交與回讀,整個過程比較容易掌握。中途遇到缺欄位,我們能指出是哪一個子商品、少了哪項親子資料,再修正那一筆。
如果你也卡在 Amazon 變體主題調整,先理解 API 怎麼處理這組資料,比找一份「保證成功」的模板有用。下面用我們自己一次英國站的整理經驗,說明這套方法的好處與邊界。
我們想整理評論,也想讓廣告更好管理
商品分散在不同家族時,買家比較選項和查看相關評論都比較費事。我們希望把適合的變體整理在一起,讓買家在同一個家族選擇。評論能否共享,仍要符合Amazon 的評論共享條件,不能把原來的評論數直接相加當成整理後的結果。
廣告也是我們想改善的一部分。商品分散時,我們要花更多時間核對投放、預算和表現。整理家族後,我們希望集中檢視商品,按適合的子商品安排投放,減少重複管理與不必要的分散支出,讓廣告預算更好掌握。
共享合資格評論、簡化廣告管理與減少不必要廣告費,是這次整理的業務目標。我們還沒有用整理前後的數據證明廣告費或 ACoS 已下降,這篇先分享執行方法。
01改變體主題,會連動整組親子資料
Variation family 是一組父子商品關係。父商品負責把選項放在同一家族,買家購買的是子商品;每個子商品仍有自己的商品識別與供貨資料。Variation theme 則定義買家用什麼差異來選擇,例如類目允許的顏色、尺寸,或兩者的組合。
假設一件衣服有不同顏色和尺寸,你要整理的就不只是一個 theme 名稱。你得核對父子關係、各子商品的顏色與尺寸,以及該站點、該 product type 允許的設定。這裡用衣服作概念例子,並非本次實際商品。
Amazon 官方說明,變體主題建立後不能直接更改。原主題選錯時,應建立正確主題的新家族,再移入既有子商品,實際處理可能需要 Seller Support。你仍須確認商品適合放在同一家族,不能把不同款式、功能或組成硬塞進顏色選項。API 是提交資料的管道,沒有另外一套變體政策。
02SP-API 怎麼處理這件事
我們用的是 Selling Partner API,處理商品刊登資料,與建立廣告活動的 Amazon Ads API 分開。你可以把它想成讓程式與 Amazon 交換結構化商品資料的接口。賣家須先授權應用程式,開發者再依權限呼叫相關功能。
這次流程主要用到兩組功能。Product Type Definitions API讓我們取得指定站點與 product type 的資料規格,包括必填欄位與允許值。工程師可以先查規格,確認當次適用的變體主題和條件,不必把以前下載的模板當成永久規則。
Listings Items API則讓我們讀取和提交賣家的 SKU 刊登資料。程式先保存目前狀態,再比對預定結構,列出需要變更的父子關係、主題和選項屬性。需要局部更新時,可以用 PATCH 指定屬性路徑,減少把其他健康欄位一起重送的機會。
PATCH 也有粒度限制。工程師若替換一個屬性,就得依規格提供該屬性需要的完整內容,不能假設沒傳的值都會保留。因此我們在提交前先保存原始資料,並檢查變更範圍。
03我們遇到的問題,API 怎麼幫上忙
這次英國站整理牽涉一個保留父商品與 11 個既有子商品。我們希望保留子商品身份與供貨資料,所以從一開始就把「變體結構」與「商品本身」分開核對。
預檢沒有一次通過。第一輪預檢要求我們在提交內容中,明確寫出移入子商品的 parentage 資料;補上後,另一批原有子商品的提交內容,也需要明示其既有親子關係。我們依回傳結果補齊相關欄位,重新預檢,才走到正式提交。
這是我們覺得 API 比較好用的地方。我們的工具保存每筆請求、回應和變更前後狀態,你能追到哪一筆少了什麼,再修那一筆。用 flat file 也能讀處理報告找錯,但一組變體拆散在多列、多個欄位時,你還得回表格交叉檢查父子關係。
完成提交後,我們回讀賣家刊登資料和目錄關係,核對家族結構;也檢查 11 個子商品的可購買狀態、商品身份與供貨資料。本次這些檢查通過,這裡記錄的是技術回讀結果,實際家族與主題仍須符合官方政策。我們沒有量測兩種方法的工時,也沒有可比較的 flat file 失敗次數,所以不把這次經驗換算成省時百分比。
04Flat file 與 API,差在你怎麼控制變更
| 比較項目 | Flat file | SP-API 搭配自建工具 |
|---|---|---|
| 讀取現況 | 下載資料,人工比對父子列與欄位 | 程式讀刊登與關係資料,保存變更前快照 |
| 檢查規格 | 按站點、類目模板與處理報告確認 | 查當次 schema,再跑支援的提交預檢 |
| 修正問題 | 回到表格找對應列、欄位後重送 | 依 SKU 與回應問題修正指定屬性 |
| 保留紀錄 | 另存版本,對照上傳檔與處理報告 | 工具可逐筆保存請求、回應與驗證結果 |
| 無法自行修改的資料 | 整理檔案與處理結果,開 Support case | 整理請求與回讀結果,同樣可能要開 case |
| 適用情況 | 少量偶發作業,多國站點要重複整理 | 重複或跨站點作業,可共用流程,各站分別提交與驗證 |
Flat file 仍然適合少量、偶發、由人手整理的作業。你不需要先開發工具,熟悉模板後也能批次處理。API 的前期成本較高,要有人處理授權、程式、錯誤回應和維護;當你經常跨站點整理變體,或同一家族需要反覆核對,這些投入才比較容易發揮價值。
大量更新也能走JSON_LISTINGS_FEED,使用同類刊登資料規格並讀取處理報告。本文比較的是表格操作與程式化管理,不代表批次檔案都屬於舊方法。
API 的優勢也取決於工具怎麼寫。工程師若沒有保存紀錄、比較差異、處理限流與失敗重試,改用 JSON 提交也可能出錯。我們這次覺得容易管理,是因為把讀取、預檢、提交與驗證連成同一套流程。
一件商品,要在多個國家分別處理
對我們這種 EU 多國賣家,重複工作會隨站點數增加。同一件商品在一站整理好,其他國家站點仍要核對親子關係、當地語言的選項,以及各自的目錄狀態。用 flat file 時,你要反覆準備資料、讀處理報告,再確認每一站的結果。
API 讓我們共用讀取、比對、預檢與回讀的流程,但每站仍須依當次 schema 和資料分別提交、分別驗證。不能假設同一份 JSON 到處適用,也不能把一站完成當成全部 EU 已同步。本文以英國站的一次實作說明操作流程;處理歐盟各站時,我們也需要逐站確認規格與結果。
有些欄位,最後還是得開 case
有些欄位用 flat file 改不動,換成 API 也一樣。碰到目前不允許賣家編輯、由系統控制,或牽涉目錄層級的資料時,我們能提交的範圍可能有限,最後還是得回到老方法,開 Seller Support case。
這時我們會把目前值、預期修改、已提交的資料與錯誤回應整理好,請支援團隊確認處理方式。開 case 也不代表一定能改,但至少能帶著完整紀錄說明問題,不用一直重送同一份資料。這也是 Amazon 賣家的日常。
05我們會保留的六個操作步驟
- 先保存現況。讀取父子商品、賣家刊登與目錄關係,保存商品身份及供貨資料,列清楚哪些欄位要改。
- 取得當次規格。按目標站點和 product type 查詢 schema,同時確認商品組合與主題符合變體政策。
- 逐筆跑預檢。使用支援的VALIDATION_PREVIEW 模式檢查提交內容。這一步不寫入正式資料,先處理必填欄位與結構問題。
- 按依賴順序提交。依具體家族安排父子操作,不把所有 SKU 視為可任意交換順序的獨立更新。每次請求前後都保存紀錄。
- 回讀處理結果。查刊登 issues、親子關係與目錄狀態;有差異就記錄待查項,避免反覆盲送同一筆。
- 打開買家商品頁。確認選項、標籤、圖片切換與可購買狀態,再核對沒有誤改非目標資料。
其中第三步的預檢與第五步的回讀,要分開看。Amazon 的驗證說明區分提交時能發現的問題,以及後續處理才出現的問題。預檢通過後,Amazon 仍可能在處理或目錄整合階段回報其他問題。
你看到 ACCEPTED,代表 Amazon 已受理這筆提交。之後還要確認資料有沒有依預期落地。我們在其他站點也遇過已受理、但目錄尚未採用全部新資料的情況,所以現在會把「提交成功」和「驗證完成」分開記錄。本次英國站的後台回讀已通過,本文沒有把尚未實測的前台選項體驗當成完成證據。
06經常整理變體的賣家,可以先做一個小工具
你不一定要一開始就建整套刊登系統。先讓工程師做一個唯讀檢查工具,把某一家族的父子關係、主題、各子商品選項與目前問題整理出來,已經能減少來回翻表的時間。下一步才加入變更差異與預檢,確認看得懂結果後,再開放正式提交。
對我們來說,這次用 SP-API 的收穫,是每個階段都有東西可以核對。你看得見原來的家族、預定要改的欄位、Amazon 回應的問題,也能在提交後逐項確認。以後再碰到變體整理,我們會繼續沿用這個流程。
如果你目前只有少量商品,偶爾調整一次,先把 flat file、類目規則和處理報告讀熟就夠了。當同一件商品要在多個國家站點重複整理,再考慮把可重複的檢查交給 API 工具處理,各站分別驗證;遇到無法自行修改的資料,就整理證據開 case。



