Skip to main content
POST
既存のFacebook投稿をブーストして広告を作成します。 このエンドポイントを使用すると、オーガニック投稿をカスタムターゲティング、予算、スケジュールパラメータを持つ有料広告に変換できます。
  • 予算と入札額は、小数点以下2桁までのUSDで指定する必要があります。
  • Facebookの要件に対応するため、広告は少なくとも30時間実行する必要があります。
  • ターゲティング用の関心IDを見つけるには、関心エンドポイントを使用できます。
  • Facebookがブースト投稿を確認・承認するまでに最大24時間かかることがあります。
  • fbPostIdを直接使用する場合(AyrshareのpostIdの代わりに)、有効なFacebook投稿IDであることを確認してください。
  • Facebook がキャンペーンを作成した後(クリエイティブ、広告セット、広告のいずれかのステップ)にブーストが失敗した場合、 Ayrshare はそのキャンペーンの削除を試みます。削除にも失敗した場合、空のキャンペーンは広告アカウントに残ります。 広告マネージャー(Ads Manager)で見つけて削除できます。
次の 2 つがそろうまで、Meta は広告を拒否します。
  • 広告アカウントに支払い方法があること。 Meta の請求と支払いで支払い方法を追加し、accountId で送信する広告アカウントに割り当ててください。ビジネスポートフォリオにのみ保存された支払い方法では不十分です。
  • パーソナライズ広告がオンになっていること(EU、EEA、スイス)。 Facebookページにリンクされた Facebook または Instagram アカウントの所有者がパーソナライズを抑えた広告を選択している場合、または広告なしで Meta を利用するサブスクリプションに登録している場合、Meta はそのアカウントとページによる広告の配信を許可しません。所有者はアカウントセンター → 広告設定 → 広告体験でパーソナライズ広告に戻すか、サブスクリプションを解約できます。詳しくはこちら。

広告の目標

各広告には目標が必要です。目標は、広告がどのように表示に最適化されるかを決定します。
  • engagement: この目標は、広告が最大数のユニークユーザーに到達することを保証しながらエンゲージメントを向上させます。可視性とエンゲージメントのバランスを取り、広告に反応する可能性のあるできるだけ多くの人々に広告を表示します。
  • interactions: いいね、コメント、シェアなど、広告へのインタラクションを促進するように設計されています。Facebookは広告に最も関わりそうなユーザーに広告を表示することを優先します。
  • awareness_views: 広告が表示される回数を最大化することで、ブランド認知度を高めることに重点を置きます。ユニークリーチに関係なく、予算内でできるだけ多くの回数広告を表示することを優先します。
  • awareness_audience: 広告を見るユニークユーザー数を最大化することで、ブランド認知度を向上させることを目指します。広告ができるだけ多くの異なるユーザーに到達することを保証し、同じオーディエンスに複数回表示するのではなく、ユニークオーディエンスのサイズを最大化します。
  • traffic: ウェブサイト、ランディングページ、求人情報など、選択した移動先へFacebookの外にユーザーを誘導します。Facebookはプラットフォーム上のエンゲージメントではなくリンククリックに最適化します。これはcallToActionボタンをサポートする唯一の目標です。
AyrshareとFacebook Marketing APIの統合について詳しくは、Facebook Marketing API統合ガイドをご覧ください。

ヘッダーパラメータ

ボディパラメータ

