影片和輪播廣告

您可透過 API，輕鬆建立、衡量及最佳化 Facebook 的影片和輪播廣告。請參閱 Facebook for Business：輪播廣告。如需廣告支援的影片格式，請參閱廣告主使用說明：影片。

影片廣告

參考文件

廣告創意

若要在 VIDEO_VIEWS 目標中建立影片廣告並為觸及人數最佳化出價，請依照下列步驟操作：

步驟 1：提供廣告創意

使用現有的影片編號和上傳至 Facebook 的影片，建立影片廣告。

必備資料：

pages_read_engagement 和 ads_management 權限
將影片上傳至 act_{ad-account-id}/advideos 端點

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

輕影片

若要在新興市場的基本功能手機上擴大或推出品牌行銷活動，或是建立簡單影片，請嘗試使用圖像輕影片（需要至少 3 個圖像）。請將圖像上傳至影片素材。例如：

curl \
  -F 'slideshow_spec={ 
  "images_urls": [ 
  "<IMAGE_URL_1>", 
  "<IMAGE_URL_2>", 
  "<IMAGE_URL_3>" 
  ], 
  "duration_ms": 2000, 
  "transition_ms": 200 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph-video.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/advideos
 
  Open In Graph API Explorer

請參閱影片廣告創意最佳作法和參考資料：廣告影片。

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

將目標設定為 VIDEO_VIEWS：

curl -X POST \
  -F 'name="Video Views campaign"' \
  -F 'objective="OUTCOME_ENGAGEMENT"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/campaigns
  
Open In Graph API Explorer

請參閱參考資料：行銷活動、PHP 中的 AdObjectives 和 Python 中的 AdObjectives

步驟 3：建立廣告組合

如果您的目標是盡可能將每次觀看成本降到最低，您應該將影片觀看行銷活動目標與廣告組合的 optimization_goal=THRUPLAY 配對。將 bidding_event 設為 IMPRESSIONS 或 THRUPLAY，可依曝光次數付費或依影片觀看次數付費。請參閱 CPV 出價。

curl \
  -F 'name=A CPV Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2024-05-06T04:45:29+0000' \
  -F 'end_time=2024-06-06T04:45:29+0000' \
  -F 'billing_event=THRUPLAY' \
  -F 'optimization_goal=THRUPLAY' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
  "device_platforms": ["mobile"], 
  "geo_locations": {"countries":["US"]}, 
  "publisher_platforms": ["facebook"] 
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adsets


  Open In Graph API Explorer

相較於針對影片觀看次數最佳化的觸及率與頻率購買的每次觀看成本，使用 optimization_goal=THRUPLAY 的廣告組合的每次觀看成本費用較低。結束日期必須是未來時間。請參閱參考資料：廣告組合。

步驟 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/v20.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

行銷活動目標為 VIDEO_VIEWS 時，廣告預設將取得適當的追蹤規格，用於定義要追蹤的廣告動作。例如，追蹤影片觀看次數：

{'action.type':'video_view','post':'POST_ID','post.wall':'PAGE_ID'}

請參閱廣告管理員：我的行銷活動和參考資料：廣告。

品牌知名度範例

若要建立用於品牌知名度的影片廣告，請參閱品牌知名度部落格。

觸及率與頻率範例

參考文件

觸及率與頻率

若要將影片的觸擊人數延伸到更多用戶，請將影片觀看行銷活動目標搭配觸及率與頻率使用。您需要建立預測資料、加以預訂，然後將其指派給廣告組合。

請遵照影片觀看建立流程操作，並將觸及率與頻率套用到廣告組合。請指定以下其他參數：

-F "rf_prediction_id=<RESERVATION_ID>" \

用於成效型廣告的影片

若要鼓勵用戶從熟悉知名度到採取行動，請參閱輪播格式的影片廣告創意。

觸及觀看影片的用戶。從熟悉知名度，到產生吸引力，最後觸動購買意願。請參閱再行銷。
和品牌與產品互動。加入行動呼籲以造訪網站的特定頁面。請參閱行動呼籲。

再行銷

