首頁
部落格
圖形 API 第 25.0 版和行銷 API 第 25.0 版隆重登場

2026年2月18日

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

發佈者： Manjari Jain

以下為第 25 版 GAPI／MAPI 的全新變更重點。如需完整的變更清單和詳細資訊，請瀏覽我們的變更紀錄。

一般更新

圖形 API：「粉絲專頁觀眾」衡量指標隆重登場

我們計畫於 2026 年 6 月底前在圖形 API 中推出「粉絲專頁觀眾」衡量指標。「觀眾人數」衡量指標旨在取代舊版的「觸及人數」衡量指標，並提供一致的跨平台成效衡量功能（Facebook 和 Instagram），讓您知道看過一則內容的用戶人數。開發人員應開始計畫改用「觀眾人數」衡量指標，以確保繼續存取廣告受眾洞察報告。

變更內容

粉絲專頁洞察報告和限時動態洞察報告將提供「觀眾」衡量指標

貼文／粉絲專頁洞察報告

  • GET {page-id}/insights/page_total_media_view_unique*
  • GET {post-id}/insights/post_total_media_view_unique*

限時動態洞察報告

  • 新的衡量指標將新增
  • GET {stories-id}/insights/metric
    • PAGE_STORY_TOTAL_MEDIA_VIEW_UNIQUE

上述的圖形 API 將在第 25 版推出後開放使用，建議開發人員查看圖形 API 變更紀錄以瞭解最新資訊。

Webhooks mTLS 憑證更新

自 2026 年 3 月 31 日起，Meta 將開始使用其擁有的其他憑證授權單位（CA）簽署 Webhooks mTLS 憑證。

對開發人員的影響

如果您的伺服器配置為需要並驗證 Webhooks mTLS 憑證，您必須信任新的 Meta CA。如果您在期限前未更新信任存放區，將會導致 TLS 交握失敗，且伺服器將停止接收所有 Webhooks 事件。

需採取動作：更新信任存放區

若要確保持續收到 Webhooks，您必須

  1. 下載 Meta 根 CA 憑證：前往 Webhooks 新手指南並下載名為 meta-outbound-api-ca-2025-12.pem 的檔案。
    根 CA 會簽署 Webhooks 要求中的終端憑證。
  2. 將憑證新增至信任存放區：將此憑證新增至接收 Webhooks 的任何伺服器的信任存放區。
  3. 維護目前的憑證：您應在目前憑證仍有效時將新憑證新增至信任存放區。

重要事項：請勿等到期限日。建議您立即將新憑證新增至信任存放區，以確保在 3 月 31 日時能夠順利轉換。

期限：2026 年 3 月 31 日前。

為何進行此變更

目前的 Webhooks mTLS 憑證是由 DigiCert 根 CA 簽署。由於 DigiCert 即將停用用戶端驗證 EKU，此憑證將無法使用此根 CA（2025 年 4 月 15 日到期）重新展延期限。

因此，新的 Webhooks mTLS 憑證將由 Meta 內部根 CA 簽署。該憑證會維持與現有憑證相同的常用名稱（client.webhooks.fbclientcerts.com）。

有關 Webhooks mTLS 的公開文件已更新，我們也已針對此次更新傳送相關通知。文件中的完整技術詳細資料將在轉換完成後，於 2026 年 4 月永久更新。

淘汰項目與重大變更

廣告洞察報告非同步 API 適用的進階錯誤訊息功能

我們持續努力改善 API 的開發人員使用體驗。為了提高資訊透明度，並讓開發人員打造更具彈性的應用程式，我們將針對廣告洞察報告非同步 API GET {AD_REPORT_RUN_ID} 端點強化錯誤回報功能。

自將於 2026 年 2 月 18 日發佈的下一個圖形 API 第 25.0 版起，非同步報告失敗後，開發人員將能存取詳細的錯誤資訊，方便診斷失敗問題，並提升 API 整合工具的效率。針對目前可存取 error_code 欄位的任何開發人員，類型將從 uint 變更為 int。

變更內容

我們將為所有應用程式的廣告洞察報告非同步 API GET {AD_REPORT_RUN_ID} 端點回應推出以下全新預設欄位：

  • error_code：錯誤代碼。注意：欄位將從 uint 變更為 int，適用於目前可存取該欄位的任何開發人員
  • error_message：與 error_code 對應的訊息。
  • error_subcode：錯誤的特定子代碼。
  • error_user_title：方便使用的錯誤子代碼標題。
  • error_user_msg：方便使用且詳細說明錯誤子代碼的訊息。

系統會在報告執行失敗時填入這些欄位。建議您檢查 API 整合工具，以確保與回應中新的預設欄位相容。

此更新預計將與下一個圖形 API 版本一起發佈。建議開發人員查看圖形 API 變更紀錄以瞭解最新資訊。開發人員文件也已更新以反映這些變更。

