> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 广告 API 概览

> 使用 Ayrshare API 将您的帖子转变为 Facebook 广告以进行推广。

export const PlansAvailable = ({plans = [], maxPackRequired}) => {
  let displayPlans = plans;
  if (plans && plans.length === 1) {
    const lowerCasePlan = plans[0].toLowerCase();
    if (lowerCasePlan === "business") {
      displayPlans = ["Launch", "Business", "Enterprise"];
    } else if (lowerCasePlan === "premium") {
      displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
    }
  }
  return <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

<PlansAvailable plans={["premium"]} maxPackRequired={false} />

## 广告 API 简介

Ayrshare 广告 API 提供了以编程方式创建、管理和分析社交媒体广告的能力。

目前支持 **Facebook**，Facebook Ads API（也称为 Facebook Marketing API）可让您将现有帖子转换为付费广告。
这包括推广帖子（将帖子转换为广告）、管理广告、跟踪表现以及分析广告支出。

通过 Ayrshare 创建和更新的广告，始终可以在 Facebook 广告管理器（Facebook Ads Manager）中找到。
Ayrshare 会处理广告、广告集（ad set）和活动（campaign）层面的所有设置。
无需在 Facebook 广告管理器中手动直接编辑任何设置。

<Note>
  1. 广告功能需要付费的 Ads 附加组件，可在 [Web 控制台](https://app.ayrshare.com/account) 的 Account 页面上启用。

  2. 用户在创建广告前，必须在 Facebook（Meta）中 [绑定支付方式](https://business.facebook.com/billing_hub/payment_settings/?placement=ads_manager)。

  3. 在 2025 年 4 月 1 日之前与 Facebook 主页关联的用户配置文件应重新绑定以启用广告功能。
</Note>

有关更多信息，请参阅我们的 [Facebook Ads API 指南](https://www.ayrshare.com/blog/facebook-ads-api-boosting-with-the-marketing-api/)。

## 创建广告的流程

<img class="center" src="https://mintcdn.com/ayrshare-docs/Nmrhj2Gh7WSf62Bh/images/apis/ads/ads-flow.webp?fit=max&auto=format&n=Nmrhj2Gh7WSf62Bh&q=85&s=3e57ee2134ddc3bb0937acf5b3d31781" alt="广告流程" width="1596" height="437" data-path="images/apis/ads/ads-flow.webp" />

在 Facebook 上推广（Boost）一条帖子，是将您已发布的帖子快速简便地转化为广告的方式。以下是在您的平台上实现该流程的高层步骤：

<Steps>
  <Step title="选择 Facebook 广告账户">
    您的用户将选择一个已配置好所有账单信息的 Facebook 广告账户。

    <Card title="获取 Facebook 广告账户" href="/apis/ads/facebook/get-ad-accounts" horizontal />
  </Step>

  <Step title="选择帖子">
    从您的 Facebook 主页中选择一条帖子。可以是照片、视频、状态更新等。

    > **提示：** 具有良好自然互动（点赞、分享、评论）的帖子在被推广时通常表现更好。
  </Step>

  <Step title="点击 “Boost Post”（推广帖子）">
    您的用户将点击平台上的类似"Boost Post"（推广帖子）按钮，开始设置广告。

    <Card title="通过将帖子提交到 Facebook 广告平台进行推广" href="/apis/ads/facebook/boost-post" horizontal />
  </Step>

  <Step title="设置目标、受众、预算和持续时间">
    用户可以设置多个参数。

    <ul className="custom-bullets">
      <li>
        通过选择一个目标（goal）来为此次推广帖子选择目标策略。
      </li>

      <li>根据年龄、性别、地理位置、兴趣等自定义受众。</li>
      <li>选择总共要花费多少预算。</li>
      <li>设置广告投放的时间段。</li>
    </ul>
  </Step>

  <Step title="审核并推广">
    仔细核对所有设置。如果一切正常，用户将点击类似 **"Boost Post Now"**（立即推广帖子）的按钮。
  </Step>

  <Step title="广告审核与上线">
    Facebook 将审核该广告——通常需要几分钟到几个小时。审核通过后，被推广的帖子即会上线，并按照设置进行投放。
  </Step>

  <Step title="跟踪支出与表现">
    监控以下内容：

    * 触达（Reach）
    * 互动（Engagement）
    * 点击（Clicks）
    * 支出（Spend）
    * 剩余预算（Budget Remaining）

    <Card title="获取 Facebook 广告支出与分析数据" href="/apis/ads/facebook/get-ad-history" horizontal />
  </Step>
</Steps>

## 广告 API 最佳实践

1. **预算管理**：先使用小额测试预算（例如每天 5-10 美元）来优化投放效果，之后再扩大规模。
2. **广告时长**：Facebook 要求广告的开始时间与结束时间之间至少间隔约 30 小时。
3. **兴趣定位**：选择 2-5 个相关兴趣以获得最佳定位精度。
4. **创意规范**：使用高质量的图像与简洁的文案，以提升互动率。
5. **表现监控**：定期检查广告表现，并根据需要调整定位或创意元素。

有关每个端点的详细信息，包括请求参数、响应格式和示例，请参阅各个 API 端点文档页面。