目的地廣告 - 目錄和摘要

若要在 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 參數是由下列運算子和資料所組成：