推廣 API 版本

推廣 API 參考資料

推廣 API 根節點

這是 Facebook 推廣 API 根節點的完整清單,內含每個節點的參考文件連結。如欲了解 API 架構如何呼叫根節點及其關係連線的背景資訊,請查看使用 Graph API

您需要登入 Facebook 才能存取所有參考資料資訊。

節點 說明

/{AD_ACCOUNT_USER_ID}

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

/act_{AD_ACCOUNT_ID}

代表管理廣告的企業實體

/{AD_ID}

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

/{AD_CREATIVE_ID}

圖片廣告、輪播廣告、焦點系列廣告或者影片廣告的格式

/{AD_SET_ID}

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

/{AD_CAMPAIGN_ID}

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

用戶

關係連線

關係連線 說明

/adaccounts

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

/accounts

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

/promotable_events

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

廣告帳戶

推廣 API 內屬於同一廣告帳戶的所有廣告物件系列。

關係連線

廣告帳戶節點最常用的關係連線。請瀏覽廣告帳戶關係連線參考資料,以獲取全部關係連線的完整清單。

關係連線 說明

/adcreatives

定義廣告的外觀與內容

/adimages

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

/ads

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

/adsets

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

/advideos

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

/campaigns

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

/customaudiences

此廣告帳戶擁有/與之分享的自訂廣告受眾

/insights

洞察報告的介面。刪除子物件的重複數據,提供已排序的非同步報告

/users

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

與廣告組合關聯的單一廣告。

關係連線

廣告節點最常用的關係連線。請瀏覽廣告關係連線參考資料,以獲取全部關係連線的完整清單。

關係連線 說明

/adcreatives

定義廣告的外觀與內容

/insights

廣告成效的洞察報告

/leads

任何與名單型廣告關聯的潛在顧客

/previews

產生現有廣告的廣告預覽

廣告組合

廣告組合是一組共享相同單日預算或總經費、預定時間、出價類型、出價資訊及目標指定資料的廣告。

關係連線

廣告組合節點最常用的關係連線。請瀏覽廣告組合關係連線參考資料,以獲取全部關係連線的完整清單。

關係連線 說明

/activities

廣告組合中的動作記錄

/adcreatives

定義廣告的內容與外觀

/ads

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

/insights

廣告成效的洞察報告

廣告宣傳活動

宣傳活動是廣告帳戶組織架構中的最高級別,會呈現廣告客戶的單一目標。

關係連線

廣告宣傳活動節點最常用的關係連線。請瀏覽廣告宣傳活動關係連線參考資料,以獲取全部關係連線的完整清單。

關係連線 說明

/ads

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

/adsets

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

/insights

廣告成效的洞察報告

廣告創意

用於提供版面配置並包含廣告內容的格式。

關係連線

廣告創意節點最常用的關係連線。請瀏覽廣告創意關係連線參考資料,以獲取全部關係連線的完整清單。

關係連線 說明

/previews

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