全新推出 Facebook Graph API v18.0 和推廣 API v18.0

2023年9月12日發佈者：Naveen Santhanavel

今天，我們隆重推出 Facebook Graph API v18.0 和推廣 API v18.0。為配合本次的發佈版本，我們於下方重點列出了我們認為與部分開發人員社群相關的變更。這些變更包括公告、產品更新和停用通知，而我們認為這些變更跟您應用程式與我們平台之間的整合息息相關。

如欲了解所有變更及詳情的完整清單，請參閱我們的變更記錄。

一般更新

地點目標設定的廣告受眾地點狀態選項經已整合

如我們早前於 2023 年 5 月所公佈，在選擇要於地點目標設定選項中接觸的受眾類型時，我們已將「廣告受眾地點狀態」整合至我們目前的預設選項「居住或最近在此地點的人」。這項更新可反映其他先前可供使用的選項之整合，並移除了「在此地點旅行的用戶」選項。

我們之所以作出此項變更，是為了配合我們一直以來的長遠目標，務求為企業帶來更多價值、簡化我們的廣告系統及目標設定選項以改善成效效率，並移除不常用的選項。

此項更新將適用於全新或複製宣傳活動。在此更新項目推出之前所建立的現有宣傳活動，除非處於草稿模式或屬於複製宣傳活動，否則將不支援此全新體驗。

在 WhatsApp 訊息範本 API 中新增「add_security_recommendation」和「code_expiration_minutes」

今年年初，我們推出了 WhatsApp 身分驗證解決方案，以便透過原生按鈕與預設驗證訊息來建立和傳送驗證範本。隨著 Graph API v18 的推出，我們會改善驗證範本的擷取功能，以及簡化企業解決方案供應商和企業的端到端驗證範本流程。

有了 Graph API v18，企業解決方案供應商和企業就可在完成建立程序後，進一步掌握預設驗證訊息範本內容。具體而言，除了 WhatsApp 使用的文字以外，裝載亦會傳回預設內容的配置選項。這個改善項目讓企業解決方案供應商和企業能夠針對可在此 API 的基礎上建立的驗證類別範本，來構建「編輯」用戶介面。

請注意，若企業解決方案供應商或企業透過 GET 要求獲取整個回應，並將其重新傳送給 POST 要求以更新範本，則升級為 Graph API v18 時可能會發生錯誤。為了解決這個問題，請在將回應重新傳遞至 API 之前，先捨棄內文／標題／頁尾文字欄位。

重新推出用於建立通話廣告的開發人員文件和變更記錄

通話廣告專用 Facebook Reels 版位
Meta 即將推出透過 Facebook Reels 平台刊登通話廣告的功能。通話廣告可讓用戶在看到廣告且有意消費時立即致電企業，並協助企業與對自己有興趣的用戶展開更深入的討論。這讓企業有機會根據用戶在 Facebook 上的即時行為來刊登通話廣告。在廣告管理員的「廣告組合級別」下方，企業可選擇在「版位」區塊下方新增「Facebook Reels」。
重新推出透過 API 建立的通話廣告
2023 年 9 月 12 日，我們提供了有關如何透過 API 建立通話廣告的更新版指引。我們即將推出通話廣告專用文件，以方便第三方開發人員建立通話廣告宣傳活動，以及了解如何查看有關進行中通話廣告宣傳活動的洞察報告，包括與通話相關的衡量數據。未來，我們亦打算透過我們的 API 平台支援通話附加元件。開發人員需要擁有建立一般廣告所需的一般權限，方可透過 API 平台建立通話廣告。

請參閱開發人員文件以取得更多資訊。

停用項目及重大變更

用戶細項權限功能的 Graph API 變更

我們即將為 WhatsAppBusinessAccount 更新兩個 Graph API 端點，這兩個端點如下：

擷取與 WhatsAppBusiness 帳戶相關的訊息範本
擷取與 WhatsAppBusiness 帳戶相關的手機號碼

我們會在 v18 中推出一項名為「用戶細項權限」的新功能。所有已加至 WhatsAppBusinessAccount 的現有用戶將被回填，並會繼續擁有原有存取權限而不受影響。

管理員可靈活地更改這些權限。如果管理員更改權限，並移除其中一位用戶查看訊息範本或手機號碼的權限，則該位用戶會開始收到錯誤訊息，表明其沒有相關權限，無法查看 v18 及所有更舊版本之訊息範本或手機號碼。

停用 Instagram 影音素材和用戶洞察報告的舊版衡量數據命名方式

由 9 月 12 日起，Instagram 會從 Instagram Graph API 移除重複和舊版洞察報告衡量數據，以便為開發人員提供單一衡量數據來源。

這次新升級可減少任何混淆，並提高我們分析報告的可靠性和品質。

在此項變更推出 90 天後（即 2023 年 12 月 11 日），我們會從所有版本的 Instagram Graph API 中移除所有這些重複和舊版洞察報告衡量數據，以便與 Instagram 應用程式更加一致。

我們感謝開發人員社群所提供的各種寶貴意見，亦希望繼續維持我們的合作關係。

請參閱影音素材洞察報告和用戶洞察報告開發人員文件以了解詳情。

停用所有 Facebook Wi-Fi v1 和 Facebook Wi-Fi v2 端點

Facebook Wi-Fi 專門用於在企業中改善連線至 Wi-Fi 熱點的體驗。商家顧客只需在 Facebook 上簽到，便可取得免費 Wi-Fi。此產品亦可讓商家控制誰能使用其 Wi-Fi 以及使用時間，並且可與廣告整合，以便鎖定使用過該商家 Wi-Fi 的顧客。此產品已於 2023 年 6 月 12 日停用。由於合作夥伴通知期已結束，Facebook Wi-Fi v1 和 Facebook Wi-Fi v2 使用的所有端點皆已停用並移除。