预订方案

预订方案可提供经过优化的覆盖人数，会对广告的展示频次实施控制，同时帮助您预测广告系列的表现，因此让您能以固定费用规划和购买广告系列。这类似于传统的电视广告购买方式。这是一种专用的高级购买方案，大部分广告主仅在想要高度确保广告能够覆盖特定数量的帐户管理中心帐户时使用这种方案。

预订方案适用于各种广告类型和设备。Meta 的广告定位功能以真实的人为基础，而非以 Cookie 为基础，因此我们能够更加准确地预测覆盖人数并控制广告在不同设备中的展示频次。

限制

• 仅面向特定广告帐户开放。请查看广告帐户的 CAN_USE_REACH_AND_FREQUENCY 参数。
• 广告组的 stop_time 必须在预估的 180 天以内。
• 帐户还有国家/地区限制；通过向 https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>?fields=rf_spec 发出 GET API 调用，可查看限制详情。
• 在 target_spec 中，一次只能设置一个国家/地区。
• user_os 没有最低 iOS 版本要求，如 iOS_ver_2.0_and_above。
• 在创建或更新预订广告系列时，您不能设置总预算或单日预算、总展示次数或单日展示次数限制、频次上限或外部竞价，抑或字段 PacingType。

搜索 rf_spec，了解适用的限制：

结果如下所示：

{
  "rf_spec": {
    "min_reach_limits": {
      "US": 1000000,
      "CA": 1000000,
    },
    "countries": [
      "US",
      "CA",
    ],
    "min_campaign_duration": {
      "US": 3,
      "CA": 3,
    },
    "max_campaign_duration": {
      "US": 30,
      "CA": 30,
    },
    "max_days_to_finish": {
      "US": 56,
      "CA": 56,
    }
  }
}

创建预估

预估包含广告根据特定的覆盖人数、频次、受众和预算，在某个日期范围内能够覆盖的帐户管理中心帐户数量。预订预估可帮助您模拟广告系列的总成效，并会根据您的目标、预算、受众、格式和版位、品牌安全、表现目标和频次控制设置进行调整。

支持在预订后编辑预订广告系列。但是，该广告系列一旦投放，便无法编辑或暂停，除非更换广告创意。如果只编辑广告创意，则预估数据不会改变。您可以通过删除该广告系列来取消和停止该系列，但是您将需要重新预订该系列，届时您可能会收到新的千次展示费用和有关该广告系列成效的预估数据。请仅预订您想要投放的广告系列。**如果是进行测试，请将预订限制为最小规模和最短时长；确保取消预订，因为我们为您预留的是真实广告库存。

限制

预估的默认限制如下：

• 至少 30 万个帐户管理中心帐户的目标受众。
• 最少 20 万个帐户管理中心帐户的覆盖数量。
• 广告组的投放天数必须至少为 1 天，至多为 90 天（根据广告系列投放跨越的天数计算天数。举例而言，如果广告系列在第 1 天的中午 12:00 开始投放，在第 2 天的上午 10:00 结束投放，尽管两个时间之间的差值不足 24 小时，但广告系列的投放天数为 2 天）。
• 广告组的停止时间必须在预估的 180 天以内。
• 广告系列的投放必须在广告帐户时区的最后一天早上 6 点以后结束。

读取预估数据

如需获取详情，请指定字段。如要查看一个帐户的所有 reachfrequencyprediction，请向 https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions?fields={COMMA_SEPERATED_FIELD_LIST} 发出 HTTP GET 请求。

如要根据 reachfrequencyprediction 编号获取所有 reachfrequencyprediction，请发出 HTTP GET 请求并添加您需要的字段：https://graph.facebook.com/{API_VERSION}/{RF_PREDICTION_ID}?fields={COMMA_SEPERATED_FIELD_LIST}。

默认情况下，Meta 会返回该编号。如需获取字段详情，请参阅“预订预估”下的“读取”部分。

响应状态代码

下方列出了 reachfrequencyprediction 中可能的 status 结果。适用时会显示初始限制，但今后，每个广告帐户或国家/地区的初始限制可能会有所不同：

使用预估数据