string
必須
投稿をブーストするFacebook広告アカウントのID。アカウントIDは広告アカウントエンドポイントから取得できます。
string
必須
広告の名前(Facebook広告マネージャーに表示されます)。形式は{adName} - {postId or fbPostId} - {current date}となります。
number
必須
最大入札額(USD)。最小入札額は$1.00です。
number
必須
日次予算(USD)。最小予算は$1.00です。
string
必須
ブーストする投稿のFacebookソーシャル投稿ID。Facebookで直接作成された投稿から広告を作成できます。これはFacebook上の投稿のIDであり、AyrshareのIDではありません。postIdが設定されていない場合は必須です。
string
デフォルト:"engagement"
必須
広告の目標。値: engagement、interactions、awareness_views、awareness_audience、traffic。詳細については上記の広告の目標の詳細をご覧ください。
object
配列のオブジェクトでターゲット広告の場所を指定します: countries、regions、cities。 {}のように国、地域、都市のいずれも指定していないオブジェクトは、コード101で拒否されます。米国をターゲットにするにはlocationsを省略してください。
string
必須
ブーストする投稿のAyrshare投稿ID。fbPostIdが設定されていない場合は必須です。
string
デフォルト:"active"
必須
広告のステータス。値: activeおよびpaused。後で広告更新エンドポイントを使用して広告のステータスを変更できます。
boolean
デフォルト:false
Metaのキャンペーンレベルの広告セット予算共有を制御します。 Metaは現在、キャンペーンレベルの予算なしで作成されたすべてのキャンペーンでこのワイヤーフィールドを必須としているため、Ayrshareは常にこれを送信します — 後方互換性のためデフォルトはfalseです。全体的なパフォーマンスを最適化するために、同じキャンペーン内の他の広告セット間で広告セットの予算の約20%までをMetaが共有できるようにするには、trueに設定します。詳細については、Metaの広告キャンペーングループリファレンスをご覧ください。
object
ブースト投稿に、Apply Now(今すぐ応募)やShop Now(今すぐ購入)などのコールトゥアクションボタンを追加します。ボタンはlinkで指定したURLを開きます。destinationを使用すると、代わりにMessenger、WhatsApp、またはInstagram Directのチャットを開きます(リンクの代わりに会話を開くをご覧ください)。
リンクを開くcallToActionはtraffic広告目標でのみサポートされます。destinationを指定したボタンは、リンクの代わりに会話を開くで説明しているとおり、代わりにengagementまたはinteractionsを使用します。 リンクボタンをengagement、interactions、awareness_views、awareness_audienceと共に送信すると、互換性のある目標を示すcode: 101付きの400が返されます。 以前は、この値はどの目標でも受け付けられた後に暗黙的に無視され、ボタンのない広告が作成されていました。
callToAction.linkは移動先URLを指定します。Metaが既存の投稿上でコールトゥアクションをボタンとして表示する場合、urlTagsはそのボタンリンクに追加されます。callToActionなしのgoal: "traffic"も許可されており、ボタンのないトラフィック広告が作成されます。送信したcallToActionは、typeが大文字化された状態でブーストのレスポンスにエコーバックされます(Post Boosted with a Call to Actionの例をご覧ください)。また、その後はブーストされた広告エンドポイントからも広告上に返されます。リンクの代わりにMessenger、WhatsApp、またはInstagram Directのチャットを開くには、リンクの代わりに会話を開くをご覧ください。
object
Facebook Pixelを使用して広告を追跡します。
array
広告URLにUTMタグを追加します。
例えば、リンクURLがhttps://www.mysite.com/my-postで、追加されたURLタグが次のとおりの場合:utm_source=ayrshare、utm_medium=social、utm_campaign=ayrshare-social。広告URLは次のようになります: https://www.mysite.com/my-post?utm_source=ayrshare&utm_medium=social&utm_campaign=ayrshare-social。
array
Metaは、特別広告カテゴリの広告主に対して、キャンペーンカテゴリを自己識別するよう要求します。あなたのビジネスがこれらのカテゴリの1つに該当する場合、投稿をブーストする際に適切なカテゴリを選択する必要があります。以下の値がサポートされています:
  • housing: 住宅の機会または関連サービスを宣伝または直接リンクする広告(住宅またはアパートの売買・賃貸のリスト、住宅所有者保険、住宅ローン保険、住宅ローン、住宅修理、住宅担保または鑑定サービスなどを含むがこれらに限定されない)。
  • financial_product_services: クレジットを含む金融商品およびサービスの提供を宣伝または直接リンクする広告。financial_products_servicesは同等の綴りとして受け付けられ、creditもこのカテゴリのMetaにおける旧称として受け付けられます — 3つの値はいずれも同じカテゴリとしてMetaに到達するため、お手元にある値をそのまま送信できます。
  • employment: 雇用機会を宣伝または直接リンクする広告(パートタイムまたはフルタイムの仕事、インターンシップ、または専門資格プログラムを含むがこれらに限定されない)。このカテゴリに該当する関連広告には、求人掲示板や求人フェアの宣伝、集約サービス、または特定の求人提供に関係なく企業が提供する福利厚生を詳述する広告が含まれます。
  • none: デフォルト。キャンペーンがどの特別広告カテゴリにも該当しないことを宣言します。明示的に送信することはspecialAdCategoriesを完全に省略することと同等であり、常にこのフィールドを送信する呼び出し側が特別扱いなしで「カテゴリなし」を表明できるように受け付けられています。
  • issues_elections_politics: 公職候補者、政治家、政党について、またはそれらのために作成された広告、または公職選挙の結果を主張する広告。これには、選挙、国民投票、または住民投票イニシアチブに関する広告も含まれ、「投票に行こう」選挙キャンペーンも含まれます。広告が掲載される場所での政治広告または社会問題に関する広告として規制される広告。問題、選挙、または政治を選択する場合、これらの広告を実行したい国を選択する必要があります。指定された国で社会問題、選挙、または政治に関する広告を実行するには、認証を受ける必要があります。
