以商品為基礎購物體驗手冊

概覽

目錄

購物體驗

為了讓我們的賣家業務成功,我們必須提供強大而與眾不同的購物體驗,突出 eBay 的獨特價值和包羅萬有。要達到這個目標,我們將以商品取代刊登,作為 eBay 體驗的基礎。

只有具體的買家查詢才會預設為使用以商品為基礎的體驗,而新體驗會直接與已識別的商品和類別配對。在這些情況下,刊登將統合為商品卡,而只有在與 eBay 目錄商品配對的情況下才會顯示。這些商品卡將轉導至商品頁,買家可在這些頁面查看某一商品可供購買的存貨數量。

你也可透過在 eBay 搜尋結果頁頂選取「合併類似刊登物品」,檢視以商品為基礎購物方式的早期版本(目前適用於美國、英國及澳洲網站)。商品資料將來自 eBay 目錄並前後一致,買家只需按「查看詳細資料」即可檢視賣家提供的物品說明。

以下顯示以商品為基礎刊登的搜尋結果頁面的範例以及 Nest 恒温器商品頁

 

圖 1:以商品為基礎刊登的搜尋結果頁面

當會員選取任何其中一張商品卡,該商品即載入 eBay 商品頁,如下方所示:

 

Nest 恒温器商品頁

圖 2:Nest 恒温器的 eBay 商品頁

 

eBay 將於 2018 年在美國、英國、澳洲和加拿大(英文)網站推出這個體驗的新版本,並指定為某些搜尋結果的預設體驗,配合下方所述的新賣家挸定。

以商品為基礎的出售體驗 - 第一階段

以商品為基礎的購物體驗規定刊登必須與 eBay 目錄商品連結。

eBay 會在 2018 年 5 月開始為少數商品規定採用目錄商品。詳情請參看下方的第一階段的類別/品牌表格。

出售這些商品的賣家必須將刊登與 eBay 目錄連結,不論狀況及刊登形式為何。我們將會推出刊登過程中更方便搜尋 eBay 目錄並找出商品的方式,以支援這項新規定。要建立新刊登物品或修改已採用目錄商品的現有刊登,賣家需要直接選取商品,提供 eBay 商品編號(亦稱為 ePID)或 GTIN(UPC、ISBN、EAN)。如果使用了 GTIN,eBay 會嘗試將該 GTIN 與目錄商品配對。如果 eBay 無法在目錄找到完全匹配的商品,建立/修改將失效,賣家必須以不同的 GTIN 或 ePID 再試一次。

eBay 建議賣家和開發人員在流程的第一步搜尋 eBay 目錄找出正確的商品。找到正確的商品後便可為商品加入正確的 ePID,確保刊登成功與正確商品連結。請查看下方的建議流程 取得更多資料。

請注意:提供款式的刊登[即 MSKU 或 多款式]必須為每個款式提供 GTIN。多款式刊登無法提供 ePID。請參照關於多款式刊登的附註章節以取得更多資料。

除 eBay 目錄中取得的圖片和物品細節,賣家可繼續為刊登提供自己的圖片以及相關物品細節。請注意,賣家將無法修改目錄商品定義的物品細節值。如果賣家加入一張或更多圖片,刊登的檢視物品頁只會顯示賣家提供的圖片而並非預設的圖片;但商品頁會同時顯示預設圖片及賣家提供的圖片。

時間表和重點

2018 年 3 月

2018 年稍後時間

第一階段的類別/品牌

第一階段中受影響的 eBay 類別/品牌如下:請注意,清單可能在 2018 年 5 月公佈前有所變動。接近第二階段時我們將建立類似的表格。

類別名稱 類別編號 品牌 商品範例
空氣清新機 43510 Dyson Pure
音頻基座和迷你音箱 111694 Jawbone* Jambox*
加濕器 71240 Dyson AM 加濕器
互聯網和媒體串流器 168058 Amazon Fire Stick
互聯網和媒體串流器 168058 Apple 電視
互聯網和媒體串流器 168058 Google Chromecast
互聯網和媒體串流器 168058 Roku Premier/Express/1/2/3/4
可攜式風扇 20612 Dyson AM 冷卻風扇
可編程恆溫器 115949 NEST* 恆溫器*
小型暖氣機 20613 Dyson AM 冷暖風扇
聲控智能助手 184435 Amazon Echo
聲控智能助手 184435 Google 首頁
手提電話 9355 Apple iPhones
平板電腦 171485 Apple iPads

*在英國或澳洲非必須

 

採用 eBay 目錄商品刊登之規定

