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

広告の目標

各広告には目標が必要です。目標は、広告がどのように表示に最適化されるかを決定します。
  • 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"socialPostIdigPostIdが含まれます。

ヘッダーパラメータ

ボディパラメータ

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"
広告の目標。値: engagementinteractionsawareness_viewsawareness_audience。詳細については上記の広告の目標の詳細をご覧ください。
object
{"countries": ["US", "CA"]}のように国コードを使用してターゲット国を指定します。regionsおよびcities配列も指定できます。地域都市をご覧ください。
string
ブーストする投稿のAyrshare投稿IDsocialPostIdが設定されていない場合は必須です。
string
デフォルト:"active"
広告のステータス。値: activeおよびpaused後で広告更新エンドポイントを使用して広告のステータスを変更できます。
object
Meta Pixelを使用して広告を追跡します。
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.
array
Metaは、特別広告カテゴリの広告主に対して、キャンペーンカテゴリを自己識別するよう要求します。あなたのビジネスがこれらのカテゴリの1つに該当する場合、投稿をブーストする際に適切なカテゴリを選択する必要があります。以下の値がサポートされています:
  • housing: 住宅の機会または関連サービスを宣伝または直接リンクする広告(住宅またはアパートの売買・賃貸のリスト、住宅所有者保険、住宅ローン保険、住宅ローン、住宅修理、住宅担保または鑑定サービスなどを含むがこれらに限定されない)。
  • financial_product_services: クレジットを含む金融商品およびサービスの提供を宣伝または直接リンクする広告。
  • employment: 雇用機会を宣伝または直接リンクする広告(パートタイムまたはフルタイムの仕事、インターンシップ、または専門資格プログラムを含むがこれらに限定されない)。このカテゴリに該当する関連広告には、求人掲示板や求人フェアの宣伝、集約サービス、または特定の求人提供に関係なく企業が提供する福利厚生を詳述する広告が含まれます。
  • issues_elections_politics: 公職候補者、政治家、政党について、またはそれらのために作成された広告、または公職選挙の結果を主張する広告。これには、選挙、国民投票、または住民投票イニシアチブに関する広告も含まれ、「投票に行こう」選挙キャンペーンも含まれます。広告が掲載される場所での政治広告または社会問題に関する広告として規制される広告。問題、選挙、または政治を選択する場合、これらの広告を実行したい国を選択する必要があります。指定された国で社会問題、選挙、または政治に関する広告を実行するには、認証を受ける必要があります。
Metaは、広告主がキャンペーンカテゴリを正しく識別することを要求します。 Metaは人間のレビュアーと機械学習を使用して、これらの種類の広告を識別します。 誤ったspecialAdCategoriesを送信した場合、キャンペーンが調整されるまで広告が一時停止されるリスクがあります。
string
広告から利益を得る個人または組織。dsaPayorと共に設定します。提案についてはDSAレコメンデーションエンドポイントを使用してください。
string
広告の費用を支払う個人または組織。dsaBeneficiaryと共に設定します。
string
ISO 8601形式の終了日時(開始から少なくとも30時間後である必要があります)。例: 2025-03-01T00:00:00Z設定されていない場合、広告は無期限に実行され、終了日はongoingとなります。
object
locationsと同じcountriesregionscities構造を使用して場所を除外します。
string
デフォルト:"all"
オーディエンスの性別。値: allmalefemale
array
Instagram 関心IDの配列としての広告のターゲット関心。
number
デフォルト:65
広告のターゲティングの最大年齢(デフォルト: 65)。
number
デフォルト:18
広告のターゲティングの最小年齢(デフォルト: 18)。
string
ISO 8601形式の開始日時。例: 2025-03-01T00:00:00Z設定されていない場合、広告はすぐに開始されます。
例のIDはご自身のものに置き換えてください。startDateendDateは実際のスケジュールに合わせて設定してください。例の日付は説明用のものです。