Skip to main content
POST
既存のInstagram投稿をブーストして広告を作成します。 このエンドポイントを使用すると、オーガニック投稿をカスタムターゲティング、予算、スケジュールパラメータを持つ有料広告に変換できます。
  • 予算と入札額は、小数点以下2桁までのUSDで指定する必要があります。
  • Instagramの要件に対応するため、広告は少なくとも30時間実行する必要があります。
  • ターゲティング用の関心IDを見つけるには、関心エンドポイントを使用できます。
  • Instagramがブースト投稿を確認・承認するまでに最大24時間かかることがあります。
  • socialPostIdを直接使用する場合(AyrshareのpostIdの代わりに)、有効なInstagram投稿IDであることを確認してください。
  • Facebook がキャンペーンを作成した後(クリエイティブ、広告セット、広告のいずれかのステップ)にブーストが失敗した場合、 Ayrshare はそのキャンペーンの削除を試みます。削除にも失敗した場合、空のキャンペーンは広告アカウントに残ります。 広告マネージャー(Ads Manager)で見つけて削除できます。

広告の目標

各広告には目標が必要です。目標は、広告がどのように表示に最適化されるかを決定します。
  • engagement: この目標は、広告が最大数のユニークユーザーに到達することを保証しながらエンゲージメントを向上させます。可視性とエンゲージメントのバランスを取り、広告に反応する可能性のあるできるだけ多くの人々に広告を表示します。
  • interactions: いいね、コメント、シェアなど、広告へのインタラクションを促進するように設計されています。Instagramは広告に最も関わりそうなユーザーに広告を表示することを優先します。
  • awareness_views: 広告が表示される回数を最大化することで、ブランド認知度を高めることに重点を置きます。ユニークリーチに関係なく、予算内でできるだけ多くの回数広告を表示することを優先します。
  • awareness_audience: 広告を見るユニークユーザー数を最大化することで、ブランド認知度を向上させることを目指します。広告ができるだけ多くの異なるユーザーに到達することを保証し、同じオーディエンスに複数回表示するのではなく、ユニークオーディエンスのサイズを最大化します。
Instagram広告には、Facebook経由で接続されたInstagramビジネスアカウント、関連付けられたFacebookページ、およびads_management権限が必要です。この権限を付与するには、Facebook経由で再連携してください。Instagram Loginで接続されたアカウントは、これらの広告エンドポイントを使用できません。メディアIDとInstagramアカウントIDは連携済みアカウントから解決されるため、instagram_user_idを送信しないでください。
socialPostIdセレクターは、Instagram固有のエイリアスigPostIdも受け付けます。fbPostIdはFacebookにのみ適用されます。成功時のレスポンスにはplatform: "instagram"、socialPostId、igPostIdが含まれます。

ヘッダーパラメータ

ボディパラメータ