以商品為基礎的出售配對規定適用於所有 API、出售流程、刊登工具和物品狀況。如果以商品為基礎的出售配對規定適用於刊登類別和商品品牌,賣家必須將新刊登及現有刊登均連結到 eBay 目錄商品。如果以商品為基礎的出售配對規定不適用於刊登類別和商品,將刊登連結目錄商品並非強制規定,但如果 eBay 目錄中存在配對商品,賣家應考慮採用。以下圖表及建議流程為所有賣家和開發人員概括相關流程,如何找出正確的目錄商品,然後將單一存貨單位編號刊登連結目錄商品。

 

找出目錄商品及採用商品刊登的流程

圖 3:找出目錄商品及採用商品刊登的

建議流程

以下建議流程說明如何在 eBay 目錄找出配對商品,然後使用這個目錄商品建立商品或修改現有刊登。

  1. 在全新目錄 API中使用搜尋呼叫以在 eBay 目錄中找出配對的商品。這個呼叫支援 GTIN 及關鍵字的搜尋方式。此外也提供其他縮小搜尋範圍條件。如果你已結合購物 APIFindProducts 呼叫,你仍可使用這個呼叫,但呼叫只容許關鍵字搜尋。以下範例是 GTIN (UPC) 搜尋和查詢搜尋。目錄 API呼叫參考文件中可檢視完整的呼叫範本,及每個可支援查詢參數的說明。

    按 GTIN (UPC) 搜尋

    GET

    https://sandbox.api.ebay.com/commerce/catalog/v1_beta/product_summary/search?gtin%3D0813917020203

    查詢搜尋

    GET

    https://sandbox.api.ebay.com/commerce/catalog/v1_beta/product_summary/search?q%3DNest%2520Thermostat

    如果找到了你的商品,請記下 eBay 商品編號(ePID),然後前往第 5 步。如果找不到你的商品,請前往第 2 步

    請注意:如果搜尋呼叫找到了多個商品,而你無法根據回報的資料決定哪一個是正確商品,你可使用回應中的 productWebUrl 欄位檢視 eBay 網站上的產品資料。你亦可以使用目錄 APIgetProduct 來回報目錄商品的完整資料。使用 getProduct 呼叫的方法是在呼叫 URI 的最後輸入 ePID 值。 <![CDATA[ ]]>

  2. 如果你不知道物品的 eBay CategoryID,請呼叫 分類 API 中的 getCategorySuggestions(或交易API) 中的 GetSuggestedCategories),為刊登找出適合的類別。請務必記下 CategoryID 的值,因為流程中其他步驟會需要這項資料。在 GetSuggestedCategoriesgetCategorySuggestions 兩個呼叫中,回應中會提供支援的 eBay 類別,並按關連程度排序(由最高至最低)。找到了 CategoryID,請繼續進行第 3 步

  3. 呼叫 GetCategoryFeatures 來取得獲支援物品狀況等資訊,並查看 ProductRequiredEnabled 欄位以確定類別是否規定採用目錄商品。你需要這個回應資料連同 GetCategorySpecifics,以決定你的刊登類別和品牌是否規定採用目錄商品。查看 GetCategoryFeatures 和 GetCategorySpecifics 的動作章節了解詳情。繼續進行第 4 步
  4. 呼叫交易 APIGetCategorySpecifics,查看你的刊登類別和品牌是否規定採用目錄商品。如果 GetCategoryFeatures 回報了 ProductRequiredEnabled 欄位,則該類別的大部分/所有品牌均規定採用目錄商品(可能有少數例外)。如果沒有回報 ProductRequiredEnabled 欄位,則只有該類別的分組品牌(如有)需要採用目錄商品。查看 GetCategoryFeatures 和 GetCategorySpecifics 的動作章節了解詳情。

    如果你的品牌規定採用目錄商品,請回到第 1 步並縮小搜尋範圍,在 eBay 目錄中尋找商品。所有第一階段的商品都會納入 eBay 目錄。

    如果你的品牌不規定需與商品配對,你可以透過交易 API庫存 API 使用賣家定義的特性建立刊登物品,做法載於相關 API 的文件,並略過餘下的步驟。

  5. 使用 ePID 建立或修改刊登物品。詳情請參考採用目錄商品建立/修改刊登章節。

GetCategoryFeatures 和 GetCategorySpecifics 的行為

