飯店清單包含合作夥伴希望在 Google 上顯示的所有房源和房源資訊。合作夥伴可使用 CSV 或 XML 檔案提供來源資料,檔案中包含房源的實際屬性,例如名稱、地址、地理編碼位置、電話號碼和網站網址。
事前準備
刊登規定
如要在 Google 上顯示,飯店清單中的房源須符合刊登規定。不合規定的常見例子包括公寓、長期住宿 (超過 30 天) 和度假民宿。如要在房源清單中新增度假民宿,請參閱「度假民宿合作夥伴:入門指南」。
你可以刊登季節性或暫停營業的房源資訊,但永久停業的房源不符合資格。
資料品質
飯店清單資料須與 Google 地圖專屬商家清單中的資訊相符,才能成功發布。請盡可能提供準確的房源資訊,包括電話號碼和經緯度座標,並確認該資訊與 Google 商家檔案和 Google 地圖上顯示的飯店資訊一致。
如果房源缺漏資訊或資訊有誤,系統可能就無法進行比對,你也無法刊登廣告。你可以在「房源」頁面中查看成功比對的飯店,以及資料有問題的飯店。進一步瞭解如何透過手動比對解決房源比對問題
新加入的合作夥伴:在新手上路流程中,媒合率通常偏低。Google 建議先上傳所有飯店,再選取一部分比對相符的飯店來開始傳送價格。在驗證價格動態饋給設定期間,請繼續改善飯店清單媒合率。雖然這不是硬性規定,但我們建議盡量達成 90% 以上的長期媒合率。
操作說明
1. 選擇飯店清單的提交方式
你可以使用飯店清單上傳功能,手動上傳 CSV 或 XML 檔案格式的飯店清單,或透過飯店清單提取功能 (舊稱「飯店清單動態饋給」),在伺服器上代管 XML 檔案。飯店清單上傳提交模式支援單一檔案手動上傳,檔案中的房源數量通常不到 50,000 個。如果是這類檔案,Google 建議你使用 CSV 語法,以便與採用單一語言列出的基本飯店內容整合。
如需更詳細的飯店內容,可以使用 XML 語法。如果你打算減少飯店資訊更新頻率、以單一語言提供飯店內容資訊,而且房源數量少於 50,000 個,Google 建議你使用飯店清單上傳提交模式,在 Hotel Center 中上傳飯店清單。
注意:如果你預期會經常更新飯店清單,或需要以多種語言提供內容,那麼建議你在自己的伺服器上代管 XML 檔案,以便導入 Google 飯店清單提取功能。Google 會定期提取最新的可用檔案,並自動將內容發布或更新至你的帳戶。這樣一來,每次需要更新時,就能簡化上傳和發布檔案所需的手動步驟。
如要導入飯店清單提取功能,請與飯店廣告支援團隊聯絡。
2. 建立飯店清單
選擇設定飯店清單的提交模式後,請建立 CSV 或 XML 檔案。
CSV 檔案
飯店清單 CSV 檔案包含一個標示欄位名稱的標題列,以及動態饋給資料中的每間飯店各列一行。
第一列是用來指定要在動態饋給中使用的欄名稱。例如:
id,name,addr1,addr2,addr3,city,province,postal_code,country,phone,latitude,longitude
部分欄位為選填。下表說明每個可用欄位:
欄 | 是否必填? | 說明 |
---|---|---|
id |
必填 | 飯店的專屬 ID。網站中的這個值不可重複。 |
name |
必填 | 飯店的名稱,例如「湖景飯店」。 |
address |
必填* |
飯店的完整地址 (形式不拘),例如「555 南投縣魚池鄉文化街 999 號」。 注意:如果已提供 |
addr1 |
必填 | 飯店的主要街道地址,例如「文化街 999 號」。請注意,郵政信箱或其他僅供郵寄的地址都不算是完整的實際地址。 |
addr2 |
選填 | 飯店的次要街道地址,不一定要填寫,例如「6 樓」。 |
addr3 |
選填 | 飯店街道地址的第三個部分,不一定要填寫,例如「湖光套房 610」。 |
city |
必填 | 飯店的所在城市,例如「魚池鄉」。 |
province |
必填 | 飯店的所在州、省或地區,例如「南投縣」或「新北市」。 |
postal_code |
必填 | 飯店的郵遞區號。例如「338」。 |
country |
必填 | 飯店的所在國家/地區。這個值必須是由 2 個大寫字母構成的 ISO 3116 標準國家/地區代碼,例如美國是「US」,加拿大是「CA」。 |
phone |
必填* | 飯店的主要語音電話號碼,例如「02 2722 1234」。 |
latitude |
必填* | 與飯店資訊中列出的所在位置對應的緯度,例如「37.423738」。 |
longitude |
必填* | 與飯店資訊中列出的所在位置對應的經度,例如「-122.090101」。 |
category |
選填 | 飯店的類別,例如「飯店」、「民宿」或「汽車旅館」。 |
star_rating |
選填 | 飯店的星級評等。這個值必須是介於 1 至 5 之間的整數 (含首尾),也可以留空。例如「1」代表一星級飯店,「5」代表五星級飯店,留空則表示星級評等未知。 |
hotel_brand |
選填 | 這間飯店隸屬的品牌,例如「萬豪國際」或「希爾頓」。 |
alternate_hotel_id |
選填 | 房源的替代 ID。如果對動態饋給資訊與預訂引擎設定不同的房源 ID,則採用各不相同的專屬 ID 會有所幫助。 |
custom_0 |
選填 | 任何字串類型的自訂屬性。系統不會向使用者顯示這些屬性。 |
custom_1 |
選填 | |
custom_2 |
選填 | |
custom_3 |
選填 | |
custom_4 |
選填 | |
* 必須輸入電話號碼「或」經緯度座標。建議最好兩項資訊都提供。 |
指定動態饋給資料時,請注意下列原則:
- 我們建議可使用 Google 試算表、Excel 或其他試算表應用程式來編輯資料,然後將檔案匯出為 CSV。
- 欄可按任何順序顯示,但欄名稱必須與上述值相符。
- 所有資料欄都必須以半形逗號分隔。
- 如有任何值包含半形逗號,請以半形引號圍住該值,例如 "Emerson, Lake, and Powell Hotel"。
- 如果沒有任何飯店資訊包含特定欄要求的值,可將該欄留空 (除非是必填欄位)。
任意形式的地址
建議使用 address
欄來指定任意形式的地址,不需要針對地址的各部分單獨使用資料欄。建議採用結構化地址。
指定任意形式的地址值時,請以半形逗號分隔各個元素,例如 "555, 南投縣, 魚池鄉, 文化街, 999 號"。
address
欄可取 addr1
、addr2
、addr3
、city
、province
和 postal_code
等欄。即使採用任意形式的地址,仍必須指定 country
欄。
CSV 範例
以下是一份簡單的飯店清單範例,其中包含一間提供電話和座標值的飯店:id,name,addr1,city,province,postal_code,country,phone,latitude,longitude
123abc,湖景飯店,555,南投縣,魚池鄉,文化街,999 號,TW,23.852530,120.927172
以下範例是只包含座標值的飯店 (不含電話號碼):
id,name,addr1,city,province,postal_code,country,latitude,longitude
123abc,湖景飯店,555,南投縣,魚池鄉,文化街,999 號,TW,23.852530,120.927172
以下範例是採用任意形式地址的飯店:
id,name,address,country,phone,latitude,longitude
123abc,湖景飯店,"555, 南投縣, 魚池鄉, 文化街, 999 號",TW,123-123-4567,23.852530,120.927172
XML 檔案
如要進一步瞭解如何使用 XML 建立飯店清單檔案,請參閱飯店清單 XML 參考資料。
3. 上傳或代管飯店清單
如要代管自己的飯店清單及利用飯店清單提取功能,請參閱在伺服器上代管 XML 動態饋給一文。或者也可登入 Hotel Center,使用飯店清單上傳功能手動上傳:
- 前往 Hotel Center 帳戶,在「導覽」選單中選取「房源」。
- 點選「設定」。
- 首次設定的使用者必須先回答幾個設定相關問題,包括要使用的飯店清單檔案類型。
- 確認飯店清單內容或架構符合我們的格式條件,然後上傳 CSV 或 XML 檔案。(注意:檔案上傳會在 1 小時內完成)。
- 如果檔案無效,系統會顯示錯誤訊息。請進行必要的修改,然後重新上傳。
- 檔案成功上傳至 Hotel Center 後,就會收到一封確認電子郵件。確認上傳後,請返回「房源設定」頁面來發布飯店清單。如要調整通知設定,請前往「帳戶設定」頁面並選取「快訊」類別。
4. 發布飯店清單 (僅限上傳飯店清單)
上傳至少一份飯店清單後,就可以選擇要使用哪一份當做上線版本。
選擇要發布的飯店清單:
- 前往 Hotel Center 帳戶,在「導覽」選單中選取「房源」。
- 點選「設定」。
- 在「發布」分頁中點選「發布」,讓指定的清單上線。發布程序一個工作天內就會處理完畢。
發布飯店清單後,請前往 Hotel Center 查看「房源」頁面,檢查是否有飯店不相符的情況。瞭解如何透過手動比對解決房源比對問題
如要還原先前上傳的檔案,請將游標移至檔案名稱上,然後按一下「重新發布這個檔案」。
5. 更新現有的飯店清單 (僅上傳飯店清單)
飯店清單成功發布後,只要上傳編輯過的清單來覆寫先前的版本,即可更新清單。
如要更新飯店清單: