Instagram API の非推奨指標:impressions と plays は views に置き換え
Meta は Instagram インサイト API で impressions を views に置き換えました。2025 年 1 月 21 日に views を導入し、同年 4 月 21 日にすべての API バージョンで impressions、plays、clips_replays_count、ig_reels_aggregated_all_plays_count を非推奨にしました。video_views と 6 つのアカウント指標は 1 月 8 日にサポートが終了しています。その後も、2025 年 12 月の reposts や reels_skip_rate のように指標は追加されています。
easyCoexistence は get_social_insights を使って Instagram のインサイトを読み取ります。
impressions、plays、clips_replays_count、ig_reels_aggregated_all_plays_count が、すべての API バージョンで非推奨となった時期。
Meta が、アカウントとメディアのインサイト向けに views を導入し、Instagram Login アプリにインサイトを開放した時期。
video_views と、profile_views や website_clicks を含む 6 つのアカウント時系列指標が、すべてのバージョンでサポートされなくなった時期。
2025 年 4 月 21 日以降に impressions をリクエストすると、2024 年 7 月 2 日以降に作成されたメディアはデータではなくエラーを返します。
アカウントレベルの views が受け付ける metric_type は一つだけです。impressions は日次の time_series も提供していました。
Meta は 2025 年に、どの Instagram 指標を廃止しましたか?
2 回に分けて廃止されました。いずれも Meta の変更履歴で数か月前に発表され、まず新しい Graph API バージョンで適用され、その後すべてのバージョンに広がりました:
- 2025 年 1 月 8 日:メディアの
video_viewsと、アカウントの時系列指標email_contacts、get_direction_clicks、phone_call_clicks、profile_views、text_message_clicks、website_clicks。v21.0 で最初に削除されました。 - 2025 年 1 月 21 日:アカウントとメディアのインサイトの impressions、ならびにメディアの plays、
clips_replays_count、ig_reels_aggregated_all_plays_count。v22.0 以降で非推奨となり、views が登場したのと同じ日です。 - 2025 年 4 月 21 日:上記の 4 つをすべての API バージョンで非推奨にしました。
廃止された各指標は何に置き換えるべきですか?
Meta は 2025 年 4 月の廃止と views を、同じ変更履歴の項目で示しました。1 月の廃止については後継を名指ししていないため、右側の列には、2026 年 10 月 31 日時点でアカウントとメディアのリファレンスに記載されていた、最も近い指標を記載しています。
| Retired | Request instead | |
|---|---|---|
| impressions | Account and media, 21 Apr 2025 | views |
| plays | Media, 21 Apr 2025 | views |
| clips_replays_count | Media, 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Media, 21 Apr 2025 | views |
| video_views | Media, 8 Jan 2025 | views |
| phone_call_clicks, email_contacts, text_message_clicks, get_direction_clicks | Account, 8 Jan 2025 | profile_links_taps, by contact_button_type |
| profile_views | Account, 8 Jan 2025 | profile_visits, per post or Story |
| website_clicks | Account, 8 Jan 2025 | profile_activity per post, whose action_type includes BIO_LINK_CLICKED |
impressions はまだ何か値を返しますか?
古いメディアに対してのみ返します。Meta の変更履歴では、2025 年 4 月 21 日以降に、2024 年 7 月 2 日以降に作成されたメディアに対して行われたリクエストは、エラーを返すとされています。また、メディアのインサイトのリファレンスでは、impressions はそれより前に作成されたメディアにのみ残されています。アカウントでは impressions がすべてのバージョンで非推奨のため、今書くコードに使い道はありません。
views は何を数えますか?
アカウントでは、リール、投稿、ストーリーにわたって、コンテンツが再生または表示された回数です。個別の投稿、リール、ストーリーでは、Instagram 上で再生された回数です。impressions は広告を含め、コンテンツが画面に表示された回数を数えていました。そのため、impressions から views へ移行するグラフは、切り替えの時点で測定内容が変わります。アカウントレベルの views は metric_type=total_value のみを受け付け、media_product_type で内訳を返します。Meta はこれをまだ開発中と表示しています。
それ以降、Meta はどの指標を追加しましたか?
Meta の変更履歴では、2025 年の廃止の後に追加された項目として、次が挙げられています:
- 2025 年 12 月 3 日:メディアの
reels_skip_rateと reposts、アカウントの reposts、クロスポストされたリールのcrossposted_viewsとfacebook_views。 - 2026 年 4 月 22 日:
total_likes、total_comments、total_views。複数の表示面をまたいで集計され、プロモーション中のメディアも含みます。Meta のリファレンスでは Facebook Login でのみ提供されています。facebook_viewsは投稿とストーリーにも拡大されました。 - 2026 年 6 月 22 日:ストーリーの
link_clicks。リンクステッカーなどのリンクのタップを数えます。変更履歴では Facebook Login に限定されています。
コードでは何を変更する必要がありますか?
2025 年より前に書かれた指標のリストは、引き続き動かすために次の変更が必要です:
- impressions、plays、
clips_replays_count、ig_reels_aggregated_all_plays_count、video_viewsを、アカウントとメディアのリクエストの両方で views に置き換えます。 - アカウントレベルの views は
metric_type=total_valueで指定します。time_seriesはないため、impressions で日次の折れ線を得ていた箇所では、期間ごとに 1 つの合計値を読み取ります。 crossposted_viewsとfacebook_viewsは、クロスポストされたメディアに対してのみ、単独のリクエストで指定します。Meta のリファレンスでは、クロスポストされていないメディアに対してはどちらもエラーになるとされています。total_likes、total_comments、total_viewsは Instagram Login アプリでは外します。Meta はこれらを Facebook Login でのみ提供しているためです。phone_call_clicks、email_contacts、text_message_clicks、get_direction_clicksは、profile_links_tapsをcontact_button_type別に内訳化したものに置き換えます。- 指標名に対するエラーは、再試行ではなく、指標リストを更新する合図として扱ってください。
非推奨化は古い API バージョンにどのように伝わりますか?
2 段階で伝わります。変更はまず新しい Graph API バージョン(video_views は v21.0、impressions は v22.0)に適用され、その後、同じ変更履歴の項目に記載された日付で、すべてのバージョンに広がります。どちらの場合も約 3 か月後です。古いバージョンに固定しても、猶予は長くても数か月です。Meta の Instagram Platform の変更履歴には、変更ごとに両方の日付が記載されています。
2025 年より前の廃止で、今も古いコードに影響するものはありますか?
2025 年より前の廃止が 2 つ、手を付けられていない古いコードに今も影響します:
- 2023 年 12 月 11 日:
carousel_albumの指標、メディアのtaps_forward、taps_back、exits、engagement、アカウントのaudience_gender_age、audience_locale、audience_country、audience_city。そのためfollower_demographicsが年齢、都市、国、性別を扱います。 - 2024 年 8 月 19 日:
engaged_audience_demographicsとreached_audience_demographicsの期間指定last_14_days、last_30_days、last_90_days、prev_month。this_weekとthis_monthは残っています。
よくある間違い
- 2024 年 7 月以降に投稿されたメディアで impressions をリクエストすること。Meta はそのメディアに対してエラーを返すため、views をリクエストしてください。
- アカウントの views を time_series としてリクエストすること。Meta は total_value のみで文書化しているため、必要な期間ごとに合計値を読み取ってください。
- クロスポストされたことのないメディアに対して crossposted_views または facebook_views をリクエストすること。Meta のリファレンスでは、その場合どちらもエラーになるとされています。
- Instagram Login で total_likes、total_comments、total_views が使えると想定すること。Meta はこれらを Facebook Login でのみ提供しています。likes、comments、views は引き続き利用できます。
指定された指標名はそのまま Meta に渡され、views を含め Meta のデータが返されます。名称が廃止されている場合は Meta 自身のエラーメッセージが返るため、Meta が変更を行った当日に、Claude、ChatGPT、または独自のコードがその名称変更に追従できます。料金は、接続済みの番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 までです。無料トライアルは最初の 3 日間です。
よくある質問
Instagram API で phone_call_clicks と email_contacts を置き換えるものは何ですか?
2025 年 1 月 8 日にすべてのバージョンで終了した際、Meta は直接の後継を名指ししませんでした。Meta のアカウントのリファレンスで現在文書化されている最も近い指標は、contact_button_type 別に内訳化した profile_links_taps です。
Instagram リールの plays を置き換えるものは何ですか?
views です。Meta は views を導入した 3 か月後の 2025 年 4 月 21 日に、すべての API バージョンで plays、clips_replays_count、ig_reels_aggregated_all_plays_count を非推奨にしました。
Instagram インサイトの呼び出しが失敗するようになったのはなぜですか?
まず指標リストを確認してください:impressions、plays、video_views、古いプロフィール指標は廃止されており、アカウントの views は total_value のみを受け付けます。同じリクエストを再試行しても、同じエラーが返ります。
Meta は 2026 年に Instagram の指標を廃止しましたか?
2026 年 10 月 28 日までの Meta の Instagram 変更履歴には、廃止されたものはありません。2026 年の項目では、代わりに指標が追加されています。その中には total_views、対象を広げた facebook_views、ストーリーの link_clicks が含まれます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日