API 呼叫 所有品牌都必須與商品配對(但有少數例外) 所有品牌都不需要與商品配對(但有少數例外)
GetCategoryFeatures 回應中有 ProductRequiredEnabled 如果 ProductRequiredEnabled 為停用狀態,將不會在回應中回報
GetCategorySpecifics 所有品牌必須採用目錄,除非是 Recommendations.NameRecommendation。名稱值等於你的品牌,而 ValidationRules 容器中相應的 ProductRequired 值為 '�Disabled'/td> 沒有品牌必須採用目錄,除非是 Recommendations.NameRecommendation。名稱值等於你的品牌,而 ValidationRules 容器中相應的 ProductRequired 值為 'Enabled'

採用目錄商品建立/修改刊登

只要有正確的 eBay 目錄商品及其 ePID 值,即可建立或修改刊登物品。你可透過交易 API 或庫存 API 建立或修改刊登物品。使用這兩個 API 建立或修改刊登的步驟,將於以下的兩個章節講述。請留意,這些步驟只適用於單一款式刊登。這些規定如何影響多款式刊登的相關說明,載於關於多款式刊登的說明章節。有關交易 API 和庫存 API 兩者分別的資料,請參考 eBay 上出售存貨的 API 頁面。

賣家如有出售中的物品會受第一階段規定影響,必須根據配對的 eBay 目錄商品之產品資料修改這些刊登。如果賣家嘗試修改受第一階段規定影響的出售中物品,除非是採用配對的 eBay 目錄商品修改,否則這個動作會被禁止。

賣家可透過幾個方法找到受第一階段規定影響的出售中物品數目,以及是哪些物品。可使用的方法如下:

有關如何利用 eBay 目錄商品更新現有的刊登物品,請參照在交易 API 中採用目錄商品修改刊登或在庫存 API 中採用目錄商品修改刊登章節。

在交易 API 中採用目錄商品建立刊登

要在交易 API 中採用 eBay 目錄商品建立新刊登,你可使用 AddItemAddFixedPriceItem 呼叫來建立你的刊登物品。在使用任何一個 'Add' 呼叫時,你需要執行以下動作:

  1. 利用 ProductListingDetails.ProductReferenceID 欄位來輸入該 eBay 目錄商品的 ePID 值,而 ePID 可在目錄 API 的回應中找到;請注意,你也可以在 'Add' 呼叫的 ProductListingDetails 容器中提供 GTIN 值來嘗試找到配對目錄商品,但如果 eBay 找到多於一個目錄商品符合該 GTIN 值,或 eBay 無法找到任何符合條件的目錄商品,呼叫會失效。因此如果賣家知道 ePID 值,最好能夠使用。
  2. 為刊登物品提供全部其他必填資料,包括刊登國家、該國家使用的主要貨幣、刊登日數、刊登類型、付款方式、運送服務、退貨政策等。請查看 AddItem 呼叫參考文件,取得更多有關使用交易 API 建立刊登的資料。

成功的 'Add' 呼叫會使用你提供的 ePID 值來將刊登和合適的 eBay 目錄商品連結,並將商品刊登到合適的類別。

注意:請注意,交易 API 的新增/修改/重新刊登呼叫中的 ProductListingDetails 容器,設有一個稱為 IncludeeBayProductDetails 的布爾欄位,預設為 'true'。如果商品的類別和品牌規定要使用目錄商品,而上述布爾欄位有包括在新增/修改/重新刊登呼叫但設定為 'false',建立/修改/重新刊登功能會被阻止(即使已加入匹配的商品之合適 GTIN 或 EPID 值)。如果賣家為商品配對規定以外的商品提供了 GTIN 或 EPID,並將 IncludeeBayProductDetails 標籤設定為 'false',eBay 會嘗試根據賣家提供的資料(非目錄資料)建立刊登。eBay 建議任何情況下均將 IncludeeBayProductDetails 值設為 'true'。

請注意:對於二手或改造物品,賣家可考慮加入有關的圖片、物品細節、狀況說明以及自訂的刊登說明,讓有興趣的買家更清楚認識這件物品。然而,賣家提供的資料只會在檢視物品頁顯示,而不會是商品頁。請同時留意,賣家將無法覆蓋目錄商品已定義的物品細節。

在交易 API 中採用目錄商品修改刊登

要使用 eBay 目錄商品的定義商品資料修改出售中的物品,請使用 ReviseItemReviseFixedPriceItem 呼叫。'Revise' 呼叫中的以下欄位必須設定好才能以目錄的產品資料更新刊登:

在庫存 API 中採用目錄商品建立刊登

