Facebook 圖形 API 第 16.0 版和行銷 API 第 16.0 版隆重登場

今天我們將推出 Facebook 圖形 API 第 16.0 版和行銷 API 第 16.0 版。以下將重點介紹我們認為此版本對部分開發人員社群較為重要的變更。這些變更包括公告、產品更新，以及您整合至我方平台的應用程式相關淘汰項目通知。

如需所有變更及細節的完整清單，請瀏覽我們的變更紀錄。

一般公告與更新

WhatsApp Business 平台錯誤回應

在我們持續努力地改善 API 錯誤回應行為的過程中，我們進行了以下變更。

• 錯誤子代碼很少使用且不應該加以依賴，其將不再包含在 16.0 以上版本的錯誤回應中。請改用 code 和 details。
• 錯誤代碼 100（"code":100）具有多個不重複標題，可指出指定錯誤的性質。所有代碼 100 錯誤現在都將使用 Invalid Parameter（無效的參數）作為其標題。描述指定代碼 100 錯誤性質的舊標題已移至 details 屬性。此變更現在也反映在描述代碼 100 錯誤回應的 Webhooks 裝載中。
• Webhook 錯誤物件擁有新的 message 屬性，該屬性對應到 API 錯誤回應裝載中的 message 屬性。

開發人員平台現在需要商家驗證才能取得任何 API 的進階存取權限

依據我們於 2023 年 2 月 1 日公告的事項，Meta 現在會要求開發人員必須進行商家驗證，才能獲得 Meta 開發人員平台上的任何進階存取權限，此程序有助於我們確認企業或組織的真實性和合法性。

針對在 2023 年 2 月 1 日後建立的應用程式，我們將在新的應用程式要求進階存取權限時，開始逐步推出此程序。從 2023 年 5 月 1 日開始，於 2023 年 2 月 1 日之前建立之具有進階存取權限的應用程式，必須連結至已驗證的商家。若要查看需要商家驗證才能獲准進階存取的權限清單，請參閱此頁面。

淘汰項目與重大變更

停用觸動旅遊考量

我們在 2018 年推出了「觸動旅遊考量」作為旅遊業廣告主可開啟的切換開關，該功能可將廣告優先向展現旅遊意願但尚未決定旅遊目的地的用戶投遞。觸動旅遊考量解決方案不僅能與既有的目標設定選項完美相容，可協助廣告主在適當時機向 Facebook、Instagram 和 Audience Network 平台上的理想用戶投遞廣告。在過去 4 年，我們透過持續開發自家的機器學習系統和進行大量測試，現在能夠協助旅遊業廣告主觸及有旅遊意願的消費者，且無須啟用觸動旅遊考量選項就能實現相近的成效目標。

自 2023 年 2 月 2 日起，「觸動旅遊考量」切換開關將會移除，不再是廣告管理員和新行銷活動的 API 中的選項。我們認為已不再需要該切換開關，且預期廣告主無須切換開關即可達到相同成效。在此期間，開啟或關閉切換開關不太可能會顯著地影響行銷活動成效。

隨著機器學習模型的改進，現在無須切換開關作為選項即可達成相同的目標與成效，因此我們認為移除它將能提供更順暢的體驗。

淘汰開發潛在顧客的航班廣告

我們在 2018 年 9 月成功推出了開發潛在顧客的航班廣告。在 2021 年年中，該產品開始遭遇技術性挑戰，而且發現了會導致行銷活動無法有效執行的錯誤。因此，我們決定主動告知廣告主改為使用其他開發潛在顧客選項。再行銷功能仍然保持不變，且可供廣告主使用。

如果您或合作夥伴目前正在使用航班廣告潛在顧客，建議您在 2023 年 5 月 1 日時關閉所有現有的行銷活動。

淘汰即時文章廣告版位

我們將從 2023 年 4 月 17 日開始將即時文章和即時文章廣告版位從 Facebook 移除。我們在 2015 年時首次推出即時文章，讓發佈商能夠建立行動版互動式媒體文章，並搭配廣告在 Facebook 上營利。但是，對於使用該平台的大部分用戶來說，新聞探索只是 Facebook 體驗的一小部分，而且用戶向我們表示希望在其動態消息中減少顯示此類內容。因此，我們正在調整投資方向以更符合用戶偏好。

自 2023 年 4 月 20 日起，即時文章廣告版位將不再提供給在廣告管理員和行銷 API 內建立的新行銷活動使用。2023 年 4 月 20 日之後，先前單獨包含即時文章版位的廣告組合將會暫停，而且包含即時文章版位的所有其他廣告組合將會自動更新為排除該版位。

隱藏對用戶個人檔案發佈內容的心情、留言和標籤

