航班广告 - 目录和信息库

要在 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 参数由以下运算符与数据组成：