精選集廣告

精選集廣告格式包含即時體驗廣告，能讓用戶在視覺效果強大的沉浸式體驗中，使用行動裝置輕鬆探索、瀏覽及購買商品和服務。用戶與您在動態消息中的廣告互動時，該廣告會在主要圖像或影片底下展示三項商品，並以全螢幕即時體驗廣告的形式開啟。精選集廣告有兩種類型：圖像型和影片型。

請將所有參考資料中提及的「全螢幕互動廣告」視為「即時體驗」，因為全螢幕互動廣告是該格式的舊名稱。

您可以透過建置即時體驗，建立具有精選集格式的廣告。從範本開始著手，或選擇您自己的自訂版面。如需更多資訊，請參閱廣告使用說明：即時體驗。

您也可以使用 JavaScript SDK，在您的網站上新增適用於精選集格式的 Facebook 廣告建立流程用戶介面，以建立精選集廣告對話方塊。

如需有關使用精選集廣告的一般資訊，請參閱：

若要建立在商店中使用的精選集，或將中繼資料新增至商品組合，請參閱商務平台：商品組合精選集 API。

For API calls, your AD_ACCOUNT_ID should be formatted as act_XXXXXXXXXXXXXXX.

支援的目標和版位

您可以使用具有以下目標的精選集廣告：

流量
轉換次數
商品目錄銷售 - （使用具有商品組合的精選集廣告時支援。）
來店客流量 - （使用具有商品組合的精選集廣告時支援。）
品牌知名度
觸及人數

若是流量和轉換次數目標，您也可以使用輕影片影片。請參閱企業商家使用說明：選擇合適的廣告目標取得詳細資訊。

支援下列版位：

Facebook 動態消息
Facebook Reels
Instagram 動態消息（請參閱即時體驗：即時體驗和即時廣告。）
Instagram 限時動態（請參閱即時體驗：即時體驗和即時廣告。）

如需版位的詳細資訊，請參閱企業商家使用說明：關於版位和企業商家使用說明：為實現行銷目標可使用的版位。

從商品組合建立精選集廣告

建立精選集廣告前，您必須先提供廣告創意和即時體驗。請務必提供至少四項要輪替顯示的相片素材，或是四項含商品標籤的商品素材。輪播廣告素材中的子女相片素材同樣有效。

您可從目錄建立精選集廣告。精選集廣告會在主頁橫幅圖像或影片底下列出三項商品，並且顯示在行動版動態消息中。您可以藉由這項功能使用輕影片。

廣告會顯示在動態消息中，當用戶點按廣告時，就可在開啟的全螢幕體驗中觀看更多內容。

若要使用商品組合，您對高效速成+ 目錄廣告應該要有相當程度的瞭解，並且已設定商品目錄。如需更多資訊，請參閱高效速成+ 目錄廣告和商品目錄：高效速成+ 目錄廣告。

建立廣告

當您從商品組合建立精選集廣告時，必須一併正式建立具有適當素材的即時體驗。當您在精選集廣告中使用此即時體驗時，Facebook 會自動產生精選集廣告。您的即時體驗應包含：

影像，為全螢幕互動廣告相片、全螢幕互動廣告影片，或全螢幕互動廣告範本影片。
show_in_feed 設為 true 的商品組合。（請參閱參考資料：全螢幕互動廣告商品組合。）
頁尾（請參閱參考資料：全螢幕互動廣告頁尾。）

即時體驗影像

建立一個圖像格式的即時體驗：

curl \
  -F 'canvas_photo={ 
    "photo_id": "PHOTO_ID", 
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

或是一個影片格式的即時體驗：

curl \
  -F 'canvas_video={ 
    "video_id": "VIDEO_ID", 
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

或是一個範本影片格式的即時體驗：

