Metricile depreciate ale API-ului Instagram: impressions și plays sunt înlocuite cu views
Meta a înlocuit impressions cu views în API-ul Instagram pentru statistici. Metrica views a fost introdusă la 21 ianuarie 2025, iar impressions, plays, clips_replays_count și ig_reels_aggregated_all_plays_count au fost depreciate în toate versiunile API la 21 aprilie 2025, după ce video_views și șase metrici ale contului încetaseră la 8 ianuarie. Modificările ulterioare au adăugat metrici, precum reposts și reels_skip_rate, în decembrie 2025.
easyCoexistence citește statisticile Instagram cu get_social_insights, care transmite lui Meta numele metricilor pe care le dați, inclusiv views, și returnează datele Meta sau propriul mesaj de eroare al Meta atunci când un nume este retras, astfel încât Claude, ChatGPT sau propriul cod să urmeze o redenumire în ziua în care Meta o face.
Când impressions, plays, clips_replays_count și ig_reels_aggregated_all_plays_count au fost depreciate în toate versiunile API.
Când Meta a introdus views pentru statisticile contului și ale conținutului media și a deschis statisticile pentru aplicațiile Instagram Login.
Când video_views și șase serii temporale ale contului, printre care profile_views și website_clicks, au pierdut suportul în toate versiunile.
Conținutul media creat la sau după această dată returnează o eroare, nu date, dacă se cere impressions după 21 aprilie 2025.
Singurul metric_type acceptat de metrica views la nivelul contului; impressions oferea și o serie zilnică time_series.
Ce metrici Instagram a retras Meta în 2025?
Două valuri, fiecare anunțat cu luni înainte în jurnalul de modificări al Meta și aplicat mai întâi dintr-o versiune nouă a Graph API, apoi în toate versiunile:
- 8 ianuarie 2025:
video_viewspe conținutul media și seriile temporale ale contuluiemail_contacts,get_direction_clicks,phone_call_clicks,profile_views,text_message_clicksșiwebsite_clicks, eliminate întâi din v21.0. - 21 ianuarie 2025: impressions pe statisticile contului și ale conținutului media, precum și plays,
clips_replays_countșiig_reels_aggregated_all_plays_countpe conținutul media, depreciate pentru v22.0 și versiunile ulterioare, în ziua în care a apărut views. - 21 aprilie 2025: cele patru depreciate în toate versiunile API.
Ce ar trebui să devină fiecare metrică retrasă?
Meta a asociat views cu retragerile din aprilie 2025 în aceeași intrare din jurnalul de modificări. În cazul celor din ianuarie, Meta nu a numit niciun succesor, așa că cel mai apropiat echivalent este metrica pe care referințele sale pentru cont și conținut media o documentau la 31 octombrie 2026.
| 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 |
Mai returnează ceva impressions?
Doar pentru conținutul mai vechi. Jurnalul de modificări al Meta spune că cererile făcute după 21 aprilie 2025 pentru conținutul media creat la sau după 2 iulie 2024 returnează o eroare, iar referința pentru statisticile conținutului media păstrează impressions doar pentru conținutul creat înainte de această dată. La nivelul contului, impressions este depreciat în toate versiunile, deci codul scris astăzi nu are nevoie de el.
Ce numără views?
La nivelul contului, numărul de ori în care conținutul a fost redat sau afișat, pe Reels, postări și Stories; pentru o singură postare, Reel sau Story, numărul de ori în care a fost redată pe Instagram. Impressions număra de câte ori conținutul a fost pe ecran, inclusiv reclamele, așa că un grafic care trece de la una la cealaltă își schimbă ce măsoară în momentul trecerii. Views la nivelul contului acceptă doar metric_type=total_value și se defalcă după media_product_type, iar Meta încă o marchează ca fiind în dezvoltare.
Ce metrici a adăugat Meta de atunci?
Jurnalul de modificări al Meta enumeră aceste adăugiri după retragerile din 2025:
- 3 decembrie 2025:
reels_skip_rateși reposts pe conținutul media, reposts pe cont, precum șicrossposted_viewsșifacebook_viewspentru Reels publicate pe mai multe platforme. - 22 aprilie 2026:
total_likes,total_commentsșitotal_views, agregate pe toate suprafețele și incluzând conținutul promovat, pe care referința Meta le oferă doar cu Facebook Login;facebook_viewss-a extins și la postări și Stories. - 22 iunie 2026:
link_clickspe Stories, care numără atingerile linkurilor, precum autocolantele cu link, pe care jurnalul le limitează la Facebook Login.
Ce trebuie schimbat în cod?
O listă de metrici scrisă înainte de 2025 are nevoie de aceste modificări ca să continue să funcționeze:
- Înlocuiți impressions, plays,
clips_replays_count,ig_reels_aggregated_all_plays_countșivideo_viewscu views, atât în cererile pentru cont, cât și pentru conținut media. - Solicitați views la nivelul contului cu
metric_type=total_value. Nu aretime_series, deci citiți un singur total pe interval acolo unde impressions dădea o linie zilnică. - Cereți
crossposted_viewsșifacebook_viewsdoar pentru conținutul media publicat pe mai multe platforme, într-o cerere separată: referința Meta spune că ambele generează eroare dacă conținutul nu a fost publicat astfel. - Excludeți
total_likes,total_commentsșitotal_viewsdin aplicațiile cu Instagram Login, deoarece Meta le oferă doar cu Facebook Login. - Înlocuiți
phone_call_clicks,email_contacts,text_message_clicksșiget_direction_clickscuprofile_links_taps, defalcat dupăcontact_button_type. - Tratați o eroare la un nume de metrică drept un semnal să actualizați lista, nu să reîncercați.
Cum ajung deprecierile la versiunile vechi ale API-ului?
În doi pași. O modificare se aplică mai întâi dintr-o versiune nouă a Graph API, v21.0 pentru video_views și v22.0 pentru impressions, apoi ajunge la toate versiunile la o dată indicată în aceeași intrare din jurnal, la aproximativ trei luni în ambele cazuri. Rămânerea pe o versiune mai veche aduce cel mult câteva luni de răgaz, iar jurnalul de modificări al Meta pentru Instagram Platform enumeră ambele date pentru fiecare modificare.
Ce retrageri anterioare afectează în continuare codul vechi?
Două dintre retragerile de dinainte de 2025 apar în cod care nu a mai fost atins de mult:
- 11 decembrie 2023: metricile
carousel_album,taps_forward,taps_back, exits și engagement pe conținutul media, precum șiaudience_gender_age,audience_locale,audience_countryșiaudience_citype cont, undefollower_demographicsacoperă acum vârsta, orașul, țara și genul. - 19 august 2024: intervalele
last_14_days,last_30_days,last_90_daysșiprev_monthpentruengaged_audience_demographicsșireached_audience_demographics;this_weekșithis_monthrămân.
Greșeli frecvente
- Solicitarea impressions pentru o postare publicată din iulie 2024. Meta returnează o eroare pentru acest conținut media; cereți views.
- Cererea views pe cont ca time_series. Meta o documentează doar cu total_value, deci citiți un total pentru fiecare interval de care aveți nevoie.
- Solicitarea crossposted_views sau facebook_views pentru conținut media care nu a fost niciodată publicat pe mai multe platforme. Referința Meta spune că ambele generează eroare în acest caz.
- Așteptarea ca total_likes, total_comments sau total_views să funcționeze cu Instagram Login. Meta le oferă doar cu Facebook Login; aprecierile, comentariile și views rămân disponibile.
US$ 9 până la US$ 0,75 pe conexiune pe lună, care scade pe măsură ce adăugați conexiuni, cu o perioadă de probă gratuită de 3 zile.
Întrebări frecvente
Ce a înlocuit phone_call_clicks și email_contacts în API-ul Instagram?
Meta nu a numit un succesor direct când au încetat în toate versiunile, la 8 ianuarie 2025. Cel mai apropiat echivalent pe care referința sa pentru cont îl documentează astăzi este profile_links_taps, defalcat după contact_button_type.
Ce a înlocuit redările din Reels pe Instagram?
views. Meta a depreciat plays, clips_replays_count și ig_reels_aggregated_all_plays_count în toate versiunile API la 21 aprilie 2025, la trei luni după ce a introdus views.
De ce a început să eșueze apelul meu pentru statisticile Instagram?
Verificați mai întâi lista de metrici: impressions, plays, video_views și vechile metrici de profil sunt retrase, iar views la nivelul contului acceptă doar total_value. Reîncercarea aceleiași cereri returnează aceeași eroare.
A retras Meta vreo metrică Instagram în 2026?
Niciuna nu apare în jurnalul de modificări al Instagram de la Meta până la 28 octombrie 2026. Intrările din 2026 adaugă metrici în schimb, printre ele total_views, o facebook_views extinsă și link_clicks pe Stories.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la