行銷 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）的行銷活動，您可以使用 instream_video 且不需要 VIDEO_VIEWS 和 POST_ENGAGEMENT 目標的 feed。instream_video 不支援 CONVERSIONS 目標。
  • 如果您選擇 story，必須使用 Facebook feed 或 Instagram story 和 device_platforms: mobile，因為 Facebook 限時動態為行動版專屬。
  • 如果您選擇 marketplace、search 或 profile_feed，必須使用 feed。
  • 從第 3.0 版開始，right_hand_column 僅適用於 TRAFFIC、CONVERSIONS 和 PRODUCT_CATALOG_SALES 目標的單一圖像、單一影片和輪播格式。

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

選用。
預設：全部
您可以鎖定 Instagram stream、story 或 ig_search 的 Instagram 輪播廣告。如果您在限時動態中使用無提示的輪播廣告創意，則不能為同一個廣告組合同時選擇兩個選項。
使用 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 可用於會帶動網站、應用程式和 Messenger 流量之廣告的 LINK_CLICKS、CONVERSIONS、MESSAGES、APP_INSTALLS 和 PRODUCT_CATALOG_SALES 目標中的單一圖像和輪播廣告。
  • 如果您選擇 story，必須使用 Facebook feed 或 Instagram story 和 device_platforms: mobile，因為 Messenger 限時動態為行動版專屬。您可以在廣告行銷活動中使用單一圖像和影片格式的 story，搭配會帶動網站和應用程式流量之廣告的 CONVERSIONS、TRAFFIC、REACH、BRAND_AWARENESS 和 APP_INSTALLS 目標。
  • 您不能使用 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 Web Feeds 廣告使用 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 版位的廣告組合，且目標設定為支援的國家／地區（例如「美國」）：

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 版位的廣告組合，且目標設定為支援的國家／地區（例如「美國」）：

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”},]

如需詳細資訊，請參閱廣告推薦參考資料和使用目標設定的有效廣告版位。