string
このブーストリクエストの一意で空でないキー。同じキーで同じペイロードを再試行すると、重複した広告の作成を回避できます。異なるペイロードまたはプラットフォームでキーを再利用すると、HTTP 409が返されます。処理中のリクエストも409を返します。予約が利用できない場合は、広告を作成せずに503が返されます。
boolean
デフォルト:false
キャンペーン内の広告セット間でMetaが予算を共有できるようにします。
string
必須
投稿をブーストするInstagram広告アカウントのID。アカウントIDは広告アカウントエンドポイントから取得できます。
string
必須
広告の名前(Instagram広告マネージャーに表示されます)。形式は{adName} - {postId or socialPostId} - {current date}となります。
number
必須
最大入札額(USD)。小数点以下2桁までの正の値で指定します。
number
必須
日次予算(USD)。小数点以下2桁までの正の値を使用してください。Metaは、アカウントと目標に応じて追加の最小額を適用する場合があります。
string
ブーストする投稿のInstagramソーシャル投稿ID。Instagramで直接作成された投稿から広告を作成できます。これはInstagram上の投稿のIDであり、AyrshareのIDではありません。postIdが設定されていない場合は必須です。
string
デフォルト:"engagement"
広告の目標。値: engagement、interactions、awareness_views、awareness_audience。詳細については上記の広告の目標の詳細をご覧ください。
object
{"countries": ["US", "CA"]}のように国コードを使用してターゲット国を指定します。regionsおよびcities配列も指定できます。地域と都市をご覧ください。{}のように国、地域、都市のいずれも指定していないオブジェクトは、コード101で拒否されます。米国をターゲットにするにはlocationsを省略してください。
string
ブーストする投稿のAyrshare投稿ID。socialPostIdが設定されていない場合は必須です。
string
デフォルト:"active"
広告のステータス。値: activeおよびpaused。後で広告更新エンドポイントを使用して広告のステータスを変更できます。
object
Meta 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: クレジットを含む金融商品およびサービスの提供を宣伝または直接リンクする広告。
  • employment: 雇用機会を宣伝または直接リンクする広告(パートタイムまたはフルタイムの仕事、インターンシップ、または専門資格プログラムを含むがこれらに限定されない)。このカテゴリに該当する関連広告には、求人掲示板や求人フェアの宣伝、集約サービス、または特定の求人提供に関係なく企業が提供する福利厚生を詳述する広告が含まれます。
  • issues_elections_politics: 公職候補者、政治家、政党について、またはそれらのために作成された広告、または公職選挙の結果を主張する広告。これには、選挙、国民投票、または住民投票イニシアチブに関する広告も含まれ、「投票に行こう」選挙キャンペーンも含まれます。広告が掲載される場所での政治広告または社会問題に関する広告として規制される広告。問題、選挙、または政治を選択する場合、これらの広告を実行したい国を選択する必要があります。指定された国で社会問題、選挙、または政治に関する広告を実行するには、認証を受ける必要があります。
Meta は、特別広告カテゴリの広告を配信する国の情報も必要とします。Ayrshare は locations からそれらの国を取得します。指定した国に加えて、各地域と各都市の国も含まれます。そのため、英国の都市をターゲットにした housing のブーストは、リクエストに何も追加しなくても英国向けに設定されます。locations を指定しない場合、広告は米国で配信され、キャンペーンも米国向けに設定されます。Meta はこれらのカテゴリについて、各都市の周囲に最小半径も設定しています。半径 17 キロメートルの英国の都市は #2909039 で拒否されました。このエラーは少なくとも 25 キロメートル(15 マイル)を求めるため、25 キロメートル以上を使用してください。
Metaは、広告主がキャンペーンカテゴリを正しく識別することを要求します。 Metaは人間のレビュアーと機械学習を使用して、これらの種類の広告を識別します。 誤ったspecialAdCategoriesを送信した場合、キャンペーンが調整されるまで広告が一時停止されるリスクがあります。
string
広告から利益を得る個人または組織。dsaPayorと共に設定します。提案についてはDSAレコメンデーションエンドポイントを使用してください。
string
広告の費用を支払う個人または組織。dsaBeneficiaryと共に設定します。
string
ISO 8601形式の終了日時(開始から少なくとも30時間後である必要があります)。例: 2025-03-01T00:00:00Z。設定されていない場合、広告は無期限に実行され、終了日はongoingとなります。
object
locationsと同じcountries、regions、cities構造を使用して場所を除外します。
string
デフォルト:"all"
オーディエンスの性別。値: all、male、female。
array
Instagram 関心IDの配列としての広告のターゲット関心。
number
デフォルト:65
広告のターゲティングの最大年齢(デフォルト: 65)。
number
デフォルト:18
広告のターゲティングの最小年齢(デフォルト: 18)。
string
ISO 8601形式の開始日時。例: 2025-03-01T00:00:00Z。設定されていない場合、広告はすぐに開始されます。
例のIDはご自身のものに置き換えてください。startDateとendDateは実際のスケジュールに合わせて設定してください。例の日付は説明用のものです。

キャンペーン予算

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