> ## 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 Ads Manager で確認できます。
Ayrshare は、広告、広告セット、キャンペーンの各レベルのすべての設定を処理します。
Facebook Ads Manager で直接設定を手動で編集する必要は一切ありません。

<Note>
  1. 広告機能を利用するには、有料の広告アドオンが必要です。これは
     [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 Page とリンクされた 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="Ads Flow" width="1596" height="437" data-path="images/apis/ads/ads-flow.webp" />

Facebook で投稿をブーストするのは、既存の投稿を広告に変換するための迅速でシンプルな方法です。プラットフォームに実装するための概要フローは以下のとおりです。

<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>
        このブースト投稿の目標戦略を、ゴールを選択して設定します。
      </li>

      <li>年齢、性別、地域、興味関心などに基づいてオーディエンスを
      カスタマイズします。</li>
      <li>合計でいくら費やすかを選択します。</li>
      <li>広告を実行する期間を
      設定します。</li>
    </ul>
  </Step>

  <Step title="確認とブースト">
    すべての設定を再確認します。問題がなければ、ユーザーは **「Boost Post Now」** などのボタンをクリックします。
  </Step>

  <Step title="広告審査と公開">
    Facebook は広告をレビューします — 通常、数分から数時間かかります。承認されると、
    ブースト投稿は公開され、設定に従って実行されます。
  </Step>

  <Step title="支出とパフォーマンスの追跡">
    次の項目を監視します:

    * リーチ
    * エンゲージメント
    * クリック
    * 支出
    * 予算残高

    <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 エンドポイントドキュメントページを参照してください。