Facebook Reels ותובנות סרטונים דרך ה-API
התובנות של סרטוני Facebook ו-Reels מגיעות מ-GET /{video-id}/video_insights: total_video_views סופר השמעות של 3 שניות לפחות. השדות total_video_avg_time_watched וגם total_video_view_total_time נותנים את זמן הצפייה באלפיות שנייה, ואצל Reels נוספים השדות blue_reels_play_count, fb_reels_total_plays וגם fb_reels_replay_count, שמודדים הפעלות. ביוני 2026 הוציאה Meta משימוש, לכל הגרסאות, את total_video_impressions וכל מדדי החשיפה והצופים הייחודיים לסרטון.
easyCoexistence קוראת תובנות של עמוד ופוסט ב-Facebook עם get_social_insights, מ-Claude, מ-ChatGPT או מהקוד שלכם, כך שה-AI שלכם יוכל לומר איך העמוד והפוסטים שלו מתפקדים; את video_insights של סרטון או Reel קוראים ב-Meta Business Suite.
השדה total_video_views סופר השמעה שאורכה הקצר ביותר, או כמעט האורך המלא של סרטונים קצרים מכך.
מתי Meta הוציאה משימוש את השדות total_video_impressions, total_video_views_unique וגם post_video_views_unique, לכל הגרסאות.
עד כמה אחורה זמינים נתוני תובנות הסרטונים.
איך השדה total_video_retention_graph מחלק סרטון, ומדווח על השמעות בכל נקודה כאחוז מכל הצפיות.
השמעה שנספרת כהשמעת Reel בשדה blue_reels_play_count, והפעלות חוזרות לא נכללות בה.
לפי מדריך התובנות של Meta, אינטראקציות ב-Reels לא נכללות במדדי העמוד.
אילו מדדים מחזיר video_insights לסרטון?
המדדים האלה מופיעים במדריך של Meta ואינם ברשימות ההוצאה משימוש נכון לנובמבר 2026, וכולם סכומים מצטברים שנקראים לפי מזהה הסרטון. הצפיות לא כוללות זמן שמושקע בהפעלה חוזרת באותה השמעה, ולכמה מהם יש גרסה אורגנית וגרסה בתשלום, כמו השדות total_video_views_organic וגם total_video_views_paid, שמפוצלות לפיהן.
אילו מדדים מכסים Reels?
במדריך של Meta יש סעיף Reels, שנקרא לפי מזהה הווידאו של ה-Reel, עם ערכים מצטברים:
blue_reels_play_count: השמעות של מילישנייה אחת לפחות אחרי שנספרה חשיפה, בלי הפעלות חוזרות.fb_reels_total_plays: אותן השמעות כולל הפעלות חוזרות;fb_reels_replay_count: הפעלות חוזרות באותו סשן בלבד.- השדות
post_video_avg_time_watchedוגםpost_video_view_time: ממוצע וסך המילישניות שנוגנו, כולל הפעלות חוזרות. post_video_followers: עוקבים שנרשמו בזכות הסרטון.post_video_likes_by_reaction_type: לייקים לפי סוג ריאקציה.post_video_social_actions: התגובות והשיתופים שלו.post_video_retention_graph: השמעות בנקודות לאורך הסרטון, כאחוז מכלל ההשמעות.
אילו מדדי וידאו Meta הוציאה משימוש ב-2026?
ההודעה על Graph API v25 של Meta הוציאה משימוש ביוני 2026, לכל גרסאות ה-API, שתי קבוצות, והפנתה במקום למדדי Media Views ו-Media Viewers: השדות post_total_media_view_unique וגם page_total_media_view_unique לצופים ייחודיים, והשדות post_media_view וגם page_media_view לחלוקה לתשלום ולאורגני.
- חשיפות סרטון:
total_video_impressionsעם הגרסאות הייחודיות, בתשלום, אורגניות, ויראליות וגרסת fan שלו, וכן השדהpost_impressions_uniqueעל סרטון. - צופים של 3 שניות: השדות
total_video_views_unique,post_video_views_uniqueוגםpage_video_views_unique, עם הגרסאות האורגניות והבתשלום שלהם.
האם post_video_views וגם page_video_views עדיין תקפים?
כן. שניהם נשארים במדריך של Meta בלי סימון הוצאה משימוש. post_video_views סופר השמעות של פוסט וידאו של 3 שניות לפחות, לפי סך מצטבר או יומי, וגם page_video_views סופר את השמעות העמוד לפי הערכים day, week או days_28, כלומר לפי יום, שבוע או 28 ימים. הגרסאות הייחודיות שלהם, post_video_views_unique ו-page_video_views_unique, הוצאו משימוש ביוני 2026 בכל גרסאות ה-API, ומדדי ה-10 שניות, כמו post_video_views_10s, מסומנים כאלה מ-v18 ומעלה.
איך מבקשים תובנות סרטונים?
בשלושה אובייקטים, לכל אחד מדדים משלו. GET /{video-id}/video_insights עם metric כרשימה מופרדת בפסיקים קורא סרטון או Reel, וללא metric הוא מחזיר את הסך המצטבר של הסרטון. מדדי וידאו ברמת פוסט, כמו post_video_views, נקראים עם GET /{page-post-id}/insights, ומדדי עמוד, כמו page_video_views, עם GET /{page-id}/insights ותקופה.
GET /{video-id}/video_insights?metric=total_video_views,total_video_avg_time_watched,total_video_retention_graphאילו הרשאות ומשימה נדרשים?
אסימון עמוד ממישהו שיכול לבצע את המשימה ANALYZE בעמוד. במדריך video_insights של Meta מופיעות ההרשאות read_insights וגם pages_manage_engagement, ואילו מדריך התובנות לסרטונים מזכיר את pages_read_engagement, והנתונים מכסים את השנתיים האחרונות. תובנות לסרטונים של משתמשים או קבוצות אינן זמינות, וסרטון שפורסם בכמה עמודים מקבל מזהה וידאו נפרד בכל עמוד שאליו פורסם.
האם מדדי העמוד כוללים Reels?
לא. במדריך התובנות של Meta מופיעה בין המגבלות לקריאת מדדי עמוד שאינטראקציות ב-Reels לא נכללות. השמעות, עוקבים, תגובות ושיתופים של Reel נקראים על ה-Reel עצמו, דרך video_insights עם מזהה הווידאו שלו.
איך easyCoexistence קוראת אותם?
get_social_insights קורא את ה-insights edge של העמוד או של פוסט אחד: מדדים, תקופה ומזהה object_id לפוסט, עם פרמטרים נוספים כמו since וגם until, שמועברים הלאה. video_insights הוא edge משלו, שאף כלי אינו קורא, ולכן מדדי סרטון או Reel עצמם נקראים ב-Meta Business Suite. מדד שהוצא משימוש חוזר כשגיאה מ-Meta, כך שה-AI שלכם יכול להחליף את השם.
טעויות נפוצות
- במקום לבקש את total_video_impressions, מבקשים את מדדי Media Views, למשל post_media_view, כי מדדי החשיפה לסרטון הוצאו משימוש ביוני 2026.
- סכימת ערכי גרף השימור. הם אחוזים מהצפיות בכל מרווח, לא ספירה של השמעות.
- חיפוש Reels בסיכומי העמוד. במדדי העמוד של Meta אינטראקציות ב-Reels לא נכללות, ולכן יש לקרוא את video_insights של כל Reel בנפרד.
- קריאת זמן צפייה כשניות. השדות total_video_avg_time_watched, total_video_view_total_time וגם post_video_view_time נמדדים במילישניות.
US$ 9 עד US$ 0.75 לכל חיבור בחודש, שיורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
מה החליף את total_video_views_unique?
Meta מפנה למדדי Media Viewers שלה: השדה post_total_media_view_unique לפוסט, והשדה page_total_media_view_unique לעמוד.
איך מקבלים הפעלות Reel דרך ה-API?
קראו את blue_reels_play_count, או את fb_reels_total_plays כדי לכלול הפעלות חוזרות, מ-GET /{video-id}/video_insights, עם מזהה הסרטון שקריאת ההתחלה של ה-Reel החזירה.
האם post_impressions_unique עדיין עובד בסרטוני Reels?
לא. הטבלה של Meta בנושא Reels עדיין מציגה אותו, אבל הודעת v25 הוציאה אותו משימוש בתוך video_insights ביוני 2026, בעוד השדה post_total_media_view_unique סופר צופים ייחודיים בפוסט.
אילו סרטונים אין להם תובנות?
סרטונים שפורסמו בחשבונות משתמשים או בקבוצות. מדדי הווידאו של Meta מכסים סרטונים בעמודים, עם נתונים מהשנתיים האחרונות.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-