影片廣告再行銷讓廣告商能夠在 Facebook 和 Instagram，將目標設定在來自自主或付費影片的特定自訂廣告受眾。這項功能可用於促使用戶從熟悉知名度到採取更進一步的漏斗目標，例如產生吸引力和觸動購買意願。請參閱研究：有效的廣告創意組合。

您需要廣告商授權包含影片的頁面，才能針對該影片建立廣告受眾。

如為廣告受眾，請設定 subtype=ENGAGEMENT。接著，針對想要建立的廣告受眾撰寫規則。每項規則都有一個 object_id（例如影片編號）和 event_name。event_name 為下列其中一項：

video_watched：用戶觀看影片的總時間達 3 秒以上或是幾乎全部看完的次數（以先發生者為準）。
video_completed：用戶觀看影片至全長 95% 的次數（包括直接跳到 95% 的觀看次數）。
video_view_10s：用戶觀看影片的總時間達 10 秒以上或是幾乎全部看完的次數（以先發生者為準）。
video_view_15s：用戶觀看影片的總時間達 15 秒以上或是幾乎全部看完的次數（以先發生者為準）。
video_view_25_percent：用戶觀看影片至全長 25% 的次數（包括直接跳到 25% 的觀看次數）。
video_view_50_percent：用戶觀看影片至全長 50% 的次數（包括直接跳到 50% 的觀看次數）。
video_view_75_percent：用戶觀看影片至全長 75% 的次數（包括直接跳到 75% 的觀看次數）。

您可組合影片，根據��多影片和動作來建立廣告受眾。例如，廣告受眾可包括影片 A 觀看 3 秒以上及影片 B 和 C 完整觀看的用戶。

以下範例會建立的廣告受眾為：過去 14 天內，影片 1 觀看 3 秒以上及影片 2 全部觀看的用戶。廣告受眾也會在建立廣告受眾前使用 prefill=true 為觀看者自動填入。

curl \
  -F 'name=Video Ads Engagement Audience' \
  -F 'subtype=ENGAGEMENT' \
  -F 'description=Users who watched my video' \
  -F 'prefill=1' \
  -F 'rule=[ 
  {"object_id":"%video_id_1","event_name":"video_watched"}, 
  {"object_id":"%video_id_2","event_name":"video_completed"} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/customaudiences
  
Open In Graph API Explorer

2015 年 10 月 16 日之後的影片觀看次數支援回填。

行動呼籲

包含行動呼籲（CTA）的影片會鼓勵用戶瞭解更多資訊，並造訪網站上的特定網頁。當主要目標為提高影片觀看次數或品牌知名度，且次要目標為提高離站點擊次數時，這將有助於改善成效。對於後者，您應使用影片連結廣告。CTA 呈現的方式如下：

如為行動版和桌面版，CTA 會顯示為貼文的一部分。當影片暫停播放時，CTA 會顯示在「繼續」選項旁。
如為行動版，當用戶點擊影片以全螢幕觀看時，浮動 CTA 會以影片特效層的方式顯示。
外部影片連結貼文不會顯示 CTA。

包含 CTA 的影片僅可搭配以下行銷活動目標使用：

PAGE_LIKES
LEAD_GENERATION
LOCAL_AWARENESS
LINK_CLICKS
CONVERSIONS
APP_INSTALLS
VIDEO_VIEWS
BRAND_AWARENESS
行動應用程式互動

請參閱影片延伸至其他目標。此會使用 GET_DIRECTIONS 行動呼籲建立影片廣告：

curl \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": { 
  "call_to_action": { 
  "type": "GET_DIRECTIONS", 
  "value": { 
  "link": "fbgeo:\/\/37.48327, -122.15033, \"1601 Willow Rd Menlo Park CA\"" 
  } 
  }, 
  "image_url": "<THUMBNAIL_URL>", 
  "link_description": "Come check out our new store in Menlo Park!", 
  "video_id": "<VIDEO_ID>" 
  } 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
   https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

影片衡量指標

影片貼文洞察報告：自主

參考文件

影片貼文洞察報告

