> ## 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 主頁關聯的 User Profile 應重新綁定以啟用廣告功能。
</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 端點文檔頁面。