目的地广告 - 目录与信息库

如要在 Facebook 上推广目的地，您必须与 Facebook 分享目的地信息。方法是：创建目的地目录，然后在其中填入目的地。

上传包含待推广目的地的 CSV 或 XML 文件，用作“目的地信息库”

您可以在电商管理工具中创建和管理目的地目录。

如需使用此 API 管理目录，请执行以下操作：

1. 创建目的地目录
2. 将信息库上传到 Facebook
3. 根据目的地目录创建商品系列
4. 将目录与事件源关联

目的地信息库 - 将目的地上传到 Facebook

目的地信息库是一个包含待推广目的地的文件，此文件中的每一行或每个项目均代表一个单独的目的地。您可以使用一个或多个目的地信息库，但前提是所有待推广的目的地都包含在这些信息库中。

支持的目的地信息库格式

CSV — 示例和说明

CSV 示例 | TSV 示例（平展） | TSV 示例（JSON 格式）

• 第一行必须按照赋值顺序列出选定的字段名称，然后，后面的每行会为每个目的地提供相应的值。
• 如果字段包含空格或逗号，应使用双引号 "" 将该字段括起来。
• 嵌套字段或多值字段（如 address、neighborhood 或 image）可使用 JSON 编码值表示，也可以通过由 JSON 路径语法标记的一组“平展”的纯文本列表示（例如：address.city、neighborhood[0]、image[0].url、image[0].tag[0] 和 image[0].tag[1]）。您可以在同一个文件中交替使用这两种惯例做法。

XML - 示例和说明

XML 示例

• 一个根 <listings> XML 节点包含一组 <listing> 节点，其中的每个节点均代表一个目的地。
• 文件必须以有效的 <?xml 声明标签开头。

支持的字段 - 目的地

以下支持的字段可用于要添加到商品目录中的商品。

对于本地化目录，请参阅目的地的支持字段。

商品深度链接

按照应用链接文档的说明，在信息库中提供深度链接。信息库中的深度链接信息优先于 Facebook 借助网络爬虫通过应用链接元数据收集的任何信息。

如果您已通过应用链接获得深度链接信息，则无需指定此数据。Facebook 使用来自应用链接的信息显示正确的深度链接。如需在广告中展示深度链接，请参阅广告模板 > 进阶赋能型目录广告。

图片对象参数

地址对象参数

以下部分仅适用于使用此 API 管理目录的情况。

使用 API 创建目的地目录

目的地目录是待推广目的地的容器。如需使用目录 API，请确保您拥有适当的市场营销 API 访问权限级别，并通过在商务管理平台中创建首个目录，接受了服务条款。

如需为目的地广告创建目的地目录，请将 vertical 设置为 destinations：

curl -X POST \
  -F 'name="Test Destination Catalog"' \
  -F 'vertical="destinations"' \
  -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;

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

$destination_set->setData(array(
  ProductSetFields::NAME => 'Test Destination Set',
  ProductSetFields::FILTER => array(
    'price_change' => array(
      'lt' => -20,
    ),
  ),
));

$destination_set->create();

from facebookads.adobjects.productset import ProductSet

destination_set = ProductSet(None, <PRODUCT_CATALOG_ID>)

destination_set[ProductSet.Field.name] = 'Test Destination Set'
destination_set[ProductSet.Field.filter] = {
    'price_change': {
        'lt': -20,
    },
}

destination_set.remote_create()

curl \
  -F 'name=Test Destination Set' \
  -F 'filter={"price_change":{"lt":-20}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.10/<PRODUCT_CATALOG_ID>/product_sets

filter 参数由以下运算符与数据组成：