返回開發人員最新消息

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

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

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

如需所有變更項目和其細節的完整清單,請瀏覽我們的變更紀錄

一般更新

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

依照先前 2023 年 5 月時發佈的資訊,在地點目標設定選項內選擇要觸及的廣告受眾類型時,我們已將分享對象地點狀態整合至現有的「居住或最近在此地點的人」預設選項。此更新反映了其他先前可用選項的合併,以及移除「在此地點旅行的人」選項等變更。

此變更是我們持續努力的一部分,旨在為企業商家帶來更多價值、簡化廣告系統和目標設定選項,進而提升成效及移除使用率低的選項。

此更新將適用於新的或重複的行銷活動。除非行銷活動處於草稿模式,或屬於複製的行銷活動,在更新生效之前建立的現有行銷活動將不會套用這項新體驗。

新增「add_security_recommendation」和「code_expiration_minutes」至 WA 訊息範本 API

我們在今年較早時推出了 WhatsApp 驗證解決方案,用戶可以使用原生按鈕和預設驗證訊息建立及傳送驗證範本。在圖形 API 第 18 版中,我們改善了驗證範本的擷取功能,讓 BSP 和企業更容易執行端對端驗證範本程序。

在圖形 API 第 18 版中,BSP 和企業商家可以在建立預設的驗證訊息範本內容後更清楚地檢視內容。具體來說,除了 WhatsApp 使用的文字之外,裝載也將會傳回預設的內容設定選項。此改善項目讓 BSP 和企業商家能夠為可在 API 的基礎上建置的驗證範本建立「編輯」用戶介面。

請注意,如果 BSP 或企業商家從 GET 要求取得完整回應,並提供給 POST 要求以更新範本,可能會在升級到圖形 API 第 18 版時發生錯誤。若要解決此問題,應在傳回 API 之前先刪除內文/頁首/頁尾文字欄位。

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

  • 通話廣告的 Facebook Reels 版位
    Meta 推出透過 Facebook Reels 平台投遞通話廣告的功能。通話廣告可讓用戶在觀看廣告時立即致電企業商家,並協助企業商家帶動與感興趣的用戶更複雜的討論。對於企業商家而言,這是根據用戶在 Facebook 上的即時行為來刊登通話廣告的機會。企業商家可以在廣告管理員中的廣告組合層級下,於「版位」區塊下方選擇新增「Facebook Reels」。
  • 重新推出透過 API 建立通話廣告
    我們於 2023 年 9 月 12 日更新了和如何透過 API 建立通話廣告有關的指南。我們針對通話廣告獨立推出文件,以便第三方開發人員能更容易建立通話廣告行銷活動,並瞭解如何查看與進行中的通話廣告行銷活動有關的洞察報告(包括與通話有關的衡量指標)。我們也計畫在未來透過自家 API 平台支援通話附加功能。開發者應擁有建立一般廣告所需的一般權限,以便透過 API 平台建立通話廣告。

    請參閱開發人員文件以瞭解更多資訊。

淘汰項目與重大變更

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

我們正在更新 WhatsAppBusinessAccount 的兩個圖形 API 端點。這些端點如下:

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

我們在第 18 版中推出了「用戶細項權限」新功能。所有已新增至 WhatsAppBusinessAccount 的現有用戶都將被回填,並繼續擁有存取權(不受影響)。

管理員可以視情況變更這些權限。如果管理員變更用戶的權限並移除查看訊息範本或電話號碼的存取權,該特定用戶會開始收到錯誤訊息,說明用戶沒有在所有版本(第 18 版和較舊版本)上查看訊息範本或電話號碼的權限。

淘汰「IG 媒體」和「用戶洞察報告」的舊版衡量指標命名方式

自 9 月 12 日開始,Instagram 將移除 Instagram 圖形 API 中重複和舊版的洞察報告衡量指標,以便與我們的開發人員共用單一衡量指標來源。

此升級有助於減少混淆狀況發生機率,並提高分析報告的可靠性和品質。

在此升級推出 90 天後(即 2023 年 12 月 11 日),我們將會移除所有版本上的 Instagram 圖形 API 的所有重複和舊版洞察報告衡量指標,以便與 Instagram 應用程式更加一致。

我們非常感謝開發人員社群提供的所有意見回饋,並期待能繼續合作。

請瀏覽媒體洞察報告用戶洞察報告開發人員文件以了解詳情。

淘汰所有 Facebook Wi-Fi 第 1 版和第 2 版端點

Facebook Wi-Fi 旨在改善商家 Wi-Fi 熱點的連線體驗。該產品讓商家的顧客只需在 Facebook 上打卡即可使用免費 Wi-Fi。商家也可以透過該產品控制可使用 Wi-Fi 的對象和使用時間,並和廣告整合以鎖定使用過該商家 Wi-Fi 的顧客作為目標受眾。此產品已在 2023 年 6 月 12 日淘汰。隨著合作夥伴通知期結束,Facebook Wi-Fi 第 1 版和 第 2 版使用的所有端點均已淘汰並刪除。

API 版本淘汰項目:

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

圖形 API

  • 2023 年 9 月 14 日:圖形 API 第 11.0 版將淘汰並從開放平台移除
  • 2024 年 2 月 8 日:圖形 API 第 12.0 版將淘汰並從開放平台移除
  • 2024 年 5 月 28 日:圖形 API 第 13.0 版將淘汰並從開放平台移除

行銷 API

  • 2023 年 9 月 20 日:行銷 API 第 14.0 版將淘汰並從平台移除
  • 2023 年 9 月 20 日:行銷 API 第 15.0 版將淘汰並從平台移除
  • 2024 年 2 月 6 日:行銷 API 第 16.0 版將淘汰並從平台移除

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

Facebook 開放平台 SDK

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

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