動態影音素材

動態影音素材可讓廣告主從高效速成+ 目錄廣告中的目錄，投遞影片素材。

準備工作

必備資料：

• 包含現有商品的商品目錄
• 每種產品項目的影片（採用可下載的影片網址格式）

請參閱高效速成+ 目錄廣告文件，深入瞭解運作方式。

限制

• 建議至少有 20 種商品，但實際上並沒有最低數量限制。
• 每支影片的大小不得超過 200MB。長度沒有限制。
• 影片必須採用以下格式之一：3g2、3gp、3gpp、asf、avi、dat、divx、dv、f4v、flv、gif、m2ts、m4v、mkv、mod、mov、mp4、mpe、mpeg、mpeg4、mpg、mts、nsv、ogm、ogv、qt、tod、ts、vob 或 wmv。
• video_fetch_status 可能會顯示為 NO_STATUS，直到影片用於廣告或其他需要觸發該影片的事件。

在目錄中新增影片

有 3 種方式可以將影片新增至目錄中的產品項目：目錄摘要檔案、目錄批次 API，以及透過商務管理工具手動上傳。

使用目錄摘要檔案新增影片

步驟 1：準備您的目錄摘要檔案

您可以使用以下其中一個流程來實作目錄摘要檔案。

• 流程 1：變更主要摘要

  • 在現有的目錄摘要檔案中新增 video[0].url 欄，僅在所選商品中填入影片網址，並在其他商品列中保留空白。
  • 您可以使用 video[1].url、video[2].url、video[3].url 等其他欄位，為相同的商品新增其他影片。
  • 將標籤加入到個別欄位中，即可為影片新增標籤。例如：video[0].tag[0]、video[0].tag[1]、video[1].tag[0] 等。
• 流程 2：補充摘要
  準備一個補充目錄摘要檔案，以補充現有的摘要上傳。此補充摘要僅能對現有的產品項目新增或取代影片。新增 video[0].url 欄和編號欄，建立影片與產品項目編號的關聯。

選擇性：
您也可以不使用 video[0].url 欄，而改為建立名為 video 的欄位，並為影片加上標籤。video 欄可包含每個產品的多個影片網址，以及每個 JSON 格式編碼網址的多個標籤。如果選擇將標籤欄用於篩選商品組合，您也需要在摘要檔案中新增此欄。

針對 XML 摘要，可以使用如下的 <video> 標籤新增影片網址：

<video><url>https://{URL1}</url><tag>video_product_set1</tag><tag>video_product_set2 </tag></video><video><url>https://{URL2}</url><tag>video_product_set1</tag></video>

從商品項目 API 查詢影片資料

目錄 API 中提供 videos、videos_metadata 和 video_fetch_status 欄位，以擷取目錄商品影片詳細資料。

curl -i GET \ "http://graph.facebook.com/v25.0/<PRODUCT_ITEM_ID>?fields=videos,videos_metadata,video_fetch_status"

若要深入瞭解影片資訊，請參閱商品項目詳細資料。

使用目錄批次 API 新增影片

可以使用/{product_catalog_id}/items_batch 端點更新產品項目。video 欄位是一個網址陣列，您可以使用該欄位進行 POST API 呼叫。

curl \
  -d @body.json \
  -H "Content-Type: application/json"

> cat body.json
{
  "access_token": "<ACCESS_TOKEN>",
  "item_type": "PRODUCT_ITEM",
  "requests": [
    {
      "method": "CREATE",
      "data": {
        "id": "retailer-2",
        "availability": "in stock",
        "brand": "BrandName",
        "google_product_category": "t-shirts",
        "description": "product description",
        "image_link": "http://www.images.example.com/t-shirts/1.png",
        "title": "product name",
        "price": "10.00 USD",
        "shipping": [
          {
            "shipping_country": "US",
            "shipping_region": "CA",
            "shipping_service": "service",
            "shipping_price_value": "10",
            "shipping_price_currency": "USD"
          }
        ],
        "condition": "new",
        "link": "http://www.images.example.com/t-shirts/1.png",
        "item_group_id": "product-group-1",
        "video": [
          {"url": "http://www.jaspersmarket-example1.com/video-file.avi", "tag": ["Optional Tag1", "Optional Tag2"]}, 
          {"url": "http://www.jaspersmarket-example2.com/video-file.avi", "tag": ["Optional Tag1", "Optional Tag2"]}
        ]
      }
    },
    {
      "method": "UPDATE",
      "data": {
        "availability": "out of stock",
        "id": "retailer-3",
        "video": [
          {
            "url": "https://yourvideo.com/demo.mp4?q=1411"
          },
          {
            "url": "https://yourvideo.com/demo.mp4?q=1421"
          }
        ]
      }
    }
  ]
}

請參閱圖形 API 測試工具中的這個範例。

使用動態影音素材建立廣告

建立廣告時，有三種類型的選項可運用目錄中的影片：

• 輪播／精選集動態影音素材（建議）
• 顯示可用的影片（僅適用於單一影片格式）
• 單一圖像已選擇使用動態影音素材

注意：使用 API 選擇動態影音素材類型與在廣告管理員中選擇動態影音素材選項類似。自 2025 年 9 月起的變更，高效速成+ 目錄廣告將預設選擇使用動態影音素材。

動態影音素材類型廣告