以庫存 API 建立以商品為基礎的 eBay 刊登物品之所需步驟,視乎賣家/開發人員是否初次使用庫存 API。如果是本來已使用庫存 API 的賣家/開發人員,並已將存貨所在地和存貨資料載入庫存 API 模型,可省卻某些步驟。以下的流程圖涵蓋了所有使用庫存 API 以目錄商品建立或修改刊登的實際使用情況,適用於所有使用者(初次使用庫存 API 或已部分/完全結合 API)。

 

存貨刊登中使用目錄商品

圖 4:透過庫存 API 使用目錄商品建立/修改單一 SKU 刊登

以下根據目錄商品建立刊登的步驟,是假設賣家已結合了庫存 API,並已設定了希望的存貨位置以及商品的存貨物品紀錄:

  1. 呼叫 getInventoryItem 以擷取存貨物品紀錄的所有現有細節;使用 createOrReplaceInventoryItem 呼叫來修改存貨物品時,呼叫會進行全面取代,因此所有定義數據為必填,請記下呼叫回應中的資料,因為在 createOrReplaceInventoryItem 呼叫時會再次使用
  2. 使用 createOrReplaceInventoryItem 呼叫來採用 eBay 目錄商品修改存貨物品紀錄,指定修改的存貨物品紀錄的做法是在呼叫 URI 中輸入賣家定義的存貨單位編號(SKU);假設現有的存貨物品紀錄已是最新(數目、物品狀況、包裹重量和體積等),你唯一需要加入存貨物品紀錄的新資料是 product.epid 值。如果商品是全新,epid 是唯一需要在 createOrReplaceInventoryItem 呼叫的 product 容器中加入的欄位。如果是二手或改造物品,賣家仍需提供 epid 欄位,但可保留/新增額外的圖片和獨特的物品細節,幫助展示該二手物品或物品改造的狀況。請注意,你亦需為 product 容器提供 GTIN 值以嘗試找出配對的目錄商品,但如果 eBay 找到多於一個目錄商品符合該 GTIN 值,或 eBay 無法找到任何符合條件的目錄商品,呼叫會失效。因此如果賣家知道 ePID 值,最好能夠使用。
  3. 為商品建立優惠,做法是使用 createOffer 呼叫,你可以在 createOffer 的呼叫參考文件中查看更多有關此呼叫的必填和選擇性欄位,而成功的 createOffer 會在回應中產生 offerId 值,這個值會在下一步驟使用。
  4. 使用 publishOffer 呼叫建立新刊登物品, createOffer 呼叫回應中回報的 offerId 值將會輸入作為呼叫 URI 的一部分;呼叫範例如下: https://api.ebay.com/sell/inventory/v1/offer/36445435465/publish,當中 '36445435465' 是要發表出售物品的 offerId
  5. 成功的 publishOffer 會在回應中產生 listingId 值,這個值是新刊登物品的獨特識別碼

如果賣家未有結合庫存 API,則首要步驟是建立存貨的所在地(商品寄出的地點)。存貨所在地是經過 createInventoryLocation 呼叫設定。請注意,存貨所在地應是實際的地址,即賣家實際寄出商品的地點(如倉庫或商店)。下一步是使用 createOrReplaceInventoryItem 呼叫建立商品的存貨物品紀錄。賣家建立好存貨所在地和存貨物品後,可前往建立並發表刊登。上述的第 3-5 步驟說明當中的規定。

在庫存 API 中採用目錄商品修改刊登

如果你出售中的物品是使用庫存 API 建立,你必須使用庫存 API 來根據 eBay 目錄商品定義的產品資料修改刊登。當刊登進入了庫存 API 模型後,交易 API 的修改/重新刊登/確認物品呼叫將無法使用。

要使用庫存 API 來更新出售中的物品,賣家需先執行 getInventoryItem 呼叫來擷取存貨物品紀錄的所有現有資料。正如之前章節所述,當你使用 createOrReplaceInventoryItem 來修改存貨物品,呼叫會進行全面取代,因此所有定義數據為必填。請記下 getInventoryItem 呼叫回應中的資料,因為會在 createOrReplaceInventoryItem 呼叫中再次使用。

