開始使用高效速成+ 目錄廣告

高效速成+ 目錄廣告可讓您建立個人化廣告，根據一組產品鎖定正確的廣告受眾。

準備工作

若要建立高效速成+ 目錄廣告行銷活動，您需要準備以下項目：

• 代表廣告主的 Facebook 粉絲專頁，若要在 Instagram 上推行此行銷活動，另外還需要 Instagram 帳號。
• 已註冊付款資料的廣告帳號。
• 目錄，例如企業管理平台帳號中的商品目錄。

或者，您可以設定動態商品廣告受眾，但不需要在目標設定中涉及商品組合包含關係或排除關係。

步驟 1：建立廣告行銷活動

請參閱廣告行銷活動文件，瞭解如何建立廣告行銷活動。

在此層級中，您必須透過 objective 欄位設定廣告目標。若為高效速成+ 目錄廣告，支援的目標為 PRODUCT_CATALOG_SALES、CONVERSIONS、LINK_CLICKS 或 APP_INSTALLS。如果您提供的 objective 為 CONVERSIONS、LINK_CLICKS 或 APP_INSTALLS，則 promoted_object 欄位並非必填。

curl \
  -F 'name=Product Catalog Sales Campaign' \
  -F 'objective=PRODUCT_CATALOG_SALES' \
  -F 'promoted_object={"product_catalog_id":"<PRODUCT_CATALOG_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

步驟 2：建立廣告組合

若為高效速成+ 目錄廣告，您必須在 promoted_object 中，為廣告組合層級指定 product_set_id，以推廣該商品組合中的商品。

另外，當 optimization_goal 為 OFFSITE_CONVERSIONS 時，您還可在 promoted_object 中指定 custom_event_type 來為該商品組合定義自己的轉換事件。這會讓您的廣告鎖定在應用程式或網站中執行該事件的用戶。

例如，若您將此設為 ADD_TO_CART，這表示「加到購物車」事件為轉換事件。根據預設，custom_event_type 設為 PURCHASE。請參閱 Meta 像素廣告轉換追蹤，深入瞭解 custom_event_type 的標準事件和值。

若您想要針對站外轉換進行最佳化處理，包括來自應用程式事件和 Facebook 像素的轉換，並根據曝光次數收費：

• 將 optimization_goal 設為 OFFSITE_CONVERSIONS
• 將 billing_event 設為 IMPRESSIONS

如需有效的 optimization_goal 和 billing_event 組合詳細資訊，請參閱最佳化目標和計費事件。

以下是建立根據 IMPRESSIONS 收費並針對 OFFSITE_CONVERSIONS 最佳化的廣告組合範例：

