焦點系列廣告

此焦點系列廣告格式包含即時體驗，可讓用戶在視覺效果強大的沉浸式體驗中，使用流動裝置更輕鬆地探索、瀏覽及購買商品和服務。您的動態廣告會在主圖像或影片下方展示三件商品。當用戶與您的廣告互動時會開啟全螢幕的即時體驗。焦點系列廣告分為兩大類：圖像廣告和影片廣告。

請將所有提及「全螢幕展示廣告」的內容當作即時體驗的內容，因為「全螢幕展示廣告」是此格式的舊稱。

您可以透過創造即時體驗，建立採用焦點系列格式的廣告。您可以選用範本或自訂版面以開始建立焦點系列廣告。如需更多資訊，請參閱廣告幫助中心，即時體驗。

您也可以使用 JavaScript SDK，將 Facebook 的焦點系列格式廣告建立用戶介面加至您的網站，以建立焦點系列廣告對話框。

如需有關使用焦點系列廣告的一般資訊，請參閱：

若要建立商店使用的焦點系列或將中繼資料加至商品組合，請參閱商務平台 > 商品組合焦點系列 API。

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

支援的目標和廣告版位

您可以使用帶有以下目標的焦點系列廣告：

流量
轉換次數
商品目錄銷售（在您配合商品組合使用焦點系列時受支援。）
來店客流量（在您配合商品組合使用焦點系列時受支援。）
品牌知名度
接觸人數

如果目標為流量和轉換次數，您也可以使用微影片。如需更多資訊，請參閱企業商家幫助中心：選擇合適的廣告目標。

系統支援以下版位：

Facebook 動態消息
Facebook Reels
Instagram 動態消息（請參閱即時體驗：即時體驗和 Instagram 廣告。）
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 焦點系列廣告建立用戶介面流程。若要了解有關用戶介面元件的詳情，請參閱對話框。

若要設定 JavaScript 專用 Facebook SDK，請參閱：

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，則即示用戶在完成即時體驗之前關閉對話框，或者用戶儲存即時體驗卻沒有將其完成。您可以查詢 Graph 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