在隨後的 createOrReplaceInventoryItem,你可以指定修改哪個存貨物品紀錄,做法是在呼叫 URI 中輸入賣家為商品定義的存貨單位編號值。假設你不想對存貨物品紀錄及出售中物品作出任何其他變更,你唯一需要加入存貨物品紀錄的新資料是 product.epid 值。如果是全新商品,epid 欄位是唯一需要在 createOrReplaceInventoryItem 呼叫的 product 容器中需要加入的欄位。如果是二手或改造物品,賣家仍需提供 epid 欄位,但可保留/新增額外的圖片和獨特的物品細節,幫助展示該二手物品或物品改造的狀況。成功的 createOrReplaceInventoryItem 呼叫會自動以目錄商品資料更新出售中的物品。請注意,你也可以在 product 容器中提供 GTIN 值來嘗試找到配對目錄商品,但如果 eBay 找到多於一個目錄商品符合該 GTIN 值,或 eBay 無法找到任何符合條件的目錄商品,呼叫會失效。因此如果賣家知道 ePID 值,最好能夠使用。

關於多款式刊登的說明

賣家可利用規定適用的商品建立多款式刊登,但過程稍有不同,因為 eBay 商品編號無法在款式層面套用。然而,如果商品是在第一階段的規定範圍內,賣家必須為刊登中每一個款式提供 GTIN 值。

如果賣家不知道商品的 GTIN,則需要找出這個資料。賣家有幾個方法可找出這個 GTIN 值,其中一個方法是透過目錄 API 中的搜尋呼叫使用關鍵字或商品特性搜尋。除了 ePID,搜尋呼叫的回應亦會回報所有該目錄商品的已定義 GTIN 值。所有 GTIN 值會在呼叫回應中的 gtins 排列下回報。請注意,MPN 不足以符合規定,因此賣家必須指定 UPC、ISBN 或 EAN。

利用交易 API 建立/修改多款式刊登

必須使用 AddFixedPriceItem 呼叫來建立新的多款式刊登,而 ReviseFixedPriceItem 呼叫則用來根據每個商品款的適用 GTIN 值更新現有的多款式刊登。賣家應該是為每個商品款式使用 Variations.Variation.VariationProductListingDetails 容器為相應的欄位輸入適用的 UPC、ISBN 或 EAN 值,而不是在 ProductListingDetails.ProductReferenceID 欄位輸入 ePID 值。

利用庫存 API 建立/修改多款式刊登

利用庫存 API 建立多款式刊登,基本上與利用庫存 API 建立單一款式刊登相似,例外情況如下:

要修改利用存貨管理 API 建立的現有多款式刊登,賣家需為每個商品款式執行 createOrReplaceInventoryItem,請記得輸入正確的 isbnupcean 值。我們也建議在 createOrReplaceInventoryItem 之前執行 getInventoryItem 呼叫,因為createOrReplaceInventoryItem 呼叫會完全取代存貨物品紀錄。

修改不合規的刊登

合規 API 推出後,賣家現在可擷取所有不符合以商品為基礎規定的刊登。規定包括要求必須連結 eBay 目錄商品的類別/品牌,以及要求為指定 eBay 類別的商品/款式提供有關 GTIN(或品牌/MPN 組合)值。

合規 APIgetListingVariations 呼叫會回報違反以商品為基礎刊登規定的不合規物品。其中一個 getListingVariations 呼叫中為每個刊登違規回報的資料欄位,是reasonCode 欄(以及伴隨的 message 欄位)。下表涵蓋某些最常見的回報 reasonCode 值,而接下來應該做的動作以通過庫存 API交易 API 修改不合規的刊登,令這些刊登符合以商品為基礎刊登規定。

合規 API reasonCode 值及訊息

 

下一步規定動作 使用庫存 API 修改 使用交易 API 修改
EPID_MISSING

"EPID missing for listing with specific category and brand. Provide EPID value"

使用目錄 API搜尋呼叫或購物 APIFindProducts 呼叫為商品找出 EPID 值 請確認為商品使用正確的存貨單位編號(SKU)值,執行 createOrReplaceInventoryItem 呼叫並將正確的 EPID 值輸入請求有效載荷中 product.epid 欄位 執行 ReviseFixedPriceItem 呼叫(或 ReviseItem)並將正確的 EPID 值輸入 product.epid 欄位
GTIN_MISSING

"Missing GTIN on the listing or on specific variation. Make sure to add GTIN."

使用目錄 API搜尋呼叫或購物 APIFindProducts 呼叫為商品找出 GTIN 值 請確認為商品/款式使用正確的存貨單位編號(SKU)值,執行 createOrReplaceInventoryItem 呼叫並將正確的 EPID 值輸入請求有效載荷中 product.epid 欄位

如果是單一款式刊登,執行 ReviseFixedPriceItem 呼叫(或 ReviseItem)並通過 ProductListingDetails 容器輸入正確的 GTIN 值(或品牌/MPN 組合)

