預訂

預訂能使您以固定成本，計畫及購買行銷活動，提供最佳化觸及人數及控制的廣告頻率，同時幫助您預測行銷活動的成效。這與用戶以往購買電視廣告的形式類似。這是一個特殊的進階選項，大多數廣告主只有在想要加強保證其廣告觸及人數能達到特定帳號管理中心帳號數時，才會使用這個選項。

預訂可用於各種廣告類型及裝置。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,
    }
  }
}

建立預測資料

預測資料含廣告在某個日期範圍內能夠觸及的帳號管理中心帳號數，以指定觸及人數、曝光頻率、分享對象以及預算為準。預訂估計值可幫助您模擬行銷活動的生命週期結果，並會根據您的目標、預算、廣告受眾、格式和版位、品牌安全、成效目標和頻率控制設定進行調整。

預訂後可以對預訂行銷活動進行編輯，但除非切換廣告創意，否則行銷活動一旦開始後，您便無法編輯或暫停。如果您只變更廣告創意，您的預測結果並不會改變。您可以刪除行銷活動來取消和停止，但需要重新預訂行銷活動，如此您可能會收到新的 CPM 和行銷活動成果預測。請只預訂您有意願刊登的行銷活動。** 若要執行測試，請將預訂的行銷活動規模及期間縮至最小；由於我們會替您保留實際廣告供應量，因此請務必取消測試行銷活動。

限制

預測資料的預設限制如下：

• 目標廣告受眾至少 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 結果。初始限制會在適用時出現，但日後可能會依據各廣告帳號或國家／地區而有所不同：

使用預測資料

輸入時提供您的預測資料編號及其資料，建立一個新編號，新編號的作用是預訂編號。接著將這個預訂編號附加在廣告組合中。建立預訂後，他人便無法使用您預訂的廣告供應量，因此您應該在預訂內容過期前附加編號。

倘若預訂成功，我們會替您暫時預留庫存。您可以在預訂後約莫一小時內指派廣告所屬的廣告組合。

預訂

為廣告組合預訂預測資料，以鎖定價格並取得可預測觸及人數。使用 reserve 預訂 reachfrequencyprediction 認定的分享對象，在既定時間內進行 action。您可以使用單一預測編號來建立多個預訂。例如：

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（處理中）。完成後，狀態會是 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 附加於廣告組合，用於修改其預測資料。發出 POST 要求，用於：https://graph.facebook.com/{ad_set_id}，rf_prediction_id 是您要使用的 reachfrequencyprediction。

以下是對廣告組合的限制：

• 發佈商平台選項：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 天，至於持續 1 到 2 天的廣告組，則需在 6 小時內建立第一則廣告。若您未照做，我們將會刪除預訂資料。

移除預訂資料，修改廣告組合

您可以在預訂行銷活動開始之前，編輯或暫停行銷活動。行銷活動開始後，您只能編輯廣告創意、預算，或延後結束日期。如果您只變更廣告創意，您的預測結果並不會改變。

如果變更預算或結束日期，這可能會產生新的行銷活動預測資料，您將會在預訂估計值中看到該預測資料。

您無法在預訂行銷活動展開之後暫停，但隨時可以刪除行銷活動來取消活動。

若要暫停或編輯已經開始的廣告組合，請參閱暫停或重新開始刊登廣告組合，以及編輯刊登中的廣告組合。要刪除刊登中的組合，請參閱廣告組合：參考。我們會依據廣告獲得的曝光次數向您收費。

請注意，為避免可能發生失敗，強烈建議您不要在預訂廣告組合上線時刪除所有廣告。

如果您在廣告組合啟用之前，先行指派預訂至該廣告組合，那麼除非您移除預訂，否則將無法變更大部分的屬性。對組合發出 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 傳遞給進行中的廣告組合，讓廣告組合在要求中重新啟用。在您建立並預訂新的預測資料後，請將 reachfrequencyprediction 附加於廣告組合，並對以下目標發出 HTTP POST：https://graph.facebook.com/{ad_set_id}（指定您要使用之預測資料的 rf_prediction_id）。

編輯刊登中的廣告組合

您可以在組合開始之後進行這些更新。

• 增加或減少廣告組合預算與觸及人數。預算或觸及人數應高於目前花費或已達成的觸及人數。
• 將廣告組合排程延長至 90 天。

您無法編輯或暫停符合以下任何一項標準的刊登中組合：

• 投遞效果極差。投放完成度不到預測資料的 10%。花費超支組合（花費超出預算）
• 只刊登一天的廣告組合
• 即將在 24 小時內結束的廣告組合

若要編輯刊登中的廣告組合，請建立新預測資料。請參閱建立預測資料與預定預測資料。您應將 existing_campaign_id 傳遞給進行中的廣告組合，讓廣告組合在要求中重新啟用。

建立新預測資料並完成預訂後，您可以將 reachfrequencyprediction 附加至廣告組合，方法是對以下目標發出 HTTP POST 要求：https://graph.facebook.com/{廣告組合編號}（指定以 rf_prediction_id 做為您要使用之觸及人數頻率預測資料的編號）。

重複使用已經預訂的分享對象

若您取消預訂資料，就會開放其他廣告主預訂您原本預訂的庫存。不過，您可以重複使用之前預訂之預測資料的分享對象，前提是您尚未使用該分享對象。如此一來，我們建立預測資料時就能考量其他廣告供應量，您也不必取消現有的預訂內容。

在您建立預訂資料時加入 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"}

建立應用程式 destination_id 的 reachfrequencyprediction（有 Instagram 版位）：

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