2024年6月3日より、boost_eligibility_info
フィールドを使って、メディアを広告として宣伝できるかどうかを簡単かつ効率的に確認できるようになりました。また、boost_ads_list
を使うことで、その広告に関連する過去のInstagram広告情報の追跡も可能になりました。詳しくは、ブログをご覧ください。
InstagramまたはFacebookの投稿からInstagram広告を作成します。
1つの写真、動画、カルーセル、リール動画(タグ付きの複数の写真や動画を使用可能)、またはアクティブなInstagramストーリーズが含まれるInstagramフィード投稿から広告を作成できます。フィード画像、カルーセル、商品タグ付きの既存の動画を含むフィード投稿から広告を作成することもできます。現時点では、Instagram TVの投稿から広告を作成することはできません。
InstagramユーザーID (IGユーザー)は、次の2とおりの方法で取得できます。
関連するFacebookページのinstagram_business_account
フィールドを使用して、Instagram BusinessアカウントまたはクリエイターアカウントのユーザーIDを取得します。InstagramグラフAPIのスタートガイドをご覧ください。
マーケティングAPIを使用して、特定の広告アカウントや広告ページにリンクしたInstagramアカウントのユーザーIDを取得します。次のエンドポイントをクエリして情報を入手します。
{ad_account_id}/connected_instagram_accounts
— 広告アカウントにリンクしたInstagramアカウントのユーザーIDを取得します。{business_id}/instagram_business_accounts
— ビジネスにリンクしたInstagramアカウントのユーザーIDを取得します。Instagramアカウントをリンクする必要がある場合は、ビジネスマネージャにInstagramアカウントを追加するやInstagramアカウントと自分が管理しているFacebookページのリンクについてをご覧ください。
広告として使用するInstagram投稿(IGメディア)のIDを取得するには、InstagramグラフAPIのメディアエンドポイントを使用してください。広告として使用したい当該InstagramストーリーズのIDを取得するには、InstagramグラフAPIのストリーズエンドポイントを使用してください。このIDは、広告のsource_instagram_media_id
として使用されます。
boost_eligibility_info
フィールドを使用して、メディアが広告として宣伝可能かどうかを判断できます。
すでにInstagram投稿を使用して広告クリエイティブをセットアップしている場合は、{ad_creative_id}/source_instagram_media_id
をクエリして、その投稿のオリジナルのメディアIDを確認してください。
広告を作成するには、Instagram広告APIのスタートガイドにある、ステップ3: 広告セットを作成するまでのプロセスを実行してください。ステップ4: 広告クリエイティブを用意して広告を作成するについては、以下のようにします。
instagram_actor_id
を指定する代わりに、instagram_user_id
にステップ1: InstagramユーザーIDを取得するで取得したInstagramユーザーIDを設定します。以下はその例です。
{ "object_id":"<object_id>", // page id "instagram_user_id":"<instagram-user-id>", "source_instagram_media_id":"<source_instagram_media_id>" }
source_instagram_media_id
に、ステップ2: 宣伝する投稿を見つけるで取得したメディアIDを指定します。以下はその例です。
curl -i -X POST \ "https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT>/adcreatives ?object_id=<PAGE_ID> &instagram_user_id=<IG_USER_ID> &source_instagram_media_id=<IG_ORGANIC_MEDIA_ID> &access_token=<API_ACCESS_TOKEN>"
call_to_action
フィールドを更新することもできます。以下はその例です。
curl -i -X POST \ "https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT>/adcreatives ?object_id=<PAGE_ID> &instagram_user_id=<IG_USER_ID> &source_instagram_media_id=<IG_ORGANIC_MEDIA_ID> &call_to_action="{'type':'LEARN_MORE','value':{'link': '<YOUR_LINK>'}}" &access_token=<API_ACCESS_TOKEN>"
"call_to_action": { "value": {"app_destination":"INSTAGRAM_DIRECT"}, "type": "MESSAGE_PAGE" }
"call_to_action": { "value": {"app_destination":"MESSENGER"}, "type": "MESSAGE_PAGE" }
"asset_feed_spec": { "optimization_type": "DOF_MESSAGING_DESTINATION", "call_to_actions": [ { "type": "MESSAGE_PAGE", "value": { "app_destination": "MESSENGER", "link": "https://fb.com/messenger_doc/" } }, { "type": "INSTAGRAM_MESSAGE", "value": { "app_destination": "INSTAGRAM_DIRECT", "link": "https://www.instagram.com" } } ] }詳細は、アセットフィードの仕様のドキュメントをご覧ください。
広告クリエイティブを用意したら、広告を作成します。このプロセスを2つのステップに分けず、広告を作成する際にクリエイティブを用意することもできます。
すべてのFacebook投稿をInstagram広告として使用できるわけではありません。
広告クリエイティブの一部として既存のFacebookフィード投稿やストーリーズを使用して、Instagramコンテンツを宣伝することができます。投稿を広告に使用できるかどうかを調べるには、次のAPI呼び出しを行ってください。
curl -G \ -d "access_token=<ACCESS_TOKEN>"\ -d "fields=is_instagram_eligible"\ "https://graph.facebook.com/<API_VERSION>/<POST_ID>"
応答に"is_instagram_eligible": true
が含まれている場合、広告を作成できます。
curl -i -X POST \
"https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT>/adcreatives
?object_story_id=<postOwnerID_postID>
&instagram_actor_id=<IG_USER_ID>
&call_to_action="{'type':MESSAGE_PAGE,'value':{'app_destination':'MESSENGER'}}"
&access_token=<ACCESS_TOKEN>"
ここで、object_story_id
はpostOwnerID_postID
形式の投稿IDであり、instagram_actor_id
はページにリンクされたInstagramアカウントIDまたはページバックInstagramアカウント IDです。詳細は、ページでInstagramアカウントを設定するをご覧ください。
「クリエイティブの標準エンハンスのenroll_statusを指定する必要があります」というエラーが表示される場合、詳しくはAdvantage+クリエイティブの標準エンハンス機能を参照してください。
広告クリエイティブ内でFacebook投稿をInstagramアクターIDで宣伝したり、広告セットにFacebook配置とInstagram配置の両方が含まれたりしている場合、「クリエイティブにDOFスペックがありません」または「複数のリンク先を設定した広告のクリエイティブにはdegrees_of_freedomスペックが必要です。」というエラーが表示されることがあります。"optimization_type": "DOF_MESSAGING_DESTINATION"
を広告クリエイティブのasset_feed_spec
パラメーターに追加してください。