curl \
  -F 'name=Product Catalog Sales Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ "geo_locations": {"countries":["US"]}, 
    "dynamic_audience_ids": ["<DYNAMIC_AUDIENCE_ID>"] 
  }' \
  -F 'promoted_object={"product_set_id":"<PRODUCT_SET_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

DYNAMIC_AUDIENCE_ID 是指商品廣告受眾。或者，您可以省略呼叫中的 dynamic_audience_ids。

若為電子商務使用案例，您可以省略呼叫中的 dynamic_audience_ids，並改為將行為目標設定資訊當作 product_audience_specs 或 excluded_product_audience_specs 參數的一部分傳送。這些規格是由您用於建立 商品廣告受眾的相同參數所定義。

參數

再行銷

在本範例中，我們鎖定在過去 3-5 天內瀏覽商品，但尚未購買的用戶。廣告版位在行動版動態消息和 Audience Network 上。若要建立此廣告受眾：

curl \
  -F 'name=Product Catalog Sales Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=LINK_CLICKS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "publisher_platforms": ["facebook","audience_network"], 
    "device_platforms": ["mobile"], 
    "geo_locations": {"countries":["US"]}, 
    "product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_ID>", 
        "inclusions": [{"retention_seconds":432000,"rule":{"event":{"eq":"ViewContent"}}}], 
        "exclusions": [{"retention_seconds":432000,"rule":{"event":{"eq":"Purchase"}}}] 
      } 
    ], 
    "excluded_product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_ID>", 
        "inclusions": [{"retention_seconds":259200,"rule":{"event":{"eq":"ViewContent"}}}] 
      } 
    ] 
  }' \
  -F 'promoted_object={"product_set_id":<PRODUCT_SET_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

交叉銷售或追加銷售

以下是針對用戶尚未查看的產品進行宣傳的範例：

curl \
-F 'name=Case 1 Adset' \
-F 'bid_amount=3000' \
-F 'billing_event=IMPRESSIONS' \
-F 'status=ACTIVE' \
-F 'daily_budget=15000' \
-F 'campaign_id=<CAMPAIGN_ID>' \
-F 'targeting= { \
            "geo_locations": { \
            "countries":["US"], \
             }, \
            "interests":[ \
                {"id":6003397425735,"name":"Tennis"}, \
            ], \
        }' \
-F 'promoted_object={"product_set_id”:<PRODUCT_SET_ID>}' \
-F 'access_token=<ACCESS_TOKEN>’ \
https://graph.facebook.com/<API_VERSION>/act_<ACCOUNT_ID>/adsets

在商品組合之間交叉銷售：

• 為商品廣告受眾提供與商品組合 A 相關的事件規則。
• 在廣告創意層級將 product_set_id 設為商品組合 B，以在廣告中顯示來自商品組合 B 的產品。

例如，商家想要將廣告的目標設定為已經對 PRODUCT_SET_2 中鞋子表露興趣的現有用戶，進而增加 PRODUCT_SET_1 中手提包的銷售量。請將 product_audience_specs 中的 product_set_id 設為 PRODUCT_SET_2 的編號或鞋子，並將 promoted_object 中的 product_set_id 設為 PRODUCT_SET_1 的編號或手提包。

curl \
  -F 'name=My cross sell ad set' \
  -F 'bid_amount=3000' \
  -F 'billing_event=LINK_CLICKS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "geo_locations": {"countries":["US"]}, 
    "product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_2_ID>", 
        "inclusions": [{"retention_seconds":432000,"rule":{"event":{"eq":"ViewContent"}}}], 
        "exclusions": [{"retention_seconds":432000,"rule":{"event":{"eq":"Purchase"}}}] 
      } 
    ], 
    "excluded_product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_2_ID>", 
        "inclusions": [{"retention_seconds":259200,"rule":{"event":{"eq":"ViewContent"}}}] 
      } 
    ] 
  }' \
  -F 'promoted_object={"product_set_id":"<PRODUCT_SET_1_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets  

然後將廣告創意中的 product_set_id 設為 PRODUCT_SET_1 的編號。

  curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

廣大的廣告受眾目標設定

除了針對既有顧客進行再行銷和交叉銷售外，高效速成+ 目錄廣告也可用於利用年齡、性別和其他人口統計資料目標設定等條件，將廣大的廣告受眾鎖定至商品目錄中的相關產品。藉由使用廣泛鎖定的廣告受眾加上站外轉換出價，高效速成+ 目錄廣告能讓您大幅提高廣告的觸及人數。

若要鎖定廣大的廣告受眾：

• 使用基本的人口統計資料目標設定來建立廣告受眾，例如超過 18 歲的美國女性。
• 將 OFFSITE_CONVERSIONS 的 customOptimize 包括在內，搭配購買意願較強的訊號，例如 Purchase 或 InitiateCheckout。

在本範例中，我們會建立一個廣告組合，目標為 30-65 歲的美國女性，但不包括在過去 10 天內曾購買的顧客。我們將出價 $8 美元，並使用 OFFSITE_CONVERSIONS 代表 PURCHASE 事件。

curl \
  -F 'name=Broad Audience Targeting' \
  -F 'bid_amount=800' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "age_max": 65, 
    "age_min": 30, 
    "geo_locations": {"countries":["US"]}, 
    "genders": [2], 
    "excluded_product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_ID>", 
        "inclusions": [{"retention_seconds":864000,"rule":{"event":{"eq":"Purchase"}}}] 
      } 
    ] 
  }' \
  -F 'promoted_object={"product_set_id":"<PRODUCT_SET_ID>","custom_event_type":"PURCHASE"}' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

高效速成+ 目錄廣告的類別

高效速成+ 目錄廣告的類別針對高效速成+ 目錄廣告平台，推出了兩個新的廣告創意選項，這兩個選項都可用來為處於購買決策早期階段的潛在買家，打造個人化的廣告創意。運用這項功能，您可以有效地建立第二個較小型的圖像廣告創意目錄來代表每個類別（除了您已經擁有的產品圖像目錄之外），我們將會用比對產品與用戶的相同方式，來比對您廣告中的產品類別與用戶。

高效速成+ 目錄廣告的類別可搭配流量、轉換或目錄銷售目標中的任何目標設定選項使用。如果您沒有高品質的圖像來表示每個類別或品牌，Facebook 可以針對每組商品的最相關商品，自動產生 2x2 的影像拼貼。

在將這個新圖像對應到現有的商品目錄時，您可以使用摘要中三個欄位之一來將商品分組：品牌、商品類型和 Google 商品類別。

在下方的目錄範例中，商品類型欄位有五個唯一值。廣告主可以提供最多五種影像拼貼或生活風格圖像，product_type 中的每個唯一值各代表一種圖像。商品類型是類別的分類條件，也就是用來定義類別的目錄欄位名稱。目錄欄位的值為類別的條件值。

類別可藉由下列項目識別唯一性：

• 商品目錄編號
• 分類條件（品牌、商品類型或 Google 產品類別）
• 條件值（擷取自目錄）

您可以將每個類別（例如，以上述指定之其中一個欄位中的唯一值來定義每組商品）與素材建立關聯：