curl -X POST \
  -F canvas_template_video={
      "name": "Cover Image or Video",
	"bottom_padding": "0",
	"top_padding": "0",
	"product_set_id": <Product_Set_ID>,
	"template_video_spec": {
	    "customization": {
	        "text_color": "FFFFFF",
	        "text_background_color": "000000",
		  "name_template": "{{product.name}}",
		  "body_template": "{{product.current_price strip_zeros}}"
	    },
	}
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<PAGE_ID>/canvas_elements

即時體驗商品組合

然後使用商品目錄中的 product_set_id 建立一個 canvas_product_set。您必須將 show_in_feed 設為 true，才能建立精選集廣告。

curl \
  -F 'canvas_product_set={ 
    "max_items": 50,
    "product_set_id": "<PRODUCT_SET_ID>",
    "item_headline": "{{product.name}}",
    "item_description": "{{product.current_price}}"
    "image_overlay_spec": {
      "overlay_template": "pill_with_text",
      "text_type": "price",
      "text_font": "dynads_hybrid_bold",
      "position": "top_left",
      "theme_color": "background_e50900_text_ffffff",
      "float_with_margin": true,
    },
    "storefront_setting": {
        "enable_sections": true,
        "customized_section_titles": [
            { "title_id": "popular", "customized_title": "My Populars" },
            { "title_id": "favorites", "customized_title": "My Favorites" }
        ],
        "product_set_layout": {
            "layout_type": "GRID_3COL"
        }
    },
    "retailer_item_ids": [0, 0, 0],
    "show_in_feed": true
  }' \
  https://graph.facebook.com/v19.0/<PAGE_ID>/canvas_elements

注意：上述範例中，item_headline、item_description、image_overlay_spec、storefront_setting 和 retailer_item_ids 皆為選用欄位。過去您會在相同呼叫中提供這些資訊，以建立精選集廣告和非正式建立的即時體驗廣告素材，現在則是在此呼叫中提供它們。

請在 image_overlay_spec 參數中提供所有必填欄位。如需更多資訊，請參閱行銷 API：參考資料：廣告創意連結資料、圖像疊壓規格。

storefront_setting 參數支援 product_set_layout、enable_sections 和 customized_section_titles 欄位。

`product_set_layout` 欄位

名稱	說明
`layout_type` 字串	必要項目。商品組合的顯示方式。值：`GRID_2COL`、`GRID_3COL`、`CAROUSEL`、`HSCROLL_LIST`

若要使用 customized_section_titles，必須將 enable_sections 設為 true。customized_section_titles 欄位需要一個物件陣列，每個物件包含 title_id 和 customized_title 參數。

`customized_section_titles` 欄位

名稱	說明
`title_id` 字串	必要項目。列舉字串，表示要替換的預設區塊標題字串。值：`keep_shopping`、`take_another_look`、`you_may_also_like`、`related_products`、`trending`、`popular`、`top_items`、`favorites`、`most_viewed`、`top_picks_for_you`、`suggested_for_you`、`featured_favorites`、`just_for_you`、`explore_more`、`shop_by_category`
`customized_title` 字串	必要項目。檢視者應視為區塊標題的替代自訂字串。

即時體驗頁尾

建立包含連結的即時體驗頁尾。

curl \
  -F 'canvas_button={ 
    "rich_text": {
      "plain_text": "See more at www.abc.com."
    },
    "open_url_action": {
      "url": "https://www.abc.com"
    }
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

如果需要，您也可以建立在頁尾中使用的按鈕。

curl \
  -F 'canvas_footer={ 
    "child_elements": [BUTTON_ELEMENT_ID]
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

在頁尾提供的文字相對而言較具彈性，過去必須使用 See more....，現在則可使用 URL 按鈕輸入自訂文字。

完整的即時體驗

curl \
  -F 'body_element_ids=[
    PHOTO/VIDEO_ELEMENT_ID,
    PRODUCT_SET_ELEMENT_ID,
    FOOTER_ELEMENT_ID
  ]' \
  -F 'is_published=true' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvases

