返回開發人員最新消息

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

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

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

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

一般更新

推廣 API 版本自動升級功能

為提高推廣 API 的流暢度和效率,增強此 API 的整體體驗,我們很高興宣佈即將推出推廣 API 版本自動升級功能。由即日起,我們會為不受版本變更影響的推廣 API 端點啟用自動版本升級功能。這就代表,在要停用的版本與下一個可用版本之間,如果某個端點不受影響,平台會自動升級呼叫,改為對下一個可用版本執行呼叫,而不是直接表示要求失敗。

如要進一步了解相關行為,請參閱推廣 API 版本控制發佈網誌

如要查看在各版本中受影響的端點,請參閱變更記錄

如欲了解 v20.0 更新項目的具體資訊,請繼續閱讀下文。

使用推廣 API 建立提醒式廣告

在 2024 年 5 月 13 日之前,開發人員無法支援透過 Instagram 推廣 API 建立 Instagram 提醒式廣告,其顧客只能在 Meta 廣告管理員建立提醒式廣告。這種不相容性為我們的合作夥伴及其希望刊登提醒式廣告的顧客帶來了不必要的阻礙。

在持續收到有關這種不相容性的意見後,我們自 2024 年 5 月 13 日起開始支援透過 Instagram 推廣 API 建立提醒式廣告。

我們感謝開發人員社群及其客戶提供的意見,亦希望能繼續改善透過推廣 API 提供的提醒式廣告體驗。

關於 Instagram 提醒式廣告

Instagram 提醒式廣告可鼓勵有興趣的用戶設定提醒,以助廣告客戶銜接推廣活動與發表會時間。若用戶選擇接收提醒,便會在活動開始前的關鍵時刻收到提醒。

關於建立和編輯活動

Instagram 提醒式廣告使用活動開始時間和日期來決定何時傳送提醒。這項變更讓開發人員能夠在 Instagram Graph API 中建立和編輯活動。製作與活動相關的廣告創意後,您便可以透過 Instagram 推廣 API 建立提醒式廣告。

廣告帳戶節點上的新 API

新的廣告帳戶節點更新項目並未作出重大變更,而是加入了新 API。如果您呼叫此 API,系統便會列出相關廣告帳戶下所有包含指引式推薦做法的宣傳活動,並顯示相關指引和預期的每次動作成本改善幅度。

新 API 將允許廣告客戶查看 Meta 針對其宣傳活動提供的指引。這類資料已存在於所有合作夥伴的合作夥伴中心。不過,您可以透過用戶介面來存取這類資料,且需要手動選擇單一廣告帳戶才能查看相關指引。

我們已將透過 CPA_GUIDANCE API 存取此等資料的流程變為自動完成,以期減少查看每個帳戶指引所需的人手操作。我們的合作夥伴可以透過存取此 API,在內部建立自訂檢視畫面和查看長期趨勢。

如果您的企業管理著數百或數千個帳戶,便很難逐一檢查它們的任何衡量數據,當這些衡量數據具有時效性時更是如此(RSS 建議每天更新一次,並考慮過去 28 天的有效宣傳活動)。有了此 API,代理商將能夠找出最有潛力且可採用所提供的推薦做法加以優化的宣傳活動,並在之後將這些推薦做法納入其系統。

代理商可以專門透過 CPA_GUIDANCE API 為自家品牌合作夥伴提供指引,助其了解哪些商品或類別的每次招攬成本最高。透過提供這類資訊,代理商可協助其品牌合作夥伴優化廣告花費,並改善其協作宣傳活動的整體成效。

代理商亦可以觀察每次招攬成本的改善趨勢,從而追蹤指引式推薦做法的落實情況。

多廣告客戶廣告

今天,我們為廣告客戶推出透過推廣 API 選擇啟用多廣告客戶廣告的功能。在此次更新之前,開發人員無法支援透過推廣 API 建立多廣告客戶廣告,其顧客只能在 Meta 廣告管理員選擇啟用多廣告客戶廣告。

關於多廣告客戶廣告