使用 act_<AD_ACCOUNT_ID>/adcreatives 端點建立廣告創意物件時

• 自 2025 年 9 月起，高效速成+ 目錄廣告將預設開始投遞目錄商品影片。您可以將 media_type_automation 設定為 OPT_out，以關閉目錄商品影片在廣告中的顯示。
• media_type_automation 鍵適用於輪播、精選集和單一圖像格式。

curl -X POST \ -F 'name=Dynamic Media Ad Creative' \ -F 'object_story_spec={ ... }' \ -F 'degrees_of_freedom_spec={ "creative_features_spec": { "media_type_automation": { "enroll_status": "OPT_IN" } } }' \ -F 'product_set_id=<PRODUCT_SET_ID>' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

同樣地，若透過 act_<AD_ACCOUNT_ID>/ads 端點建立高效速成+ 目錄廣告物件，該廣告將預設開始投遞可用的目錄商品影片。您可以將 media_type_automation 鍵設定為 OPT_out，以關閉目錄商品影片在廣告中的顯示。

curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Dynamic Media Ad Creative", "object_story_spec": { ... }, "degrees_of_freedom_spec": { "creative_features_spec": { "media_type_automation": { "enroll_status": "OPT_IN" } } }, "product_set_id": "<PRODUCT_SET_ID>" }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

動態影音素材廣告（使用精選集格式）

• 動態影音素材只會替換主頁橫幅影音素材。點擊前體驗和即時體驗的商品縮圖一律為圖像。
• 如果選擇使用動態影音素材且有商品影片可供使用，則動態影片主頁橫幅影音素材將會替換為商品影片。自 2025 年 9 月起，精選集格式中的高效速成+ 目錄廣告將預設選擇使用動態影音素材，並開始投遞目錄商品影片。您可以繼續將 media_type_automation 設定為 OPT_OUT，以關閉目錄商品影片在廣告中的顯示。
• 選擇使用時，動態影音素材只會替換動態影片主頁橫幅影音素材。目前，靜態主頁橫幅圖像和影片不會遭到商品影片替換，亦即，圖像輕影片體驗會替換為商品影片。

含有動態影音素材之精選集的創意規格範例

curl -X POST \ -F 'name=Dynamic Media Ad Creative' \ -F 'object_story_spec={ "template_data": { ... "format_option": "collection_video", "link": "https://fb.com/canvas_doc/<CANVAS_ID>", "message": "Your Collection Ad", ... } }' \ -F 'degrees_of_freedom_spec={ "creative_features_spec": { "media_type_automation": { "enroll_status": "OPT_IN" } } }' \ -F 'product_set_id=<PRODUCT_SET_ID>' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

動態影音素材廣告（顯示可用的影片）

在 object_story_spec 中，將 format_option 變更為 single_video。這僅適用於單一圖像/影片格式。

curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Dynamic Media Ad Creative", "object_story_spec": { "page_id": "<PAGE_ID>", "template_data": { ... "format_option": "single_video", ... } }, "product_set_id": "<PRODUCT_SET_ID>" }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

動態影音素材廣告（單一圖像已選擇使用動態影音素材）

在 object_story_spec 中，選擇使用 media_type_automation 時，single_image 的 format_option 將顯示動態影音素材。

自 2025 年 9 月起，使用 single_image 的 format_option 之高效速成+ 目錄廣告將預設選擇使用動態影音素材，並在廣告中顯示可用的目錄商品影片。您可以將 media_type_automation 設定為 OPT_OUT，以關閉目錄商品影片在廣告中的顯示。

curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Dynamic Media Ad Creative", "object_story_spec": { "page_id": "<PAGE_ID>", "template_data": { "format_option": "single_image" } }, "degrees_of_freedom_spec": { "creative_features_spec": { "media_type_automation": { "enroll_status": "OPT_IN" } } } }, "product_set_id": "<PRODUCT_SET_ID>" }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

選用項目：選擇是否使用自動影片裁切

使用 video_crop_style 欄位可控制自動影片裁切。可用值為 AUTO 或 NONE。

若要選擇不使用自動影片裁切，請將 video_crop_style 設為 NONE，或移除 media_type_automation 設定中的自訂。

curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Dynamic Media Ad Creative", "object_story_spec": { ... }, "degrees_of_freedom_spec": { "creative_features_spec": { "media_type_automation": { "customizations": { "video_crop_style": "NONE" }, "enroll_status": "OPT_IN" } } }, "product_set_id": "<PRODUCT_SET_ID>" }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

自動裁切僅適用於未達版位大小要求的影片，目前主要是為了讓影片符合播放器的檢視區。

如果有符合廣告版位長寬比的影片，系統會傳回該影片。如果已提供指定商品影片的所有長寬比，則不會套用自動裁切。否則，廣告將選擇該項目的影片，並檢查自動裁切設定：AUTO 會傳回自動裁切的影片，NONE 會傳回原始影片。

動態影音素材洞察報告

您也可以在 API 查詢廣告管理員的影片互動衡量指標。請使用以下圖表進行比較。

要求範例

curl GET \ -d 'access_token=<ACCESS_TOKEN>' \ -d 'fields=impressions,video_continuous_2_sec_watched_actions,actions,video_thruplay_watched_actions' \ https://graph.facebook.com/v25.0/<AD_ID>/insights

如需詳細資訊，請參閱洞察報告 API 文件。