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

2024年5月21日發佈者：Ayyad Farah

訂閱開發人員最新消息

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

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

一般更新

行銷 API 版本自動升級

為了透過讓 API 更具無縫性和高效率來強化其整體體驗，我們很高興地宣佈近期將推出 MAPI 版本自動升級功能。即日起，我們將為不受版本影響的行銷 API 端點啟用自動版本升級功能。這表示在要停用的版本和下一個可用版本之間，如果端點不受影響，平台會自動將呼叫升級到下一個可用版本，而不是直接讓要求失敗。

如需深入瞭解該行為，請參閱行銷 API 版本控制和啟用部落格。

若要查看每個版本中受影響的端點，請參閱變更紀錄。

如需 20.0 版特定更新項目的詳細資訊，請繼續閱讀。

行銷 API 的提醒式廣告

在 2024 年 5 月 13 日之前，開發人員無法透過 Instagram 行銷 API 建立 Instagram 提醒式廣告，而且其顧客只能在 Meta 廣告管理員中建立提醒式廣告。這種缺乏相容性的狀況為我們的合作夥伴和想刊登提醒式廣告的顧客帶來了惱人的阻礙。

在我們持續地聆聽合作夥伴的意見回饋後，我們將自 2024 年 5 月 13 日起支援透過 Instagram 行銷 API 建立提醒式廣告。

我們感謝開發人員社群和其顧客提供的意見回饋，並希望繼續改進透過行銷 API 建立的提醒式廣告體驗。

關於 Instagram 提醒式廣告

Instagram 提醒式廣告可透過鼓勵有興趣的用戶設定提醒，來協助廣告主銜接活動推廣和活動開始時間之間的時間間隔。選擇接收提醒的用戶，將會在活動開始前最關鍵的時刻收到提醒。

關於建立及編輯活動

Instagram 提醒式廣告使用活動開始時間和日期來決定何時傳送提醒。這項變更允許開發人員在 Instagram 圖形 API 中建立和編輯活動。您可以在將活動附加到廣告創意之後，透過 Instagram 行銷 API 建立提醒式廣告。

廣告帳號節點上的新 API

新的廣告帳戶節點更新並不是重大變更，而是一個 API 新增項目。呼叫該 API 新增項目會列出該廣告帳號下所有具有指導建議的行銷活動，以及指導內容和預期的每次行動成本（CPA）改善幅度。

新的 API 將允許廣告主查看 Meta 的行銷活動指導。這項資料已存在於合作夥伴中心以供所有合作夥伴使用。但是，目前只能透過用戶介面查看，且需要手動選擇單一廣告帳號來查看指引。

透過 CPA_GUIDANCE API 自動存取這些資料，我們希望免去查看每個廣告帳號的指引時所需的手動操作。而對我們的合作夥伴來說，能夠使用此 API 將能讓夥伴在內部建立自訂檢視畫面，並查看一段時間的發展趨勢。

如果您的企業管理數百或數千個帳號，會很難逐一檢查帳號的任何衡量指標，尤其是在要求時效性的情況下（RSS 建議每天更新並考慮納入過去 28 天內刊登中的行銷活動）。這項 API 能夠協助代理商找出最有可能使用提供的建議來順利最佳化，然後整合至他們的系統中的行銷活動。

CPA_GUIDANCE API 專門用於協助代理商向其品牌合作夥伴提供指引，以說明哪些產品或類別具有最高的每次取得成本（CPA）。代理商可透過分享這項資訊，協助其品牌合作夥伴將廣告花費最佳化，並提高協作行銷活動的整體成效。

代理商也可以透過觀察 CPA 的改善趨勢來追蹤合作夥伴是否確實採用指引建議。

多廣告商廣告

今天，我們向廣告主推出透過行銷 API 選擇使用多廣告商廣告的功能。在此更新之前，開發人員無法透過 API 建立多廣告商廣告，而且其顧客只能在 Meta 廣告管理員中選擇使用多廣告商廣告。

關於多廣告商廣告

多廣告商廣告可協助用戶探索來自多個商家的產品及服務。對於 Facebook 和 Instagram 上的特定版位，您的廣告可以與其他廣告一併顯示在相同的廣告單位中，協助用戶探索系統為其量身推薦的商家商品和服務。廣告單位是一種容器，通常會在同一個頁面上顯示多則廣告。瀏覽企業商家使用說明瞭解詳情。

此變更對開發人員的意義