多廣告客戶廣告有助用戶探索多間企業的商品和服務。在 Facebook 和 Instagram 的部分特定版位中,廣告可以出現在同一個廣告單位中的其他廣告旁邊,以助用戶發掘來自不同企業且切合自身需求的商品和服務。「廣告單位」是一個容器,通常可在同一個頁面中顯示多個廣告。瀏覽企業商家幫助中心以了解詳情。

對開發人員的影響

此功能推出後,透過推廣 API 建立的多廣告客戶廣告之刊登功能預設為關閉狀態,這表示開發人員需要執行相關程式碼變更,其顧客的廣告才符合資格在體驗中刊登。推廣 API 的所有版本均支援多廣告客戶廣告建立流程,但符合多廣告客戶廣告功能使用資格的所有廣告建立要求都必須指明相關廣告是否選擇啟用此功能。自 2024 年 8 月 19 日起,多廣告客戶廣告功能將預設為開啟狀態,而尚未執行程式碼變更的開發人員需要完成此等變更,才能為其顧客提供退出這項體驗的功能。

推廣 API 即將引入生成式 AI 廣告創意功能:文字生成、圖像放大功能和背景生成

2023 年 10 月,我們宣佈在廣告管理員中向企業推出首批生成式 AI 廣告創意功能,其中包括文字生成圖像放大背景生成。今天我們想通知大家,我們正在透過推廣 API 為廣告客戶提供這些生成式 AI 廣告創意功能,因此各合作夥伴、代理商和廣告客戶也能透過推廣 API 善用 Meta 的生成式 AI 產品。

這些功能可自動快速生成不同廣告創意版本,從而開啟廣告創意的新世代,將所有廣告客戶的效率、自訂程度和成效都提升至最高:

  • 背景生成:此功能最多可建立 4 種背景來配合商品圖像,以便向廣告受眾顯示各式各樣的廣告創意。所生成的背景將以您原本的商品圖像為依據,且通常都是運用各種顏色和圖案的簡單背景。

  • 圖像放大:此功能會以流暢自然的方式調整圖像廣告創意素材,使其符合各個平台上的不同長闊比例。這項功能首先在動態消息中推出,並很快擴展到 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
        

備註:上述範例顯示的是如何選擇啟用背景生成功能。同樣地,若要啟用圖像放大功能,請使用「image_uncrop」密鑰;若要啟用文字生成功能,請在 creative_features_spec 中使用「text_generation」密鑰。

廣告客戶也將能夠透過此 API 預覽經過生成式 AI 轉換的廣告創意。請前往開發人員文件連結,以進一步了解如何生成、提供廣告創意,以及預覽使用我們各項生成式 AI 功能生成的內容。

Instagram 影片 API:Instagram 影片 API 的可恢復上載功能

自 2024 年 5 月 15 日起,新版「可恢復的上載通訊協定」將同時支援透過本機影片和公共託管網址影片發佈 Instagram 影片,即 Reels、影片限時動態和影片輪播項目。此新版通訊協定可讓您上載本機檔案、 單獨上載 Reels 的 較長影片(即最長 15 分鐘),以及在網絡中斷或出現其他傳輸故障後恢復上載操作。

以往建立 Instagram 影片時,您必須將影片檔案上載至可公開存取的託管服務中,以在當中獲取可分享的網址並將其提供給 Meta,然後才能發佈影片。

若要查看改善後的內容發佈流程詳情,請瀏覽內容發佈開發人員文件。此外,如需了解 Instagram 影音素材的更多詳情,請前往此處

Instagram Graph API:引入全新衡量數據

今天,我們將為 Graph API 提供 6 個額外的輪播內容容器影音素材衡量數據。這些衡量數據包括「讚好次數」、「回應數量」、「分享次數」、「追蹤人數」、「個人檔案動態」(即用戶瀏覽您個人檔案時採取的動作數量)、「個人檔案瀏覽次數」(即用戶瀏覽您個人檔案的次數)。我們已在 Instagram 的「洞察報告」頁面提供這些衡量數據,而現在我們亦可透過 Graph API 提供此等衡量數據。

在輪播帖子的 Graph API 端點中加入「讚好次數」、「回應數量」、「分享次數」、「追蹤人數」、「個人檔案動態」、「個人檔案瀏覽次數」後,您應能夠直接透過呼叫此 API 來閱讀這些衡量數據。