如果是多款式刊登,執行 ReviseFixedPriceItem 呼叫,並通過對應欠缺 GTIN 值的款式之 Variation.ProductListingDetails 容器輸入正確的 GTIN 值如果款式欠缺 MPN,請注意刊登中所有款式的品牌值是設定於刊登層面的 ItemSpecifics.NameValueList 容器,而每個款式的 MPN 是在款式層面的 Variation.VariationsSpecifics.NameValueList 容器設定

ITEM_SPECIFIC_MISSING

"Missing Item Specific. Provide valid value."

使用目錄 API搜尋呼叫或購物 APIFindProducts 呼叫為欠缺的物品細節找出有效的名稱與值的組合

請確認為商品/款式使用正確的存貨單位編號(SKU)值,執行 createOrReplaceInventoryItem 呼叫並透過請求有效載荷中 product.aspects 排列輸入正確的物品細節名稱與值的組合。務必使用這個 JSON 語法:

"aspects": {
"Brand": ["Apple"],
}

如果是單一款式刊登,執行 ReviseFixedPriceItem 呼叫(或 ReviseItem)並通過 ItemSpecifics.NameValueList 容器輸入正確的物品細節名稱與值的組合;

如果是多款式刊登,執行 ReviseFixedPriceItem 呼叫(或 ReviseItem)並通過 Variation.VariationsSpecifics.NameValueList 容器輸入正確的物品細節名稱與值的組合

GTIN_OR_ITEM_SPECIFIC_INVALID

"GTIN or Item Specific value is invalid. Provide correct value."

使用目錄 API搜尋呼叫或購物 APIFindProducts 呼叫找出有效的 GTIN 值或物品細節名稱與值的組合

如果是 GTIN 值無效,執行 createOrReplaceInventoryItem 呼叫,並輸入正確的 GTIN 值請求有效載荷中 product 欄位

如果是物品細節名稱與值的組合無效,執行 createOrReplaceInventoryItem 呼叫並透過有效載荷中product.aspects 排列輸入正確的物品細節名稱與值的組合請求。務必使用這個 JSON 語法:

"aspects": {
"Brand": ["Apple"],
}

 

如果是單一款式刊登的 GTIN 值無效,執行 ReviseFixedPriceItem 呼叫(或 ReviseItem)並通過 ProductListingDetails 容器輸入正確的 GTIN 值(或品牌/MPN 組合);

如果是多款式刊登的 GTIN 值無效,執行 ReviseFixedPriceItem 呼叫(或 ReviseItem),並通過對應無效 GTIN 值的款式之 Variation.ProductListingDetails 容器輸入正確的 GTIN 值。如果款式的 MPN 值無效,請注意刊登中所有款式的品牌值是設定於刊登層面的 ItemSpecifics.NameValueList 容器,而每個款式的 MPN 是在款式層面的 Variation.VariationsSpecifics.NameValueList 容器設定;

如果是單一款式刊登的物品細節名稱與值的組合無效,執行 ReviseFixedPriceItem 呼叫(或 ReviseItem)並通過 ItemSpecifics.NameValueList 容器輸入正確的物品細節名稱與值的組合;

如果是多款式刊登的物品細節名稱與值的組合無效,執行 ReviseFixedPriceItem 呼叫(或 ReviseItem)並通過 ItemSpecifics.NameValueList 容器輸入正確的物品細節名稱與值的組合

DOES_NOT_APPLY_GTIN_OR_MPN_INVALID

"GTIN or MPN value invalid and/or used “does not apply” where “does not apply” is not allowed. Provide valid GTIN or MPN value."

使用目錄 API搜尋呼叫或購物 APIFindProducts 呼叫為商品找出 GTIN 或 MPN 值 請確認為商品/款式使用正確的存貨單位編號(SKU)值,執行 createOrReplaceInventoryItem 呼叫並將正確的 EPID 值輸入請求有效載荷中 product 欄位。如果是 MPN,賣家同時必須確保 product.brand 欄位輸入了正確的品牌名稱

如果是單一款式刊登,執行 ReviseFixedPriceItem 呼叫(或 ReviseItem)並通過 ProductListingDetails 容器輸入正確的 GTIN 值(或正確的品牌/MPN 組合)

如果是多款式刊登,執行 ReviseFixedPriceItem 呼叫,並通過對應 GTIN 值無效的款式之 Variation.ProductListingDetails 容器輸入正確的 GTIN 值。如果款式的 MPN 值無效,有效的 MPN 是在款式層面的 Variation.VariationsSpecifics.NameValueList 容器設定。賣家同時必須確保 ItemSpecifics.NameValueList 容器輸入了正確的品牌名稱。