若要使用您設定的範本影片、商品組合、按鈕、商店地點和選用頁尾建立即時體驗，必須包含 source_template_id 參數：

curl \
  -F 'body_element_ids=[
    TEMPLATE_VIDEO_ELEMENT_ID,
    PRODUCT_SET_ELEMENT_ID,
    FOOTER_ELEMENT_ID
  ]' \
  -F 'name="Dynamic Video Instant Experience"', \
  -F 'source_template_id="1932289657009030"', \
  -F 'is_published=true' \
  https://graph.facebook.com/v19.0/<PAGE_ID\/canvases

若是店面範本，您必須指定 source_template_id = 1932289657009030，其定義於即時體驗：使用範本。各範本有固定版面，不過您可將預設內容替換為您自己的動態影片、商品、文字和連結。如需更多資訊，請參閱即時體驗：使用範本。

建立包含即時體驗的精選集廣告

最後，您必須建立一個精選集廣告，讓用戶可以點擊精選集廣告上的圖像或影片素材。

如果即時體驗的第一個素材是相片，必須將 object_type 設為 SHARE。

curl \
  -F 'name=Collection Sample Image Creative' \
  -F 'object_story_spec={ 
    "link_data": { 
      "link": "https://fb.com/canvas_doc/CANVAS_ID", 
      "message": "AD_MESSAGE",
      "name": "AD_HEADLINE", 
    }, 
    "page_id": "PAGE_ID" 
  }' \
  -F 'object_type=SHARE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

如果即時體驗的第一個素材是影片，請提出以下要求：

curl \
  -F 'name=Collection Sample Video Creative' \
  -F 'object_story_spec={ 
    "video_data": {
      "call_to_action": {
        "type":"LEARN_MORE",
        "value":{
          "link":"https://fb.com/canvas_doc/CANVAS_ID",
        }
      },
      "image_url": "THUMBNAIL_IMAGE_URL",
      "message": "AD_MESSAGE",
      "title": "AD_HEADLINE", 
    }, 
    "page_id": "PAGE_ID" 
  }' \
  -F 'object_type=VIDEO' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

如果即時體驗的第一個素材是範本影片，請提出以下要求：

curl -X POST \
  -F 'name="Dynamic Video Collection Ad"' \
  -F 'adset_id=<ADSET_ID>' \
  -F 'status=PAUSED \
  -F 'creative={
       "object_story_spec": {
         "instagram_actor_id": "<INSTAGRAM_PAGE_ID>",
         "page_id": "<MAIN_PAGE_ID>",
         "template_data":{
           "call_to_action":{
             "type":"LEARN_MORE"
           },
           "format_option":"collection_video",
           "link":"https://fb.com/canvas_doc/CANVAS_ID",   
           "name":"Test Dynamic Ads with dynamic video",
           "retailer_item_ids":[
             "0",
             "0",
             "0",
             "0"
           ]
         }
       },
       "object_type": "SHARE",
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

廣告預覽

如果您具備廣告預覽功能，可以提供 ad_format 和用戶存取權杖，根據您的廣告或廣告創意產生預覽。

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

注意：若是範本影片即時體驗廣告，支援的格式包括 BIZ_DISCO_FEED_MOBILE、GROUPS_MOBILE、MOBILE_FEED_STANDARD、SUGGESTED_VIDEO_DESKTOP、SUGGESTED_VIDEO_MOBILE、WATCH_FEED_MOBILE。

請參閱廣告預覽以瞭解更多資訊。

標準精選集廣告

您可利用範本，快速建立針對特定業務目標的即時體驗。各範本有固定版面，不過您可將預設內容替換為您自己的圖像、影片、商品、文字和連結。如需更多資訊，請參閱即時體驗：使用範本。

即時體驗的精選集廣告有兩種類型：圖像型和影片型，取決於您提供的廣告素材。取得廣告創意後，就可以建立廣告。

建立圖像型廣告

curl 
  -F 'name=Instant Experiences Collection Sample Image Creative' 
  -F 'object_story_spec={ 
    "link_data": {
      "link": "https://fb.com/canvas_doc/ELIGIBLE_CANVAS_ID", 
      "message": "Ad message", 
      "name": "name", 
      "picture": "IMAGE_URL", 
      "collection_thumbnails": [
        {"element_crops": {"100x100": [[0, 0], [100, 100]]},"element_id": "PHOTO_ELEMENT_WITH_PRODUCT_TAGS_ID",},
        {"element_child_index": 0,"element_id": "",},
        {"element_child_index": 1,"element_id": "PRODUCT_LIST_ELEMENT_ID",},
      ],
    }, 
    "page_id": "PAGE_ID" 
  }' 
  -F 'access_token=ACCESS_TOKEN' 
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