深入瞭解影片在 Facebook 產生的成效，並對影片內容做出更明智的決定。目前僅提供用戶開始觀看影片後的衡量指標。其中包括影片觀看次數、不重複影片觀看次數、平均觀看影片長度及觀眾續看率。您可從中瞭解到用戶對影片失去興趣的時間點，以及用戶覺得最有興趣的部分。

影片廣告洞察報告：付費

使用廣告洞察報告 API。回應包含多種影片衡量指標。

影片類型

擷取按影片類型（如自動播放、點擊播放）分組的影片廣告統計資料。將 action_video_type 包含在 action_breakdowns 內。action_video_type 預期值有 total、click_to_play 和 auto_play。

action_video_type 選項目前正在進行限定測試。若要用資料解析識別客戶，請查看廣告帳號的 CAN_USE_VIDEO_METRICS_BREAKDOWN。

curl -G \
  -d 'action_breakdowns=action_video_type' \
  -d 'date_preset=last_30_days' \
  -d 'fields=actions,video_avg_pct_watched_actions,video_complete_watched_actions' \
  -d 'access_token= <ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/insights
   
Open In Graph API Explorer

回應內含 action_type 為 video_view 的目標，且包含 action_video_type 金鑰：

{
  "data": [
    {
      "actions": [
        ...
        {
          "action_type": "video_play", 
          "value": 9898
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 921129
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 915971
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 5158
        }
      ], 
      "video_avg_pct_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 60.59
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 60.47
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 80.63
        }
      ], 
      "video_complete_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 156372
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 154015
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 2357
        }
      ], 
      "date_start": "2014-12-26", 
      "date_stop": "2015-03-25"
    }
  ], 
  "paging": {
    "cursors": {
      "before": "MA==", 
      "after": "MA=="
    }
  }
}

請參閱廣告洞察報告 API

輪播廣告

這類廣告可讓您在動態消息中為廣告創意取得更多版面，促使用戶造訪網站或行動應用程式以進行轉換。輪播廣告有兩種建立方式：

在單一呼叫中建立廣告和贊助式專頁貼文：廣告創意 API。
建立贊助式專頁貼文，然後使用貼文（不可用於影片輪播廣告）建立廣告創意。

Facebook 限時動態不支援輪播廣告。

建立內嵌

在建立廣告創意的同時，建立輪播廣告粉絲專頁貼文。在 object_story_spec 中建立專頁貼文內容，從 adcreatives 建立贊助式專頁貼文。請參閱廣告創意。例如：

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "link_data": { 
      "child_attachments": [ 
        { 
          "description": "$8.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product1", 
          "name": "Product 1", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$9.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product2", 
          "name": "Product 2", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$10.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product3", 
          "name": "Product 3" 
        } 
      ], 
      "link": "<URL>" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

系統會傳回廣告創意編號：

{"id":"<CREATIVE_ID>"}

建立貼文，然後建立廣告

建立贊助式專頁貼文。child_attachments 為連結物件陣列。每個連結物件上的 picture、name 和 description 皆為選用。只有使用粉絲專頁存取權杖，您才能以粉絲專頁的身分張貼這些貼文。

curl -X GET \
  -d 'message="Browse our latest products"' \
  -d 'published=0' \
  -d 'child_attachments=[
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 1",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 2",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 3",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 4",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       }
     ]' \
  -d 'caption="WWW.EXAMPLE.COM"' \
  -d 'link="http://www.example.com/products"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<PAGE_ID>/posts
  
Open In Graph API Explorer

然後，以贊助式專頁貼文提供廣告創意。在廣告創意中使用 object_story_id 的 id。

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

建立影片輪播廣告

影片輪播廣告可在子附件中指定「說明文字」，以自訂影片結尾顯示的網址：

"child_attachments": [
 {
   "link": "https://www.facebookmarketingdevelopers.com/",
   "name": "Facebook Marketing Developers",
   "description": "Facebook Marketing Developers",
   "call_to_action": {
     "type": "APPLY_NOW",
     "value": {
      "link_title": "Facebook Marketing Developers"
     }
   },
   "video_id": "123",
   "caption": "mycustomlinkcaption.com"
  },
]

