版本 3.0

市场营销 API

发布日期 2018 年 5 月 1 日 | 停用日期 2019 年 2 月 1 日 | 博文

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

新功能

最低成本竞价策略，bid_strategy 字段

我们为 {account-id}/adsets 引入了新字段 bid_strategy，您可以使用该字段根据自己的业务目标选择广告竞价策略。每种策略都有利有弊。选项包括：

• LOWEST_COST：根据您的广告组预算和投放量 optimization_goal 获取最多的结果。Facebook 将根据需要自动提高竞价，以花费您的预算。您可以使用此选项为竞价提供最大值或不设限制。

• TARGET_COST：在您增加广告组预算时，为广告提供稳定的平均成本。

如需了解更多信息，请参阅“广告购买和优化”下的“竞价策略”部分

精品栏广告，创建

用于创建精品栏广告的新 API：过去，每当您创建一条精品栏广告时，Facebook 都会在背景中相应地创建一条全屏广告。这限制了您对这条底层全屏广告的访问，而且您也无法使用该条广告重新定位与全屏广告互动的受众。现在，根据商品系列创建精品栏广告时，您还必须明确创建一个包含正确元素的全屏广告。当您在精品栏广告中使用此全屏广告时，Facebook 会自动生成精品栏广告。如需了解更多详细信息，请参阅根据商品系列创建精品栏广告部分。

重大变更

广告管理

• 右栏失效 - 我们会使仅投放在 Facebook 版位上的广告，以及在 {ad_account_id}/adsets 上含有 right_hand_column 无效目标的 right_hand_column 失效。现在，我们仅对具有以下目标的受支持广告格式支持右侧版位：流量、转化量和商品目录促销。

• 在 v3.0 及更高版本中，已在 GET 和 POST 中停用 is_autobid 和 is_average_price_pacing。

受众和广告定位

• 更改了自定义受众的规则语法 - 我们更新了用于创建网站自定义受众、移动应用自定义受众、页面互动自定义受众、线索广告互动受众、全屏广告互动受众及线下自定义受众的规则的结构。这使得您可以根据聚合行为创建规则、根据不同的事件来源创建规则以及排除规则。请参阅：

  • 网站自定义受众，受众规则、

  • 移动应用自定义受众，受众规则、

  • 页面互动自定义受众、

  • 线索广告的互动受众、

  • 全屏广告互动受众及

  • 线下转化自定义受众。

动态广告

• 商品目录访问：如要访问目录商品，您必须指定正确的目录垂直领域。如果您的请求与目录的正确垂直领域不匹配，则您将收到错误消息。例如，如果您有电子商务目录，则应该使用相应的 /products 端点（例如，GET {catalog_id}/products、GET {product_feed_id}/products 或 GET {product_set_id}/products）访问它。您无法使用其他垂直领域的端点（例如，GET {catalog_id}/autos、GET {product_feed_id}/hotels 或 GET {product_set_id}/flights）访问该目录。

• 模板标签中的空字符串：我们不再允许将空字符串用作动态广告的模板标签选项的参数。例如，如果向 {{trip.checkin_date date_format:}} 传递一个空字符串，则您将收到错误消息。如需了解背景资料，请参阅动态广告下的广告管理部分。

广告成效分析和成效衡量

• 成效分析超时：如果预计成效分析 API 请求会在完成前导致超时，则我们将返回错误代码为 100 且子代码为 1504033 的错误。我们会根据请求大小以及相对于超时限制的处理进度对此进行估算。如果您收到此错误消息，则应该对此数据进行成效分析 API 异步请求。请参阅成效分析 API 异步任务部分。

• 事件数据中的负值：如果您将具有负值的事件数据发布到 {data_set_id}/events，则它将失败。这会影响 POST /{data_set_id-id}/events 的 data 字段。

• 对广告系列预算优化的成效分析：当您的广告系列使用广告系列预算优化时，adset_budget_value 现在会返回 using campaign budget。这会影响：

  • GET {adaccount-id}/insights、

  • GET {campaign-id}/insights、

  • GET {adset-id}/insights、

  • GET {ad-id}/insights、

  • POST {adaccount-id}/insights、

  • POST {campaign-id}/insights、

  • POST {adset-id}/insights、

  • POST {ad-id}/insights。

• Pixel 像素代码的默认排序：如果您在业务帐户或广告帐户中调用 GET {account_id}/adspixel 连线，则我们将返回按默认值（即，Pixel 像素代码名称）而不是按 Pixel 像素代码触发时间排序的结果。

• 重命名 Pixel 像素统计数据字段：我们已将 Pixel 像素统计数据连线上的 timestamp 字段重命名为 start_time。这表示我们在 Pixel 像素触发时汇总每小时数据的开始时间。现在，我们以 ISO 8601 格式返回此时间并包含时区偏移。这解决了返回无效 Unix 时间戳的问题。以下端点将受到影响：GET {ads-pixel-id}/stats。

