目的地廣告：目錄及摘要

若要在 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].tag[1]、image[0].url、image[0].tag[0]）。您可以在同一個檔案中交替使用這兩種慣常做法。

XML：範例及描述

XML 範例

• <listings> XML 根節點包括一組 <listing> 節點，而後者每一個節點代表一個目的地。
• 檔案必須以有效的 <?xml 宣告型標籤開頭。

支援的欄位：目的地

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

如欲查看本地化目錄，請參閱目的地支援欄位。

商品深層連結

按照應用程式連結規格在摘要中提供深層連結。摘要中的深層連結資訊，優先於 Facebook 使用網絡爬蟲透過應用程式連結中繼資料收集而來的資訊。

如果您已經有來自應用程式連結的深層連結資訊，則無需指定此數據。Facebook 會使用應用程式連結的資訊，以展示正確的深層連結。若要在您的廣告中展示深層連結，請參閱廣告範本：進階高效速成目錄廣告。

Image 物件參數

Address 物件參數

以下部分僅適用於以此 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」參數由以下運算子及數據組成：