廣告空間檢視器是一項工具，可讓您：
- 根據供應商 ID (您在動態饋給中提供的 ID) 查詢實體
- 查看實體的詳細資料，包括：
- 實體名稱
- 餐廳地址
- 原始實體 JSON
- 服務範圍
- 小時
- 消費者途徑的放送狀態
- 消費者訂購流程的連結
- 和其他商品
- 在相關實體之間導覽 (例如從「Menu」導覽至其父項「Service」和「Restaurant」，反之亦然)
- 查看 Google 擁有的實體版本
如要存取商品目錄檢視器，請開啟行動中心，然後依序前往「商品目錄」>「食品訂購實體」，或按一下這個連結。
凡是擁有 Actions Center 帳戶Reader 存取權或更高存取權的使用者，都會自動取得廣告空間檢視器的存取權。
廣告空間檢視器僅支援實際工作環境和沙箱環境。不支援快速測試。
如何使用 Inventory Viewer
首先，依序前往「廣告空間」>「食品訂購實體」，或點選這個連結
Inventory 檢視器有兩種檢視畫面：清單檢視畫面和詳細資料檢視畫面
清單檢視
這是使用者首次前往工具時看到的檢視畫面。其中包含一個表格，每個實體類型各有一個分頁。每個分頁都包含該類型所有實體的分頁表格。資料欄會因實體類型而異，但一律包含下列項目：
| 資料欄名稱 | 說明 |
|---|---|
| 實體 ID | 合作夥伴提供的實體 ID (來自批次動態饋給和 RTU) |
| 上次修改時間 | 這是實體上次在動態饋給或 RTU 中修改後，最後一次擷取的時間戳記 (以您所在時區為準)。 |
其他實體專屬欄包括：
| 資料欄名稱 | 說明 |
|---|---|
| 名稱 | 動態饋給中的實體名稱。 |
| 狀態 | 實體的放送狀態。僅適用於餐廳和服務 |
| 已刪除狀態 | 實體的刪除狀態。值為「已刪除」或「未刪除」。適用於所有實體類型，但服務和餐廳除外 |
| 類型 | 服務的Delivery 或Takeout，MenuItemOptions 的 optionType |
按一下資料列，即可前往該實體的詳細資料檢視畫面。
清單檢視畫面篩選器
每個清單檢視表格都支援一組特定實體類型的篩選器。所有實體都支援依實體 ID 篩選 (您在動態饋給和 RTU 中提供給 Google 的 ID)。
部分實體類型支援更進階的篩選器。下表列出幾個這類篩選器。
| 鍵 | 運算子 | 支援的實體類型 | 說明 |
|---|---|---|---|
| 名稱 | =、包含 | Restaurant、Menu、MenuSetion、MenuItem | 動態饋給中提供的實體名稱 |
| SKU | = | MenuItemOffer | |
| 地址 | =、contains | 餐廳 | 動態饋給中提供的地址 |
| 服務狀態 | 複選 | 餐廳、服務 | 消費者使用者介面上的服務狀態 |
| 已刪除狀態 | 複選 | 所有實體 (餐廳和服務除外) | 實體的刪除狀態 (已刪除或未刪除) |
詳細資料檢視畫面
詳細資料檢視畫面是使用者在清單檢視畫面中點選實體時看到的檢視畫面。詳細資料檢視畫面會顯示實體的其他資訊，例如：
- 停用原因 (適用於餐廳和服務實體類型)
- 相關實體的清單檢視畫面
- 實體的索引時間 (上次同步至服務資料庫的時間)
- 動態饋給或 RTU 的原始 JSON
- 相關實體的合併檢視畫面 (例如 OperationHours、ServiceAreas、price)
- 實際和測試訂購流程的連結 (僅限餐廳和服務)
狀態和修正錯誤的方式
下表說明 Inventory Viewer 中顯示的實體放送狀態。只有餐廳和服務項目有服務狀態。
| 狀態 | 說明 |
|---|---|
| 已啟用 | 實體符合在 Google 平台上放送的資格。 |
| 已停用 | 實體未在 Google 上放送。按一下資料列即可開啟詳細檢視畫面，查看未放送的原因。 |
| 待處理 | 實體已新增至最新動態饋給，但尚未放送。 |
| 已刪除 | 實體已在動態饋給或 RTU 中刪除。已刪除的實體會保留 30 天。 |
由於實體處理時間的關係，你在「Inventory Viewer」中看到的版本可能不是服務中使用的版本。詳情請參閱常見問題。
如果實體已停用，請開啟詳細檢視畫面，查看「停用原因」。
| 停用原因 | 說明 | 如何修正 |
|---|---|---|
| 缺少或有錯誤的選單 | 菜單實體遺失或在擷取期間發生錯誤。 | 請確認資料動態饋給中已為餐廳定義選單實體。請確認 @id 參照正確無誤。使用商品目錄檢視器檢查選單中的錯誤 |
| 餐廳缺少或發生錯誤 | 動態饋給中缺少餐廳實體，或在擷取期間發生錯誤。 | 請確認資料動態饋給中定義了餐廳實體。確認 @id 參照餐廳實體的內容正確無誤。 |
| 無法在 Google 資料庫中比對到有效的餐廳 | 當資料動態饋給中的餐廳實體無法與 Google 資料庫中的有效餐廳比對時，就會發生這類問題。 | 檢查餐廳是否顯示在 Google 搜尋和 Google 地圖中。如果餐廳不存在，請按照「如何新增 Google 商家檔案或聲明商家檔案擁有權」中的指示操作。請確認資料動態饋給檔案中的名稱和地址，與商家檔案中的名稱和地址完全一致。 |
| 服務缺少或發生錯誤 | 服務實體遺失或在擷取期間發生錯誤。 | 請確認資料動態饋給中已為餐廳定義服務實體。請確認 @id 參照正確無誤。使用 Inventory Viewer 檢查服務實體相關錯誤並修正。 |
| 暫時從動態饋給中停用 | 餐廳已加入資料動態饋給，但服務已停用。 | 傳送增量更新或批次攝入內容，將服務實體 isDisabled 屬性設為 false。 |
| 餐廳已選擇不採用 OwG | 商家未啟用「從頭到尾訂餐」功能，因為他們先前已按照「設定、開啟或關閉『線上訂購』按鈕」中的操作說明，將「線上訂購」按鈕關閉。 | 請聯絡餐廳，並要求他們按照這篇文章的說明開啟「線上訂購」按鈕。 |
| 餐廳已選擇不使用供應商 | 商家已按照「設定、開啟或關閉『線上訂購』按鈕」中的操作說明，在訂購端到端功能中停用「線上訂購」功能，因為他們回報與你沒有業務關係。 | 請與商家聯絡，要求對方使用聯絡表單為供應商啟用「線上訂購」按鈕。 |
| 在 Google 上標示為永久停業 | 該營業地點在 Google 知識面板中顯示為永久停業。 | 商家可以按照這篇文章的說明，在商家檔案中將地點標示為已恢復營業。 |
| 在 Google 上標示為暫停營業 | 該地點在 Google 知識面板中顯示為永久或暫時停業。 | 商家可以按照這篇文章的說明，在商家檔案中將地點標示為已恢復營業。 |
| 重複的餐廳 | 也就是說，資料動態饋給中的多個餐廳實體會與 Google 資料庫中的同一間餐廳相符。 | 從資料動態饋給中移除重複的餐廳實體。如果同間餐廳有多個地點，且位於同一綜合大樓 (購物中心、機場或購物中心) 或彼此相距不遠，請務必在 Google 商家檔案中為每個地點建立獨立的營業地點 (操作說明)，並在資料動態饋給中比對單一實體。 |
| 重複服務 | 也就是說，資料動態饋給中的多項相同類型服務 (外送或外帶) 會在 Google 資料庫中連結至同一間餐廳。範例：在資料動態饋給中，為同一個餐廳設定了兩個外送服務實體。 | 更新資料動態饋給，確保每間餐廳都沒有重複的店外送或外帶服務。 |
已刪除的實體
對於已刪除的餐廳和服務實體，「狀態」欄會顯示「已刪除狀態」。對於所有其他實體類型，清單檢視畫面會包含「已刪除狀態」欄，其值為「已刪除」或「未刪除」。刪除事件發生後，系統會保留刪除實體 30 天。Inventory Viewer 不會顯示已刪除的實體完整資訊，而名稱等欄位會顯示為「Unknown」。
常見問題
是否可使用 Inventory Viewer 報表取代餐廳狀態報表？
不會。餐廳狀態報告仍會繼續提供，並提供服務狀態的匯總檢視畫面。
Inventory Viewer 中顯示的資料延遲時間為何？
Inventory Viewer 中的資料延遲時間會隨擷取和處理時間而變動。對於在批次動態饋給中提供的資料，延遲時間最長為成功擷取資料的 2 小時。對於 RTU，則為 <5 分鐘。擷取成功表示：
- 在「Ingestion History」畫面中，含有實體的動態饋給顯示為「Success」狀態。
- 包含實體的 RTU 沒有 RTU 回報中所述的請求層級或實體層級驗證錯誤。
Inventory Viewer 是否支援 Quicktesting？
不行。Inventory Viewer 僅支援實際執行環境和沙箱環境。
我已修正導致餐廳無法放送的問題，但餐廳仍顯示為「停用」狀態。
從透過批次動態饋給成功攝入資料起算，資料最多可能需要 2 小時，才會反映在消費者訂購流程中。如要進一步瞭解延遲時間，請參閱常見問題。Inventory Viewer 會顯示最新的放送狀態，因此一旦實體在消費者 UI 中變更放送狀態，Inventory Viewer 幾乎會立即顯示變更。
上次修改和索引時間
Inventory Viewer 一律會顯示實體的最新擷取版本。不過，在擷取完成後，如果取用者 UI 尚未更新至最新版本，實體服務的版本就不會與剛擷取的版本相符，且會顯示在Inventory Viewer 中。這是因為服務管道中的處理時間。索引時間是指透過動態饋給和 RTU 接收的資料同步至放送資料庫，以便在消費者介面上放送的時間。任何上次修改時間早於索引時間的實體，都會在消費者途徑上提供。
舉例來說，假設您在動態饋給中新增服務，該服務會在 00:30:00 完成擷取，並在 01:30:00 建立索引，因此會在該時間開始放送。然後在 04:00:00 上傳另一個動態饋給，其中包含該服務的新版本，且 isDisabled=true，該動態饋給會在 04:30:00 完成擷取。完成第二次攝入作業後，「Inventory Viewer」會顯示 1 月 1 日 04:30:00 世界標準時間，做為「Last Modified」時間戳記，但在索引作業完成前，消費者訂購流程仍會提供在 00:30:00 完成攝入的版本。假設另一個索引作業會在 04:45:00 執行。此時，服務的停用狀態會在消費者 UI 中更新，該實體也會停止放送，但在 01:30:00 (第一次索引作業) 到 04:45:00 (第二次索引作業) 的整個期間，由於消費者 UI 會放送先前版本的實體，因此實體的狀態會是「已啟用」。