店面商品目錄動態饋給會列出您在各間門市販售的產品。某些屬性對所有商品都是必要項目,有些屬性在提交特定類型的商品時才須提供,另外有些則是建議使用。
你可以根據各門市的供應情形,常態調整商品目錄的價格和供應情形。你可以提高動態饋給的更新頻率,讓系統更頻繁地更新商品目錄資料。如有動態饋給頻率相關問題,請使用聯絡表單與我們的支援團隊聯絡。另外也請注意,系統最多可能需要 24 小時才能將商家所在地點同步處理到 Merchant Center 帳戶,因此建議你在連結帳戶 24 小時後上傳商品目錄動態饋給,或是等商家檔案的商店代碼已變更或更新後再上傳。
如要透過 API 提交產品資料,請參閱這篇文章,進一步瞭解 Google Content API。
提交店面商品目錄動態饋給
檔案類型:店面商品目錄動態饋給可透過定位點分隔符號文字檔、XML 檔案或 API 提供。
建立新的店面商品目錄動態饋給:如要建立及登錄新的店面商品目錄動態饋給,請按照這些操作說明進行。
重要事項:這類店面商品目錄動態饋給規格中的部分屬性含有空格和底線。為確保你提交的屬性包含正確的字元和空格,請視你的檔案類型選擇適用的操作指南:
- 定位點分隔動態饋給:必須使用空格。如果屬性含有底線,請以空格取代底線 (_)。
- XML API 或 JSON API:必須使用底線。收到這些資料時,系統會將底線轉換為空白字元。
屬性規定總覽
屬性 | 提交規定 | |
---|---|---|
必要的商品目錄詳細資料 |
商店代碼 |
所有產品均須包含這些屬性。 注意事項:輸入商店代碼 |
商品目錄詳細資料 (選用) |
特價生效日期 數量 |
建議視情況為動態饋給中的各項商品填入這些屬性,詳細說明價格、數量和當天到貨服務。 請注意,如果是全國預設價格,價格為選填屬性。如果特定商店的價格會變動,就必須提供價格。 |
到店取貨詳細資料 (選用) |
取貨方式 取貨服務水準協議 |
如果商品可供到店取貨,建議視情況在動態饋給為這類商品提供這項屬性。 重要注意事項:2024 年 9 月 1 日起,為商品啟用到店取貨功能時,取貨方式 |
店面運送詳細資料 (選填) | 本地運費標籤 [local shipping label] |
如想啟用當天到貨服務,但只有個別商店的特定產品可使用這項服務,則必須在動態饋給中提供此屬性。 |
必要的商品目錄詳細資料
這些屬性可為指定商店中的個別商品提供基本的商品目錄資訊。
[store_code]
- 商家檔案中的商店 ID
每間當地商家都要有一組以英數字元組成的專屬 ID。輸入這個屬性時請務必區分大小寫,而且必須與您在商家檔案中提交的商店代碼相符。
使用時機:動態饋給中的所有商品都必須含有這項屬性。
類型 | 文字 (字串) |
純文字/定位點分隔範例 | Store123 |
XML 範例 | <g:store_code>Store123</g:store_code> |
[id]
- 商品的識別碼
商品的專屬產品 ID,以英數字元組成,適用於你的所有商店。
如果你在多間商店銷售相同的商品,則會有多個商店代碼顯示相同的 ID。每間商店應包含一個 ID [id]
屬性,並使用供應情形 [availability]
屬性來表示在該商店中,商品是否有現貨。
如果同一個國家/地區有多個同類型的動態饋給,各個動態饋給中的商品 ID 不得重複。如果你的商品目錄資料有各自的 SKU 且符合下列規定,建議你為這個屬性使用 SKU。
使用時機:動態饋給中的所有商品都必須含有這項屬性。
類型 | 文字 (字串) |
純文字/定位點分隔範例 | 421486 |
XML 範例 | <g:id>421486</g:id> |
重要注意事項:
- 請在你的主要和店面商品目錄動態饋給中使用相同的 ID 值。
- 開頭和結尾的空白字元和回車字元 (0x0D) 都會移除,
- 每個回車字元 (0x0D) 和空白字元序列 (含有空白字元屬性的萬國碼 (Unicode) 字元) 都會以單一空白字元 (0x20) 取代。
- 系統只接受有效的萬國碼 (Unicode) 字元,但下列字元除外:
- 控制字元 (回車字元 0x0D 除外)
- 功能字元
- 私人區域字元
- 代理值配對
- 未指定碼點 (尤其是任何大於 0x10FFFF 的碼點)
- 提交商品後,即便更新資料動態饋給也無法變更 ID
[id]
屬性,這組識別碼日後也無法用於其他產品。 - 只能加入可在店內購買的產品。
[availability]
- 商品的供應情形狀態
- 有現貨 [in stock]:表示本地商店中有商品現貨。
- 缺貨中 [out_of_stock]:表示門市中沒有商品現貨。
- 限量供應 [limited_availability]:表示門市中商品現貨的數量只剩幾件。
- 可訂購的展示商品:表示可在本地商店中訂購的展示商品,例如須從倉庫出貨的冰箱。如果你同時提供數量
[quantity]
屬性,請為「可訂購的展示商品」使用「1」的值。
類型 | 文字 (字串),系統只接受以下 4 個值:in_stock [有現貨]、out_of_stock [缺貨中]、limited_availability [限量供應] 或 on_display_to_order [可訂購的展示商品]。 |
純文字/定位點分隔範例 | 有現貨 |
XML 範例 | <g:availability>in stock</g:availability> |
商品目錄詳細資料 (選用)
這些屬性可為你的商品提供價格、數量和供應情形等額外資訊。
[price]
:商品的價格
商品的原價。如果你在商品目錄動態饋給和主要動態饋給提交價格值,商品目錄動態饋給價格就會覆寫相關商店的主要動態饋給價格。
使用時機:動態饋給中的所有商品均須包含這項屬性。
類型 | 數值 (系統會根據商店所在國家/地區自動指派幣別)。 |
純文字/定位點分隔範例 | 299.99 |
XML 範例 | <g:price>299.99</g:price> |
[sale_price]
- 商品的廣告特價
暫時的廣告特價,會在這個動態饋給和店面產品動態饋給中覆寫指定商店的價格 [price]
屬性值。
建議為所有特價商品提交特價生效日期 [sale_price_effective_date]
屬性,這項資訊可決定特價生效的日期。如未提交特價生效日期,則只要在動態饋給中提交特價資訊,特價就會生效。
類型 | 數字 |
純文字/定位點分隔範例 | 279.99 |
XML 範例 | <g:sale_price>279.99</g:sale_price> |
[sale_price_effective_date]
屬性中加入過去的時間值。[sale_price_effective_date]
- 商品的特價期間
廣告特價的有效期間。
類型 | 文字 (字串),採 ISO8601 格式,以正斜線 (/) 分隔開始日期和結束日期 |
純文字/定位點分隔範例 |
世界標準時間範例: 所有時間值均採 24 小時制。 |
XML 範例 | <g:sale_price_effective_date>2021-07-19T09:00-0800/2021-07-26T21:00-0800</g:sale_price_effective_date> |
[quantity]
- 商品的現貨數量
商店中商品的現貨數量。如要提交暫時缺貨中的商品,請為這項屬性加入「0」值。
數量已經不是必填的屬性,而是改為必須為所有商品目錄提交供應情形。
類型 | 整數 |
純文字/定位點分隔範例 | 4 |
XML 範例 | <g:quantity>4</g:quantity> |
重要注意事項:
- Google 會將供應數量多於 3 件的商品視為「有現貨」,如果是 1 至 2 件,則會視為「限量供應」,0 件則為「缺貨中」。
- 如果數量和供應情形兩者均提交,則系統會判斷哪一項的值比較低,並根據值較低者為商品目錄分類。
到店取貨詳細資料 (選用)
在店面商品目錄動態饋給新增這些屬性,即可提供門市專屬的取貨資訊。
取貨方式[pickup_method]
- 商品的到店取貨選項
[pickup_method]
會變為選填屬性。為商品指定取貨選項。
- buy [線上購買]:消費者會在線上完成所有交易程序。
- reserve [預訂]:客戶必須在線上預訂商品,然後在實體商店中完成交易。
- ship_to_store [送貨到店]:客戶在線上購買商品,隨後商品會配送到門市供客戶取貨。
- not_supported [不支援]:商品不提供到店取貨服務。
類型 | 文字 (字串),必須使用下列其中一個值,系統才會接受: buy [線上購買]、reserve [預訂]、ship_to_store [送貨到店] 或 not_supported [不支援] |
純文字/定位點分隔範例 | buy |
XML 範例 | <g:pickup_method>buy</g:pickup_method> |
[pickup_sla]
- 商品的到店取貨時間
指明訂單預定可供取貨的日期 (相對於下單時間)。
- same_day [當天]:表示客戶可以在下單當天取貨,但仍須遵守截止時間規範。
- next_day [次日]:表示客戶可以在下單隔天取貨。
- 2_day [2 天]:表示商品會在 2 天內送達門市供客戶取貨。
- 3_day [3 天]:表示商品會在 3 天內送達門市供消費者取貨。
- 4_day [4 天]:表示商品會在 4 天內送達門市供消費者取貨。
- 5_day [5 天]:表示商品會在 5 天內送達門市供消費者取貨。
- 6_day [6 天]:表示商品會在 6 天內送達實體商店供客戶取貨。
- multi-week [數週]:表示商品會在數週內送達實體商店供客戶取貨。
類型 | 文字 (字串),必須使用下列其中一個值,系統才會接受: same day [當天]、next day [次日]、2-day [2 天]、3-day [3 天]、4-day [4 天]、5-day [5 天]、6-day [6 天] 或 multi-week [數週] |
純文字/定位點分隔範例 | same_day [當天] |
XML 範例 | <g:pickup_sla>same day</g:pickup_sla> |
店面運送詳細資料 (選填)
將這項屬性加入店面商品目錄動態饋給,以便提供店面運送資訊。
本地運送標籤 [local_shipping_label]
如要啟用當天到貨服務,不過某間門市只有部分店面商品目錄資料可以使用這個選項,則須將本地運送標籤 [local_shipping_label]
屬性新增至店面商品目錄動態饋給。
這個屬性值必須是當天到貨標籤的名稱,或是你在帳戶層級的當天到貨運送設定中建立的標籤名稱。每個當天到貨標籤都代表一組不重複的當天到貨設定,並會套用至店面商品目錄動態饋給中符合資格的特定產品。
如要進一步設定提供當天到貨服務的商品,你可以設定最大運送範圍半徑 (以英里或公里為單位)。你可以設定截止時間,指定商品須在商店打烊前的特定時間 (以小時為單位) 之前完成訂購,才提供當天到貨服務。對於提供當天到貨服務的商品,如果這類商品的下單時間晚於截止時間,你可以標明是否會提供隔日到貨服務。
如果你的所有商店和所有產品都提供當天到貨服務,或符合資格的商店清單中的所有產品均提供這項服務,此屬性就是選填屬性。進一步瞭解當天到貨服務。