跳转到主要内容
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 中任一个, 则必须同时设置两者。