Chuyển đến nội dung chính
POST
Boost một bài đăng Facebook hiện có để tạo một quảng cáo. Endpoint này cho phép bạn chuyển đổi các bài đăng tự nhiên (organic) của mình thành các quảng cáo trả phí với các tham số nhắm mục tiêu, ngân sách và lịch trình tùy chỉnh.
  • Ngân sách và số tiền đặt giá phải được chỉ định bằng USD với tối đa hai chữ số thập phân.
  • Quảng cáo phải chạy ít nhất 30 giờ để đáp ứng yêu cầu của Facebook.
  • Bạn có thể sử dụng endpoint interests để tìm ID sở thích dùng cho việc nhắm mục tiêu.
  • Facebook có thể mất tối đa 24 giờ để xem xét và phê duyệt các bài đăng được boost.
  • Nếu sử dụng fbPostId trực tiếp (thay vì postId của Ayrshare), hãy đảm bảo đó là một ID bài đăng Facebook hợp lệ.

Mục tiêu Quảng cáo (Ad Goals)

Mỗi quảng cáo phải có một mục tiêu. Mục tiêu quyết định cách quảng cáo sẽ được tối ưu hóa để hiển thị.
  • engagement: Mục tiêu này nhằm tăng mức tương tác đồng thời đảm bảo rằng quảng cáo tiếp cận số lượng người dùng duy nhất tối đa. Nó cân bằng giữa khả năng hiển thị và tương tác, hiển thị quảng cáo cho càng nhiều người khác nhau càng tốt — những người có khả năng tương tác với quảng cáo.
  • interactions: Được thiết kế để tăng cường các tương tác như thích, bình luận và chia sẻ trên quảng cáo. Facebook ưu tiên hiển thị quảng cáo cho những người dùng có nhiều khả năng tương tác với nó nhất.
  • awareness_views: Tập trung vào việc tăng nhận diện thương hiệu bằng cách tối đa hóa số lần quảng cáo được hiển thị. Nó ưu tiên hiển thị quảng cáo càng nhiều lần càng tốt trong phạm vi ngân sách, bất kể độ phủ (reach) duy nhất.
  • awareness_audience: Nhằm nâng cao nhận diện thương hiệu bằng cách tối đa hóa số người duy nhất xem quảng cáo. Nó đảm bảo rằng quảng cáo tiếp cận càng nhiều người dùng khác nhau càng tốt và tối đa hóa quy mô đối tượng duy nhất thay vì hiển thị nhiều lần cho cùng một đối tượng.
Tìm hiểu thêm về việc tích hợp Facebook Marketing API với Ayrshare trong Hướng dẫn tích hợp Facebook Marketing API của chúng tôi.

Tham số Header

Tham số Body

