行銷 API 版本

行銷 API 參考資料

行銷 API 根節點

此為 Facebook 行銷 API 根節點的完整清單,每個根節點皆包含參考文件的連結。如需瞭解這項 API 的架構、如何呼叫根節點及其關係連線,請參閱使用圖形 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

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