影片和輪播廣告

透過 API,您可以輕鬆在 Facebook 上建立、衡量及優化影片和輪播廣告。請參閱 Facebook for Business 的「輪播廣告」頁面。如要了解廣告支援的影片格式,請參閱廣告客戶幫助中心有關「影片」的文章

影片廣告

參考文件

如要以 VIDEO_VIEWS 為目標建立影片廣告並優化出價以接觸更多受眾,請按以下步驟操作:

第 1 步:提供廣告創意

使用現有影片編號及上載至 Facebook 的影片建立影片廣告。

您將需要:

  • pages_read_engagementads_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 設定為 IMPRESSIONSTHRUPLAY,按展示次數或影片觀看次數付費。請參閱每次觀看成本出價

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_nameevent_name 可以是以下其中一項:

  • video_watched:用戶觀看影片總計最少 3 秒或幾乎達到影片總長度的次數,以較先者為���。
  • video_completed:影片觀看進度達 95% 的次數,包括直接跳到這個時間點的觀看次數。
  • video_view_10s:用戶觀看影片總計最少 10 秒或幾乎達到影片總長度的次數,以較先者為準。
  • video_view_15s:用戶觀看影片總計最少 15 秒或幾乎達到影片總長度的次數,以較先者為準。
  • video_view_25_percent:影片觀看進度達 25% 的次數,包括直接跳到這個時間點的觀看次數。
  • video_view_50_percent:影片觀看進度達 50% 的次數,包括直接跳到這個時間點的觀看次數。
  • video_view_75_percent:影片觀看進度達 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 日以後的影片觀看次數支援回填。

呼籲字句

包含呼籲字句的影片會提示用戶了解詳情並前往網站上的特定網頁。如果您的主要目標是推動影片觀看次數或品牌知名度,且次要目標是提升離站點擊次數,使用呼籲字句有助您改善成效。在前例中,您應該為次要目標使用影片連結廣告。呼籲字句的呈現方式如下:

  • 在流動裝置和桌面電腦上顯示為帖子的一部分。影片暫停時,呼籲字句會展示在「繼續」選項一旁。
  • 在流動裝置上,當用戶點擊影片來以全螢幕模式觀看時,浮動呼籲字句會以影片疊壓文字的形式呈現。
  • 外部影片連結帖子不會顯示呼籲字句。

您只能配合下列宣傳活動目標在影片中加入呼籲字句:

請參閱擴展影片支援的目標。以下程式碼將建立具有 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_breakdowns 中加入 action_video_typeaction_video_type 的預期值為 totalclick_to_playauto_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_typevideo_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

在動態消息爭取更多空間展示廣告創意,將用戶帶到您的網站或流動應用程式完成轉換。建立輪播廣告的方法有兩種:

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連結物件陣列。在每個連結物件中,picturenamedescription 為選用項目。如要以專頁的身分發佈有關帖子,您必須使用專頁存取憑證。

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

接著,使用此贊助式專頁帖子提供廣告創意。將 id 用作廣告創意中的 object_story_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"
  },
]

如要獲取子附件的詳細資料,請參考參考資料:Graph API > 影片,以相應編號呼叫 Graph API。

建立流動應用程式廣告

限制:

  • 輪播流動應用程式廣告僅支援 1 個應用程式。
  • 必須最少包含 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 建立廣告創意:

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 個物件可實現輕量化整合,而且可帶來次優的宣傳活動成效。

child_attachments.link

類型:字串

附加到帖子的連結網址或應用程式商店網址。此為必要項目。

child_attachments.picture

類型:網址

與連結相關的預覽圖像。如要展示最佳畫質,長闊比例應為 1:1,尺寸最少應為 458 x 458 像素。必須指定 pictureimage_hash

child_attachments.image_hash

類型:字串

取自圖庫且與連結相關的預覽圖像之雜湊;如要展示最佳畫質,長闊比例應為 1:1,尺寸最少應為 458 x 458 像素。必須指定 pictureimage_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_hashpicture

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_idaction_carousel_card_name 僅適用於輪播廣告。

您可就各圖卡取得下列統計資料:

  • website_ctr:指定 fields=['website_ctr'] 時適用。
  • app_installapp_useapps.usescredit_spentmobile_app_installtab_viewlink_clickmobile_app_installapp_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
            },
            ...
         ],
      }
   ]
}
  • 2015 年 6 月 20 日之前的 action_report_time=impression 輪播廣告資料細節衡量數據有誤。
  • 2015 年 7 月 20 日之前的 action_report_time=conversion 輪播廣告資料細節衡量數據有誤。

版位

如果您僅選擇 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

如果您收到錯誤代碼,請提供系統支援的廣告創意,或更改受眾目標設定。