メインコンテンツへスキップ
POST
既存のFacebook投稿をブーストして広告を作成します。 このエンドポイントを使用すると、オーガニック投稿をカスタムターゲティング、予算、スケジュールパラメータを持つ有料広告に変換できます。
  • 予算と入札額は、小数点以下2桁までのUSDで指定する必要があります。
  • Facebookの要件に対応するため、広告は少なくとも30時間実行する必要があります。
  • ターゲティング用の関心IDを見つけるには、関心エンドポイントを使用できます。
  • Facebookがブースト投稿を確認・承認するまでに最大24時間かかることがあります。
  • fbPostIdを直接使用する場合(AyrshareのpostIdの代わりに)、有効なFacebook投稿IDであることを確認してください。

広告の目標

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

ヘッダーパラメータ

ボディパラメータ

accountId
string
必須
投稿をブーストするFacebook広告アカウントのID。アカウントIDは広告アカウントエンドポイントから取得できます。
adName
string
必須
広告の名前(Facebook広告マネージャーに表示されます)。形式は{adName} - {postId or fbPostId} - {current date}となります。
bidAmount
number
必須
最大入札額(USD)。最小入札額は$1.00です。
budget
number
必須
日次予算(USD)。最小予算は$1.00です。
fbPostId
string
必須
ブーストする投稿のFacebookソーシャル投稿ID。Facebookで直接作成された投稿から広告を作成できます。これはFacebook上の投稿のIDであり、AyrshareのIDではありません。postIdが設定されていない場合は必須です。
goal
string
デフォルト:"engagement"
必須
広告の目標。値: engagementinteractionsawareness_viewsawareness_audience。詳細については上記の広告の目標の詳細をご覧ください。
locations
object
必須
配列のオブジェクトでターゲット広告の場所を指定します: countriesregionscities
postId
string
必須
ブーストする投稿のAyrshare投稿IDfbPostIdが設定されていない場合は必須です。
status
string
デフォルト:"active"
必須
広告のステータス。値: activeおよびpaused後で広告更新エンドポイントを使用して広告のステータスを変更できます。
adSetBudgetSharingEnabled
boolean
デフォルト:false
Metaのキャンペーンレベルの広告セット予算共有を制御します。 Metaは現在、キャンペーンレベルの予算なしで作成されたすべてのキャンペーンでこのワイヤーフィールドを必須としているため、Ayrshareは常にこれを送信します — 後方互換性のためデフォルトはfalseです。全体的なパフォーマンスを最適化するために、同じキャンペーン内の他の広告セット間で広告セットの予算の約20%までをMetaが共有できるようにするには、trueに設定します。詳細については、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は、特別広告カテゴリの広告主に対して、キャンペーンカテゴリを自己識別するよう要求します。あなたのビジネスがこれらのカテゴリの1つに該当する場合、投稿をブーストする際に適切なカテゴリを選択する必要があります。以下の値がサポートされています:
  • 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"
オーディエンスの性別。値: allmalefemale
interests
array
Facebook 関心IDの配列としての広告のターゲット関心。
maxAge
number
デフォルト:65
広告のターゲティングの最大年齢(デフォルト: 65)。
minAge
number
デフォルト:18
広告のターゲティングの最小年齢(デフォルト: 18)。
startDate
string
ISO 8601形式の開始日時。例: 2025-03-01T00:00:00Z設定されていない場合、広告はすぐに開始されます。
dsaBeneficiary
string
EU諸国向けのデジタルサービス法(DSA)コンプライアンスのための広告の受益者。いずれかが提供されている場合、dsaPayorと共に設定する必要があります。詳細についてはDSAガイドをご覧ください。
dsaPayor
string
EU諸国向けのデジタルサービス法(DSA)コンプライアンスのための広告の支払者。いずれかが提供されている場合、dsaBeneficiaryと共に設定する必要があります。