• 名稱 — 用戶會看到的類別簡稱（最多 40 個字元）。
• 說明 — 用戶會看到的類別說明（最多 20 個字元）。
• destination_uri — 當用戶點擊類別時，連結頁面的網址。
• image_url — 選用項目。代表類別之生活風格圖像的網址。如果未提供 image_url，我們會從該類別的最相關商品自動產生影像拼貼。

在廣告投遞期間，我們會使用與現有強力高效速成+ 目錄廣告相同的機器學習模型，以動態方式比對每個帳號管理中心帳號與其最有可能回應的類別。

類別管理 API

類別資訊儲存於目錄層級，這代表推銷同一目錄類別的不同廣告，將會共用素材，推銷產品的廣告也同樣會共用目錄中所定義的素材。我們支援用來自訂類別廣告的不同廣告創意選項。

以下是用來取得和更新類別資訊的 API。

讀取

要求

  curl -G \
    -d 'fields=["criteria_value","name","description","destination_uri","image_url"]' \
    -d 'categorization_criteria=product_type' \
    -d 'filter={"price_amount":{"gt":1500}}' \ # optional
    -d 'access_token=<ACCESS_TOKEN>' \
    https://graph.facebook.com/v19.0/<PRODUCT_CATALOG_ID>/categories

我們會對所有產品進行查詢（支援選用的篩選條件），並找出前 1,000 大類別（依商品數量排序）。

回應範例

{
  "data": [
    {
      "criteria_value": "clothes",
      "name": "Awesome clothes",
      "description": "Check out these awesome clothes!",
      "destination_uri": "http://www.example.com/clothes",
      "image_url": "http://www.example.com/clothes.jpg"
    },
    ...
    {
      "criteria_value": "shoes",
      "name": "Awesome shoes",
      "description": "Check out these awesome shoes!",
      "destination_uri": "http://www.example.com/shoes",
      "image_url": "http://www.example.com/shoes.jpg"
    }
  ]
}

更新

您可以在資料中指定多項類別資訊。針對每個類別，categorization_criteria 和 criteria_value 為必要項目，而 name、description、destination_uri 和 image_url 欄位為選用項目。第一次更新類別的資訊時，您必須指定 destination_uri。如果您想要略過類別的投遞，只要讓其 destination_uri 設為空白即可。

附註：目前不支援刪除類別。

要求

curl \
  -F 'data=[{"categorization_criteria":"product_type","criteria_value":"product_type_value","name":"Name","description":"Description","destination_uri":"http://www.example.com/","image_url":"<IMAGE_URL>"}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<lPRODUCT_CATALOG_ID>/categories

建立廣告

高效速成+ 目錄廣告類別的廣告建立方式類似其他高效速成+ 目錄廣告的廣告建立方式，但廣告創意的選擇稍有不同。您仍是使用動態類別廣告來推廣商品組合；差別在於我們會改為顯示類別廣告創意。

curl \
  -F "name=Dynamic Category Ad Creative" \
  -F 'object_story_spec={"page_id": "<PAGE_ID>", "template_data": {"description": "{{category.description}}", "link": "https://www.example.com/", "message": "<MESSAGE>", "name": "{{category.name}}"}}' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'categorization_criteria=brand' \
  -F 'category_media_source=MIXED' \ # optional
  -F access_token=<ACCESS_TOKEN> \
  https://graph.facebook.com/v19.0/act_<ACCOUNT_ID>/adcreatives

這會建立以輪播格式呈現的類別廣告創意：

類別權杖

支援的類別權杖：

• category.name — 推廣商品組合中的類別名稱。
• category.description — 推廣商品組合中的類別說明。
• category.destination_uri — 類別目的地 URI。
• category.min_price — 在推廣商品組合中，此類別的最低價格。此資訊擷取自目錄。

參數

名稱	說明
categorization_criteria	指定所要使用的類別類型。 值： brand product_type google_product_category
category_media_source	指定如何呈現類別輪播圖卡。 值： mixed（預設值） 使用類別的圖像（如果存在）；否則會返回 products_collage。 category 使用類別的圖像。如果此類別沒有圖像，請略過此類別。 products_collage 從此類別產生商品圖像的 2x2 影像拼貼。 products_slideshow 呈現此類別中商品的輕影片。

在類別廣告創意建立期間，我們會搜尋可能呈現的類別。

注意：我們會篩選掉沒有名稱或目的地網址的類別。如果 category_media_source = category，我們也可以篩選掉沒有圖像的類別。

常見錯誤

如果符合資格的類別不到 4 個，廣告創意會建立失敗（例如，若要針對指定的行銷活動，使用高效速成+ 目錄廣告的類別做為您的廣告創意，則在資料摘要檔案的指定欄位中，必須有至少四個唯一值）。

步驟 3：提供廣告創意

高效速成+ 目錄廣告範本會使用內嵌粉絲專頁貼文來建立高效速成+ 目錄範本廣告創意。

建置範本廣告創意

建立高效速成+ 目錄廣告範本廣告創意的方式，類似建立其他廣告創意。差別在於，您可以根據資料摘要檔案中的資料，新增可在執行階段正確呈現的範本參數。