推出時，透過行銷 API 建立的多廣告商廣告的投遞設定預設為關閉，這表示開發人員需要針對其顧客的廣告實作程式碼變更，才能夠在體驗中投遞。行銷 API 的所有版本皆支援多廣告商廣告建立流程，但所有符合多廣告商廣告資格的廣告建立要求，都必須指定廣告是否選擇使用此功能。2024 年 8 月 19 日，多廣告商廣告將變更為預設開啟，尚未變更程式碼的開發人員屆時需要更新程式碼，顧客才能選擇停用體驗。

行銷 API 即將迎來生成式 AI 廣告創意功能：文字生成、圖像放大和背景產生。

2023 年 10 月，我們宣佈在廣告管理員中向企業推出首批由生成式 AI 廣告創意廣告功能：文字生成、圖像放大和背景產生。今天，我們想讓您知道，我們正在透過行銷 API（MAPI）向廣告主推出這些生成式 AI 廣告創意功能。如此一來，合作夥伴、代理商和廣告主也可以透過 MAPI 利用 Meta 的生成式 AI 產品。

這些功能可以快速自動產生不同的廣告創意版本，開啟創造力的新時代，以大幅提高所有廣告主的生產力、客製化程度和廣告成效：

背景產生：建立最多四種背景來使商品圖像更加完整，為廣告受眾提供多元化的廣告創意。背景將根據原始商品圖像來產生，通常是具有顏色和圖案的簡單背景。
圖像放大：無縫調整圖像廣告創意素材以適應各種介面的不同長寬比，從支援動態消息開始，然後迅速擴展到 Reels，讓您花費更少的時間和資源就能重新利用廣告創意素材。
文字生成：根據原始文案生成多種廣告文字版本，強調商品／服務的賣點並生成多種文字選項，向廣告受眾提供多元化廣告。

今天我們將這些功能帶給更多廣告主，我們很高興能夠將生成式 AI 的力量提供給更廣大的對象。

根據我們測試新產品的方法，這些產品可能會受到額外審查，因此特定產業（例如金融服務和製藥／健康，以及住房、就業或金融服務／信貸（HEC）、社會議題、選舉或政治（SIEP））可能無法立即使用所有生成式 AI 功能。

運作方式

即日起，我們將透過行銷 API（更具體而言為廣告創意 API）支援這些功能。廣告主將能夠選擇使用 API 中的這些功能，並透過 API 預覽生成式 AI 廣告創意。

以下範例顯示如何選擇將廣告創意納入行銷 API 的生成式 AI 功能。

          curl -X POST \
          -F 'name=Generative AI Creative' \
          -F 'object_story_spec={
          ...
          }' \
          -F 'degrees_of_freedom_spec={
          "creative_features_spec": {
          "image_background_gen": {
          "enroll_status": "OPT_IN"
          }
          }
          }' \
          -F 'access_token=<ACCESS_TOKEN>'\
          https://graph.facebook.com/<GRAPH_API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

注意：上方範例顯示選擇啟用背景產生功能。同樣地，對於「圖像放大」功能，請在 creative_features_spec 中使用 image_uncrop 金鑰；對於「文字生成」功能，則使用 text_generation 金鑰。

廣告主也可以透過 API 預覽生成式 AI 轉換後的廣告創意。請參閱開發人員文件連結，深入瞭解如何生成內容、提供廣告創意，以及預覽各項生成式 AI 功能生成的內容。

Instagram 影片 API：可恢復上傳的 Instagram 影片 API

自 2024 年 5 月 15 日起，新的「可續傳的上傳通訊協定」將支持發佈 Instagram 影片（例如 Reels、限時動態影片和輪播影片），可從本機影片和公開代管網址影片兩種方式上傳。這項新的協定允許本機檔案上傳、 僅適用於 Reels 的長篇影片上傳（最長 15 分鐘），以及在網路中斷或其他傳輸失敗後繼續上傳操作。

先前若要製作 Instagram 影片，影片檔案必須上傳到可公開存取的代管服務，然後取得可分享的網址，並提供給 Meta 才能發佈影片。

完整的內容發佈流程詳情可以在內容發佈開發人員文件中找到，其中包含與 Instagram 媒體有關的更多詳細資料，請參閱此處。

Instagram 圖形 API：啟用新衡量指標

