2.11 版

市场营销 API

发布日期：2017 年 11 月 7 日 | 博文

• 新功能
• 重大变更
• 停用内容
• 立即停用的内容

新功能

重新设计的商务管理平台 API

现在，我们已经创造了一种代表客户和经销商的新关系。在以前，我们也没有 user，我们要通过 bid/userpermissions 处理所有与商务管理平台及其资产相关的访问权限和邀请问题，而这种方法往往性能欠佳。新推出的 API 提供以下重要功能：

• 商务管理平台范围用户 - 新用户将与指定的商务管理平台绑定并拥有商务管理平台范围的权限。用户可以管理与指定的商务管理平台相关的信息页、权限和资产访问等。
• 邀请 - 邀请用户通过新端点访问某个商务管理平台。查看和更新这些端点的用户邀请状态。
• 资产类别 - 将不同类型的资产划分为不同类别，并为每个类别提供独立的端点。这样，您便可以采取分页的形式更轻松地查看资产信息。如果商务管理平台要管理的资产数量庞大，采用这种方法将有助于减少性能问题。在重新设计的过程中，我们添加了一些新端点。

要访问商务管理平台上的用户：

• BUSINESS_ID/business_users
• BUSINESS_ID/system_users
• BUSINESS_ID/pending_users

要访问分配给用户的资产：

• BUSINESS_USER_ID/assigned_pages
• BUSINESS_USER_ID/assigned_ad_accounts
• BUSINESS_USER_ID/assigned_product_catalogs
• SYSTEM_USER_ID/assigned_pages
• SYSTEM_USER_ID/assigned_ad_accounts
• SYSTEM_USER_ID/assigned_product_catalogs
• PENDING_USER_ID/assigned_pages
• PENDING_USER_ID/assigned_ad_accounts
• PENDING_USER_ID/assigned_product_catalogs

要访问商务管理平台中的主页：

• BUSINESS_ID/owned_pages - 可获取一份列表，包含商务管理平台拥有的主页
• BUSINESS_ID/client_pages - 可获取一份列表，包含商务管理平台的客户拥有的主页
• BUSINESS_ID/pending_owned_pages - 可获取一份列表，包含商务管理平台拥有的待审核主页
• BUSINESS_ID/pending_client_pages - 可获取一份列表，包含商务管理平台的客户拥有的待审核主页

要访问商务管理平台中的广告帐户：

• BUSINESS_ID/owned_ad_accounts - 可获取一份列表，包含商务管理平台拥有的广告帐户
• BUSINESS_ID/client_ad_accounts - 可获取一份列表，包含商务管理平台的客户拥有的广告帐户
• BUSINESS_ID/pending_owned_ad_accounts - 可获取一份列表，包含商务管理平台拥有的待审核广告帐户
• BUSINESS_ID/pending_client_ad_accounts - 可获取一份列表，包含商务管理平台的客户拥有的待审核广告帐户

要访问商务管理平台中的商品目录：

• BUSINESS_ID/owned_product_catalogs - 可获取一份列表，包含商务管理平台拥有的商品目录
• BUSINESS_ID/client_product_catalogs - 可获取一份列表，包含商务管理平台的客户拥有的商品目录

要访问商务管理平台中的应用：

• BUSINESS_ID/owned_apps - 可获取一份列表，包含商务管理平台拥有的应用
• BUSINESS_ID/client_apps - 可获取一份列表，包含商务管理平台的客户拥有的应用
• BUSINESS_ID/pending_client_apps - 可获取一份列表，包含商务管理平台的客户拥有的待审核应用

如需了解更多信息，请参阅商务管理平台，API、商务管理平台，系统用户、商务管理平台资产管理 API 和商务管理平台 API，最佳实践。

轮播广告，添加实时位置

现在，您可以在创建轮播广告时添加可展示实时位置的附件。我们在 AD_CREATIVE_ID/object_story_spec 的 place_data 中添加了选项 type=REALTIME 和 location_source_id = PAGE_ID。 在以下两项的 object_story_spec 字段中可使用这些选项：

• POST /AD_ACCOUNT_ID/adcreatives
• GET CREATIVE_ID

店铺访问量，按地理位置定位

现在，您可以定位店铺周边某一半径范围以外的地理区域。对于使用店铺访问量目标创建的广告组，我们在 targeting_specs 字段中添加了 geo_locations 参数。如果使用受限，请联系您的 Facebook 代表了解自己是否有使用权限。 请参阅店铺访问量目标

• POST AD_ACCOUNT_ID/adsets 已添加此新选项。
• 除了不支持按 country_groups 定位和定位 travel_in 地区类型外，支持定位定位参数，按地区定位中提到的所有地理区域。
• 使用 STORE_VISITS 目标（仅限有限的用户使用）创建广告时，请参阅店铺访问量

广告组，目标位置类型

这反映了广告链接跳转到的目标位置类型，即用户点击广告或其中的行动号召后将去往哪里。对广告组中的所有广告而言，这为它们提供了一个统一的目标位置类型，因此它们只在广告创意类型上有所区别。请参阅广告组，目标位置类型。

• 为广告组添加了 destination_type
• 在 /ADSET_ID 中可用

关键表现指标

向 AD_ACCOUNT_ID/CAMPAIGN_ID 添加了新字段 kpi_type，说明您想为广告系列或其中的广告目标追踪的关键表现指标类型。要在 kpi_results 中查看按 kpi_type 分类的成效分析数据，请执行以下调用：

