跳转到主要内容
POST
推廣一條現有的 Facebook 貼文以建立廣告。 此端點允許您使用自定義定位、預算和排期參數,將自然發布的貼文轉換為付費廣告。
  • 預算和出價金額必須以美元(USD)指定,最多保留兩位小數。
  • 為滿足 Facebook 的要求,廣告必須至少投放 30 小時。
  • 您可以使用 興趣端點 來查找用於定位的興趣 ID。
  • Facebook 審核並批準推廣貼文最多可能需要 24 小時。
  • 如果直接使用 fbPostId(而非 Ayrshare 的 postId),請確保它是有效的 Facebook 貼文 ID。

廣告目標

每條廣告都必須設定一個目標(goal)。目標決定了廣告將如何針對展示進行最佳化。
  • engagement(互動):該目標旨在提升互動,同時確保廣告觸達盡可能多的獨立使用者。 它在曝光度與互動之間取得平衡,把廣告展示給盡可能多可能與之互動的不同使用者。
  • interactions(互動動作):旨在增加廣告的互動,例如按讚、評論和分享。 Facebook 會優先將廣告展示給最有可能與之互動的使用者。
  • awareness_views(品牌認知—展示):透過最大化廣告的展示次數來提升品牌認知。 它會在預算范圍內優先盡可能多次地展示廣告,而不考慮獨立觸達。
  • awareness_audience(品牌認知—受眾):透過最大化看到廣告的獨立使用者數量來增強品牌認知。 它確保廣告觸達盡可能多的不同使用者,並最大化獨立受眾規模,而不是對同一受眾多次展示。
在我們的 Facebook Marketing API 整合指南 中了解更多有關將 Facebook Marketing API 與 Ayrshare 整合的資訊。

請求頭參數

請求體參數

accountId
string
必填
用於推廣該貼文的 Facebook 廣告帳戶 ID。可以從 廣告帳戶端點 獲取帳戶 ID。
adName
string
必填
您的廣告名稱(顯示在 Facebook 廣告管理器中),格式為 {adName} - {postId or fbPostId} - {current date}
bidAmount
number
必填
最高出價金額,以美元計。最低出價金額為 $1.00。
budget
number
必填
每日預算,以美元計。最低預算為 $1.00。
fbPostId
string
必填
要推廣的貼文的 Facebook 社群貼文 ID,可用於以直接在 Facebook 上建立的貼文來建立廣告。 這是 Facebook 上貼文 的 ID,而不是 Ayrshare 的 ID。如果未設定 postId,則該參數必填。
goal
string
默认值:"engagement"
必填
廣告的目標。可選值:engagementinteractionsawareness_viewsawareness_audience。 詳見上文 廣告目標詳細說明
locations
object
必填
廣告的目標位置,採用包含陣列的物件:countriesregionscities
postId
string
必填
要推廣的貼文的 Ayrshare 貼文 ID。如果未設定 fbPostId,則該參數必填。
status
string
默认值:"active"
必填
廣告的狀態。可選值:activepaused之後可以使用 更新廣告端點 修改廣告狀態。
adSetBudgetSharingEnabled
boolean
默认值:false
控制 Meta 在活動層級的廣告集預算共享。 Meta 現在要求在每個未設定活動級預算的活動上都傳遞此參數欄位,因此 Ayrshare 總會發送該欄位——為向後相容預設設為 false設定為 true 可讓 Meta 在同一活動的其他廣告集之間共享某個廣告集最多約 20% 的預算,以最佳化整體表現。詳見 Meta 的 廣告活動組參考
tracking
object
使用 Facebook Pixel 追蹤廣告。
urlTags
array
向廣告 URL 添加 UTM 標簽。
例如,如果連結 URL 為 https://www.mysite.com/my-post,添加的 URL 標簽為:utm_source=ayrshareutm_medium=socialutm_campaign=ayrshare-social那麼廣告 URL 將為: https://www.mysite.com/my-post?utm_source=ayrshare&utm_medium=social&utm_campaign=ayrshare-social
specialAdCategories
array
Meta 要求屬於 特殊廣告類別 的廣告主必須自行標識其活動類別。如果您的業務屬於其中之一,在推廣貼文時必須選擇相應的類別。支援以下取值:
  • housing(住房):推廣或直接連結到住房機會或相關服務的廣告,包括但不限於房屋或公寓的 出售/出租資訊、房主保險、按揭保險、按揭貸款、房屋維修以及房屋淨值或估價服務。
  • financial_product_services(金融產品與服務):推廣或直接連結到金融產品與服務優惠 (包括信貸)的廣告。
  • employment(就業):推廣或直接連結到就業機會的廣告,包括但不限於兼職或全職工作、 實習或專業認證專案。此類別還包括對招聘網站或招聘會、招聘聚合服務,或詳述公司福利的廣告 (無論是否有具體的職位提供)。
  • issues_elections_politics(社會議題、選舉或政治):由候選人、政治人物、政黨,或代表他們, 或與其相關的廣告,或倡導選舉結果的廣告。這也包括與任何選舉、公投或投票倡議相關的廣告, 包括”號召投票”的選舉宣傳。以及在投放地被視為政治廣告或涉及社會議題的廣告。若選擇社會議題、 選舉或政治,則必須選擇投放這些廣告的國家/地區。您必須已獲得在該指定國家/地區投放社會議題、 選舉或政治相關廣告的授權。
Meta 要求廣告主必須自行標識其活動類別。 Meta 會使用人工審核和機器学習來識別此類廣告。 如果您向我們發送了錯誤的 specialAdCategory,您的廣告可能會被暫停,直到活動被調整為止。
endDate
string
ISO 8601 格式的結束日期和時間(必須至少在開始時間後 30 小時),例如 2025-03-01T00:00:00Z如果未設定,廣告將無限期執行,結束日期為 ongoing(進行中)。
excludedLocations
object
使用一個包含 countriesregionscities 陣列的物件來排除位置。
gender
string
默认值:"all"
受眾性別。可選值:all(全部)、male(男性)、female(女性)。
interests
array
廣告的目標興趣,作為 Facebook 興趣 ID 的陣列。
maxAge
number
默认值:65
廣告定位的最大年齡(預設:65)。
minAge
number
默认值:18
廣告定位的最小年齡(預設:18)。
startDate
string
ISO 8601 格式的開始日期和時間,例如 2025-03-01T00:00:00Z如果未設定,廣告將立即開始投放。
dsaBeneficiary
string
面向歐盟國家、用於合規《數字服務法》(DSA)的廣告受益人。若提供 dsaPayordsaBeneficiary 中任一個, 則必須同時設定兩者。有關更多資訊,請參閱我們的 DSA 指南
dsaPayor
string
面向歐盟國家、用於合規《數字服務法》(DSA)的廣告付款方。若提供 dsaBeneficiarydsaPayor 中任一個, 則必須同時設定兩者。