建立影片型廣告

curl 
  -F 'name=Instant Experiences Collection Sample Video Creative' 
  -F 'object_story_spec={ 
    "page_id": "PAGE_ID", 
    "video_data": { 
      "call_to_action": {"type":"LEARN_MORE","value":{"link":"https://fb.com/canvas_doc/ELIGIBLE_CANVAS_ID"}}, 
      "image_url": "IMAGE_URL",
      "collection_thumbnails": [
        {"element_crops": {"100x100": [[0, 0], [100, 100]]},"element_id": "PHOTO_ELEMENT_NO_PRODUCT_TAGS_ID",},
        {"element_child_index": 0,"element_id": "PHOTO_ELEMENT_WITH_PRODUCT_TAGS_ID",},
        {"element_child_index": 1,"element_id": "PRODUCT_LIST_ELEMENT_ID",},
      ],
      "title": "My title", 
      "video_id": "VIDEO_ID" 
    } 
  }' 
  -F 'access_token=ACCESS_TOKEN' 
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

參數

名稱	說明
`link` 字串	必要項目將檢視者重新導向至即時體驗。
`collection_thumbnails` 陣列	必要項目縮圖的陣列。需要四個縮圖。

`collection_thumbnails` 欄位

名稱	說明
`element_id` 數值字串	必要項目全螢幕互動廣告相片素材編號或商品清單素材編號。全螢幕互動廣告相片需要與附加到此精選集廣告的即時體驗產生關聯。用戶點擊廣告後，與此編號相關聯的圖像會顯示在即時體驗中。主頁橫幅圖像素材編號為無效。
`element_child_index` 整數	包含商品標籤的相片素材以及商品清單素材的必要項目包含商品標籤的相片素材編號陣列中的商品索引。或包含商品清單素材的 `product_id_list` 陣列中的商品索引。注意：必須為正整數。
`element_crops` AdsImageCrops	相片素材的必要項目 JSON 物件，用於定義指定圖像的裁切尺寸。僅允許 `100x100` 裁切索引鍵。

建立互動廣告受眾

您可針對與精選集廣告互動的用戶，自動建立廣告受眾。此方式與標準即時體驗的互動廣告受眾雷同。如需更多資訊，請參閱即時體驗：互動廣告受眾。

您可以將全螢幕檢視即時體驗廣告的目標設定在曾點按精選集廣告的用戶。我們稱此類型的廣告受眾為全螢幕體驗互動廣告受眾。建立此廣告受眾的方式為：建立自訂廣告受眾，並將 object_id 設為 CANVAS_ID，以及將規則設定為追蹤其中一個事件。

建立曾開啟即時體驗的廣告受眾

curl \
    -F 'name=Collection Engagement Audience' 
    -F 'description=People who opened this Instant Experience' 
    -F 'rule=[{"object_id":"CANVAS_ID","event_name":"instant_shopping_document_open"}]' 
    -F 'access_token=ACCESS_TOKEN' 
https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/customaudiences

建立曾點擊精選集廣告的廣告受眾