根據 object_story_spec 的 template_data 物件建置範本，並使用下列欄位：

範例

建立輪播高效速成+ 目錄廣告範本

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

使用含圖像特效層的高效速成+ 目錄廣告範本

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "call_to_action": {"type":"SHOP_NOW"}, 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}",
      "image_layer_specs": [
        {
          "layer_type": "image",
          "image_source": "catalog"
        },
        {
          "layer_type": "frame_overlay",
          "blending_mode": "lighten",
          "frame_image_hash": "<HASH>",
          "frame_source": "custom",
          "opacity": 100,
          "overlay_position": "center",
          "scale": 100
        },
        {
          "layer_type": "text_overlay",
          "content": {
            "type": "price"
          },
          "opacity": 100,
          "overlay_position": "top_left",
          "overlay_shape": "rectangle",
          "shape_color": "DF0005",
          "text_color": "FFFFFF",
          "text_font": "open_sans_bold"
        }
      ]
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

建立含行動呼籲的單一商品高效速成+ 目錄廣告範本

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "call_to_action": {"type":"SHOP_NOW"}, 
      "description": "Description {{product.description}}", 
      "force_single_link": true, 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

建立輪播高效速成+ 目錄廣告範本，其中廣告圖像使用其他圖像陣列中的第一張圖像

若要預覽含 additional_image_index 的高效速成+ 目錄廣告，您必須將整個 object_story_spec 傳遞至 /generatepreviews 端點。只傳遞 object_story_id 不會產生預覽。

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "additional_image_index": 0, 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

建立單一商品的輪播高效速成+ 目錄廣告範本：其中每張圖像都取自目錄中的其他圖像陣列

curl -X POST \
     -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
     -F 'object_story_spec={
           "page_id": <PAGE_ID>,
           "template_data": {
             "message": "Test {{product.name | titleize}}",
             "link": "<YOUR_LINK_URL>",
             "name": "Headline {{product.price}}",
             "description": "Description {{product.description}}",
             "multi_share_end_card": false,
             "force_single_link": true,
             "show_multiple_images": true,
           }
         }' \
     -F 'product_set_id=<PRODUCT_SET_ID>' \
     -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

建立輪播高效速成+ 目錄廣告範本，以第一張圖卡做為抵用券靜態圖卡

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "child_attachments": [ 
        { 
          "call_to_action": {"type":"SHOP_NOW"}, 
          "description": "30% off", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/coupon", 
          "name": "Coupon Static Card", 
          "static_card": true 
        }, 
        { 
          "call_to_action": {"type":"SHOP_NOW"}, 
          "description": "Description {{product.description}}", 
          "name": "Headline {{product.price}}" 
        } 
      ], 
      "link": "<LINK>", 
      "message": "Test Message" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

從高效速成+ 目錄廣告範本建立輪播廣告輕影片

在輪播廣告中，我們會以輕影片呈現每張動態圖卡。如果同一個動態商品有多張圖像，每段輕影片會顯示該商品的多張圖像。如果動態商品只有一張圖像，圖卡會以靜態圖像呈現。

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={
    "page_id": "PAGE_ID",
    "template_data": {
      "call_to_action": {"type":"SHOP_NOW"},
      "description": "Description {{product.description}}",
      "link": "LINK",
      "message": "Test {{product.name | titleize}}",
      "name": "Headline {{product.price}}",
      "format_option": "carousel_slideshows"
    }
  }' \
  -F 'product_set_id=PRODUCT_SET_ID' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

對這些呼叫的回應就是新高效速成+ 目錄廣告範本創意的編號。

{"id":"creative_id"}

上傳目錄

上傳目錄時，您可以針對每個屬性中的每張圖像指定任意英數字串標籤。

<listing>
 <hotel_id>hotel_1</hotel_id>
 ...
 <image>
 <url>https://media-cdn.tripadvisor.com/media/photo-o/05/ca/40/af/the-epiphany-a-joie-de.jpg (https://l.facebook.com/l.php?u=https%3A%2F%2Fmedia-cdn.tripadvisor.com%2Fmedia%2Fphoto-o%2F05%2Fca%2F40%2Faf%2Fthe-epiphany-a-joie-de.jpg&h=ATPTuLcCa7Vsnmn07cEVa0YseTFl1C2hOax9NezejmXDbR48w3CLdjLlwlpuGCRDQmuafQvk03ybGqfhk-2mBcH7xtuKAsnuuq9xKwBd8DwfuBMZkq3n1qX5MdychRKGy2bo2ax9BZQzgqVDY_AvC1EqE6aAdUEc)</url>
 <tag>exterior</tag>
 <tag>first image</tag>
 <tag>tree</tag>
 </image>
 <image>
 <url>http://www3.hilton.com/resources/media/hi/DFWANHH/en_US/img/shared/full_page_image_gallery/main/HH_exteriorview001_1270x560_FitToBoxSmallDimension_Center.jpg (http://l.facebook.com/l.php?u=http%3A%2F%2Fwww3.hilton.com%2Fresources%2Fmedia%2Fhi%2FDFWANHH%2Fen_US%2Fimg%2Fshared%2Ffull_page_image_gallery%2Fmain%2FHH_exteriorview001_1270x560_FitToBoxSmallDimension_Center.jpg&h=ATPTuLcCa7Vsnmn07cEVa0YseTFl1C2hOax9NezejmXDbR48w3CLdjLlwlpuGCRDQmuafQvk03ybGqfhk-2mBcH7xtuKAsnuuq9xKwBd8DwfuBMZkq3n1qX5MdychRKGy2bo2ax9BZQzgqVDY_AvC1EqE6aAdUEc)</url>
 <tag>skyline</tag>
 ...
 </image>
 ...
