共用方式為

在先前的 Hotel 摘要) 檔案 (建立 CSV 屬性摘要

  • 發行項

注意事項

此 Beta 版的旅館價格廣告僅供選取參與者使用。 如需參與 Beta 發行計劃的相關信息，請連絡您的帳戶管理員或 在這裡註冊。

屬性摘要和檔可能會變更。

若要提供Microsoft旅館清單，請建立 CSV 檔案，其中包含您想要公告的每個旅館清單。 清單描述旅館的名稱、位址、電話號碼和地理座標。

如需使用 XML 檔建立摘要檔案的相關信息，請參閱 建立 XML 屬性摘要檔案。

注意事項

Property 摘要僅支援英文。

CSV 格式不支援映像。 請改用 XML 格式。

取得正確的數據

因為Microsoft嘗試比對您屬性摘要中的屬性與 Bing 地圖服務中的企業，所以您提供有關旅館的數據必須正確且完整。

如果您的旅館缺少或不正確的資訊，Microsoft可能無法比對。 如果Microsoft無法與旅館相符，Microsoft將不會公告。 在您的 TAM 匯入您的屬性摘要檔案之後，它們會傳送報告給您，指出哪些旅館Microsoft相符或不相符。 如果Microsoft不符合旅館，報表會包含訊息「無法將此旅館與 Bing 中的屬性比對。 如需改善比對率的協助，請使用您的 TAM。

定義旅館清單

摘要檔案的第一行是標頭數據列，其中包含摘要中旅館數據的數據行名稱。 標頭必須包含所有必要數據元素的數據行名稱。 只有在您提供數據時，才包含選擇性數據行的名稱。

以下是您可能包含在摘要中的數據行清單。 摘要檔案可能以任何順序包含數據行，而且數據行名稱不區分大小寫。

欄名稱 描述 資料類型 必要項目
id 不透明的使用者定義標識碼，可唯一識別摘要內的旅館。

當您建立價格摘要時，請在 Price 摘要的 元素中 Property 使用此標識碼來識別旅館。		 字串 是
name 旅館的名稱。 名稱最多可包含 200 個字元。 字串 是
地址 使用自由格式文字的旅館街地道址。 以逗號分隔位址的每個元件，並以引弧括住位址。 例如，“1234 Billings Way， Redmond， WA， 98030”。

只有在您使用自由格式文字提供位址時，才使用此數據行;否則，請使用位址元件數據行，例如 addr1、city 和 province。 建議您使用位址元件數據行，而不是使用自由格式文字。		 字串 是
addr1 旅館的街地道址。 例如，1234 計費方式。 地址必須是實體街地道址，而不是郵局方塊或其他僅限郵件位址。 字串 是
addr2 第二條街地道址線。 字串 否
addr3 第三條街地道址線。 字串 否
縣/市 旅館所在的城市名稱。 字串 是
省 旅館所在的州、地區或省名稱。 字串 是
postal_code 地址的郵遞區號。 字串 是
國家 旅館所在的國家或地區。 使用兩個字母的 ISO 3116 國家/地區代碼指定國家或地區。 例如，使用 美國 版。 字串 是
緯度 旅館地理座標的緯度。

附註：
  • 只有當您未指定 phone時，才需要緯度和經度。 建議您同時指定電話和地理座標。
  • 緯度必須介於 -90.0 到 90.0 之間。
  • 使用 位置 API 或其他 GeoCoding 工具，從街地道址產生座標。
 小數 否
經度 旅館地理座標的經度。

附註：
  • 只有當您未指定 phone時，才需要緯度和經度。 建議您同時指定電話和地理座標。
  • 經度必須介於 -180.0 到 180.0 之間。
  • 使用 位置 API 或其他 GeoCoding 工具，從街地道址產生座標。
 小數 否
電話 客戶用來連絡旅館的主要語音電話號碼。 號碼應該是前台的電話號碼，而不是中央保留的電話號碼。

附註：
  • 在電話號碼中使用連字元、空格或括弧，讓您更容易閱讀。 例如，使用 “610-222-3333” 或 “ (610) 222-3333” 而不是 “6102223333”。
  • 只指定一個電話號碼;請勿指定多個數位，例如 650-123-2222/33。
  • 電話號碼可能包含最多7位數的擴充功能。 在延伸模組前面加上下列其中一個縮寫：“ext”、“extn” 和 “x”。 例如，“408-555-1111x12345” 或 “408-555-1111 x12345”。
  • 電話號碼可能不包含字母字元。
  • 如果電話號碼包含國家/地區代碼，請在前面加上 “+”。 例如，新加坡國家/地區代碼為65的數位為 “+65 6722-2323”，如果美國國家/地區代碼為001的數位，則為 “+001 (408) 555-1111”。
 字串 是
類別 識別旅館類型的類別。 預期的格式 是vacation_rental 或 旅館 ，後面接著管道字元和自定義值。 例如， vacation_rental |'custom value' 或 hotel |'custom value'

如需自定義值的清單，請參閱 Lodging 屬性類別目錄。		 字串 否
hotel_brand 連鎖旅館的品牌。 例如，Fabrikam Marketplaces by Contoso，其中 Contoso 是品牌。 字串 否
star_rating 旅館的星級評等。 可能的值為 1 到 5。 字串 否

注意事項

數據行 address 和 addr、 addr2、 addr3、 city、 province和 postal_code 數據行互斥。 指定資料列 address 或地址元件數據列。 建議您指定位址元件數據行。

雖然您可以指定地理座標或電話號碼，但您應該同時指定兩者，以確保在 Bing 地圖服務中比對屬性的機會更好。

若要包含清單的描述、影像和評論，請使用 XML 摘要檔案。 請參閱 建立 XML 屬性摘要檔案。

以下顯示 CSV 格式的範例標頭。 使用逗號分隔所有數據行。 只包含包含至少一家旅館值的數據行。

id,name,addr1,city,province,postal_code,country,phone

在標頭列之後，針對您公告的每個旅館包含一個數據列。 摘要必須包含您所有旅館的清單，摘要程式不支援部分更新。 請勿在摘要中包含空白數據列。

如果值包含逗號，您必須以引弧括住值。 以下顯示範例 CSV 檔案的內容。

id,name,addr1,city,province,postal_code,country,latitude,longitude,phone
abc123,Great Ambers Getaway,1234 Porter Rd,Goldendale,WA,98234,US,47.694351,-122.451782,123-456-7890

如果旅館的內容變更，會發生什麼事？

如果您在摘要執行之間變更任何旅館的屬性值， (例如其名稱、位址、電話等 ) ，Microsoft Advertising 可能會將它視為新的旅館屬性，併為其建立新的清單。 如果Microsoft建立新清單，舊旅館的先前效能歷程記錄會保留最多 36 個月。 請注意，舊旅館的報價和乘數將不會轉移至新的旅館實體。

如果您移除旅館，並以與之前相同的屬性值將其新增至稍後的摘要中，Microsoft將它視為新的清單。 此外，效能報告會將其顯示為兩個不同的清單。

後續步驟

要求您的帳戶管理員匯入摘要檔案。

也請務必匯入登陸頁面數據。 如需建立登陸頁面摘要檔案的相關信息，請參閱 登陸頁面摘要。

在Microsoft成功匯入您的數據，並且能夠比對您的飯店與 Bing 地圖服務中的屬性之後，您就可以開始傳送旅館價格和可用性數據。 如需詳細資訊，請 參閱價格摘要。