行銷 API 版本

行銷 API 參考資料

此為 Facebook 行銷 API 根節點的完整清單，每個根節點皆包含參考文件的連結，可用的關係連線則另行說明。有關如何呼叫根節點及其關係連線的 API 架構背景資訊，請參閱使用圖形 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`	洞察報告介面。功能包括刪除子物件間的重複資料、進行排序、非同步報告。