値は大文字・小文字を区別しません。認識されない値は、受け付けられる値の一覧を示すcode: 101付きの400で拒否されます。以前は、認識されない値は暗黙的に破棄され、キャンペーンはカテゴリ未指定のまま作成されていたため、タイプミスがあると規制対象の広告がカテゴリを宣言しないまま実行され続けていました。このエラーメッセージ内の受け付けられる値の一覧はMetaの大文字形式で記述され、上記の別の綴りも含まれるため、NONE, HOUSING, FINANCIAL_PRODUCTS_SERVICES, EMPLOYMENT, ISSUES_ELECTIONS_POLITICS, FINANCIAL_PRODUCT_SERVICES, CREDITと表示されます。これらはここに記載されている5つのカテゴリと同じものです — FINANCIAL_PRODUCT_SERVICESとCREDITはfinancial_product_servicesと同等の値であり、追加のカテゴリではありません。関心エンドポイントも同一のメッセージを返します。カテゴリの重複や、["credit", "financial_product_services"]のような同一カテゴリの2つの綴りの送信は受け付けられ、Metaに到達する前に単一のカテゴリにまとめられます。空の値はcode: 101付きの400で拒否されます。これらのカテゴリのいずれかに対してMetaが許可する関心IDを見つけるには、同じ値を関心エンドポイントに渡してください。Meta は、特別広告カテゴリの広告を配信する国の情報も必要とします。Ayrshare は locations からそれらの国を取得します。指定した国に加えて、各地域と各都市の国も含まれます。そのため、英国の都市をターゲットにした housing のブーストは、リクエストに何も追加しなくても英国向けに設定されます。locations を指定しない場合、広告は米国で配信され、キャンペーンも米国向けに設定されます。Meta はこれらのカテゴリについて、各都市の周囲に最小半径も設定しています。半径 17 キロメートルの英国の都市は #2909039 で拒否されました。このエラーは少なくとも 25 キロメートル(15 マイル)を求めるため、25 キロメートル以上を使用してください。
Metaは、キャンペーンカテゴリを自己識別した広告主を要求します。 Metaは人間のレビュアーと機械学習を使用して、これらの種類の広告を識別します。 誤ったspecialAdCategoryを送信した場合、キャンペーンが調整されるまで広告が一時停止されるリスクがあります。
string
ISO 8601形式の終了日時(開始から少なくとも30時間後である必要があります)。例: 2025-03-01T00:00:00Z。設定されていない場合、広告は無期限に実行され、終了日はongoingとなります。
object
countries、regions、citiesの配列を持つオブジェクトを使用して場所を除外します。
string
デフォルト:"all"
オーディエンスの性別。値: all、male、female。
array
Facebook 関心IDの配列としての広告のターゲット関心。
number
デフォルト:65
広告のターゲティングの最大年齢(デフォルト: 65)。
number
デフォルト:18
広告のターゲティングの最小年齢(デフォルト: 18)。
string
ISO 8601形式の開始日時。例: 2025-03-01T00:00:00Z。設定されていない場合、広告はすぐに開始されます。
string
EU諸国向けのデジタルサービス法(DSA)コンプライアンスのための広告の受益者。いずれかが提供されている場合、dsaPayorと共に設定する必要があります。詳細についてはDSAガイドをご覧ください。
string
EU諸国向けのデジタルサービス法(DSA)コンプライアンスのための広告の支払者。いずれかが提供されている場合、dsaBeneficiaryと共に設定する必要があります。

キャンペーン予算