前往此處參閱這些衡量數據的完整清單,以立即在您的 GET API 呼叫中加入與輪播內容容器帖子相關的衡量數據。

已更新的停用時間表:Meta 離線轉換 API

去年,我們已宣佈離線轉換 API 第 17 版不再支援離線事件,並預計自 2024 年第 3 季起,離線轉換 API 將停止提供服務。此預計的停用時間表現已更新,我們確認離線轉換 API 將自 2025 年 5 月起停止提供服務。儘管離線轉換 API 的停用時間已由 2024 年第 3 季延長至 2025 年 5 月,但我們仍建議目前透過離線轉換 API 傳送離線事件的廣告客戶繼續規劃轉移其現有設定,以開始透過轉換 API(離線事件的轉換 API)傳送離線事件。

停用項目及重大變更

Messenger API 的「預訂」按鈕停止提供服務

由即日起,Messenger API 呼叫將不再支援「預訂」按鈕。這項變更不會影響其他範本和按鈕,且企業仍可使用 Meta Business Suite 管理預訂事宜。

推廣 API 的贊助訊息廣告類型建立流程停止提供服務

由即日起,推廣 API v20.0 不再提供贊助訊息廣告類型的建立流程,並且此 API 的先前版本將在 90 天後停止就此廣告類型提供廣告建立流程支援項目。這項變更不會影響其他發訊廣告類型。

建議您查看目前的整合情況,並根據需要調整各應用程式,以確保用戶順暢無阻地完成過渡。

透過外部 Instagram Graph API 移除洞察報告人口統計資料衡量數據的非關鍵時間範圍

2024 年 5 月 21 日,我們推出了 Instagram Graph API 第 20 版。

在此版本推出 90 天後(即 2024 年 8 月 19 日),Graph API 將不再就您於 Instagram Graph API 的非關鍵時間範圍內互動和接觸的廣告受眾成員,提供相關人口統計資料衡量數據,例如過去 14 天和 90 天內的國家/地區、城市、年齡和性別分佈資訊。

Instagram Graph API 仍會像 Instagram 應用程式一樣,傳回過去一個月(即「this_month」)和過去一週(即「this_week」)的人口統計資料,以確保不同平台之間的資料均為一致。

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

請參閱開發人員文件了解詳情。

API 版本停用資訊:

請注意,根據 Facebook 的 Graph API推廣 API 版本控制時間表,接下來的停用項目如下:

Graph API

  • 2024 年 5 月 28 日:Graph API v13.0 停止提供服務,並會從平台中移除。

  • 2024 年 9 月 17 日:Graph API v14.0 停止提供服務,並會從平台中移除。

  • 2024 年 11 月 20 日:Graph API v15.0 停止提供服務,並會從平台中移除。

推廣 API

  • 2024 年 8 月 13 日:推廣 API v18.0 停止提供服務,並會從平台中移除。

  • 2025 年 2 月 4 日:推廣 API v19.0 停止提供服務,並會從平台中移除。

為免導致業務中斷,我們建議您立即將所有呼叫轉移至今天發佈的最新 API 版本。

Meta Business SDK

Meta Business SDK v20 版本

Meta Business SDK v20 將緊隨 Graph API v20 版本之後發佈。此版本將包含錯誤修正、相依項目升級、全新功能;最重要的是,此版本亦包括經更新的 API 介面,以與 Graph API v20 保持一致。

在此版本中,我們亦將推出額外的 Instagram API 支援項目,其中包括 IGMediaForIGOnlyAPI、IGUserForIGOnlyAPI、IGRefreshAccessTokenForIGOnlyAPI 和 IGAccessTokenForIGOnlyAPI。除了現有的 Instagram API,這些項目也讓您能透過更多方式來直接擷取影音素材。我們的目標是引入更多涵蓋其他 Meta 產品的 API,以豐富 Business SDK 的生態系統。

請注意,根據我們平台 SDK 的兩年停用時間表,接下來的停用和棄用項目如下:

  • 2024 年 5 月:Facebook 平台 SDK v13.0 及更低版本將被棄用。