curl \
    -F 'name=Collection Engagement Audience' 
    -F 'description=People who clicked any links in this Instant Experience' 
    -F 'rule=[{"object_id":"CANVAS_ID","event_name":"instant_shopping_element_click"}]'
    -F 'access_token=ACCESS_TOKEN' 
https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/customaudiences

精選集廣告對話方塊

精選集廣告是根據範本的即時體驗。因此，若要使用對話方塊建立精選集廣告，必須使用具有其他參數的即時體驗廣告對話方塊。如此一來，就能夠在您的網站中提供 Facebook 精選集廣告建立用戶介面流程。如需瞭解用戶介面元件的詳細資訊，請參閱對話方塊。

若要設定 Facebook SDK for Javascript，請參閱：

登入用戶必須具有建立即時體驗的權限，才能使用 JavaScript SDK。若用戶想為粉絲專頁和企業建立即時體驗，卻沒有必備的權限，對話方塊會顯示錯誤。此外，用戶還須具有存取商品目錄和組合的權限。為避免出現錯誤，用戶必須能夠存取企業管理平台，且具備該粉絲專頁的「建立廣告」權限。

接著您可以觸發精選集廣告對話方塊。

FB.ui({         
  display: 'popup',
  method: 'instant_experiences_builder',
  account_id: 'AD_ACCOUNT_ID'.
  business_id: 'BUSINESS_ID',
  page_id: 'PAGE_ID',
  template_id: 'TEMPLATE_ID'
}, function(response) {
  // callback
});

您可以為外掛程式提供下列設定：

名稱	說明
`display`	必要項目設定值為 `popup` 的必要參數。
`method`	必要項目設定值為 `instant_experiences_builder` 的必要參數。
`account_id`	必要項目您的廣告帳號編號。
`business_id`	必要項目您的商家編號。
`page_id`	必要項目您想要與即時體驗建立關聯的粉絲專頁編號。
`template_id`	必要項目您想要使用的範本編號。
`product_catalog_id`	選用項目精選集廣告中使用的商品目錄編號。若有提供 `product_set_id`，此為必要項目。
`product_set_id`	選用項目精選集廣告中使用的商品組合編號。

您可以前往即時體驗：使用範本找到所有有效範本類型及對應的編號。

product_catalog_id 和 product_set_id 兩個參數為選用。不過，如果您提供 product_set_id，則必須提供 product_catalog_id。在提供這些編號之後，用戶將無法變更用戶介面中的精選集廣告。如果未提供這兩個參數，用戶可以在用戶介面中選擇目錄和商品組合。若要預覽精選集廣告，建議您使用即時體驗預覽對話方塊。

成功時，外掛程式會提供以下回應：


{
  "success": true,
  "id": "CANVAS_ID"
}

傳回的 id 是未發佈的即時體驗，必須先發佈才能在廣告行銷活動中使用。

若沒有回應或傳回 undefined 回應，表示用戶在完成即時體驗之前已關閉對話方塊，或用戶已儲存該即時體驗，但尚未完成。您可以查詢圖形 API 來檢視所有屬於某個粉絲專頁的即時體驗，如此可查看是否有任何未完成的即時體驗。

包含目的地目錄

您可以在精選集廣告的主頁橫幅圖像中顯示目標目錄的廣告創意。您還可以在該目的地顯示旅館圖像的輪播廣告。若要這麼做，您必須提供顯示在主頁橫幅圖中的回呼圖像，以免我們在輪播廣告中找不到旅館所對應的目的地。如需更多資訊，請參閱目的地目錄。

請注意以下限制：

不支援影片廣告創意。
我們只支援同時顯示目的地和旅館目錄圖像。
我們不支援顯示其他目錄組合。

若要使用此功能，請在建立 canvas_photo 素材時，新增 destination_set_id 參數，然後按照其他標準步驟建立即時體驗和精選集廣告。

範例

curl \
  -F 'canvas_photo={ 
    "photo_id": "PHOTO_ID", 
    "destination_set_id": "DESTINATION_SET_ID",
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements