Reel e insight video di Facebook tramite l'API
Gli insight video e Reel di Facebook arrivano da GET /{video-id}/video_insights: total_video_views conta le riproduzioni di almeno 3 secondi, total_video_avg_time_watched e total_video_view_total_time danno il tempo di visualizzazione in millisecondi, e i Reel aggiungono blue_reels_play_count, fb_reels_total_plays e fb_reels_replay_count. A giugno 2026 Meta ha dismesso, per tutte le versioni dell'API, le metriche di impression e di visualizzatori unici dei video, come total_video_impressions.
easyCoexistence legge gli insight di Pagina e dei post di Facebook con get_social_insights da Claude, ChatGPT o dal tuo codice, così la tua AI può dire come stanno andando la Pagina e i suoi post; i video_insights propri di un video o di un Reel si leggono in Meta Business Suite.
La riproduzione più breve che total_video_views conta, o quasi l'intera durata per i video più brevi di quella.
Quando Meta ha dismesso total_video_impressions, total_video_views_unique e post_video_views_unique per tutte le versioni dell'API.
Per quanto indietro sono disponibili i dati degli insight video.
Come total_video_retention_graph divide un video, riportando le riproduzioni a ogni punto come percentuale di tutte le visualizzazioni.
La riproduzione che conta come Reel in blue_reels_play_count, escluse le riproduzioni ripetute.
Le interazioni sui Reel non sono incluse nelle metriche della Pagina, tra i limiti indicati nel riferimento degli insight di Meta.
Quali metriche restituisce video_insights per un video?
Queste metriche video sono nel riferimento di Meta e fuori dalle sue liste di dismissione a novembre 2026, tutte totali cumulativi letti sull'ID del video. Le visualizzazioni non includono il tempo passato a rivedere una riproduzione, e diverse hanno una versione organica e una a pagamento, come total_video_views_organic e total_video_views_paid:
Quali metriche riguardano i Reel?
Il riferimento di Meta ha una sezione sui Reel, da leggere sull'ID video del Reel, con valori cumulativi:
blue_reels_play_count: riproduzioni di almeno 1 millisecondo dopo che un'impression viene conteggiata, escluse le riproduzioni ripetute.fb_reels_total_plays: le stesse riproduzioni incluse quelle ripetute;fb_reels_replay_count: solo le riproduzioni ripetute nella stessa sessione.post_video_avg_time_watchedepost_video_view_time: media e totale dei millisecondi riprodotti, incluse le riproduzioni ripetute.post_video_followers: i follow dal Reel.post_video_likes_by_reaction_type: i like sul Reel.post_video_social_actions: i suoi commenti e condivisioni.post_video_retention_graph: riproduzioni in punti del Reel, come percentuale delle riproduzioni totali.
Quali metriche video Meta ha dismesso nel 2026?
L'annuncio dell'API Graph v25 di Meta ha dismesso due gruppi a giugno 2026, per tutte le versioni dell'API, e indirizza verso le sue metriche Media Views e Media Viewers: post_total_media_view_unique e page_total_media_view_unique per i visualizzatori unici, e post_media_view e page_media_view per la suddivisione tra a pagamento e organica.
- Impression dei video:
total_video_impressionscon le sue varianti unique, paid, organic, viral e fan, epost_impressions_uniquesu un video. - Visualizzatori dei 3 secondi:
total_video_views_uniquee le sue versioni organiche e a pagamento,post_video_views_uniquee le sue versioni organiche e a pagamento, epage_video_views_unique.
post_video_views e page_video_views sono ancora validi?
Sì. Entrambe restano nel riferimento degli insight di Meta senza contrassegno di dismissione: post_video_views conta le riproduzioni di almeno 3 secondi di un post video, per totale cumulativo o per giorno, e page_video_views conta quelle della Pagina, per giorno, settimana o days_28. Le loro versioni unique, post_video_views_unique e page_video_views_unique, sono state dismesse a giugno 2026 per tutte le versioni dell'API, e le metriche a 10 secondi, come post_video_views_10s, sopra la v18.
Come si richiedono gli insight video?
Su tre oggetti, ciascuno con le proprie metriche. GET /{video-id}/video_insights con il parametro metric impostato a un elenco separato da virgole legge un video o un Reel, e senza metric restituisce i totali del video. Le metriche video a livello di post, come post_video_views, si leggono con GET /{page-post-id}/insights, e quelle a livello di Pagina, come page_video_views, con GET /{page-id}/insights e un period.
GET /{video-id}/video_insights?metric=total_video_views,total_video_avg_time_watched,total_video_retention_graphQuali permessi e attività servono?
Un token della Pagina di qualcuno che può eseguire l'attività ANALYZE sulla Pagina. Il riferimento di Meta su video_insights indica read_insights e pages_manage_engagement, mentre la sua guida agli insight video indica pages_read_engagement. I dati coprono gli ultimi 2 anni, gli insight dei video su utenti o gruppi non sono disponibili, e un video condiviso in crosspost ha un ID video separato per ciascuna Pagina su cui è stato pubblicato.
Le metriche a livello di Pagina includono i Reel?
No. Il riferimento degli insight di Meta elenca, tra i suoi limiti per la lettura delle metriche di Pagina, che le interazioni sui Reel non sono incluse. Riproduzioni, follow, commenti e condivisioni di un Reel si leggono sul Reel stesso, tramite video_insights con il suo ID video.
Come le legge easyCoexistence?
get_social_insights legge l'edge degli insight della Pagina o di un singolo post: il parametro metric, un period e object_id per un post, con parametri aggiuntivi come since e until passati senza modifiche. video_insights è un edge a sé, che nessuno strumento legge, quindi le metriche proprie di un video o di un Reel si leggono in Meta Business Suite. Una metrica ritirata torna come errore di Meta, così la tua AI può cambiare nome.
Errori comuni
- Richiedere total_video_impressions. Meta ha dismesso le metriche di impression dei video a giugno 2026; chiedi invece le sue metriche Media Views, come post_media_view.
- Sommare i valori del grafico di permanenza. Sono percentuali delle visualizzazioni a ogni intervallo, non conteggi di riproduzioni.
- Cercare i Reel nei totali della Pagina. Gli insight di Pagina di Meta escludono le interazioni sui Reel, quindi leggi il video_insights di ogni Reel.
- Leggere il tempo di visualizzazione in secondi. total_video_avg_time_watched, total_video_view_total_time e post_video_view_time sono in millisecondi.
Da US$ 9 a US$ 0,75 per connessione al mese, con prezzo in calo man mano che aggiungi connessioni, e i primi 3 giorni di prova gratuita.
Domande frequenti
Cosa ha sostituito total_video_views_unique?
Meta indirizza verso le sue metriche Media Viewers: post_total_media_view_unique sul post, e page_total_media_view_unique per la Pagina.
Come ottengo le riproduzioni di un Reel tramite l'API?
Leggi blue_reels_play_count, oppure fb_reels_total_plays per includere le riproduzioni ripetute, da GET /{video-id}/video_insights con l'ID video restituito dalla chiamata di avvio del Reel.
post_impressions_unique funziona ancora per i Reel?
No. La tabella dei Reel di Meta lo elenca ancora, ma l'annuncio v25 lo ha dismesso su video_insights a giugno 2026; post_total_media_view_unique conta i visualizzatori unici sul post.
Quali video non hanno insight?
I video pubblicati su utenti o gruppi. Gli insight video di Meta coprono i video sulle Pagine, con dati degli ultimi 2 anni.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il