</listing>

建立廣告創意

建立廣告創意時，可在 object_story_spec 中傳遞 preferred_image_tags 的陣列。

curl \
 -F 'name=Ad Creative Test'\
 -F 'object_story_spec={
     "page_id": '<PAGE_ID>',
     "template_data": {
       "preferred_image_tags": ["skyline","exterior"],
       "call_to_action": {"type":"BOOK_TRAVEL"},
       "description": "{{hotel.description}}",
       "link": "<URL>",
        "message": "Book your stay in {{hotel.city}}",
        "name": "{{hotel.name | titleize}}"
     }
    }' \
 -F 'product_set_id=<PRODUCT_SET_ID>' \
 -F 'access_token=<ACCESS_TOKEN>' \
 https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

為高效速成+ 目錄廣告啟用影片

建立高效速成+ 目錄廣告的主要步驟仍維持不變。若要啟用影片，需加入影片資料，並在目錄中提供這些資料。請參閱下方資訊，瞭解在建立或更新目錄時必須進行的變更。

步驟 1：設定目錄

將影片新增至商品資訊時，支援 url 和 tag 欄位。目前每個產品僅限支援一部影片。

<?xml version="1.0" encoding="utf-8"?>
<listings>
  <title>Test hotel feed</title>
  <listing>
    <hotel_id>hotel_1</hotel_id>
    <name>Test Hotel 1</name>
    <description>A very nice hotel</description>
    <brand>Facebook</brand>
    <address format="simple">
      <component name="addr1">180 Hamilton Ave</component>
      <component name="city">Palo Alto</component>
      <component name="city_id">12345</component>
      <component name="region">California</component>
      <component name="postal_code">94301</component>
      <component name="country">United States</component>
    </address>
    <latitude>37.4435997</latitude>
    <longitude>-122.1615219</longitude>
    <neighborhood>Palo Alto</neighborhood>
    <neighborhood>Silicon Valley</neighborhood>
    <margin_level>8</margin_level>
    <base_price>200.5 USD</base_price>
    <phone>+1 650 666-3311</phone>
    <star_rating>2.5</star_rating>
    <guest_rating>
      <score>7.8</score>
      <rating_system>tripAdvisor</rating_system>
      <number_of_reviewers>300</number_of_reviewers>
    </guest_rating>
    <guest_rating>
      <score>9.8</score>
      <rating_system>Hotels.com</rating_system>
      <number_of_reviewers>35000</number_of_reviewers>
    </guest_rating>
    <image>
      <url>https://media-cdn.tripadvisor.com/media/photo-o/05/ca/40/af/the-epiphany-a-joie-de.jpg</url>
      <tag>front view</tag>
      <tag>first image</tag>
    </image>
    <image>
      <url>http://www.jdvhotels.com/content/uploads/2014/06/72-1200x800.jpg</url>
      <tag>room</tag>
      <tag>bed</tag>
    </image>
    <loyalty_program>Starwood</loyalty_program>
    <url>http://www.jdvhotels.com/hotels/california/silicon-valley-hotels/the-epiphany-hotel/</url>
    <applink property="ios_url" content="example-ios://electronic"/>
    <applink property="ios_app_store_id" content="42"/>
    <applink property="ios_app_name" content="Electronic Example iOS"/>
*    <video>
      <url>http://example.com/some_video1.mp4</url>
      <tag>City</tag>
      <tag>Package</tag>
    </video>*
  </listing>
</listings>

影片規格

步驟 2：使用 API 取得影片中繼資料，以進行故障排除

您可以使用 API 來查看已上傳的資料。針對每個商品，允許查詢其「影片中繼資料」。

要求

curl -i -X GET \
 "https://graph.intern.facebook.com/v19.0/1234567890?fields=videos_metadata.fields(video,tags,url)&access_token=<ACCESS TOKEN>"

回應範例

步驟 3：在廣告創意或廣告中啟用影片

若要在廣告中啟用商品層級影片內容，請參閱使用動態影音素材建立廣告說明文件。

點擊追蹤和範本