在此版本中，我們實作了一項變更，將導致連線階段用戶的留言、心情和標籤被隱藏。「via」和「sharedposts」欄位也將會為用戶個人檔案上的貼文傳回空白資料。這項變更將只會影響在用戶個人檔案上發佈的內容。

停止支援 TLS 1.2 版以前的版本

為了提高我們的安全層級，我們將停止支援 TLS 1.2 版之前的 TLS 版本的圖形 API。如果使用 TLS 1.2 版，使用靜態 RSA 密碼（AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA、AES256-SHA、DES-CBC3-SHA）的存取權限也將停用。使用舊版 TLS 版本發出的 API 要求將會在 90 天後收到錯誤。

2023 年 5 月 1 日之後，我們也將拒絕使用較舊的 TLS 版本（TLS 1.2 以前的版本，以及如果使用 TLS 1.2，則是使用靜態 RSA 密碼 [AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA、AES256-SHA、DES-CBC3-SHA]）的瀏覽器存取 developer.facebook.com 的網頁流量

WhatsApp 範本類別

我們去年更新了 WhatsApp 管理工具中的範本類別類型及 API，以擷取在 WhatsApp Business 平台上傳送的新使用案例。我們將在 2023 年 2 月 2 日將這些範本類別重新命名，以更準確地反映這些使用案例：

• 行銷範本將繼續命名為行銷 （無變更）
• 交易範本將會重新命名為工具
• OTP 範本將會重新命名為驗證

企業商家若要使用圖形 API 第 16.0 版建立或編輯範本，必須使用這些更新的範本。這項變更將於 5 月 1 日套用至所有版本，因此使用任何版本來嘗試建立或編輯範本時都必須使用這些新類別。為了確保範本建立過程或編輯程序不會中斷，企業商家和企業解決方案供應商（BSP）應於 2023 年 5 月 1 日前優先更新其 API 呼叫，以使用新的 category 值和範本。

部份其他重要日期和考量事項如下：

• 範本移轉：WhatsApp 將在 4 月 1 日移轉所有現有範本至新的範本類別。企業商家可以在 WhatsApp 管理工具中查看新的範本分類，並必須在 5 月 15 日之前審查。如果企業商家不同意分類，可以在 5 月 15 日之前提出申訴。在 4 月1 日至 5 月 1 日之間使用圖形 API 第 15 版或更舊版本新建立或編輯的任何範本將於 5 月 5 日移轉。因此，我們建議從 4 月 1 日開始使用第 16 版來建立範本。自 5 月 1 日起，在 WhatsApp 管理工具或任何圖形 API 版本中建立的任何範本都將反映新的範本類別。
• 以新的範本類別建立範本：自 4 月 1 日起，在圖形 API 第 16 版和 WhatsApp 管理工具中建立的所有範本都需要進行類別驗證來獲得批准。如果 WhatsApp 偵測到選擇的類別不正確，任何新建立或編輯的範本都可能會遭拒絕。根據我們的範本守則，拒絕原因將會說明所選擇的類別與範本內容不符。屆時商家可以選擇修改類別選項並重新提交、編輯範本，或對此處置提出申訴。自 5 月 1 日起，新建立的含變數範本將需要內嵌範例。自 6 月 1 日起，我們將會按照依範本類別區分的新價目表向商家收費。

Messenger API 平台

為了簡化重複通知，從第 16 版開始，我們將會移除指定訊息頻率的選項。如需詳細資訊，請參閱 Messenger 變更紀錄。

API 版本淘汰項目：

Facebook 的圖形 API 和行銷 API 版本修訂時間表已訂出即將淘汰項目，敬請留意：

圖形 API

• 2023 年 2 月 23 日：圖形 API 第 9.0 版將淘汰並從開放平台移除
• 2023 年 6 月 8 日：圖形 API 第 10.0 版將淘汰並從開放平台移除
• 2023 年 9 月 14 日：圖形 API 第 11.0 版將淘汰並從開放平台移除

行銷 API

• 2023 年 4 月 25 日：行銷 API 第 14.0 版將被淘汰並從平台移除

為避免干擾您的業務，建議將所有呼叫移轉至今天推出的最新 API 版本。

Facebook 開放平台 SDK

在開放平台 SDK 為期 2 年的淘汰時間表期間，請注意即將淘汰和列為過時的項目：

• 2023 年 6 月：Facebook 開放平台 SDK 第 9.0 版或以下版本將列為過時項目
• 2023 年 10 月：Facebook 開放平台 SDK 第 11.0 版或以下版本將列為過時項目
• 2024 年 2 月：Facebook 開放平台 SDK 第 12.0 版或以下版本將列為過時項目