若要取得子附件詳細資料，請使用編號並呼叫參考資料中的「影片」圖形 API。

建立行動應用程式廣告

限制：

行動應用程式輪播廣告僅支援單一應用程式
至少 3 個圖像（相較於非應用程式輪播廣告的 2 個圖像）
行動應用程式輪播廣告必須包含行動呼籲
通常顯示粉絲專頁大頭貼照的結束圖卡，在行動應用程式輪播廣告中不會顯示。請注意，您應在每個 child_attachment 中指定相同的應用程式商店連結。不需在 call_to_action:{'value':{'link':... }}} 中重新指定連結

例如，若要建立以提升行動應用程式安裝次數為目標的輪播廣告：

curl -X POST \
  -F 'name="Carousel app ad"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "message": "My message",
         "link": "http://www.example.com/appstoreurl",
         "caption": "WWW.ITUNES.COM",
         "name": "The link name",
         "description": "The link description",
         "child_attachments": [
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           }
         ],
         "multi_share_optimized": true
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

您只能以與該行動應用程式連結的 Facebook 粉絲專頁的名義發佈貼文，且必須使用粉絲專頁存取權杖。

curl \
  -F 'message=My description' \
  -F 'link=<APP_STORE_URL>' \
  -F 'caption=WWW.ITUNES.COM' \
  -F 'child_attachments=[ 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    } 
  ]' \
  -F 'multi_share_optimized=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<PAGE_ID>/feed

使用回應中的 id 建立 AdCreative：

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

欄位規格

以下是 iOS 版輪播廣告，顯示下述欄位的使用方式。

名稱	說明
`child_attachments` 類型：物件	輪播廣告必須有包含 2 到 10 個元素的連結物件陣列。您應使用至少 3 個物件才能達到最佳成效；2 個物件可啟用輕量化整合，且使用 2 個物件可能無法使行銷活動達到最好的成效。
`child_attachments.link` 類型：字串	附加至貼文的連結網址或應用程式網址。必填。
`child_attachments.picture` 類型：網址	與連結關聯的預覽圖像。長寬比 1:1 且至少 458 x 458 像素，才能呈現最佳顯示效果。必須指定 `picture` 或 `image_hash`。
`child_attachments.image_hash` 類型：字串	與來自圖庫的連結相關聯的預覽圖像雜湊（使用長寬比 1:1 且至少 458 x 458 像素，才能呈現最佳顯示效果）。必須指定 `picture` 或 `image_hash`。
`child_attachments.name` 類型：字串	連結預覽的標題。如未指定，會使用連結網頁的標題。通常在超過 35 個字元後會截斷。您應設定唯一的 `name`，因為 Facebook 介面會展示 `name` 所回報的動作。
`child_attachments.description` 類型：字串	為價格、折扣或網站網域。如未指定，會擷取並使用連結網頁的內容。通常在超過 30 個字元後會截斷。
`child_attachments.call_to_action` 類型：物件	行動呼籲（選用）。請參閱行動呼籲。您不需要在 `call_to_action:{'value':{'link':... }}}` 中重新指定連結
`child_attachments.video_id` 類型：字串	廣告影片的編號。可用於任何子元素。如果指定，也必須設定 `image_hash` 或 `picture`。
`message` 類型：字串	貼文主體，也稱為狀態訊息。
`link` 類型：字串	「查看更多」的連結網址。必填。
`caption` 類型：字串	「查看更多」連結中顯示的網址。不適用於行動應用程式輪播廣告
`multi_share_optimized` 類型：布��值	如果設為 `true`，將自動選擇圖像和連結並排序。否則會使用子元素的原始順序。預設為 `true`。
`multi_share_end_card` 類型：布林值	若設為 `false`，會移除顯示頁面圖示的結束圖卡。預設為 `true`。

各產品的廣告統計資料

每項含 actions_breakdown=['action_carousel_card_id', 'action_carousel_card_name'] 的產品輪播廣告的社團動作。每個 child_attachment 都有不同的卡片編號。action_carousel_card_id 和 action_carousel_card_name 只適用於輪播廣告。