停用内容

商务管理平台

已停用 POST {pixel-id}/shared_agencies 端点。请使用商务管理平台用户界面与代理商分享广告像素。.

广告管理

• 已停用 /{ad_campaign_id} 和 /ad_account_ID/campaigns 中的 kpi_custom_conversion_id、kpi_type 及 kpi_results。

• 已停用下列端点中的“redownload”标记，以简化 API：

  • POST {ad-id}/、

  • POST {adset-id}/、

  • POST act_{ad-account-id}、

  • POST act_{ad-account-id}/ads、

  • POST act_{ad-account-id}/adsets

  您仍然可以使用“fields”参数读取此信息。

• 已停用 POST act_{ad-account-id}/adimages 中的字段 zipbytes 并移除了在该连线中上传 ZIP 文件的功能。请使用具有以下扩展名的图像：jpg、jpeg、gif、bmp、png、tiff 或 tif。

• 已停用当前用于创建精品栏广告的方法，该方法使用一次 API 调用并且所有必需素材都用作参数。现在，您需要改为先创建全屏广告，然后使用全屏广告链接创建精品栏广告。这使得您可以访问底层全屏广告对象以便执行一些操作，例如重新定位受众。请参阅精品栏广告部分。

• 已对具有公共主页帖文互动目标的广告停用轮播广告格式。此组合不再有效。请参阅验证下的目标和创意部分。

广告购买和竞价

• 已停用端点 POST {ad-account-id}/adsets 和 POST {adset-id} 中的字段 is_autobid 及 is_average_price_pacing。改为使用新的 bid_strategy 字段为广告组指定特定竞价策略。如需获取更多信息，请参阅竞价和优化部分。

• 已对广告和广告帐户停用 delivery_estimate 下的字段。结果不满足广告主的需求。此外，Facebook 建议的竞价金额可能无法最好地实现很多广告主的业务目标。已停用的字段和参数包括：

  • bid_estimate 字段、

  • currency 参数、

  • daily_budget 参数、

  • optimize_for 参数

  我们推荐您使用通过 Facebook 广告获得的真正的内在商业价值以及基于此价值的竞价。如果您尚不了解此价值，我们建议您使用自动竞价。如需了解背景信息，请参阅广告帮助中心下的广告竞拍部分和广告购买和优化部分。

• 已停用从 GET /{rf-prediction-id} 的 curve_budget_reach 字段中返回的结果。现在会返回地图，并且已停用 JSON 序列化字符串返回值。这会影响：GET /{rf-prediction-id}。

• 已停用连线 GET /{ad-account-id}/ratecard。

• 已停用与 /ad_accounts 中的账单相关的多个字段。其中包括：

  • next_bill_date

  • active_billing_date_preference

  • pending_billing_date_preference

  • active_asl_schedule

  • salesforce_invoice_group_id

  • transactions

  • adspaymentcycle

  • show_checkout_experience

• 已停用 pixel_id 和 external_event_source 字段 GET /customaudience。

广告成效分析和成效衡量

• 已停用 OFFLINE_EVENT_SET_ID 中由 GET /{data-set-id} 和 GET /{data-set-upload-id} 返回的 matched_unique_users。请参阅线下转化 API 部分。

• 已停用 attributed_events 连线以及 GET /{data_set_id} API 中的 attribute_stats 字段。可以使用 GET /{data_set_id}/stats API 获取归因事件统计数据。

• 已停用 OFFLINE_EVENT_SET_ID 中由 GET /{data-set-id} 和 GET /{data-set-upload-id} 返回的字段 matched_unique_users。

• 已停用 GET {data_set_upload_id} 的默认返回值。默认情况下，此项不再返回以下字段：first_upload_time、last_upload_time、api_calls、valid_entries、matched_entries、duplicate_entries、event_time_min、event_time_max、event_stats 和 matched_unique_users。

• 已停用 GET {data_set_id}/stats 的默认返回值。默认情况下，此项现在仅返回计数统计数据。如要指定应返回的统计数据，请对 average_upload_delay 等累计统计数据使用 fields 参数或 summary 参数。

• 已停用 GET {data_set_id} 的默认返回值。默认情况下，此项不再返回以下字段：attribute_stats、duplicate_entries、event_stats、event_time_max、event_time_min、matched_entries、matched_unique_users、usage 和 valid_entries。

• 已停用连线 GET {data-set-upload-id}/stats。请改为使用 GET {data-set-upload-id} 中的 valid_entries 或 matched_entries 字段。

• 已停用成效分析 API 中的 canvas_component_avg_pct_view。