航班廣告 - 目錄和摘要

若要在 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 宣告標籤開頭。

支援的欄位 - 航班廣告

以下受支援的欄位專為您加入商品目錄的項目而設。

如欲查看本地化目錄，請參閱航班廣告支援欄位。

Image 物件參數

商品深層連結

按照應用程式連結規格在摘要中提供深層連結。摘要中的深層連結資訊，優先於 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 參數由以下運算子及數據組成：