若要在 Facebook 推廣飯店,您必須與 Facebook 分享飯店相關資訊。分享方式為建立飯店目錄,然後填入飯店資訊。填寫及更新目錄資料的方式有 2 種:
您可在商務管理工具中建立和管理飯店目錄。
若要使用 API 管理目錄,請執行以下步驟:
飯店摘要為內含飯店庫存資料的檔案。檔案中每一行或每一個項目都代表單一家飯店。您可使用一個以上的飯店摘要,只要所有摘要合計起來包含完整的飯店庫存即可。
CSV 範例 | TSV 範例(扁平化)| TSV 範例(JSON 樣式)
"
"
)括住。 address
、neighborhood
或 image
),可使用 JSON 編碼值代表,或以一組使用 JSON 路徑語法標記的「扁平化」純文字欄代表(例如 address.city
、neighborhood[0]
、image[0].url
、image[0].tag[0]
、image[0].tag[1]
)。您可以在同一個檔案中交替使用這兩種慣例。<listings>
XML 根節點包圍著一系列的 <listing>
節點,每一組節點代表了一家飯店。<?xml
宣告標籤。 摘要剖析器會自動偵測 UTF8
、UTF16
或 UTF32
文字編碼,且如果遇到未預期的位元組序列,會預設為 LATIN1
。您可在欄位值提供任何語言的文字,不過,欄位名稱必須完全和以下指定的英文名稱相同。
下列支援欄位是專為新增至商品目錄的項目而設計。
若是本地化目錄,請參閱支援的飯店廣告欄位。
欄位和類型 | 說明 |
---|---|
類型:字串 | 必要項目。 長度上限:100 飯店在目錄內的專屬識別碼。此編號會與 範例: |
類型:字串 | 新增飯店客房資訊時的必要欄位。 請輸入不重複的飯店客房類型編號。字元上限:100 範例: |
類型:字串 | 必要項目。 飯店最常用的名稱。 範例: |
類型:字串 | 必要項目。 大小上限:5000 飯店的簡要說明。 範例: |
類型:字串 | 新增飯店客房資訊時的必要欄位。 入住飯店的入住日期。自摘要上傳日起最多可新增 180 天。使用 ISO-8601 標準( 範例: |
類型:字串 | 新增飯店客房資訊時的必要欄位。 入住飯店的過夜次數。 範例: |
類型:字串 | 新增飯店客房資訊時的必要欄位。 飯店客房的每晚基本價格。請務必在價格中加入幣別類型(例如 USD 代表美元)。以成本格式標示價格,後面接著 ISO 幣別代碼,成本與幣別之間空一格。 範例: |
類型:字串 | 新增飯店客房資訊時的必要欄位。 飯店入住總價,根據 範例: |
類型:字串 | 新增飯店客房資訊時的必要欄位。 價格適用的稅率。以費用格式標示價格,後面接著 ISO 幣別代碼,費用與幣別之間空一格。 範例: |
類型:字串 | 新增飯店客房資訊時的必要欄位。 價格適用的服務費。以成本格式標示價格,後面接著 ISO 幣別代碼,成本與幣別之間空一格。 範例: |
類型:字串 | 必要項目。 可預訂飯店客房的外部網站連結。您也可以使用 範例: |
類型:物件 | 請參閱圖像物件參數。 |
類型:物件 | 請參閱圖像物件參數。 |
類型:字串 | 必要項目。 連鎖飯店的品牌名稱。 範例: |
類型:物件 | 請參閱地址物件參數。 |
類型:字串 | 必要項目。 允許的社區上限:20 飯店所在的社區。如果社區不只一個,請為每個社區新增額外的欄,並在每個欄名中使用 JSON-path 語法來表示社區數量。 範例: |
類型:浮點數 | 必要項目。 飯店的緯度。 範例: |
類型:浮點數 | 必要項目。 飯店的經度。 範例: |
類型:字串 | 選用項目。 飯店每晚入住的促銷價格,根據 範例: |
類型:物件 | 請參閱房客評分物件參數。 |
類型:物件 | 請參閱房客評分物件參數。 |
類型:浮點數 | 請參閱房客評分物件參數。 |
類型:字串 | 選用項目。 入住飯店即可累積點數的會員集點計畫。 範例: |
類型:整數 | 選用項目。 飯店的獲利能力指標,值為 1 到 10。 範例: |
類型:字串 | 選用項目。 飯店的主要電話號碼。 範例: |
類型:物件 | 選用項目。 使用應用程式連結,直達行動應用程式中飯店詳細資料頁面的深層連結。您可以按照優先順序(由高至低)指定深層連結:
深入瞭解產品深層連結。 |
類型:整數 | 選用項目。 飯店的優先順序指標,值為 0(最低優先順序)到 5(最高優先順序)。範例: |
類型:字串 | 選用項目。 資產的類型。此類別可以是所需的任何類型內部說明。範例: |
類型:整數 | 選用項目。 此飯店廣告的客房/單位總數。 範例: |
類型:字串 | 控制要銷售目錄中的商品或將其封存。在您的廣告、商店或任何其他管道中,用戶只能看到銷售中的商品。支援的值: 範例: 注意:部分合作夥伴平台(例如 Shopify)可能會將商品同步至您的目錄,該狀態稱為預覽,其效果等同於 這個欄位之前稱為 |
類型:字串 | 字元上限:100 最多五個自訂欄位,設定您在建立商品組合時,要用於篩選商品的任何其他資訊。舉例來說,您可以使用自訂欄位來指出所有夏季促銷房間,然後將這些商品篩選為商品組合。此欄位支援所有文字值,包括數字。 範例: 此為補充摘要支援的欄位。 |
類型:整數 | 您在建立商品組合時,可針對想用來篩選商品的任何其他數字相關資訊加入最多五個自訂欄位。此欄位允許您在建立商品組合時,依數字範圍(大於和小於)進行篩選。舉例來說,您可以使用此欄位來標示飯店的開業年分,然後將特定年分範圍篩選成商品組合。 此欄位支援 0 到 4294967295 之間的整數,不支援負數、十進位數字或逗號,例如 -2、5.5 或 10,000。 範例: |
欄位名稱和類型 | 說明 |
---|---|
類型:字串 | 必要項目。 項目上限:20。 廣告中將顯示之項目圖像的網址連結。請遵循下列圖像規格:
範例: 範例: |
類型:字串 | 選用項目。 附加在圖像中以顯示其內容的標籤。可以將單一圖像與多個標籤連結。 範例:
|
巢狀或多重值欄位(例如 address
)可使用 JSON 編碼值表示,或由一組使用 JSON 路徑語法標記的「扁平化」純文字欄表示(例如 address.region
)。您可以在同一個檔案中交替使用這兩種慣例。
欄位名稱和類型 | 說明 |
---|---|
類型:物件 | 必要項目。 飯店的主要街道地址。 範例: |
類型:物件 | 選用項目。 飯店的次要街道地址。 範例: |
類型:物件 | 選用項目。 飯店的第三街道地址。 範例: |
類型:字串 | 選用項目。 在廣告創意中用於深層連結網址( 範例: |
類型:字串 | 必要項目。 飯店所在地的城市。 範例: |
類型:字串 | 必要項目。 飯店所在地的州、縣、省。 範例: |
類型:字串 | 必要項目。 飯店所在地的國家/地區。 範例: |
類型:字串 | 若該國家/地區使用郵遞區號系統,此為必填項目。 飯店的郵遞區號。 範例: |
欄位名稱和類型 | 說明 |
---|---|
類型:物件 | 選用項目。 評論過飯店的總人數。若指定此欄位,必須同時提供 範例: |
| 選用項目。 為此飯店打過分數的總人數。 範例: |
類型:字串 | 選用項目。 用於賓客評論的系統。 範例: |
類型:整數 | 必要項目。 飯店評分的最大值。必須大於或等於 0,小於或等於 100。 範例: |
您可以使用飯店 API 直接在目錄中新增、編輯和移除飯店。如需深入瞭解如何使用 API 管理飯店,請參閱飯店 API 參考資料。
下列章節只適用於以 API 管理目錄的情況。
飯店目錄內含飯店庫存資料。若要使用目錄 API,請確認是否具備合適的行銷 API 存取層級,並且藉由透過企業管理平台建立第一個目錄,確認已接受服務條款。
若要建立用於飯店廣告的飯店目錄,請將 vertical
設為 hotels
:
curl -X POST \ -F 'name="Test Hotel Catalog"' \ -F 'vertical="hotels"' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v10.0/BUSINESS_ID/owned_product_catalogs
建立目錄後,您必須將飯店摘要上傳至 Facebook。請針對您要上傳的每個摘要,使用 API 來建立摘要物件。我們支援排程上傳和直接上傳。
飯店組合是目錄的子集。若要設定飯店廣告,您需要飯店組合。因此,您必須建立至少一個飯店組合。
飯店組合是由套用於飯店目錄的篩選條件來定義。例如,您建立的飯店組合可以包含所有 star_rating
高於 3 的飯店。注意:您也可以建立不套用任何篩選條件的飯店組合。在不套用任何篩選條件的情況下,飯店組合會包含目錄中所有飯店。
若要建立一個飯店組合,其中包含 brand
欄位中含「sample brand」(品牌範例)的所有飯店:
curl -X POST \
-F 'name="Test Hotel Set"' \
-F 'filter={
"brand": {
"i_contains": "sample brand"
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<PRODUCT_CATALOG_ID>/product_sets
filter
參數是由下列運算子和資料所組成:
運算子 | 篩選條件的類型 |
---|---|
| 包含子字串。運算子不會區別大小寫。 |
| 不包含子字串。運算子不會區別大小寫。 |
| 包含子字串。運算子不會區別大小寫。 |
| 不包含子字串。運算子不會區別大小寫。 |
| 等於。運算子不會區別大小寫。 |
| 不等於。運算子不會區別大小寫。 |
| 小於。僅限數值欄位。 |
| 小於或等於。僅限數值欄位。 |
| 大於。僅限數值欄位。 |
| 大於或等於。僅限數值欄位。 |
資料 | 所要篩選的資料。 |
---|---|
| 飯店在目錄內的專屬識別碼。 |
| 連鎖飯店的品牌。 |
| 此飯店的每晚基本價格。價格是以美分為單位(4999 代表 $49.99 美元)。 |
| 此飯店的每晚售價。價格以美分為單位(4999 代表 $49.99 美元)。 |
| 幣別 |
| 飯店所在城市。 |
| 飯店的國家/地區。 |
| 飯店最常用的名稱。 |
| 飯店星級。有效值介於 1 到 5 之間,且應為 0.5 的倍數。 |