航班廣告 - 目錄和摘要

若要在 Facebook 推廣航班，您必須與 Facebook 分享航班相關資訊。分享方式為建立航班目錄，然後填入航線資訊。若要填入目錄並將其保持在最新狀態，有三種方式。

1. 上傳內含航班庫存的「航班摘要」CSV 或 XML 檔案
2. 利用事件動態自動填入目錄
3. 結合航班摘要並搭配自動產生的航班

您可在商務管理工具中建立和管理航班目錄：

1. 建立航班目錄
2. 將摘要上傳至 Facebook
3. 從航班目錄建立產品組合
4. 將目錄與事件來源建立關聯

航班摘要 - 將航班上傳至 Facebook

航班摘要為內含航班庫存資料的檔案。檔案中每一行或每一個項目都代表單一航線。您可使用一個以上的航班摘要，只要所有摘要合計起來包含完整的航班庫存即可。

支援的航班摘要格式

CSV > 範例 - 說明

CSV 範例 | TSV 範例（扁平化）

• 第一列必須按照指定值的順序列出所選欄位名稱。後續的列會提供每個航班的相應值。
• 若有含空白字元或逗號的欄位應以雙引號（""）括住。
• 巢狀或多重值欄位（例如 image）可使用 JSON 編碼值表示，或由一組使用 JSON 路徑語法標記的「扁平化」純文字欄表示（例如 image[0].url、image[0].tag[0]、image[0].tag[1]）。您可以在同一個檔案中交替使用這兩種慣例。

XML > 範例 - 說明

XML 範例

• <listings> XML 根節點包圍著一系列的 <listing> 節點，每一組節點代表一個航班。
• 檔案開頭必須為有效的 <?xml 宣告標籤。

支援的欄位 - 航班廣告

下列支援欄位是專為新增至商品目錄的項目所設計。

若是本地化目錄，請參閱支援的航班廣告欄位。

圖像物件參數

產品深層連結

遵循應用程式連結規格在摘要中提供深層連結。摘要中的深層連結資訊會優先於任何 Facebook 資訊，這些資訊是透過我們的網路爬蟲使用應用程式連結中繼資料收集所得。

如果您已經具備應用程式連結的深層連結資訊，則無須指定此資料。Facebook 使用應用程式連結的資訊來顯示正確的深層連結。若要在廣告中顯示深層連結，請參閱廣告範本：高效速成+ 目錄廣告。

自動產生航班 - 利用事件動態，自動將航線新增至目錄

Facebook 可根據像素和應用程式事件動態，自動將航線新增至目錄。每次系統收到事件時，如果指定的航線尚不存在於目錄中，就會自動新增該航線。這樣可讓您無須處理航班摘要，即可將您所有航班用於航班廣告。

若要啟用這項功能，請向航班目錄發出 POST 要求，並且將 generate_items_from_events 設定為 true。

curl \
  -F 'flight_catalog_settings={generate_items_from_events:1}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<VERSION>/<CATALOG_ID>

自動新增的航線沒有圖像（以顯示於廣告）。因此，您必須為所有自動產生的航線提供可用的通用圖像。

curl \
  -F 'fallback_image_url=http://example.com/some.image_1.jpg' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<VERSION>/<CATALOG_ID>

當目錄連結至像素及／或應用程式，並開始接收航班廣告事件後，目錄就會有項目填入。您可查詢目錄加以確認。

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<CATALOG_ID>/flights

結合 - 使用航班摘要並搭配自動產生的航班

您可上傳航班摘要並結合自動產生的航線。結合這兩個選項可讓您將所有航班充分用於航班廣告，同時針對最重要的航線，利用航班摘要提供自訂圖像。

若要這麼做，只須合併執行上傳航班摘要和自動填入目錄兩個步驟。

下列章節只適用於以 API 管理目錄的情況。

使用 API 建立航班目錄

航班目錄內含航班庫存資料。若要使用目錄 API，請確認是否具備合適的行銷 API 存取層級，並且透過企業管理平台建立第一個目錄，確認已接受服務條款。

若要建立用於航班廣告的航班目錄，請將 vertical 設為 flights：

curl -X POST \
  -F 'name="Test Flight Catalog"' \
  -F 'vertical="flights"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v10.0/{business-id}/owned_product_catalogs

透過 API 上傳航班摘要

建立目錄後，您必須將航班摘要上傳至 Facebook。請針對每個要上傳的摘要，使用 API 建立摘要物件。可支援排程上傳和直接上傳。

將航班目錄篩選為航班組合

航班組合是目錄的子集。若要設定航班廣告，您至少得建立一個航班組合。

航班組合是由航班目錄套用的篩選條件來決定。例如，您可將所有從倫敦出發的航線建立為航班組合。請注意，您也可建立沒有任何篩選條件的航班組合。在此情況下，航班組合會包含目錄中所有航班。

use FacebookAds\Object\ProductSet;
use FacebookAds\Object\Fields\ProductSetFields;

$flight_set = new ProductSet(null, <PRODUCT_CATALOG_ID>);

$flight_set->setData(array(
  ProductSetFields::NAME => 'Test Flight Set',
  ProductSetFields::FILTER => array(
    'origin_airport' => array(
      'eq' => 'LHR',
    ),
  ),
));

$flight_set->create();

from facebookads.adobjects.productset import ProductSet

flight_set = ProductSet(None, <PRODUCT_CATALOG_ID>)

flight_set[ProductSet.Field.name] = 'Test Flights Set'
flight_set[ProductSet.Field.filter] = {
    'origin_airport': {
        'eq': 'SFO',
    },
}

flight_set.remote_create()

curl \
  -F 'name=Test Flight Set' \
  -F 'filter={"origin_airport":{"eq":"LHR"}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<PRODUCT_CATALOG_ID>/product_sets

filter 參數是由下列運算子和資料所組成：