圖形 API：停用中繼資料查詢參數

從圖形 API 第 25 版開始，我們將停用 metadata=1 查詢參數。此參數先前用於在 API 回應時傳回有關節點欄位和連線的中繼資料。此功能的使用率偏低，因此即將停用以簡化平台。停用後，系統將在 API 要求中略過 metadata 參數。

目前仰賴 metadata=1 的開發人員應轉為使用我們的官方 API 文件，以瞭解每個節點類型的可用欄位和連線。

變更內容

變更

時程

停用 metadata=1 查詢參數

第 25 版（2026 年 2 月）

移除 metadata=1 查詢參數

2026 年 5 月

之前（第 24 版和較早版本）：

在圖形 API 要求中加入 ?metadata=1 會傳回與節點有關的其他中繼資料，包括可用的欄位和連線。

之後（第 25 版以上版本）：

系統會略過 metadata=1 參數。包含此參數的要求將繼續傳回不含中繼資料的標準回應。不會發生失敗或重大變更，如果您的要求包含 metadata=1，不會出現錯誤或中斷的情況；該參數不會產生任何影響。

圖形 API：「粉絲專頁觸及人數」／「曝光次數」衡量指標停用

我們計畫在 2026 年 6 月停用圖形 API 中的「貼文／粉絲專頁觸及人數」、「影片曝光次數」和「限時動態曝光次數」衡量指標。這些舊版衡量指標不會再顯示於我們的洞察報告工具，但至今仍可透過 API 使用。

為了讓我們的產品和 API 在一致的單一衡量指標架構上相符合，並改善整體系統的可靠性，我們將停用這些舊版衡量指標。停用後，開發人員應改用全新的「影音內容觀看次數」和「影音內容觀眾人數」衡量指標，這些指標取代舊有的曝光次數、觸及人數和影片觀眾人數概念。

變更內容

所有 API 版本將於 2026 年 6 月停用以下衡量指標。建議開發人員查看圖形 API 變更紀錄以瞭解最新資訊：

貼文／粉絲專頁觸及人數

  • GET {page-id}/insights/page_impressions_unique*
  • GET {page-id}/insights/page_impressions_paid_unique*
  • GET {page-id}/insights/page_impressions_viral_unique*
  • GET {page-id}/insights/page_impressions_nonviral_unique*
  • GET {page-id}/insights/page_posts_impressions*
  • GET {page-id}/insights/page_posts_impressions_unique*
  • GET {page-id}/insights/page_posts_impressions_paid*
  • GET {page-id}/insights/page_posts_impressions_paid_unique*
  • GET {page-id}/insights/page_posts_impressions_organic_unique*
  • GET {page-id}/insights/page_posts_served_impressions_organic_unique*
  • GET {page-id}/insights/page_posts_impressions_viral*
  • GET {page-id}/insights/page_posts_impressions_viral_unique*
  • GET {page-id}/insights/page_posts_impressions_nonviral*
  • GET {page-id}/insights/page_posts_impressions_nonviral_unique*
  • GET {post-id}/insights/post_impressions_unique*
  • GET {post-id}/insights/post_impressions_paid_unique*
  • GET {post-id}/insights/post_impressions_fan_unique*
  • GET {post-id}/insights/post_impressions_organic_unique*
  • GET {post-id}/insights/post_impressions_viral_unique*
  • GET {post-id}/insights/post_impressions_nonviral_unique*
  • GET {post-id}/insights/post_impressions_nonviral_unique*

影片曝光次數

  • GET {video-id}/video_insights/post_impressions_unique
  • GET {video-id}/video_insights/total_video_impressions
  • GET {video-id}/video_insights/total_video_impressions_unique
  • GET {video-id}/video_insights/total_video_impressions_paid_unique
  • GET {video-id}/video_insights/total_video_impressions_paid
  • GET {video-id}/video_insights/total_video_impressions_organic_unique
  • GET {video-id}/video_insights/total_video_impressions_organic
  • GET {video-id}/video_insights/total_video_impressions_viral_unique
  • GET {video-id}/video_insights/total_video_impressions_viral
  • GET {video-id}/video_insights/total_video_impressions_fan_unique
  • GET {video-id}/video_insights/total_video_impressions_fan
  • GET {video-id}/video_insights/total_video_impressions_fan_paid_unique
  • GET {video-id}/video_insights/total_video_impressions_fan_paid

限時動態曝光次數

  • 兩項衡量指標將會被取代
  • GET {stories-id}/insights/metric
    • PAGE_STORY_IMPRESSIONS_BY_STORY_ID
    • PAGE_STORY_IMPRESSIONS_BY_STORY_ID_UNIQUE

