推廣 API 版本

推廣 API 參考資料

這是 Facebook 推廣 API 根節點的完整清單,內含每個節點的參考文件連結。可用的邊緣會分開顯示。若要瞭解 API 架構的背景、如何調用根節點及其邊緣,請參閱使用 Graph API

主要的根節點為:

根節點 代表項目

/{USER}

建立廣告的 Facebook 用戶。每個廣告用戶可於多個廣告帳戶中擔任一個角色

/act_{AD_ACCOUNT_ID}

代表管理廣告的企業實體

/{CAMPAIGN_ID}

定義廣告宣傳活動的目標。包含一個或多個廣告組合

/{AD_SET_ID}

包含共享預算、排定時間、出價與目標指定的所有廣告

/{AD_ID}

限制某個廣告的資訊,例如廣告創意素材與成效衡量資訊

用戶

邊緣

邊緣 代表項目

/adaccountgroups

與此用戶相關的廣告帳戶群組

/adaccounts

與此用戶相關的所有廣告帳戶

/accounts

某用戶管理的所有專頁與地點

/promotable_events

您建立的所有可推廣活動,或您管理的專頁所建立的可推廣專頁活動

/promotable_domains

此用戶可推廣的所有網域

廣告帳戶

推廣 API 中所有的廣告物件系列都屬於一個廣告帳戶

邊緣

邊緣 代表項目

/campaigns

定義宣傳活動的目標,且包含一個或多個廣告組合

/adsets

包含共享預算、排定時間、出價與目標指定的所有廣告

/ads

某個廣告的資料,例如廣告創意素材與成效衡量資訊

/adcreatives

定義廣告的外觀與內容

/adimages

用於廣告創意的圖庫。可上載並獨立管理

/advideos

用於廣告創意的影片庫。可上載並獨立管理

/activities

廣告帳戶中的動作記錄

/adtags

廣告帳戶中的標籤組合。用於標註類似的宣傳活動、廣告組合或廣告

/adcampaignconversions

廣告帳戶中由廣告組合彙整的轉換數據

/adgroupconversions

廣告帳戶中由廣告彙整的轉換數據

/customaudiences

廣告帳戶的自訂廣告受眾。這些項目有助您鎖定已與您的業務建立關係的對象刊登廣告

/generatepreviews

產生廣告預覽

/offsitepixels

與此帳戶相關的像素

/reachestimate

在特定的目標指定規格內,產生廣告的預計接觸人數

/reportstats

分析報告 API 可擷取廣告帳戶的資料與排定報告時間

/adcampaignstats

廣告帳戶中由廣告組合彙整的統計資料組合

/adgroupstats

廣告帳戶中由廣告彙整的統計資料組合

/targetingsentencelines

產生易懂的廣告組合目標指定描述

/users

與此廣告帳戶相關用戶的清單

/insights

洞察報告的介面。刪除子物件重複的結果、提供排序與同步報告的功能。

廣告宣傳活動

邊緣

邊緣 代表項目

/adsets

包含共享預算、排定時間、出價與目標設定的所有廣告。

/ads

廣告的必要資料,例如廣告創意素材與成效衡量資訊

/adtags

宣傳活動的標籤。用於輕鬆辨識類似的宣傳活動

回傳由宣傳活動彙整的單一統計資料組合

/insights

洞察報告的介面。功能包含刪除子物件重複的結果、提供排序與同步報告的功能。

廣告組合

邊緣

邊緣 代表項目

/ads

廣告的必要資料,例如廣告創意素材與成效衡量資訊

/adcreatives

定義廣告的內容與外觀

/activities

廣告組合中的動作記錄

/adtags

廣告組合的標籤。用於輕鬆辨識類似的廣告組合

/conversions

廣告組合的轉換數據

/insights

洞察報告的介面。功能包含刪除子物件重複的結果、提供排序與同步報告的功能。

邊緣

邊緣 代表項目

/adcreatives

定義廣告的外觀與內容

/adtags

廣告的標籤。用於辨識類似的廣告

/conversions

廣告的轉換數據

/keywordstats

回傳廣告每個目標關鍵字的狀態

/previews

產生現有廣告的廣告預覽

/reachestimate

取得廣告的預計接觸人數

廣告的統計資料組合

/targetingsentencelines

取得易懂的廣告組合目標指定描述

/trackingtag

將點擊標籤分配至廣告。利用點擊追蹤標籤,指定廣告受眾點擊廣告後要觸發的網址。

/insights

洞察報告的介面。功能包含刪除子物件重複的結果、提供排序與同步報告的功能。

廣告創意

邊緣

邊緣 代表項目

/previews

產生現有廣告創意物件的廣告預覽