如果您在重新導向至最終商品網址之前，透過第三方點擊追蹤器追蹤連結點擊次數，可以在廣告創意中使用 template_url_spec 欄位。如此可讓您在廣告層級中加入點擊追蹤器範本，而不需要以硬式編碼寫入資料摘要檔案。您也可以使用此欄位來建立用於深層連結的範本。

在此欄位中，您可以使用動態欄位，例如商品網址或編號，若其值可能包含會使網址無效的字元，則應為其使用網址編碼。

範例

若要建立包含 template_url_spec 設定的輪播高效速成+ 目錄廣告範本：

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "description": "Description {{product.description}}", 
      "link": "<URL>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'template_url_spec={ 
    "ios": { 
      "app_store_id": "123", 
      "url": "example:\/\/link\/?nav=item.view&id={{product.retailer_id | urlencode}}&referrer=http:\/\/rover.example.com\/rover\/1\/711-198453-24755-9\/16%3Fitemid={{product.retailer_id | urlencode | urlencode}}" 
    }, 
    "web": { 
      "url": "http:\/\/clicktrack.com\/cm325?id={{product.retailer_id | urlencode}}&redirect_url={{product.url | urlencode | urlencode}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

在範本中使用資料摘要檔案資料

當顯示廣告時，Facebook 會使用資料摘要檔案中的適當值來取代 {{ }} 區塊中的內容。可用的範本值為：

選項

部分範本值可依任何順序接收下列格式的選項：

{{field option1 option2 ...}}

目前提供下列選項：

轉換

您可以將範本值與轉換搭配使用，以根據下列格式調整您的值：

{{field | transform}}

使用其中一種轉換：

指定行動裝置的廣告點擊預期行為

當您顯示動態廣告創意時，可以指定當用戶在原生 Facebook 應用程式中點擊廣告時的預期行為。您必須符合下列兩項要求才可使用深層連結：

1. 做為用戶傳送目的地的原生行動應用程式可支援深層連結（iOS 或 Android）。
2. 深層連結資訊已納入資料摘要檔案中，或可透過應用程式連結取得深層連結資訊。

若符合這兩項要求，即可在建立廣告創意時使用 applink_treatment 欄位來指定當用戶點擊廣告時的預期行為。

範例

建立包含行動呼籲的輪播高效速成+ 目錄廣告範本，其將深層連結至原生應用程式（若適用）或返回網頁：

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'applink_treatment=deeplink_with_web_fallback' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "call_to_action": {"type":"SHOP_NOW"}, 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

建立已啟用網址標籤的輪播高效速成+ 目錄廣告範本，其將深層連結至原生應用程式（若適用）或返回應用程式所屬的應用程式商店：

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'applink_treatment=deeplink_with_appstore_fallback' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "call_to_action": {"type":"SHOP_NOW"}, 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

建立高效速成+ 目錄廣告的本地化目錄

詳情請參閱高效速成+ 目錄廣告的本地化目錄。

步驟 4：建立廣告

最後，您可以建立廣告。廣告會引用廣告創意。

範例

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={
       "creative_id": "<CREATIVE_ID>"
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

'use strict';
const bizSdk = require('facebook-nodejs-business-sdk');
const AdAccount = bizSdk.AdAccount;
const Ad = bizSdk.Ad;

const access_token = '<ACCESS_TOKEN>';
const app_secret = '<APP_SECRET>';
const app_id = '<APP_ID>';
const id = '<AD_ACCOUNT_ID>';
const api = bizSdk.FacebookAdsApi.init(access_token);
const showDebugingInfo = true; // Setting this to true shows more debugging info.
if (showDebugingInfo) {
  api.setDebug(true);
}

const logApiCallResult = (apiCallName, data) => {
  console.log(apiCallName);
  if (showDebugingInfo) {
    console.log('Data:' + JSON.stringify(data));
  }
};

let fields, params;
fields = [
];
params = {
  'name' : 'My Ad',
  'adset_id' : '<adSetID>',
  'creative' : {'creative_id':'<adCreativeID>'},
  'status' : 'PAUSED',
};
const ads = (new AdAccount(id)).createAd(
  fields,
  params
);
logApiCallResult('ads api call complete.', ads);

require __DIR__ . '/vendor/autoload.php';

use FacebookAds\Object\AdAccount;
use FacebookAds\Object\Ad;
use FacebookAds\Api;
use FacebookAds\Logger\CurlLogger;

$access_token = '<ACCESS_TOKEN>';
$app_secret = '<APP_SECRET>';
$app_id = '<APP_ID>';
$id = '<AD_ACCOUNT_ID>';

$api = Api::init($app_id, $app_secret, $access_token);
$api->setLogger(new CurlLogger());

$fields = array(
);
$params = array(
  'name' => 'My Ad',
  'adset_id' => '<adSetID>',
  'creative' => array('creative_id' => '<adCreativeID>'),
  'status' => 'PAUSED',
);
echo json_encode((new AdAccount($id))->createAd(
  $fields,
  $params
)->exportAllData(), JSON_PRETTY_PRINT);

from facebook_business.adobjects.adaccount import AdAccount
from facebook_business.adobjects.ad import Ad
from facebook_business.api import FacebookAdsApi

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_ACCOUNT_ID>'
FacebookAdsApi.init(access_token=access_token)

fields = [
]
params = {
  'name': 'My Ad',
  'adset_id': '<adSetID>',
  'creative': {'creative_id':'<adCreativeID>'},
  'status': 'PAUSED',
}
print AdAccount(id).create_ad(
  fields=fields,
  params=params,
)

import com.facebook.ads.sdk.*;
import java.io.File;
import java.util.Arrays;

public class SAMPLE_CODE_EXAMPLE {
  public static void main (String args[]) throws APIException {

    String access_token = \"<ACCESS_TOKEN>\";
    String app_secret = \"<APP_SECRET>\";
    String app_id = \"<APP_ID>\";
    String id = \"<AD_ACCOUNT_ID>\";
    APIContext context = new APIContext(access_token).enableDebug(true);

    new AdAccount(id, context).createAd()
      .setName(\"My Ad\")
      .setAdsetId(<adSetID>L)
      .setCreative(
          new AdCreative()
            .setFieldId(\"<adCreativeID>\")
        )
      .setStatus(Ad.EnumStatus.VALUE_PAUSED)
      .execute();

  }
}

require 'facebook_ads'

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_ACCOUNT_ID>'

FacebookAds.configure do |config|
  config.access_token = access_token
  config.app_secret = app_secret
end

ad_account = FacebookAds::AdAccount.get(id)
ads = ad_account.ads.create({
    name: 'My Ad',
    adset_id: '<adSetID>',
    creative: {'creative_id':'<adCreativeID>'},
    status: 'PAUSED',
})

恭喜！您已建立第一個高效速成+ 目錄廣告。隨時可取消暫停以開始投遞。

後續步驟

高效速成+ 目錄廣告預覽

您可以使用廣告預覽端點來產生動態廣告創意的預覽內容。若要預覽輪播廣告，請指定 product_item_ids 參數或指定多個 product_item_ids。

curl -X GET \
  -d 'ad_format="DESKTOP_FEED_STANDARD"' \
  -d 'product_item_ids=[
       "<PRODUCT_ITEM_ID>"
     ]' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<CREATIVE_ID>/previews

'use strict';
const bizSdk = require('facebook-nodejs-business-sdk');
const AdCreative = bizSdk.AdCreative;
const AdPreview = bizSdk.AdPreview;

const access_token = '<ACCESS_TOKEN>';
const app_secret = '<APP_SECRET>';
const app_id = '<APP_ID>';
const id = '<AD_CREATIVE_ID>';
const api = bizSdk.FacebookAdsApi.init(access_token);
const showDebugingInfo = true; // Setting this to true shows more debugging info.
if (showDebugingInfo) {
  api.setDebug(true);
}

const logApiCallResult = (apiCallName, data) => {
  console.log(apiCallName);
  if (showDebugingInfo) {
    console.log('Data:' + JSON.stringify(data));
  }
};

let fields, params;
fields = [
];
params = {
  'ad_format' : 'DESKTOP_FEED_STANDARD',
  'product_item_ids' : ['<productItemID>'],
};
const previewss = (new AdCreative(id)).getPreviews(
  fields,
  params
);
logApiCallResult('previewss api call complete.', previewss);

require __DIR__ . '/vendor/autoload.php';

use FacebookAds\Object\AdCreative;
use FacebookAds\Object\AdPreview;
use FacebookAds\Api;
use FacebookAds\Logger\CurlLogger;

$access_token = '<ACCESS_TOKEN>';
$app_secret = '<APP_SECRET>';
$app_id = '<APP_ID>';
$id = '<AD_CREATIVE_ID>';

$api = Api::init($app_id, $app_secret, $access_token);
$api->setLogger(new CurlLogger());

$fields = array(
);
$params = array(
  'ad_format' => 'DESKTOP_FEED_STANDARD',
  'product_item_ids' => array('<productItemID>'),
);
echo json_encode((new AdCreative($id))->getPreviews(
  $fields,
  $params
)->getResponse()->getContent(), JSON_PRETTY_PRINT);

from facebook_business.adobjects.adcreative import AdCreative
from facebook_business.adobjects.adpreview import AdPreview
from facebook_business.api import FacebookAdsApi

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_CREATIVE_ID>'
FacebookAdsApi.init(access_token=access_token)

fields = [
]
params = {
  'ad_format': 'DESKTOP_FEED_STANDARD',
  'product_item_ids': ['<productItemID>'],
}
print AdCreative(id).get_previews(
  fields=fields,
  params=params,
)

import com.facebook.ads.sdk.*;
import java.io.File;
import java.util.Arrays;

public class SAMPLE_CODE_EXAMPLE {
  public static void main (String args[]) throws APIException {

    String access_token = \"<ACCESS_TOKEN>\";
    String app_secret = \"<APP_SECRET>\";
    String app_id = \"<APP_ID>\";
    String id = \"<AD_CREATIVE_ID>\";
    APIContext context = new APIContext(access_token).enableDebug(true);

    new AdCreative(id, context).getPreviews()
      .setAdFormat(AdPreview.EnumAdFormat.VALUE_DESKTOP_FEED_STANDARD)
      .setProductItemIds(\"[\\"<productItemID>\\"]\")
      .execute();

  }
}

require 'facebook_ads'

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_CREATIVE_ID>'

FacebookAds.configure do |config|
  config.access_token = access_token
  config.app_secret = app_secret
end

ad_creative = FacebookAds::AdCreative.get(id)
previewss = ad_creative.previews({
    fields: {  },
    ad_format: 'DESKTOP_FEED_STANDARD',
    product_item_ids: ['<productItemID>'],
})

參數

擷取商品廣告統計資料

您可以向洞察報告端點發出 GET 呼叫，以擷取每個商品的統計資料。在 fields 參數中加入 product_id。

這會顯示高效速成+ 目錄廣告中所示之帳號商品組合中的所有商品統計資料。

範例

此範例會報告每個 product_id 的 clicks、actions 和 impressions。

要求

use FacebookAds\Object\AdAccount;
use FacebookAds\Object\Fields\AdsInsightsFields;
use FacebookAds\Object\Values\AdsInsightsActionBreakdownsValues;
use FacebookAds\Object\Values\AdsInsightsDatePresetValues;
use FacebookAds\Object\Values\AdsInsightsBreakdownsValues;

$account = new AdAccount('act_<AD_ACCOUNT_ID>');

$fields = array(
  AdsInsightsFields::ACCOUNT_NAME,
  AdsInsightsFields::IMPRESSIONS,
  AdsInsightsFields::ACTIONS,
);

$params = array(
  'date_preset' => AdsInsightsDatePresetValues::LAST_WEEK,
  'action_breakdowns' => array(
    AdsInsightsActionBreakdownsValues::ACTION_TYPE,
  ),
  'breakdowns' => array(
    AdsInsightsBreakdownsValues::PRODUCT_ID,
  ),
);

$stats = $account->getInsights($fields, $params);

from facebookads.adobjects.adaccount import AdAccount
from facebookads.adobjects.adsinsights import AdsInsights

account = AdAccount('act_<AD_ACCOUNT_ID>')

fields = [
    AdsInsights.Field.account_name,
    AdsInsights.Field.impressions,
    AdsInsights.Field.actions,
]

params = {
    'date_preset': 'last_week',
    'actions_group_by': ['action_type'],
    'breakdowns': [
        AdsInsights.Breakdowns.product_id,
    ],
}

stats = account.get_insights(fields=fields, params=params)

APINodeList<AdsInsights> adsInsightss = new AdAccount(act_<AD_ACCOUNT_ID>, context).getInsights()
  .setDatePreset(AdsInsights.EnumDatePreset.VALUE_LAST_WEEK)
  .setActionBreakdowns("[\"action_type\"]")
  .setBreakdowns("[\"product_id\"]")
  .requestField("account_name")
  .requestField("impressions")
  .requestField("actions")
  .execute();

curl -G \
  -d 'date_preset=last_week' \
  -d 'action_breakdowns=["action_type"]' \
  -d 'breakdowns=["product_id"]' \
  -d 'fields=account_name,impressions,actions' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.8/act_<AD_ACCOUNT_ID>/insights

回應

{
 "data": [ 
   {
      "account_id": "123456", 
      "product_id": "60750", 
      "date_start": "2015-02-03", 
      "date_stop": "2015-02-03", 
      "impressions": 880, 
      "clicks": 8, 
      "actions": [ 
        {
          "action_type": "link_click", 
          "value": 6
        }, 
        {
          "action_type": "offsite_conversion.other", 
          "value": 5
        },  
        {
          "action_type": "offsite_conversion", 
          "value": 5
        }
      ], 
      "account_name": "My Account"
    }, 
 ], 
...
}

擷取留言和讚

您可以擷取高效速成+ 目錄廣告貼文的留言、讚和 product_id。依下列方式，使用 post_id 發出 GET 呼叫。post_id 是廣告創意的 effective_object_story_id，格式為 PageID_PostID。

附註：您不能使用此端點來擷取 Instagram 的留言。

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<POST_ID>/dynamic_posts

此端點會傳回動態貼文物件。

一旦您取得動態貼文，即可擷取輪播格式的 comments、likes、product_id 和 child_attachments（如適用）。

瞭解詳情

• 設定目錄
• 建立廣告受眾
• 廣告組合參考資料
• 廣告創意參考資料
• Meta Blueprint 課程：準備和設定高效速成+ 目錄廣告的目錄
• Meta Blueprint 課程：高效速成+ 目錄廣告疑難排解
• Meta Blueprint 實戰工作坊：高效速成+ 目錄廣告疑難排解