Wycofane metryki Instagram API: impressions i plays zastąpione przez views
Meta zastąpiła impressions metryką views w Instagram Insights API. Views wprowadzono 21 stycznia 2025 roku, a impressions, plays, clips_replays_count i ig_reels_aggregated_all_plays_count wycofano we wszystkich wersjach API 21 kwietnia 2025 roku, po tym jak 8 stycznia zakończono obsługę video_views i sześciu metryk konta. Późniejsze zmiany dodały nowe metryki, na przykład reposts i reels_skip_rate w grudniu 2025 roku.
easyCoexistence odczytuje statystyki Instagrama przez get_social_insights, który przekazuje Meta podane przez Ciebie nazwy metryk, w tym views, i zwraca dane Meta albo jej własny komunikat o błędzie, gdy nazwa jest wycofana.
Kiedy impressions, plays, clips_replays_count i ig_reels_aggregated_all_plays_count zostały wycofane we wszystkich wersjach API.
Kiedy Meta wprowadziła views dla statystyk konta i mediów oraz udostępniła statystyki aplikacjom Instagram Login.
Kiedy video_views i sześć szeregów czasowych konta, m.in. profile_views i website_clicks, przestało być obsługiwane we wszystkich wersjach.
Media utworzone 2 lipca 2024 roku lub później zwracają błąd zamiast danych, gdy po 21 kwietnia 2025 roku poprosisz o impressions.
Jedyny metric_type, jaki przyjmuje metryka views na poziomie konta; impressions oferowało też dzienny time_series.
Które metryki Instagram Meta wycofała w 2025 roku?
Dwie fale, każda zapowiedziana z kilkumiesięcznym wyprzedzeniem w changelogu Meta, najpierw w nowej wersji Graph API, a potem we wszystkich wersjach:
- 8 stycznia 2025:
video_viewsna mediach oraz szeregi czasowe kontaemail_contacts,get_direction_clicks,phone_call_clicks,profile_views,text_message_clicksiwebsite_clicks, najpierw usunięte w v21.0. - 21 stycznia 2025: impressions w statystykach konta i mediów oraz plays,
clips_replays_countiig_reels_aggregated_all_plays_countna mediach, oznaczone jako wycofane od v22.0 i nowszych, tego samego dnia, w którym pojawiły się views. - 21 kwietnia 2025: te cztery wycofane we wszystkich wersjach API.
Czym powinna być każda wycofana metryka?
Meta połączyła views z wycofaniami z kwietnia 2025 r. w tym samym wpisie w changelogu. Dla styczniowych nie wskazała następcy, dlatego prawa kolumna tabeli podaje najbliższą metrykę, którą jej dokumentacja kont i mediów opisywała na dzień 31 października 2026 r.
| 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 |
Czy impressions nadal coś zwraca?
Tylko dla starszych mediów. Changelog Meta mówi, że żądania po 21 kwietnia 2025 roku dla mediów utworzonych 2 lipca 2024 roku lub później zwracają błąd, a jej dokumentacja statystyk mediów zachowuje impressions tylko dla mediów utworzonych wcześniej. Na poziomie konta impressions jest wycofane we wszystkich wersjach, więc kod pisany dziś nie ma z niego pożytku.
Co liczy views?
Na poziomie konta: liczbę odtworzeń lub wyświetleń treści w Reels, postach i Stories; przy pojedynczym poście, Reelsie lub Stories: liczbę odtworzeń na Instagramie. impressions liczyło, ile razy treść pojawiała się na ekranie, także reklamy, więc wykres przechodzący z jednej metryki na drugą zmienia to, co mierzy, w chwili przełączenia. Metryka views na poziomie konta przyjmuje wyłącznie metric_type=total_value i rozbija się według media_product_type, a Meta nadal oznacza ją jako w fazie rozwoju.
Które metryki Meta dodała od tego czasu?
Changelog Meta wymienia te dodatki po wycofaniach z 2025 roku:
- 3 grudnia 2025:
reels_skip_ratei reposts na mediach, reposts na koncie orazcrossposted_viewsifacebook_viewsdla crosspostowanych Reelsów. - 22 kwietnia 2026:
total_likes,total_commentsitotal_views, zagregowane po powierzchniach i obejmujące media promowane, które dokumentacja Meta udostępnia tylko z logowaniem przez Facebook;facebook_viewsrozszerzono też na posty i Stories. - 22 czerwca 2026:
link_clicksna Stories, liczące kliknięcia linków, takich jak naklejki z linkiem, które changelog ogranicza do logowania przez Facebook.
Co trzeba zmienić w kodzie?
Lista metryk napisana przed 2025 rokiem wymaga tych zmian, by dalej działać:
- Zamień impressions, plays,
clips_replays_count,ig_reels_aggregated_all_plays_countivideo_viewsna views, zarówno w żądaniach dotyczących konta, jak i mediów. - Żądaj metryki views na poziomie konta z
metric_type=total_value. Nie ma onatime_series, więc odczytaj jedną sumę dla zakresu tam, gdzie impressions dawało dzienną linię. - Żądaj
crossposted_viewsifacebook_viewstylko dla mediów crosspostowanych, w osobnym żądaniu: dokumentacja Meta mówi, że obie zgłaszają błąd, gdy media nie były crosspostowane. - Nie umieszczaj
total_likes,total_commentsitotal_viewsw aplikacjach z logowaniem Instagram, bo Meta udostępnia je tylko z logowaniem przez Facebook. - Zastąp
phone_call_clicks,email_contacts,text_message_clicksiget_direction_clicksmetrykąprofile_links_tapsz podziałem nacontact_button_type. - Błąd w nazwie metryki traktuj jako sygnał, by zaktualizować listę, a nie by ponowić żądanie.
Jak wycofania docierają do starszych wersji API?
W dwóch krokach. Zmiana najpierw obowiązuje w nowej wersji Graph API, v21.0 dla video_views i v22.0 dla impressions, a potem trafia do wszystkich wersji w dacie podanej w tym samym wpisie changelogu, mniej więcej trzy miesiące później w obu przypadkach. Przypięcie starszej wersji daje najwyżej kilka miesięcy, a changelog Meta dla Instagram Platform podaje obie daty dla każdej zmiany.
Które wcześniejsze wycofania wciąż uderzają w stary kod?
Dwa sprzed 2025 roku pojawiają się w kodzie, którego nikt od dawna nie ruszał:
- 11 grudnia 2023: metryki
carousel_album,taps_forward,taps_back, exits i engagement na mediach orazaudience_gender_age,audience_locale,audience_countryiaudience_cityna koncie;follower_demographicsobejmuje teraz wiek, miasto, kraj i płeć. - 19 sierpnia 2024: ramy czasowe
last_14_days,last_30_days,last_90_daysiprev_monthdlaengaged_audience_demographicsorazreached_audience_demographics;this_weekithis_monthpozostają.
Typowe błędy
- Żądanie impressions dla posta opublikowanego od lipca 2024 roku. Meta zwraca błąd dla tych mediów; poproś o views.
- Żądanie views konta jako time_series. Meta dokumentuje ją wyłącznie z total_value, więc odczytaj sumę dla każdego zakresu, którego potrzebujesz.
- Żądanie crossposted_views lub facebook_views dla mediów, które nigdy nie były crosspostowane. Dokumentacja Meta mówi, że obie wtedy zgłaszają błąd.
- Oczekiwanie total_likes, total_comments lub total_views przy logowaniu Instagram. Meta udostępnia je tylko z logowaniem przez Facebook; likes, comments i views pozostają.
Dzięki temu Claude, ChatGPT lub Twój własny kod nadąża za zmianą nazwy w dniu, w którym Meta ją wprowadzi. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami w bezpłatnym okresie próbnym.
Najczęściej zadawane pytania
Czym zastąpiono phone_call_clicks i email_contacts w Instagram API?
Meta nie wskazała bezpośredniego następcy, gdy zakończyła ich obsługę we wszystkich wersjach 8 stycznia 2025 roku. Najbliższa metryka, jaką jej dokumentacja kont opisuje dziś, to profile_links_taps z podziałem na contact_button_type.
Czym zastąpiono odtworzenia w Reelsach na Instagramie?
views. Meta wycofała plays, clips_replays_count i ig_reels_aggregated_all_plays_count we wszystkich wersjach API 21 kwietnia 2025 roku, trzy miesiące po wprowadzeniu views.
Dlaczego moje wywołanie statystyk Instagrama zaczęło się nie udawać?
Sprawdź najpierw listę metryk: impressions, plays, video_views i stare metryki profilu są wycofane, a views na poziomie konta przyjmuje wyłącznie total_value. Ponowienie tego samego żądania zwraca ten sam błąd.
Czy Meta wycofała jakieś metryki Instagrama w 2026 roku?
Żadnych nie widać w changelogu Instagrama Meta do 28 października 2026 roku. Jej wpisy z 2026 roku dodają metryki, m.in. total_views, rozszerzone facebook_views i link_clicks na Stories.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w