建議您改用以下衡量指標：

  • GET {page-id}/insights/page_total_media_view_unique
  • GET {post-id}/insights/post_total_media_view_unique

針對付費和自主觸及人數之間的資料解析，建議您使用以下可提供極為類似洞察報告的衡量指標：

  • GET {page-id}/insights/page_media_view
  • GET {post-id}/insights/post_media_view

圖形 API：「觀看影片 3 秒以上的觀眾人數」衡量指標停用

我們計畫在 2026 年 6 月停用「觀看影片 3 秒以上的觀眾人數」衡量指標。相關舊版衡量指標不會再顯示於我們的洞察報告工具，但至今仍可透過圖形 API 使用。

為了讓我們的產品和 API 在一致的單一衡量指標架構上相符合，並改善整體系統的可靠性，我們將停用這些舊版衡量指標。停用後，開發人員應改用全新的「影音內容觀看次數」和「影音內容觀眾人數」衡量指標，這些指標取代舊有的曝光次數、觸及人數和影片觀眾人數概念。

變更內容

所有 API 版本將於 2026 年 6 月停用以下衡量指標。建議開發人員查看圖形 API 變更紀錄以瞭解最新資訊：

  • GET {page-id}/insights/page_video_views_unique
  • GET {post-id}/insights/post_video_views_organic_unique
  • GET {post-id}/insights/post_video_views_paid_unique
  • GET {post-id}/insights/post_video_views_unique
  • GET {video-id}/video_insights/total_video_views_organic_unique
  • GET {video-id}/video_insights/total_video_views_paid_unique
  • GET {video-id}/video_insights/total_video_views_unique

建議您改用以下衡量指標：

  • GET {page-id}/insights/page_total_media_view_unique
  • GET {post-id}/insights/post_total_media_view_unique

針對付費和自主觀看影片 3 秒以上的觀眾人數之間的資料解析，建議您使用以下可提供極為類似洞察報告的衡量指標：

  • GET {page-id}/insights/page_media_view
  • GET {post-id}/insights/post_media_view

行銷 API：ASC 和 AAC 停用

「自動化整合」可促使應用程式、銷售和開發潛在顧客行銷活動預設為自動化優先的最佳高效速成+ 設定，並讓廣告主和合作夥伴能更輕鬆地存取 Meta 最新且成效最好的自動化產品。我們正逐步停用舊版 API，並改用全新「自動化整合」（行銷 API 開發人員適用的高效速成+ 設定）。

從第 25.0 版（2026 年 2 月 18 日）起，無法再使用行銷 API 建立或更新 ASC 和 AAC 行銷活動，90 天後（2026 年 5 月 19 日）將擴大套用至所有 MAPI 版本。

第 26.0 版（預計 2026 年 9 月推出）將暫停所有剩餘的 ASC 和 AAC 行銷活動。

在第 26.0 版推出之前，仍可編輯使用現有顧客預算上限（ECBC）的 ASC 或 AAC 行銷活動，這項功能不適用於高效速成+ 行銷活動。擁有 ECBC 行銷活動的開發人員應在第 26.0 版推出之前，使用以下任一方法採取行動複製 ECBC 行銷活動：

  • 手動複製：在廣告管理員中開啟包含 ECBC 的現有 ASC／AAC 行銷活動，系統將提示您「複製行銷活動」。此一鍵式步驟會複製現有行銷活動的設定來建立新的行銷活動。
  • 複製使用 API 的 ECBC 行銷活動：透過開發人員文件提供的指引複製使用 API 的行銷活動，請參閱此處。
  • 在廣告帳號層級要求批量移轉：我們可以為合約合作夥伴提供一次性操作，在協議的日期複製所有 ECBC 行銷活動。請聯絡您的 Meta 聯絡窗口並提供帳號編號和方便的移轉日期。

注意：所有 ECBC 行銷活動複製項目將會產生新的行銷活動編號。

此變更會影響以下端點：

  • POST /{campaign-id}
  • POST /{campaign-id}/copies

請參閱更新版開發人員文件和常見問題，以瞭解此變更的所有詳細資料。

開發人員文件連結

功能説明文章連結

API 版本停用項目：

Facebook 的圖形 API 和行銷 API 版本修訂時程已訂出即將停用的項目，請留意：

圖形 API

  • 2026 年 5 月 21 日：圖形 API 第 19 版將被淘汰並從開放平台中移除。
  • 2026 年 9 月 24 日：圖形 API 第 20 版將被淘汰並從開放平台中移除。

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


標籤

商業工具開發人員工具圖形 API行銷 API

探索更多

2025年5月29日

Introducing Graph API v23.0 and Marketing API v23.0

2025年1月21日

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

2024年5月21日

Introducing Graph API v20.0 and Marketing API v20.0

訂閱電子報

訂閱 Meta for Developers 的每月最新資訊。

立即訂閱