推廣 API

版位目標設定

在特定版位刊登廣告，例如僅在桌面版動態消息刊登或在流動版動態消息刊登並加上 Audience Network 獎勵式影片。您可以根據您的宣傳活動目標，從而選用特定版位選項。詳情請參閱宣傳活動、目標和版位。

可用的平台和位置為 device_platforms、publisher_platforms、facebook_positions、audience_network_positions、instagram_positions 和 messenger_positions。詳情請參閱裝置、發佈商和位置部分。

curl -X POST \
  -F 'name="My AdSet"' \
  -F 'optimization_goal="REACH"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'targeting={
       "geo_locations": {
         "countries": [
           "US"
         ]
       },
       "publisher_platforms": [
         "facebook"
       ],
       "facebook_positions": [
         "feed"
       ]
     }' \
  -F 'promoted_object={
       "page_id": "<PAGE_ID>"
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets


如果您沒有為特定版位欄位指定任何內容，Facebook 可能會在該欄位使用所有可能的預設版位。例如，如果您將 publisher_platforms 設為 facebook，但未為 facebook_positions 選擇任何內容，Facebook 可能會使用所有預設 Facebook 位置，如 feed 和 right_hand_column 等。或者，如果您沒有選擇 publisher_platforms，Facebook 可能會使用所有預設publisher_platforms。如有可用的新位置或新平台，Facebook 也可能會自動使用這些選項。

在 Audience Network 上，您可以限制讓哪些發佈商展示您的廣告。您可以按類別排除發佈商，或者建立自訂名單，列出要排除的應用程式商店網址或網域網址。

您不能僅使用 right_hand_column 作為影片、焦點系列或全螢幕展示廣告的版位。

廣告顯示位置篩選工具有助控制您的廣告是否顯示在 Facebook 插播和 Audience Network 的不同類型內容旁邊。如需進一步了解內容分類，請查看廣告幫助中心：廣告顯示位置篩選工具。您可以為 Facebook 插播選擇一個值，再為 Audience Network 選擇另一個值。選項包括：Full、Standard 和 Limited。如需了解詳情，請查看下方的 brand_safety_content_filter_levels：

名稱 說明

brand_safety_content_filter_levels

陣列 <string>

對於 Facebook 插播，我們允許以下值：


  • FULL：FACEBOOK_RELAXED
  • STANDARD：FACEBOOK_STANDARD
  • LIMITED：FACEBOOK_STRICT

對於 Audience Network，我們允許以下值：


  • FULL：AN_RELAXED
  • STANDARD：AN_STANDARD
  • LIMITED：AN_STRICT

範例："brand_safety_content_filter_levels":["FACEBOOK_STRICT", "AN_RELAXED"]

備註：如在廣告帳戶級別套用了篩選條件，宣傳活動級別提供的選項只會更受限。例如，若在帳戶級別設定了「適中」，用戶設定宣傳活動時只能選擇「適中」或「有限」，無法選擇較寬鬆的選項，在此範例中即代表無法選擇「擴大」。

excluded_publisher_categories

陣列 <string>

包括：dating 和 gambling

excluded_publisher_list_ids

陣列 <numeric strings>

每個字串都是待排除的清單編號。在廣告管理員或推廣 API，發佈商剔除名單中建立自訂名單。


範例：
"excluded_publisher_list_ids":["{block_list_id_1}","{block_list_id_2}"]

例如，使用 brand_safety_content_filter_levels：

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=CAMPAIGN_ID' \
  -F 'targeting= { "geo_locations":{"countries":["US"]}, "brand_safety_content_filter_levels":["FACEBOOK_STRICT","AN_STANDARD"]}' \
  -F 'status=ACTIVE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/VERSION/AD_ACCOUNT_ID/adsets

在 Audience Network 和插播影片廣告，您也可以按類別排除發佈商：

名稱 說明

excluded_publisher_categories

陣列 <string>

包括：

  • debated_social_issues
  • mature_audiences
  • tragedy_and_conflict

範例：
"excluded_publisher_categories": ["debated_social_issues", "mature_audiences"]

裝置、發佈商和位置

名稱：選項 說明

device_platforms：mobile、desktop

選用項目。
預設：所有
查看您廣告的用戶裝置類型。

publisher_platforms：facebook、instagram、messenger、audience_network

選用項目。
預設：所有
您廣告的發佈渠道。您可以在 facebook_positions、instagram_positions、audience_network_positions 或 messenger_positions 設定發佈渠道位置。

facebook_positions：feed、right_hand_column、marketplace、video_feeds、story、search、instream_video、facebook_reels、profile_feed

此為選用項目。
預設：所有


備註：

  • 如有提供，publisher_platforms 必須包括 facebook 或不向所有選項提供預設值。
  • feed 包括桌面版和流動版的動態消息。
  • 如果宣傳活動的目標受眾為美國（US）、英國（GB）、法國（FR）、西班牙（ES）、德國（DE）、墨西哥（MX）、印度（IN）和泰國（TH）的用戶，您可以為 VIDEO_VIEWS 和 POST_ENGAGEMENT 目標使用不涵蓋 feed 的 instream_video。instream_video 現不支援 CONVERSIONS 目標。
  • 如果選擇 story，則您必須使用 Facebook feed 或 Instagram story 和 device_platforms: mobile，因為 Facebook 限時動態僅適用於流動版。
  • 如果選擇 marketplace、search 或 profile_feed，則您必須使用 feed。
  • 由 v3.0 起，right_hand_column 僅適用於選用 TRAFFIC、CONVERSIONS 和 PRODUCT_CATALOG_SALES 目標的單一圖像廣告、單一影片廣告和輪播格式廣告。

instagram_positions：stream、story、explore、explore_home、reels、profile_feed、ig_search、profile_reels

此為選用項目。
預設：所有
您可以將 Instagram 的輪播廣告目標版位設定為 Instagram 的 stream、story 或 ig_search。如果您在限時動態中使用非提示式輪播廣告創意，便不能為同一個廣告組合選擇這兩種選項。
使用 story 的廣告將同時在 Instagram 桌面版或流動版網頁動態消息中顯示。

audience_network_positions：classic、rewarded_video

選用項目。
預設：所有
根據預設，當您讀取廣告組合的目標設定規格時，我們不會傳回 effective_audience_network_positions。這可能與您已配置的 audience_network_positions 不同。如果您指定一個不支援既定目標的位置，則此位置就會出現在已配置位置清單中，但不會在有效位置清單中出現。

messenger_positions：messenger_home、sponsored_messages、story

選用項目。
預設：messenger_home、story


備註：

  • 如果選擇 messenger_home，則您同樣必須在 facebook_positions 選擇 Facebook publisher_platform 和 feed。
  • messenger_home 適用於選取了 LINK_CLICKS、CONVERSIONS、MESSAGES、APP_INSTALLS 和 PRODUCT_CATALOG_SALES 目標的單一圖像廣告和輪播廣告；這些廣告目標有助於提高網站、應用程式和 Messenger 的流量。
  • 如果選擇 story，則您必須使用 Facebook feed 或 Instagram story 和 device_platforms: mobile，因為 Messenger 限時動態僅適用於流動版。您可以在設定了 CONVERSIONS、TRAFFIC、REACH、BRAND_AWARENESS 和 APP_INSTALLS 目標以提高網站和應用程式流量的廣告宣傳活動中，為單一圖像和影片格式選用 story 版位。
  • 您不能使用帶有其他版位的 sponsored_messages，包括 messenger_home 或 Facebook 版位。

邏輯

  • 同一參數中選項的邏輯為 OR。
    例如，publisher_platforms=['facebook','instagram'] 是指在 Facebook 或 Instagram 上刊登廣告。
  • 參數之間的邏輯為 AND。
    例如，publisher_platforms=['facebook']&device_platforms=['mobile'] 是指僅向流動版 Facebook 刊登這些廣告。
  • 如果邏輯最終未有設定目標（如 publisher_platforms=['instagram']& device_platforms=['desktop']），將會顯示錯誤。

限制

  • 您不能僅使用 Audience Network，所以無法僅選擇 publisher_platforms: audience_network 本身。
  • 帶有 VIDEO_VIEWS 目標的 audience_network 版位必須與 THRUPLAYS 優化目標一併使用。
  • 您無法僅為 facebook_positions 選擇 story 本身。如果您為 facebook_positions 選擇 story，則必須同時選擇 Facebook feed 或 Instagram story。
  • 您無法僅為 messenger_positions 選擇 story 本身。如果您為 messenger_positions 選擇 story，必須同時選擇 Facebook feed 或 Instagram story。
  • Instagram 網頁動態消息廣告使用的是 stream 版位，系統會檢查這類廣告是否符合資格同時在桌面版或流動版網頁動態消息中刊登。相容目標為 BRAND_AWARENESS、REACH、LINK_CLICKS、POST_ENGAGEMENT、VIDEO_VIEWS 和 CONVERSIONS。

範例

限時動態

使用 Facebook 限時動態作為您的版位：

curl \
  -F 'name=My Ad Set' 
  -F 'optimization_goal=CONVERSIONS' 
  -F 'billing_event=IMPRESSIONS' 
  -F 'bid_amount=2' 
  -F 'daily_budget=1000' 
  -F 'campaign_id=<AD_CAMPAIGN_ID>' 
  -F 'targeting={"geo_locations":{"countries":["US"]}, "publisher_platforms":["messenger", "facebook"], "facebook_positions":["story"], "messenger_positions":["story"]}' 
  -F 'status=ACTIVE'
  -F 'access_token=<ACCESS_TOKEN>' 
  https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets

插播影片

建立只選用 instream_video 版位的廣告組合，並將其目標受眾設定為以上所列的支援國家／地區：

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=CAMPAIGN_ID' \
  -F 'targeting={"geo_locations":{"countries":["US"]},"publisher_platforms":["facebook"], "facebook_positions":["instream_video"]}' \
  -F 'status=ACTIVE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets

Audience Network

設定 Audience Network 獎勵式影片廣告版位目標：

curl \
  -F 'name=My Ad Set' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'is_autobid=true' \
  -F 'daily_budget=40000' \
  -F 'campaign_id=<AD_CAMPAIGN_ID>' \
  -F 'targeting={"app_install_state": "not_installed","geo_locations":{"countries":["US"]},"facebook_positions":["feed"],"device_platforms": ["mobile"],"audience_network_positions": ["classic","rewarded_video"],"user_device": ["Android_Smartphone","Android_Tablet"],"user_os": ["Android_ver_4.4_and_above"]}' \
  -F 'promoted_object={"application_id": "<APPLICATION_ID>","custom_event_type": "PURCHASE","object_store_url": "<OBJECT_STORE_URL>"}' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<APIVERSION>/<AD_ACCOUNT_ID>/adsets

這會傳回以下內容：

{
  "targeting": {
    "audience_network_positions": [
      "classic",
      "rewarded_video"
    ],
    "effective_audience_network_positions": [
      "classic",
      "rewarded_video"
    ]
  },
  "id": "<AD_SET_ID>"
}

Reels

使用 Facebook Reels 作為您的版位：

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=CAMPAIGN_ID' \
  -F 'targeting={"geo_locations":{"countries":["US"]},"publisher_platforms":["facebook"], "facebook_positions":["facebook_reels"]}' \
  -F 'status=ACTIVE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets

Instagram「探索」主頁

建立以 explore_home 為版位的廣告組合，並將其目標受眾設定為支援國家／地區的用戶（例如「US」）：

curl -X POST \
  -F 'name="My AdSet"' \
  -F 'optimization_goal="LINK_CLICKS"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'targeting={
       "geo_locations": {
         "countries": [
           "US"
         ]
       },
       "publisher_platforms": [
         "instagram"
       ],
       "instagram_positions": [
         "stream",
         "explore",
         "explore_home"
       ],
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Instagram 搜尋結果

建立以 ig_search 為版位的廣告組合，並將其目標受眾設定為支援國家／地區的用戶（例如「US」）：

curl -X POST \
  -F 'name="My AdSet"' \
  -F 'optimization_goal="LINK_CLICKS"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'targeting={
       "geo_locations": {
         "countries": [
           "US"
         ]
       },
       "publisher_platforms": [
         "instagram"
       ],
       "instagram_positions": [
         "stream",
         "ig_search"
       ],
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

在有效版位鎖定目標受眾

您根據目標設定規格建立帶有版位的廣告組合，但您其實並不了解 Facebook 有否將您的廣告刊登在指定版位，這是因為您所選的版位可能不適用於您所選的廣告目標。以有效版位 API 來鎖定目標受眾後，您可以根據目標受眾設定選項來決定您廣告的刊登位置，並且接收驗證訊息來了解部分版位被篩走的原因。如果您沒有提供受眾目標設定，仍可以根據廣告組合和廣告宣傳活動設定來決定有效的版位。

如要讀取根據您目標受眾設定而得出的有效版位，請將 effective_ 放在版位欄位名稱之前。例如：

curl -G \
  -d "fields=targeting{effective_publisher_platforms,effective_facebook_positions,effective_device_platforms,effective_audience_network_positions,effective_instagram_positions}" \
  -d "access_token=<access_token>" \
  https://graph.facebook.com/<VERSION>/<AD_SET_ID>

如需了解部分版位被篩走的原因，請使用 recommendation 欄位：

curl -G \
  -d "fields=recommendations" \
  -d "access_token=<access_token>" \
  https://graph.facebook.com/<VERSION>/23842573364570019

有了有效的版位，您便可以根據廣告組合的 billing_event、optimization_goal 和 promoted_object，以及根據廣告宣傳活動的 buying_type 和 objective，來決定在哪些版位刊登廣告。/ad_campaign_placement 的所有參數包括：

  • 廣告 account_id 及存取憑證
  • billing_event，例如 IMPRESSIONS
  • 購買類型，例如 AUCTION
  • 目標，例如 POST_ENGAGEMENT
  • 優化目標（可選），例如 POST_ENGAGEMENT
  • 推廣的物件，例如 PIXEL_ID

您需要提供所有參數（promoted_object 和 optimization_goal 除外）。如果您有提供目標指定，則可使用推廣 API，以根據設定所允許的廣告版位，確定有效的廣告版位；詳情請查看含有指定目標的有效廣告版位。例如：

curl -G \
-d 'account_id=<ACCOUNT_ID>' \
-d 'billing_event=IMPRESSIONS' \
-d 'buying_type=AUCTION' \
-d 'objective=PAGE_LIKES' \
-d 'optimization_goal=IMPRESSIONS' \
https://graph.facebook.com/<VERSION>/ad_campaign_placement?access_token=<TOKEN>

此呼叫將傳回：

{
   "effective_device_platforms": [
      "mobile",
      "desktop"
   ],
   "effective_facebook_positions": [
      "feed",
      "right_hand_column"
   ],
   "effective_publisher_platforms": [
      "facebook"
   ],
   "recommendations": [
      {
         "title": "Placement Not Supported By Objective",
         "message": "Ads with PAGE_LIKES objective do not support facebook.instream_video, facebook.suggested_video, facebook.marketplace, audience_network.classic, audience_network.instream_video, audience_network.rewarded_video, instagram.stream, instagram.story, messenger.messenger_home.",
         "code": 1815609,
         "importance": "LOW",
         "confidence": "HIGH",
         "blame_field": "targeting"
      },
      {
         "title": "Device Platform Not Supported By Objective",
         "message": "Ads with PAGE_LIKES objective do not support connected_tv.",
         "code": 1815610,
         "importance": "LOW",
         "confidence": "HIGH",
         "blame_field": "targeting"
      }
   ],     
   }
}

您可以使用此結果中的 code 欄位，然後向 /ad-recommendation 發出呼叫，以查看詳細原因。例如，您可以獲得以下資訊：

[{“code”: 1815610, “summary”: “Device Platform Not Supported By Objective”},]

詳情請查看廣告推薦做法：參考資料及在有效版位鎖定目標受眾的文章。