accountId
string
bắt buộc
ID của tài khoản quảng cáo Facebook để boost bài đăng. ID tài khoản có thể được lấy từ endpoint ad accounts.
adName
string
bắt buộc
Tên cho quảng cáo của bạn (hiển thị trong Facebook Ad Manager) với định dạng {adName} - {postId hoặc fbPostId} - {ngày hiện tại}.
bidAmount
number
bắt buộc
Số tiền đặt giá tối đa bằng USD. Số tiền đặt giá tối thiểu là $1.00.
budget
number
bắt buộc
Ngân sách hàng ngày bằng USD. Ngân sách tối thiểu là $1.00.
fbPostId
string
bắt buộc
ID bài đăng xã hội Facebook của bài đăng cần boost, cho phép bạn tạo quảng cáo từ một bài đăng được tạo trực tiếp trên Facebook. Đây là ID của bài đăng trên Facebook, không phải của Ayrshare. Bắt buộc nếu postId không được đặt.
goal
string
mặc định:"engagement"
bắt buộc
Mục tiêu của quảng cáo. Giá trị: engagement, interactions, awareness_views, và awareness_audience. Xem chi tiết ad goals ở trên để biết thêm thông tin.
locations
object
bắt buộc
Vị trí quảng cáo nhắm mục tiêu, dưới dạng một đối tượng gồm các mảng: countries, regions, cities.
postId
string
bắt buộc
Ayrshare post ID của bài đăng cần boost. Bắt buộc nếu fbPostId không được đặt.
status
string
mặc định:"active"
bắt buộc
Trạng thái của quảng cáo. Giá trị: activepaused.Bạn có thể thay đổi trạng thái của quảng cáo sau này bằng cách sử dụng endpoint update ad.
adSetBudgetSharingEnabled
boolean
mặc định:false
Kiểm soát việc chia sẻ ngân sách ad set cấp chiến dịch của Meta. Meta hiện yêu cầu trường wire này trên mọi chiến dịch được tạo mà không có ngân sách cấp chiến dịch, vì vậy Ayrshare luôn gửi nó — mặc định là false để tương thích ngược.Đặt thành true để cho phép Meta chia sẻ tối đa ~20% ngân sách của một ad set với các ad set khác trong cùng chiến dịch nhằm tối ưu hóa hiệu suất tổng thể. Xem tài liệu tham khảo ad campaign group của Meta để biết chi tiết.
tracking
object
Theo dõi quảng cáo bằng Facebook Pixel.
urlTags
array
Thêm thẻ UTM vào URL quảng cáo.
Ví dụ, nếu URL liên kết là https://www.mysite.com/my-post và các URL tag được thêm là:utm_source=ayrshare, utm_medium=social, và utm_campaign=ayrshare-social.URL quảng cáo sẽ là: https://www.mysite.com/my-post?utm_source=ayrshare&utm_medium=social&utm_campaign=ayrshare-social.
specialAdCategories
array
Meta yêu cầu các nhà quảng cáo trong các danh mục quảng cáo đặc biệt phải tự xác định danh mục chiến dịch của mình.Nếu doanh nghiệp của bạn thuộc một trong các danh mục này, bạn phải chọn danh mục phù hợp khi boost bài đăng.Các giá trị sau được hỗ trợ:
  • housing: Quảng cáo quảng bá hoặc liên kết trực tiếp đến cơ hội nhà ở hoặc dịch vụ liên quan, bao gồm nhưng không giới hạn: danh sách bán hoặc cho thuê nhà/căn hộ, bảo hiểm nhà, bảo hiểm thế chấp, các khoản vay thế chấp, dịch vụ sửa chữa nhà và dịch vụ định giá hoặc vốn chủ sở hữu nhà ở.
  • financial_product_services: Quảng cáo quảng bá hoặc liên kết trực tiếp đến các sản phẩm và dịch vụ tài chính, bao gồm cả tín dụng.
  • employment: Quảng cáo quảng bá hoặc liên kết trực tiếp đến cơ hội việc làm, bao gồm nhưng không giới hạn: công việc bán thời gian hoặc toàn thời gian, thực tập hoặc các chương trình chứng chỉ chuyên môn. Các quảng cáo liên quan thuộc danh mục này bao gồm quảng bá bảng tin việc làm hoặc hội chợ việc làm, dịch vụ tổng hợp hoặc quảng cáo mô tả các phúc lợi mà công ty có thể cung cấp, bất kể có lời mời làm việc cụ thể hay không.
  • issues_elections_politics: Quảng cáo được tạo bởi, thay mặt cho, hoặc về một ứng cử viên cho chức vụ công, một nhân vật chính trị, một đảng chính trị, hoặc vận động cho kết quả của một cuộc bầu cử cho chức vụ công. Điều này cũng bao gồm quảng cáo về bất kỳ cuộc bầu cử, trưng cầu dân ý hoặc sáng kiến bỏ phiếu nào, bao gồm các chiến dịch bầu cử “Hãy đi bỏ phiếu”. Quảng cáo được quản lý như quảng cáo chính trị hoặc về các vấn đề xã hội tại bất kỳ nơi nào quảng cáo được đặt. Nếu chọn các vấn đề, bầu cử hoặc chính trị, bạn phải chọn quốc gia mà bạn muốn chạy các quảng cáo này. Bạn phải được ủy quyền để chạy quảng cáo về các vấn đề xã hội, bầu cử hoặc chính trị tại quốc gia được chỉ định.
Meta yêu cầu các nhà quảng cáo phải tự xác định danh mục chiến dịch của mình. Meta sử dụng người xem xét và học máy để xác định các loại quảng cáo này. Nếu bạn gửi cho chúng tôi một specialAdCategory không chính xác, có nguy cơ quảng cáo của bạn sẽ bị tạm dừng cho đến khi chiến dịch được điều chỉnh.
endDate
string
Ngày và giờ kết thúc theo định dạng ISO 8601 (phải cách ngày bắt đầu ít nhất 30 giờ), ví dụ 2025-03-01T00:00:00Z.Nếu không được đặt, quảng cáo sẽ chạy vô thời hạn và có ngày kết thúc là ongoing.
excludedLocations
object
Loại trừ các vị trí bằng cách sử dụng một đối tượng có các mảng countries, regions, và cities.
gender
string
mặc định:"all"
Giới tính của đối tượng. Giá trị: all, male, female.
interests
array
Các sở thích mục tiêu của quảng cáo dưới dạng một mảng interest ids của Facebook.
maxAge
number
mặc định:65
Độ tuổi tối đa để nhắm mục tiêu quảng cáo (mặc định: 65).
minAge
number
mặc định:18
Độ tuổi tối thiểu để nhắm mục tiêu quảng cáo (mặc định: 18).
startDate
string
Ngày và giờ bắt đầu theo định dạng ISO 8601, ví dụ 2025-03-01T00:00:00Z.Nếu không được đặt, quảng cáo sẽ bắt đầu ngay lập tức.
dsaBeneficiary
string
Bên thụ hưởng của quảng cáo để tuân thủ Đạo luật Dịch vụ Kỹ thuật số (DSA) cho các quốc gia EU. Phải được đặt cùng với dsaPayor nếu một trong hai được cung cấp. Vui lòng tham khảo hướng dẫn DSA của chúng tôi để biết thêm thông tin.
dsaPayor
string
Bên chi trả của quảng cáo để tuân thủ Đạo luật Dịch vụ Kỹ thuật số (DSA) cho các quốc gia EU. Phải được đặt cùng với dsaBeneficiary nếu một trong hai được cung cấp.