市场营销 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/v21.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 视频插播广告、Facebook Reels 内嵌广告和 Instagram Reels 内嵌广告）、Audience Network 广告和动态版块广告（Facebook 动态、Instagram 动态、Facebook Reels 动态和 Instagram Reels 动态）的不同类型内容旁边。如需进一步了解内容分类，请查看广告帮助中心 > 库存筛选方案。您可以为内容中广告、Audience Network 广告和动态版块广告选择不同的值。选项包括：Expanded、Moderate 和 Limited。如需了解详情，请查看以下 brand_safety_content_filter_levels：

名称 描述

brand_safety_content_filter_levels

array<string>

对于内容中广告（Facebook 视频插播广告和 Facebook Reels 内嵌广告），我们允许使用以下值：

  • EXPANDED：FACEBOOK_RELAXED
  • MODERATE：FACEBOOK_STANDARD
  • LIMITED：FACEBOOK_STRICT

对于 Audience Network，我们允许使用以下值：

  • EXPANDED：AN_RELAXED
  • MODERATE：AN_STANDARD
  • LIMITED：AN_STRICT

对于动态版块广告（Facebook 动态、Instagram 动态、Facebook Reels 动态和 Instagram Reels 动态），我们允许使用以下值：

  • EXPANDED：FEED_RELAXED
  • MODERATE：FEED_STANDARD
  • LIMITED：FEED_STRICT

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

注意：在广告账户层级应用筛选条件时，广告系列层级仅会提供限制更严格的选项。例如，如果账户设为 MODERATE，用户将只能为广告系列选择 MODERATE 或 LIMITED，而无法选择限制较宽松的选项（如此示例中的 EXPANDED）。

excluded_publisher_categories

array<string>

包括：dating 和 gambling

excluded_publisher_list_ids

array<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

array<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、facebook_reels_overlay、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 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 publisher_platform，并指定 feed 作为 facebook_positions。
  • messenger_home 适用于在 LINK_CLICKS、CONVERSIONS、MESSAGES、APP_INSTALLS 和 PRODUCT_CATALOG_SALES 广告目标中的单图片广告和轮播广告，有助于提高在网站、应用和 Messenger 的流量。
  • 如您选择 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 网页动态广告使用 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/v21.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/v21.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”},]

详情请参阅参考资料 > 广告推荐以及具有定位功能的有效版位。