ASPECTS_ASSOCIATION_INVALID

"Aspects association invalid. Provide valid values."

使用目錄 API搜尋呼叫或購物 APIFindProducts 呼叫找出有效的物品細節名稱與值的組合

如果是物品細節名稱與值的組合無效,執行 createOrReplaceInventoryItem 呼叫並透過有效載荷中product.aspects 排列輸入正確的物品細節名稱與值的組合請求。務必使用這個 JSON 語法:

"aspects": {
"Brand": ["Apple"],
}

如果是單一款式刊登,執行 ReviseFixedPriceItem 呼叫(或 ReviseItem)並通過 ItemSpecifics.NameValueList 容器輸入正確的物品細節名稱與值的組合;

如果是多款式刊登,執行 ReviseFixedPriceItem 呼叫(或 ReviseItem)並通過 Variation.VariationsSpecifics.NameValueList 容器輸入正確的物品細節名稱與值的組合

SAME_GTIN_ACROSS_VARIANTS

"Same GTIN was provided for more than one variation. Provide unique GTIN."

使用目錄 API搜尋呼叫或購物 APIFindProducts 呼叫為每個商品款式找出正確的 GTIN 值 請確認為每個受影響的款式使用正確的存貨單位編號(SKU)值,為每個 SKU 執行 createOrReplaceInventoryItem 呼叫並透過請求有效載荷中 product 容器輸入正確的 GTIN 值 執行 ReviseFixedPriceItem 呼叫,並通過對應欠缺 GTIN 值的款式之 Variation.ProductListingDetails 容器輸入正確的 GTIN 值。如果款式欠缺 MPN,請注意刊登中所有款式的品牌值是設定於刊登層面的 ItemSpecifics.NameValueList 容器,而每個款式的 MPN 是在款式層面的 Variation.VariationsSpecifics.NameValueList 容器設定

以商品為基礎的出售方式擴展計劃

隨著我們推出了更多支持賣家的新功能,並採納社群的意見,eBay 會在 2018 年期間擴展以商品為基礎的購物體驗。我們會提前公佈涵蓋的品牌和類別。第二階段計劃會在 2018 年 8 月公佈和實施,eBay 會將以商品為基礎的購物體驗擴展至整個類別(不限於指定商品系列)。我們會提前在 8 月實施前公佈涵蓋的類別。

隨著採用 eBay 目錄的規定擴大範圍,賣家將獲得更多工具輕鬆編輯 eBay 目錄的商品,並在有需要時建立商品。

我們會在確定細節和時間表後,向賣家和合作夥伴提供有關功能和規定的詳情。

常見問題

eBay 為何要進行此項變更?
在我們轉向以商品為基礎的購物體驗之際,賣家必須準確顯示自己出售的商品,因為買家期望享受更優化的網上購物體驗。達到這個目標的最佳方法,是在刊登過程中從 eBay 目錄選擇適合的商品。

eBay 目錄是什麼?
eBay 目錄是一個中央商品目錄及資料庫,讓賣買雙方對於出售的物品有共識。

如何將刊登物品連結至 eBay 目錄中的商品?
當你開始刊登時,你可利用產品識別碼(如 UPC、EAN、ISBN 或關鍵字)在 eBay 目錄尋找商品。從目錄中選取了商品後,即可繼續完成刊登流程。2018 年 5 月起,如果我們認為你出售的物品屬於規定的商品系列但卻未連結 eBay 目錄的商品,你將無法完成刊登。

產品識別碼是什麼?
產品識別碼是獨一無二的商品編號或編碼,方便買家識別並搜尋商品。大部分新的品牌物品都有獨一無二的識別碼。這些可以是國際貨品編碼(GTIN),例如 UPC、EAN 或 ISBN,亦可能是品牌和製造商產品管理編號(MPN)的組合。

什麼是 GTIN?
答:GTIN(國際貨品編碼)是能識別特定產品和服務的獨一無二編號。GTIN 可以包括物品的通用產品代碼(UPC)、國際商品編碼(EAN)或國際標準書號(ISBN)。

我何時需要使用 eBay 目錄?
我們強烈建議你現在就開始為規定的商品系列使用 eBay 目錄。採用商品是指你在刊登過程中,必須從 eBay 目錄中選擇與你所刊登物品相應的商品(做法是搜尋 UPC、EAN 或 ISBN 或關鍵字),並將該目錄商品連結到你的刊登。由 2018 年 5 月起,如果你刊登的物品屬於特定的商品系列,你必須將物品與目錄商品配對才能完成刊登。今年稍後時間,我們會將規定範圍擴展至更多類別和產品系列。