• GET CAMPAIGN_ID/insights
• GET ADSET_ID/insights
• GET AD_ID/insights

详情请参阅广告系列，参考文档。

重大变更

广告管理

• 无效广告定位right_hand_column - 在 AD_ACCOUNT_ID/adsets 向 right_hand_column 版位投放无效的广告创意时会返回错误消息。我们不允许在只选择 right_hand_column 版位的情况下投放视频广告、精品栏广告或全屏广告。在只选择 right_hand_column 版位的情况下，您只能使用单图片和轮播两种格式。

• 更改了GET VERSION/RF_PREDICTION_ID/pause_periods - 现在会返回 Array（而非 String），以便简化操作。

商务管理平台 API

• 重命名字段 — admin_system_user 字段已重命名为 admin，system_user 字段已重命名为 employee。这将对以下连线造成影响：

  • /{business-id}/userpermissions
  • /{business-id}/system_users

停用内容

广告管理

停用了VIDEO_VIEWS 的某些优化目标 - 以 VIDEO_VIEWS 为目标创建的广告系列无法再使用CLICKS、IMPRESSIONS、PAGE_ENGAGEMENT、POST_ENGAGEMENT 和 REACH 等优化目标：

• 使用以上优化目标创建广告组时会返回错误消息。
• 复制使用 REACH 作为优化目标的广告组时，系统会自动将优化目标改为 VIDEO_VIEWS。
• 复制使用 CLICKS、IMPRESSIONS、PAGE_ENGAGEMENT 或 POST_ENGAGEMENT 作为优化目标的广告组时会返回错误消息。这是因为在现有广告组中创建或复制广告时会再次尝试使用相同的优化目标。

此项变更会影响以下连线：

• POST ACCOUNT_ID/adsets
• POST AD_ACCOUNT_ID/ads
• POST CAMPAIGN_ID/copies
• POST ADSET_ID/copies
• POST AD_ID/copies

品牌知名度目标停用了reach这一 optimization_goal。在 /adset 中被移除；只有在优化广告回想度时可用。这样可避免与使用覆盖人数作为专用目标的情况产生混淆。

已停用的优化目标：BRAND_AWARENESS - 已替换为 AD_RECALL_LIFT。这体现了一种更为高效的新广告投放模式。新的优化目标支持使用创意组合，例如在同一广告组中创建静态广告和视频广告，以及使用手动竞价。以下各项已不再支持使用 BRAND_AWARENESS：

• POST /ADSET_ID
• GET /ADSET_ID
• POST /AD_ACCOUNT_ID/adsets

已停用：frequency_cap - 包括以下各项的 lifetime_frequency_cap 和 frequency_cap_reset_period 字段：

• POST AD_ACCOUNT_ID/adsets
• GET /ADSET_ID
• POST /ADSET_ID

改用 frequency_control_specs。

已停用单次操作费用：POST_ENGAGEMENT - 您无法再使用 POST_ENGAGEMENT 作为此目标的 billing_event。这样可提升广告投放和成效衡量的一致性。/AD_SET_ID 端点将受此影响。

广告成效分析和成效衡量

已停用以下各项的 video_15_sec_watched_actions：

• GET AD_ACCOUNT_ID/insights
• GET CAMPAIGN_ID/insights
• GET ADSET_ID/insights
• GET AD_ID/insights
• POST AD_ACCOUNT_ID/insights
• POST CAMPAIGN_ID/insights
• POST ADSET_ID/insights
• POST AD_ID/insights

已停用来自高阶成效衡量 API 的 recurrence_value。此字段在 Atlas API 中也被称为定期报告。我们已将其替换为 recurrence_values。请参阅高阶成效衡量，定期报告。

商务管理平台管理

重新设计后的商务管理平台 API 已停用以下端点：

• BUSINESS_ID/userpermissions
• BUSINESS_ID/business_persona
• business_persona_id

已停用以下用于管理资产的端点：

• BUSINESS_ID/pages
• BUSINESS_ID/adaccounts
• BUSINESS_ID/product_catalogs
• BUSINESS_ID/apps

要访问资产，请使用 BUSINESS_ID/owned_ASSET 或 BUSINESS_ID/client_ASSET

已停用以下用于管理其他商务管理平台所拥有资产的端点：

• BUSINESS_ID/assigned_ad_accounts
• BUSINESS_ID/assigned_pages
• BUSINESS_ID/assigned_product_catalogs

改用 BUSINESS_USER_ID/assigned_ASSET

立即停用的内容

这些内容的停用日期为 2017 年 11 月 14 日，且会影响所有 API 版本。

活动广告和链接式广告

已停用未提供有效页面链接的活动广告或链接式广告的创建和编辑功能。以下格式已失效，如若使用将返回错误消息。

将要停用的签名：

• 活动广告

  • 目标：EVENT_RESPONSES
  • 创意字段：body、object_id
• 链接式广告

  • 目标：LINK_CLICKS
  • 创意字段：title、body、object_url（image_file 或 image_hash）

支持的签名

• 活动广告

  • 目标：EVENT_RESPONSES
  • 创意字段：object_story_id 或 object_story_spec
• 链接式广告

  • 目标：LINK_CLICKS
  • 创意字段：object_story_id 或 object_story_spec

在此变更生效后，您先前所创建的现有活动广告和链接式广告将继续投放，不过您将无法修改广告创意，也不能新建广告，否则将收到错误消息。请参阅活动广告和本地广告以及广告，参考文档。