即日起，輪播容器媒體的六個額外衡量指標將可用於圖形 API。這些衡量指標包括「按讚次數」、「留言數」、「分享次數」、「粉絲人數」、「個人檔案動態」（即用戶瀏覽您的個人檔案時採取的動作次數）、「商業檔案瀏覽次數」（即您的商業檔案被造訪的次數）。這些衡量指標已經在 Instagram 的「洞察報告」頁面中開放使用，但也可以透過圖形 API 使用。

透過將「按讚次數」、「留言數」、「分享次數」、「粉絲人數」、「商業檔案動態」、「商業檔案瀏覽次數」新增至輪播貼文的圖形 API 端點，您應該能夠直接從 API 呼叫讀取這些衡量指標。

請前往此處參閱這些衡量指標的完整清單，以立即針對輪播容器貼文的 GET API 呼叫加入相關衡量指標。

更新的停用時程：Meta 的離線轉換 API（OCAPI）

去年，我們宣布離線轉換 API 17 版將不再支援離線事件，並預計於 2024 年第三季停用離線轉換 API。先前預計的停用時程已更新，我們在此確認離線轉換 API（OCAPI）將於 2025 年 5 月停用。雖然離線轉換 API（OCAPI）的停用時間從 2024 年第三季延後到 2025 年 5 月，但我們仍建議目前正透過 OCAPI 傳送離線事件的廣告主，繼續規劃將現有設定移轉為開始透過轉換 API 傳送離線事件（離線 CAPI）。

淘汰項目與重大變更

停用 Messenger API 中的「預訂」按鈕

立即生效，Messenger API 呼叫將不再支援「預訂」按鈕。這項變更不會影響其他範本和按鈕，企業商家仍可使用 Meta Business Suite 管理預約。

停用在行銷 API 中建立贊助訊息廣告類型

即日起，行銷 API 20.0 版將不再支援建立「贊助訊息」廣告格式。此外，90 天後也將停止支援使用舊版 API 建立此廣告類型。這項變更不會影響其他訊息廣告類型。

建議您檢查目前的整合狀況，並視需要調整應用程式，以確保用戶能順利過渡。

移除洞察報告人口統計資料衡量指標的非重大時間範圍（透過外部 Instagram 圖形 API）

2024 年 5 月 21 日時，我們推出了 Instagram 圖形 API 20 版。

此版本推出 90 天後（即 2024 年 8 月 19 日），圖形 API 將不再分享廣告受眾在 Instagram 圖形 API 的非重大時間範圍內互動和觸及的廣告受眾成員人口統計資料衡量指標（例如過去 14 天和 90 天的國家／地區、城市、年齡和性別分布資訊）。

Instagram 圖形 API 仍然會傳回過去一個月（即「this_month」）和過去一週（即「this_week」）的人口統計資料，與 Instagram 應用程式類似，以確保跨平台的一致性。

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

如需深入瞭解，請參閱開發人員文件。

API 版本淘汰項目：

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

圖形 API

2024 年 5 月 28 日：圖形 API 13.0 版將被淘汰並從開放平台中移除。
2024 年 9 月 17 日：圖形 API 14.0 版將被淘汰並從開放平台中移除。
2024 年 11 月 20 日：圖形 API 15.0 版將被淘汰並從開放平台中移除。

行銷 API

2024 年 8 月 13 日：行銷 API 18.0 版將被淘汰並從開放平台中移除。
2025 年 2 月 4 日：行銷 API 19.0 版將被淘汰並從開放平台中移除。

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

Meta Business SDK

Meta 商業 SDK 20 版發佈

Meta Business SDK 20 版將在圖形 API 20 版發佈後不久發佈。此版本將包括錯誤修復、相依性升級、新功能，以及最重要的 API 介面更新，以配合圖形 API 20 版。

在本版本中，我們還推出對 Instagram API 的額外支援項目。這些項目為 IGMediaForIGOnlyAPI、IGUserForIGOnlyAPI、IGRefreshAccessTokenForIGOnlyAPI 和 IGAccessTokenForIGOnlyAPI。這些新項目建立於現有的 Instagram API 之上，可提供更多取得媒體的直接方式。我們正著手加入更多涵蓋其他 Meta 產品的 API，以讓商業 SDK 的生態系統更加豐富。

作為我們開放平台 SDK 為期 2 年的淘汰時間表的一部分，請注意即將到來的淘汰和停用項目：

2024 年 5 月：Facebook 開放平台 SDK 13.0 版或以下版本將成為過時項目。

標籤：

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

相關最新消息

更多消息