如果我使用 eBay 目錄,還可以自訂刊登物品嗎?
如何自訂刊登視乎物品狀況;例如全新物品可選擇性加入更多圖片。至於其他狀況(如二手、翻新物品),你必須加入更多圖片和物品資料,幫助買家作出購買決定。

如果我發現產品資料不準確,應怎樣做?
賣家專區用戶在刊登過程中,可按下商品旁的旗幟標誌,為商品的目錄資料提出修改建議。此外,如果你發現 eBay 目錄有錯誤的資訊,你可以電郵至 sdsupport@ebay.com 通知我們。

多款式(多項存貨單位編號物品)刊登也規定要使用 eBay 目錄嗎?
是的。為符合全新目錄相關規定,對於初始階段商品系列的多項存貨單位編號物品,你必須為每個款式提供有效的 GTIN(UPC、EAN 或 ISBN)。今年稍後時間,我們會將規定範圍擴展至更多類別和產品系列。

如果我出售的物品是套裝物品,我也需要為指定的類別使用 eBay 目錄嗎?
是的。選擇目錄中商品的方式,視乎你提供的是哪類型的套裝物品。

在以上所有情況下,除了在目錄中選擇正確的商品外,你必須將「套裝物品」的物品細節設定為「是」,在物品說明中清楚分項列明套裝物品包含內容。

如果我出售的物品是整批物品,我也需要使用 eBay 目錄嗎?
是的。選擇目錄中的商品的方式,視乎你提供的是哪類型的整批物品。

如何為原始產品系列刊登海外商品?
為每部 iPhone 和 iPad 產品選擇國際版的「代表」商品,並在刊登流程中指定實際的電訊商/網絡。

例如,你想使用外盒上的 EAN=888462563048,在美國網站刊登英國版的「Apple iPhone 6s 128GB Vodafone」,請在美國出售流程中搜尋「iPhone 6s 128GB Black」。你會見到以下結果:選取 e4 商品:

EPID 商品名稱 品牌 電訊商
e1 Apple iPhone 6s 128GB 黑色美國版 AT&T Apple AT&T
e2 Apple iPhone 6s 128GB 黑色美國版 Verizon Apple Verizon
e3 Apple iPhone 6s 128GB 黑色美國版 T-Mobile Apple T-Mobile
e4 Apple iPhone 6s 128GB 黑色國際版 Apple 未指明

如果你改為以 GTIN(即 EAN=888462563048), e4 商品將顯示為唯一結果,你便應選擇這項商品。

不管你的物品鎖定為指定的網絡或已解鎖,你都應把這些資料加入刊登的標題。

「刊登物品不會在搜尋中出現」是什麼意思?
根據全新的以商品為基礎的購物體驗,上述商品系列中未有採用 eBay 目錄商品的刊登將不會在搜尋結果頁顯示。

是否所有 eBay 刊登工具、第三方工具和 API 都可存取目錄資料?
所有 eBay 刊登工具和 API 均可將物品與 eBay 目錄商品配對。第三方工具將可透過 API 存取目錄資料。eBay 亦與第三方開發人員就此事直接溝通。但我們建議你向第三方工具服務商查詢,準備迎接變更。

這個規定是否適用於所有物品狀況、售後訂製、套裝和整批出售的物品?
是的,這個規定適用於所有物品狀況(如全新、其他、翻新)以及訂製物品、套裝物品和整批物品。

如何在全新的商品頁取得優先商品排序?
在商品頁上,當相同物品的多件刊登都已連結 eBay 目錄商品的商品系列,你的物品會和其他賣家的刊登一起爭取成為商品頁的最熱門選擇或主要位置。你必須要高於標準,確定物品有存貨,並提供具吸引力的運費和價格,提高成為最熱門選擇的機會。

以商品為基礎的購物體驗會如何影響我的推廣刊登?
推廣刊登會繼續在搜尋結果以及在商品頁面上賣家的出售物品中顯示。隨著買家體驗轉變,我們會繼續改進推廣刊登的放置,以更智能的方式提升你的刊登的瀏覽量。

以商品為基礎的搜尋方式何時開始?
只有非常具體的買家查詢才會預設為使用以商品為基礎的體驗,直接配對已確認的商品和類別,而實施時間一定是出售體驗推行起最少一個月以後。在以商品為基礎的體驗擴展之前,賣家會提早幾個月獲得通知。