如果你在連結 Facebook 時遇到問題,請參閱疑難排解
指南。
發布到 Facebook
使用 Facebook API 發布內容需要連結一個 Facebook 粉絲專頁。Facebook 不允許連結個人帳號。 發布含連結與圖片到 Facebook 粉絲專頁的基本貼文 JSON 範例:Facebook Post with Image
- 除非貼文中已包含圖片或影片,否則 Facebook 會自動顯示貼文中連結的預覽。 上述範例會顯示圖片,若移除圖片,就會改為顯示連結預覽。
- 如果你的影片副檔名不是常見的影片格式(例如 mp4),請使用
isVideo參數。詳情請參閱 /post 端點。 - Facebook 也支援發送不含貼文文字的媒體。如果你不想包含貼文文字,
請傳送空字串
post: ""。 - 更多資訊請參閱 Facebook 媒體指南 與 Facebook 授權。
輪播圖片
透過 Ayrshare API 的carousel body 參數發布 Facebook 輪播圖片。
Facebook Carousel Post
- 最上層的
link參數是輪播末端的 URL。 items是包含以下值的物件陣列。items 陣列最少 2 個元素、最多 10 個 元素。picture- 輪播圖片的 URL。link- 點擊該圖片時的目的 URL。name-(選填)顯示在每個圖片卡片上的名稱。
carousel 同時使用 media_urls。若使用 media_urls,carousels 會被忽略。
更多資訊請參閱我們的 Facebook 輪播指南。
Facebook Reels
透過以下facebookOptions,你可以將影片發布到 Facebook Reels。
Meta 對每個已連結的 Facebook 粉絲專頁在任何 24 小時內設有 30 則 Reels 的上限,以防止
垃圾內容並維持平台品質。此為滾動限制,計算的是最近的 24
小時,而非日曆日。
Facebook Reels Post
reels:設為true即可將影片發布到 Reels。若要發布到 Facebook Reels 為必填。title:影片標題,最多 255 個字元。超過 255 個字元的部分會被 截斷。選填。thumbNail:影片的縮圖(封面圖片)。縮圖應為 JPEG 或 PNG 檔案的 URL,大小應小於 10MB。選填。
Facebook Stories
以照片或影片的形式將 Facebook Stories 發布到 Facebook 粉絲專頁。- Facebook Stories 不支援貼文文字 —
post欄位中提供的任何文字(包含 提及)都會被忽略。 - 上傳為 story 的照片或影片不能是先前已發布的貼文中使用過的媒體。
- 影片 story 不得超過 60 秒。
- 請開啟 Stories Archive 才能透過 GET 取得 stories。
Facebook Stories Post
媒體說明
為發布的每張 Facebook 圖片設定媒體說明。 接受字串說明文字的陣列。每個陣列元素必須對應一個媒體 URL。例如 [“This is my best pic”, ”😃 here is the next one”] 分別對應mediaUrls 中的第 1 個與第 2 個 URL。
Facebook Media Captions
地點標註
Facebook 地點標籤透過locationId 指定,其為 Facebook Page ID 或 Facebook Page 名稱。例如,Guggenheim Museum 的 Facebook page ID 是 7640348500,或 Facebook page 名稱 "@guggenheimmuseum"。粉絲專頁必須關聯有實體地點。
Facebook Location Tagging
locationId(Page ID)。請注意,該粉絲專頁必須有列出地點,否則 locationId 會回傳錯誤。
不支援套用於純文字貼文、圖片、Reels 與 Stories。Meta 不支援對影片進行地點標註。
受眾鎖定
在 Facebook 上建立 Page 貼文時,可以使用兩種鎖定方式將可見範圍限制在特定受眾:- Facebook Targeting:可依年齡、性別、地區與感情狀態等條件定義貼文的受眾。透過設定這些參數,你可以確保只有符合條件的人能看到你的貼文。
- Facebook Feed Targeting:可進一步微調貼文在目標受眾動態消息中的可見度。
Targeting
Facebook targeting 會將發布內容的受眾限制於特定人口統計族群。不在這些族群中的人將無法看到該內容。此設定不會覆蓋粉絲專頁層級可能已設定的人口統計限制。targeting 可用的人口統計欄位:
ageMin:限制可看到貼文的最低年齡。可接受的值為 13、15、18、21 或 25。其他年齡會被拒絕。countries:又稱地區圍籬(geofencing),可限制哪些國家可以看到該貼文。以 國家代碼 陣列表示。最多可鎖定 25 個國家。 若你需要鎖定超過 25 個國家或限制某些國家,請參閱 Facebook 粉絲專頁國家限制。
Facebook Targeting
Feed Targeting
Facebook feed targeting 群組中的使用者較有可能看到此貼文,其他人較不容易看到,但仍可能會看到。如果你想確保限制生效,請使用上方的 targeting。feedTargeting 可用的人口統計欄位:
ageMin:限制可看到貼文的最低年齡。整數值為 13 以上。預設為 0。ageMax:限制可看到貼文的最高年齡。整數值為 65 以下。countries:又稱地區鎖定(geo targeting),可指定哪些國家的使用者能看到 該貼文。以國家代碼陣列表示。collegeYears:鎖定大學畢業年齡的使用者觀看該貼文。以大學畢業年份的整數陣列 表示。educationStatuses:鎖定教育程度的使用者觀看該貼文。以整數陣列表示, 以鎖定不同教育程度。1代表高中、2代表大學部、3代表 校友。genders:鎖定觀看貼文的性別。以整數陣列鎖定特定性別。1鎖定所有男性觀看者,2為女性。預設為兩者皆鎖定。relationshipStatuses:鎖定觀看貼文的感情狀態。以整數陣列表示, 以依感情狀態鎖定。1代表單身、2代表 ‘in a relationship’、3代表 已婚、4代表已訂婚。預設為全部類型。
Facebook Feed Targeting
替代文字
為 Facebook 圖片或影片加上替代文字(alt text)。Facebook alt text 是一項無障礙功能,可提供額外的使用者資訊,並協助螢幕閱讀器讀取內容。 請在faceBookOptions 物件中使用 altText。
Facebook Alt Text
mediaUrls 陣列中的一張圖片或一部影片,並依序套用到每張圖片上。
影片縮圖
為 Facebook 影片設定縮圖(封面圖片)。請傳送 PNG 或 JPG 檔案的遠端 URL,尺寸須與影片相同且小於 10 MB。URL 應以 .png 或 .jpg 結尾。Example Facebook Video Thumbnail
影片標題
透過title 參數為 Facebook 影片加上標題。
Facebook Video Title
動態 GIF
發布 Facebook 動態 GIF 時,mediaUrls 陣列中只允許一個 URL。
如果媒體 URL 不是以 “.gif” 或 ”.GIF” 結尾,請將 isVideo 欄位設為 true。
Facebook Animated GIF
Facebook 粉絲專頁提及
你可以透過在貼文文字中加入 Facebook 粉絲專頁名稱或 Page ID 來提及另一個 Facebook 粉絲專頁(也稱為 Facebook 提及或 Facebook 標註)。 Facebook 不允許提及或標註個人檔案或社團。 用以下 @提及 格式加入提及:@page-name 或 @[page-id]
使用粉絲專頁名稱提及
使用粉絲專頁名稱的貼文文字範例。你可以從 Facebook URL 找到粉絲專頁名稱,例如 https://www.facebook.com/AyrshareFacebook Page Mention with Page Name
使用 Page ID 提及
使用 Page ID 的貼文文字範例,注意 [] 的使用。如何取得 Page ID 請參閱下方說明。Facebook Page Mention with Page ID
找出 Facebook Page ID
Brand 端點
你可以使用 Brand 端點 查詢 Facebook 使用者或 Facebook 粉絲專頁。在 Facebook.com
- 從 Facebook 動態消息,點擊左側選單中的 Pages。
- 點擊你的粉絲專頁名稱進入你的粉絲專頁。
- 點擊粉絲專頁頂端的 About。若看不到,請點擊 More▼。
- 向下捲動,在 MORE INFO 下方找到你的 Page ID。
- 如果 Facebook 粉絲專頁的 URL 類似
https://www.facebook.com/ayrshare-1234567890, 則 ID 為 1234567890。 - 如果 Facebook 粉絲專頁的 URL 類似:
https://www.facebook.com/pages/ayrshare/123466789203,則 Page ID 為結尾的數字,例如 123466789203。
你可以透過前往 https://facebook.com/page-id 來測試 Page ID 是否正確,該網址應能解析到對應的粉絲專頁。
你也可以嘗試 Ayrshare 未提供支援的第三方 Facebook 粉絲專頁查詢工具,例如:https://lookup-id.com/
如果以上方法都行不通,你可以在瀏覽器中開啟該 Facebook 粉絲專頁並檢視原始碼。在 Chrome 中,右鍵選擇「View Source」,然後搜尋 owning_profile_id 或 profile_id 來找到 Page ID。
啟用粉絲專頁提及
該粉絲專頁必須允許在貼文與留言中被提及與標註。此功能預設為啟用,但你可以登入 facebook.com 並切換至你的粉絲專頁進行確認。- 以粉絲專頁身分檢視時,點擊右上角的粉絲專頁個人資料圖片。
- 點擊 Settings & Privacy -> Settings。
- 在 Settings 選單中,點擊 Privacy。
- 點擊 Page and Tagging。
- 向下捲動至 Reviewing。
- 切換設定以允許標註與提及。
Meta Business Suite
草稿貼文
建立 Facebook 草稿貼文,草稿會顯示在 Meta Business Suite Draft 分頁。Facebook 草稿貼文是你已開始撰寫但尚未發布的貼文。你可以先儲存草稿之後再回來編輯,或排程於未來的時間發布。 在faceBookOptions 中加入 draft 參數,即可將貼文送出為草稿。適用於純文字、圖片、影片與 Reels 貼文。
Facebook Draft Post
排程發布時間
為 Facebook 貼文設定排程發布時間,該貼文會顯示在 Meta Business Suite Scheduled Posts 分頁。Facebook 排程貼文是指你已建立並排程在未來日期發布,並在 Meta Business Suite 中管理的貼文。這適合用於提前規劃你的社群貼文,或在你已知受眾最活躍的時段發布貼文。 適用於純文字、圖片、影片與 Reels 貼文。 在faceBookOptions 中加入 scheduledPublishDate 參數以排程貼文時間。
Facebook Scheduled Post
連結預覽
Facebook 貼文會自動為貼文內容中的連結建立連結預覽。 但若你想指定不同的連結,或強制顯示連結預覽,可使用link 參數指定連結的 URL。
Facebook Link Preview
mediaUrls 欄位,會顯示媒體而非連結預覽。