取得各圖卡的下列統計資料：

website_ctr：指定 fields=['website_ctr'] 時可用
app_install、app_use、apps.uses、credit_spent、mobile_app_install、tab_view、link_click、mobile_app_install、app_custom_event.*、offsite_conversion.*：指定 fields=['actions'] 時可用。其他動作不適用於圖卡資料解析。

curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_id"]' \
  -d 'level=ad' \
  -d 'date_preset=last_30_days' \
  -d 'time_increment=all_days' \
  -d 'breakdowns=placement' \
  --data-urlencode 'filtering=[ 
    { 
      "field": "action_type", 
      "operator": "IN", 
      "value": ["link_click"] 
    } 
  ]' \
  -d 'fields=impressions,inline_link_clicks,actions,website_ctr' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

回應：

{
...
   "website_ctr": [
      {
         "action_carousel_card_id": "1",
         "action_type": "link_click",
         "value": 51.401869158878
      },
      {
         "action_carousel_card_id": "2",
         "action_type": "link_click",
         "value": 50.980392156863
      }
   ],
   "placement": "mobile_feed",
   "date_start": "2015-05-25",
   "date_stop": "2015-05-28"
}

您也可要求 cost_per_action_type，以按照動作類型進行成本資料解析：

curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_name"]' \
  -d 'level=ad' \
  -d 'breakdowns=placement' \
  -d 'fields=impressions,campaign_name,cost_per_action_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

回應範例：

{
   "data": [
      {
         "impressions": "1862555",
         "campaign_name": "My Campaign",
         "cost_per_action_type": [
            {
               "action_carousel_card_name": "My Carousel Card 1",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.093347346315861
            },
            {
               "action_carousel_card_name": "My Carousel Card 2",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.38324089579301
            },
            ...
         ],
      }
   ]
}

action_report_time=impression 的輪播廣告資料解析衡量指標在 2015 年 6 月 20 日之前不準確。
action_report_time=conversion 的輪播廣告資料解析衡量指標在 2015 年 7 月 20 日之前不準確。

廣告版位

如果您只選擇 right_hand_column 作為廣告版位，則只能在廣告群組中使用單一影片或輪播格式。我們不支援只選擇 right_hand_column 廣告版位的影片格式。請參閱進階目標設定和廣告版位。

例如，在只選擇 right_hand_column 為廣告版位的情況下建立廣告組合：

curl \
  -F 'name=RHS only Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2017-11-21T15:41:36+0000' \
  -F 'end_time=2017-11-28T15:41:36+0000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
    "device_platforms": ["mobile"], 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook"] ,
    "facebook_positions": ["right_hand_column"] ,  
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adsets
  
Open In Graph API Explorer

提供含有影片的廣告創意：

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

或為廣告創意提供全螢幕互動廣告格式：

curl \
  -F 'image_hash=<IMAGE_HASH>' \
  -F 'object_story_spec={ 
    "link_data": { 
      "call_to_action": {"type":"LEARN_MORE"}, 
      "image_hash": "<IMAGE_HASH>", 
      "link": "CANVAS_LINK", 
      "name": "Creative message" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

如果嘗試以該廣告組合和廣告創意來建立廣告：

curl \
  -F 'name=My Ad' \
  -F 'adset_id=<AD_SET_ID>' \
  -F 'creative={"creative_id":"<CREATIVE_ID>"}' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

系統若傳回錯誤代碼，此時您必須提供系統支援的廣告創意或變更目標設定。

影片和輪播廣告

影片廣告

步驟 1：提供廣告創意

輕影片

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

步驟 3：建立廣告組合

步驟 4：建立廣告

品牌知名度範例

觸及率與頻率範例

用於成效型廣告的影片

再行銷

行動呼籲

影片衡量指標

影片貼文洞察報告：自主

影片廣告洞察報告：付費

影片類型

輪播廣告

建立內嵌

建立貼文，然後建立廣告

建立影片輪播廣告

建立行動應用程式廣告

欄位規格

各產品的廣告統計資料

廣告版位

另請參閱