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