输入内容时提供预估编号及其数据，以创建新编号并以此作为预订编号，然后将此预订编号附加至广告组中。创建预订会让他人无法使用库存，因此您应该在预订过期之前将其附加至广告组。

如果预订成功，我们将暂时为您保留库存。预订后，您需要在大约一个小时内将广告分配给广告组。

预订

您可以为广告组预订预估数据，以锁定价格并获得可预测的覆盖人数。通过将 action 设置为 reserve，在一段固定时间内预订通过 reachfrequencyprediction 确定的受众。您可以使用一个预估编号创建多个预订。例如：

curl \
-F 'action=reserve' \
-F 'rf_prediction_id=<RF_PREDICTION_ID>' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'
 
// Response 
{"id":9876543210"}

如要根据预估数据预订库存，请向 https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions 发出 POST API 调用。

对于 reach、budget 和 impression，您可以预订 curve_budget_reach 上特定点的预估数据，而非预估覆盖人数/预算的原始元组。使用以下字段：

Meta 会以异步方式预订预估数据，您应该轮询并检查预估的状态。最初的预估数据状态为 2 (PENDING)。预估完成后，状态为 1，SUCCESS 或 15，FAIL，后者意味着系统缺少库存，无法完成此预订。

预订系统是动态变化的，因此您可能会发现预估时间和预订时间之间的库存可用性会有细微变化。然而，Meta 会遵守您在预估时间获得的值，前提是变化在合理的阈值范围内。

分配至广告组

成功预订预估数据后，您可以使用此预估数据创建广告组：

curl \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"

如要成功分配预估数据，您的广告组必须符合下列条件：

• 不要指定：
• start_time - 来源于预估数据
• end_time - 来源于预估数据
• targeting - 来源于预估数据
• bid_amount
• optimization_goal
• lifetime_budget 或 daily_budget
• 您可以将预订分配给无投放中广告的广告组。然而，在广告组开始投放之前，您必须至少有一个投放中的广告。
• 您必须加入 rf_prediction_id，它会将预估数据附加至新的广告组。
• buying_type 的广告系列属性为 RESERVED

您还可以将 reachfrequencyprediction 附加至广告组，以修改广告组的预估数据。向 https://graph.facebook.com/{ad_set_id} 发出 POST 请求，并添加您想使用的 reachfrequencyprediction 的 rf_prediction_id。

下面是关于广告组的限制：

• 发行商开放平台选项：facebook、instagram。
• Facebook 版位选项：feed 和 rightcolumn。
• Instagram 版位选项：stream、story、explore、explore_home 和 reels。如果版位包含 instagram，则您必须使用 destination_ids，而非 destination_id。destination_ids 字段应包含用作 destination_id 的 Facebook 公共主页编号，以及 Instagram 帐户编号。
• 可以使用自定义受众或合作伙伴类别，但不能同时使用两者
• 不允许使用网站自定义受众、粉丝或视频互动用户排除定位。
• 广告组的 promoted_object 必须与预估的 destination_id 一致。对于公共主页帖子，必须为指定的公共主页编号；对于应用广告，必须与指定的应用编号相符。
• 支持标准和排期广告投放期预估，但不支持加速投放。

我们会根据实际的展示次数收取预订广告系列的费用。如果广告系列的开始时间已过，但对应广告组内没有投放中的广告，则该广告系列不会投放，也不会产生任何费用。Meta 会释放剩余的库存，但如果再次发生这种情形，我们可能会对该广告帐户给予处罚。

使用 Meta 预订购买类型创建广告系列时，即表示您同意为预订的广告库存支付建议的费用。如果您更改受众规模或广告展示频次，则您的费用也会相应地变化。广告系列开始投放之前，您可以随时做出这些更改。您还可以在广告系列开始投放之前编辑广告创意。

管理广告

预订广告组可包含多条广告，您可以随时添加更多广告。如果广告组处于投放状态，但其中不包含投放中的广告，则您必须在 24 小时内为持续 3 到 30 天的广告组创建第一条广告，或者在 6 小时内为持续 1 到 2 天的广告组创建第一条广告。如若不然，我们会删除预订。

分离预估，修改广告组

您可以在预订广告系列开始投放前编辑或暂停预订广告系列。广告系列开始投放后，您只能编辑广告创意、预算或延长结束日期。如果只编辑广告创意，则预估数据不会改变。

如果您更改预算或结束日期，则可能会生成新的广告系列预估数据，您可在预订预估值中查看。

您无法在预订广告系列开始投放后暂停广告系列，但可以随时删除广告系列以将其取消。

如要暂停或编辑已经开始投放的广告组，请参阅暂停或重新开始投放广告组和编辑投放中的广告组。如要删除投放中的广告组，请参阅参考文档下的“广告组”部分。我们将根据广告获得的全部展示次数向您收费。

请注意，为避免可能发生的失败情况，当预订广告组已发布时，我们强烈建议您不要删除所有广告。

如果您将预订分配给未开始投放的广告组，除非分离预订，否则您无法更改大部分属性。向广告组发出 HTTP POST 请求，并将 rf_prediction_id 设置为 0。您只能修改广告组对象的 name 属性。

如要分离预订：

curl \
-F "rf_prediction_id=0" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"

广告组的状态变为投放中后，便无法分离预订，也无法修改广告组的属性，几个加入白名单的广告属性除外，如下所列：

• name
• creative_id
• creative_spec
• conversion_specs
• tracking_specs
• view_tags

暂停或重新开始投放广告组

您可以暂停投放中的广告组，请参阅参考文档下的“广告组”部分。如果广告组的暂停时间超过 30 分钟，此广告组的预估数据将无法得到保证。

如要恢复暂停时间超过 30 分钟的广告组，您需要新的预估数据。向 reachfrequencypredictions 发出 POST 请求。请参阅创建预估和预订预估。您应该在请求中传递要恢复的投放中广告组的 existing_campaign_id。创建和预订新的预估后，向 https://graph.facebook.com/{ad_set_id} 发出 HTTP POST 请求，并指定您想使用的预估的 rf_prediction_id，将 reachfrequencyprediction 附加至广告组。

编辑投放中的广告组

您可以在广告组开始投放后进行下列更新。

• 增加或减少广告组的预算和覆盖人数。预算应大于当前的花费，覆盖人数应大于已获得的覆盖人数。
• 将广告组的排期延长至 90 天。

如果投放中的广告组符合下列条件之一，您即无法编辑或暂停此广告组：

• 投放量严重不足。投放次数低于预估的 10%。广告组的花费超支，即超出预算
• 广告组仅投放一天
• 广告组在接下来 24 小时内投放结束

如要编辑投放中的广告组，请获取新的预估数据。请参阅创建预估和预订预估。您应该在请求中传递要恢复的投放中广告组的 existing_campaign_id。

创建并预订新的预估后，您可以向 https://graph.facebook.com/{ad_set_id} 发出 HTTP POST 请求，并指定 rf_prediction_id 为您想使用的 reachfrequencyprediction 的编号，将 reachfrequencyprediction 附加至广告组。

重复使用预订的受众

如果您取消预订，系统将释放预订的库存，将其提供给其他广告主。然而，您可以使用之前预订的预估中的受众，前提是您还未使用这组受众。这样，我们可以考虑使用其他库存来创建预估，而您不必取消当前的预订。

创建预订时应添加 rf_prediction_id_to_share。这是之前预估的编号。这样会让之前的预订失效，以便您能够将此库存用于新创建的预订。

如要预订新的预估，您还必须传递额外的参数 rf_prediction_id_to_release，此参数是指之前预订的编号。

广告轮换和排序

您可以轮换所使用广告组中的广告。为此，您无需从对应广告组中分离预订。向广告组添加一条或多条广告，并等待其状态变为投放中。此时，您可以将初始广告的状态更改为暂停。广告组中必须至少有一条投放中的广告。

您可以设计广告排序，按照顺序投放广告。首先创建广告组和广告，然后通过 creative_sequence 在广告组层级指定排序。根据排序，此广告组中的每条广告可能出现不在队列中投放、在队列中投放一次或投放多次的情况。

如果 creative_sequence 数组长度为零，则表示您未使用排序投放功能。如果数组长度为非零，则建议您将其设置为等于 rf_prediction_id 中的 frequency_cap。如果长度大于 frequency_cap，我们会从数组中截去最后几条广告。如果长度小于 frequency_cap，我们会从头重复排序，以递归的方式自动填充数组。为获得更清楚的结果，建议将 creative_sequence 的长度设置为与 frequency_cap 相同的数字。

序列中每一条广告都可能有 ACTIVE、PENDING_REVIEW 或 CREDIT_CARD_NEEDED 状态。对于序列中的某一条广告而言，只有当其前面的所有广告都获得投放后，系统才会向用户投放这条广告。系统不会投放未包含在 creative_sequence 内的广告。

广告组中使用广告排序的所有广告（无论是否位于序列中），均无法暂停、归档或删除。

此功能仅适用于预订广告组，即其父广告系列的 buying_type 为 RESERVED，且此广告组设置有 rf_prediction_id。

如需获取更多详情，请参阅广告组文档。

Instagram 预订

对于 Instagram 上的可预测覆盖人数，您可以将 buying_type 设置为 RESERVED，创建预订广告系列。

预订可优化覆盖人数、广告回想度提升和 ThruPlay，从而帮助您规划和预订知名度和互动广告系列。

广告管理工具中的覆盖人数预估和 API 可以为合作伙伴提供合理预期的指导。我们会优先考虑 Instagram 社群，尽力以妥当的方式实现覆盖人数目标，并期望随着时间的推移而发展。适用于使用 Facebook 预订预估的所有政策也适用于 Instagram。

错误代码

示例

为应用 destination_id 创建 reachfrequencyprediction：

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook"], "facebook_positions":["feed"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_id=<APP_ID>' \
-F 'prediction_mode=1' \
-F "objective=MOBILE_APP_INSTALLS" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

为公共主页 destination_id 创建 reachfrequencyprediction：

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook"], "facebook_positions":["feed"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_id=<PAGE_ID>' \
-F 'prediction_mode=1' \
-F "objective=POST_ENGAGEMENT" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

为使用 Instagram 版位的应用 destination_id 创建 reachfrequencyprediction：

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook","instagram"], "device_platforms":["mobile"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_ids=[<APP_ID>,<INSTAGRAM_ACCOUNT_ID>]' \
-F 'prediction_mode=1' \
-F "objective=MOBILE_APP_INSTALLS" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

通过 HTTP GET 请求轮询下列端点，检索状态，直至获得 2 以外的状态：

https://graph.facebook.com/67890123456?fields=status

如果状态为 1（成功），则可以将此预估附加至广告组或预订此预估。

预订预估：

curl \
-F 'action=reserve' \
-F 'rf_prediction_id=<RF_PREDICTION_ID>' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'
 
{"id":"9876543210"}

通过 HTTP GET 请求轮询下列端点，检索状态，直至获得 2 以外的状态：

https://graph.facebook.com/<API_VERSION>/<PREDICTION_ID>?fields=status

如果状态为 1（成功），则可以将此预估附加至广告组。接下来，我们将创建广告系列、广告组、广告创意、广告，并向广告组分配预订，以此设置广告架构。

创建广告系列：

curl \
-F "name=Test" \
-F "buying_type=RESERVED" \
-F "status=ACTIVE" \
-F "objective=POST_ENGAGEMENT" \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

{"id":"1122334455"}

创建广告组：

curl  \
-F "name=TestReachSet" \
-F "status=1" \
-F "campaign_id=<CAMPAIGN_ID>" \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets"

{"id":"09876543"}

生成广告创意：

curl \
-F "name=sample creative" \
-F "type=1" \
-F "title=hello world" \
-F "body=hi i'm an ad" \
-F "link_url="https://www.facebook.com/" \
-F "image_hash=4aca812b4eadb72818a2c4124abd121a" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives"

{"id":"1323123123123"}

创建广告：

// Create an ad
curl \
-F "name=my ad" \
-F "adset_id=<AD_SET_ID>" \
-F "creative={'creative_id':<CREATIVE_ID>}" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads"

{"id":"3213213123"}

向广告组分配新的预估：

curl \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"