予算を広告セットではなくキャンペーンで保持するには、ネスト形式で budget.level: "campaign" を送信してください。この場合、広告セットは独自の予算を持ちません。日次予算と通算予算のどちらでも使用できます。
  • budget.level: adSet(デフォルト)または campaign。キャンペーン予算は adSetBudgetSharingEnabled と組み合わせることはできません。両方を送信すると、code: 101 とともに 400 が返されます。
  • キャンペーン予算の場合、レスポンスに budgetLevel: "campaign" が追加されます。広告セット予算の場合は budgetLevel が返されないため、フィールドがない場合は adSet として扱ってください。
  • 履歴では、日次キャンペーン予算を使用する広告の budgetDaily にキャンペーンの日次予算が表示されます。複数の広告が 1 つのキャンペーン予算を共有している場合、各広告には自身の配分ではなくキャンペーン予算全体が表示されます。履歴には、キャンペーンと広告セットのどちらの通算予算も表示されません。通算キャンペーン予算が使い切られると、次回の夜間更新後に、そのキャンペーン内のすべての広告(配信予定の広告や審査中の広告を含む)に deliveryStatus: "COMPLETED" が表示されます。却下された広告は REJECTED のままです。

既存のキャンペーンまたは広告セットにブーストする

デフォルトでは、ブーストごとに独自のキャンペーン、広告セット、広告が作成されます。Meta ですでに運用しているキャンペーンまたは広告セットにブーストを追加するには、attachTo を含むネスト形式で送信してください。
  • attachTo.campaignId: ブーストはそのキャンペーン内に新しい広告セットと広告を作成します。budget、targeting、bidAmount は通常どおり送信してください。これらは新しい広告セットに適用されます。
  • attachTo.adSetId: ブーストはその広告セット内に広告のみを作成します。広告セットが属するキャンペーンの attachTo.campaignId も送信してください。budget、targeting、platformOptions.facebook.bidAmount は省略してください。広告セットは独自の設定を維持します。これらのいずれかを送信すると、code: 101 とともに 400 が返されます。
  • キャンペーンまたは広告セットは accountId で指定した広告アカウント内にあり、かつ他のユーザーのブーストに属していない必要があります。そうでない場合、リクエストは 400 を返します。また、Facebook のブーストは Instagram のブーストが作成したキャンペーンに追加できず、その逆も同様です。
  • attachTo は、新しいキャンペーンに設定される budget.level: "campaign"、specialAdCategories、adSetBudgetSharingEnabled と組み合わせることはできません。これらを送信すると code: 101 が返されます。
  • ブーストを一時停止または有効化しても、変更されるのはブーストが作成したもの(広告と、ブーストが作成した場合は広告セット)のみです。attachTo で指定したキャンペーンまたは広告セットは独自のステータスを維持します。広告は、その上位のキャンペーンと広告セットが有効な間のみ配信されます。これは、プロフィールが削除された場合など、Ayrshare が広告を一時停止する場合にも適用されます。
  • ブーストが失敗しても、attachTo で指定したキャンペーンまたは広告セットが削除されることはありません。
  • 追加先の広告セットが予算を保持するキャンペーン(キャンペーン予算)内にある場合、履歴はキャンペーン予算を使用する他の広告と同様にブーストを報告します。budgetDaily にはブーストの配分ではなくキャンペーン予算全体が表示され、通算キャンペーン予算が使い切られると、次回の夜間更新後に、そのキャンペーン内で Ayrshare が追跡しているすべての広告に deliveryStatus: "COMPLETED" が表示されます。これには配信予定の広告や審査中の広告も含まれます。却下された広告は REJECTED のままです。

リンクの代わりに会話を開く

ブーストのボタンで、ウェブページの代わりにお客様のビジネスとのチャットを開くことができます。callToAction.destination を含むネスト形式で送信し、callToAction.link は省略してください。
  • engagement または interactions の広告目標を使用してください。広告は会話向けに最適化され、Meta はチャットを開始する可能性が高いユーザーに広告を表示します。その他の目標では code: 101 とともに 400 が返されます。
  • callToAction.type は、表のとおり destination と一致する必要があります。大文字・小文字は問いません。
  • ボタンはページではなくチャットを開くため、callToAction.link と callToAction.linkTitle は destination と一緒に送信できません。destination がない場合、link は引き続き必須です。
  • ユーザーは、プロフィールにリンクされたアカウントにメッセージを送信します。whatsapp の場合、そのアカウントの Facebook Page に Meta で WhatsApp Business の電話番号が接続されている必要があります。
  • destination は attachTo.adSetId と組み合わせることはできません。既存の広告セットはすでに設定されている destination を維持します。attachTo.campaignId を使用する場合、キャンペーンには Meta の OUTCOME_ENGAGEMENT 目的が設定されている必要があります。そうでない場合、リクエストは code: 101 とともに 400 を返します。
  • レスポンスとブーストされた広告の取得は、destination を含む callToAction を返します。