התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

תובנות Reels ב-Instagram דרך ה-API

נקודת הקצה לתובנות המדיה של Instagram, GET /<IG_MEDIA_ID>/insights, מחזירה עבור Reel את המדדים האלה: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time, reels_skip_rate, וכן crossposted_views וגם facebook_views עבור Reel שפורסם בשיתוף. המדדים plays, clips_replays_count וגם ig_reels_aggregated_all_plays_count הוצאו משימוש באפריל 2025, והמדד views החליף אותם.

easyCoexistence קוראת את התובנות של Reel עם get_social_insights, כך ש-Claude, ChatGPT או הקוד שלכם יכולים לשאול איך Reel הצליח ולקבל צפיות, הגעה, זמן צפייה ושיעור דילוג ישירות מ-Meta עבור החשבון המחובר, עם השגיאה של Meta כששם מדד הוצא משימוש.

3 seconds

החלון שבו מודד reels_skip_rate: שיעור הצפיות שבהן דילגו על ה-Reel בתוך 3 השניות הראשונות

21 Apr 2025

מועד ההוצאה משימוש של המדדים plays, clips_replays_count וגם ig_reels_aggregated_all_plays_count בכל גרסאות ה-API

3 Dec 2025

מועד הוספת reels_skip_rate, reposts, crossposted_views וגם facebook_views לתובנות המדיה

48 hours

כמה זמן עשויים נתוני מדדי המדיה להתעכב

2 years

כמה זמן Meta שומרת את מדדי המדיה

אילו מדדים מחזיר Reel?

אלה המדדים שההפניה של Meta לתובנות המדיה מפרטת עבור media_product_type REELS, בקריאה עם GET /<IG_MEDIA_ID>/insights ופרמטר metric מופרד בפסיקים. Meta מסמנת חלק מהם כמוערכים או בפיתוח, כמצוין לצד כל אחד, ומונה לייקים ותגובות כפעילות אורגנית בלבד:

viewsTimes the Reel was played on Instagram. In development.
reachUnique accounts that saw the Reel at least once. Estimated.
likesLikes on the Reel, organic only.
commentsComments on the Reel, organic only.
sharesTimes the Reel was shared.
savedTimes the Reel was saved.
repostsReposts, minus reposts later deleted.
total_interactionsLikes, saves, comments and shares, minus unlikes, unsaves and deleted comments. In development.
ig_reels_avg_watch_timeAverage time spent playing the Reel.
ig_reels_video_view_total_timeTotal time the Reel was played, replays included. In development.
reels_skip_rateShare of initial views that skipped within the first 3 seconds. Estimated, in development.
crossposted_viewsPlays across Instagram and where the Reel was crossposted, combined. Throws if it was not crossposted.
facebook_viewsPlays of the crossposted Reel outside Instagram. Throws if it was not crossposted.

מה מחזירה בקשת תובנות ל-Reels?

אובייקט אחד לכל מדד בתוך data, ובו השדות name, period, values, title, description וגם id. השדה period תמיד מציג את הערך lifetime: Meta קובעת אותו עבור מדדי מדיה ואי אפשר לשנות אותו, ולכן הבקשה לא צריכה אותו. Meta מתארת את שני מדדי זמן הצפייה כפרק זמן בלי לציין יחידה, ולכן בודקים אותם מול Reel שאתם מכירים לפני שמציגים אותם בגרף.

A Reels insights request and the shape of its answer
GET https://graph.instagram.com/<IG_MEDIA_ID>/insights
  ?metric=views,reach,ig_reels_avg_watch_time,reels_skip_rate
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "views",
      "period": "lifetime",
      "values": [{ "value": <VALUE> }],
      "title": "<TITLE>",
      "description": "<DESCRIPTION>",
      "id": "<IG_MEDIA_ID>/insights/views/lifetime"
    }
  ]
}

אילו מדדי Reels הוצאו משימוש, ומה החליף אותם?

Meta הוציאה משימוש את שלושת המדדים הראשונים החל מ-Graph API v22.0 ב-21 בינואר 2025, היום שבו נוסף המדד views, ובכל הגרסאות החל מ-21 באפריל 2025. את video_views הוציאה משימוש החל מ-v21.0 ובכל הגרסאות החל מ-8 בינואר 2025. בקשה שמציינת מדד שהוצא משימוש נכשלת, ולכן רשימת מדדים שנכתבה לפני 2025 צריכה עדכון:

RetiredRequest instead
playsDeprecated in every version on 21 Apr 2025views
clips_replays_countDeprecated in every version on 21 Apr 2025views
ig_reels_aggregated_all_plays_countDeprecated in every version on 21 Apr 2025views
video_viewsDeprecated in every version on 8 Jan 2025views
impressionsNot in Meta's Reels list; returns an error for media created on or after 2 Jul 2024views

מה נספר במדד views ובמדד reach של Reel?

views הוא מספר הפעמים שה-Reel הושמע ב-Instagram, מדד ש-Meta מסמנת כבפיתוח. reach הוא מספר החשבונות הייחודיים שראו אותו לפחות פעם אחת, ו-Meta מסמנת אותו כמוערך. לייקים, תגובות, views וגם total_interactions סופרים פעילות אורגנית בלבד, ולא כוללים מעורבות במודעות שנוצרו מה-Reel. Facebook Login הוא התנאי היחיד לקבלת total_likes, total_comments וגם total_views, הכוללים מדיה ממומנת.

אילו מגבלות ועיכובים חלים?

ההפניה של Meta לתובנות המדיה קובעת את הכללים האלה למספרים של Reel:

  • הנתונים שמאחורי המדדים יכולים להתעכב עד 48 שעות
  • מדדי המדיה נשמרים עד שנתיים
  • נתונים חסרים או שאינם זמינים מחזירים מערך נתונים ריק, ולא ערך של אפס
  • crossposted_views וגם facebook_views נכשלים עבור Reel שלא פורסם בשיתוף, ולכן יש לבקש אותם בקריאה נפרדת משלהם
  • פירוט שהמדד המבוקש אינו תומך בו מכשיל את הבקשה כולה עם השגיאה An unknown error has occurred, ולכן יש לבדוק את הפירוט לפני שליחת הבקשה
  • בנקודת הקצה graph.instagram.com, עם Instagram Login, האסימון צריך את ההרשאות instagram_business_basic וגם instagram_business_manage_insights

איך get_social_insights קורא Reel?

עם השדה account_id של החיבור, מזהה המדיה של ה-Reel בשדה object_id ורשימת מדדים. easyCoexistence קוראת ל-GET /<IG_MEDIA_ID>/insights בשרת graph.instagram.com עם האסימון של החשבון, מעבירה ל-Meta את שמות המדדים כפי שניתנו, ומחזירה את הנתונים של Meta, או את השגיאה של Meta כששם מדד הוצא משימוש. list_social_posts מחזיר את מזהי המדיה של הפוסטים וה-Reels האחרונים של החשבון.

get_social_insights arguments for one Reel
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<REEL_MEDIA_ID>",
  "metrics": [
    "views", "reach", "likes", "comments", "shares", "saved",
    "total_interactions", "ig_reels_avg_watch_time",
    "ig_reels_video_view_total_time", "reels_skip_rate"
  ]
}

טעויות נפוצות

  • בקשת plays או clips_replays_count. שני המדדים הוצאו משימוש בכל גרסאות ה-API ב-21 באפריל 2025, ולכן יש לבקש במקומם את המדד views
  • שילוב crossposted_views או facebook_views בבקשה כללית. הם נכשלים עבור Reel שלא פורסם בשיתוף, והשגיאה מפילה את הקריאה כולה
  • הנחת יחידה לזמן הצפייה. Meta לא מציינת יחידה עבור ig_reels_avg_watch_time או עבור ig_reels_video_view_total_time, ולכן יש לבדוק מול Reel מוכר
  • קריאת תוצאה ריקה כאפס. Meta מחזירה מערך נתונים ריק כשהנתונים לא קיימים או לא זמינים כרגע
עושים את זה עם EasyCoexistence

החל מ-US$ 9 לכל חיבור בחודש, שיורד עד US$ 0.75 ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.

שאלות נפוצות

למה בקשת תובנות Reels מחזירה תוצאה ריקה?

Meta מחזירה מערך נתונים ריק, ולא 0, כשהנתונים לא קיימים או לא זמינים כרגע, והנתונים שמאחורי המדדים יכולים להתעכב עד 48 שעות.

איך מקבלים את זמן הצפייה של Reels מה-API?

מבקשים את ig_reels_avg_watch_time עבור הממוצע ואת ig_reels_video_view_total_time עבור הסך הכול, כולל צפיות חוזרות, בקריאה GET /<IG_MEDIA_ID>/insights, בנקודת הקצה של Meta.

מהו reels_skip_rate?

שיעור הצפיות הראשוניות שבהן דילגו על ה-Reel בתוך 3 השניות הראשונות. Meta הוסיפה אותו ב-3 בדצמבר 2025 ומסמנת אותו כמוערך ובפיתוח.

האם תובנות Reels כוללות צפיות ממודעות?

לא. לייקים, תגובות, views וגם total_interactions סופרים פעילות אורגנית בלבד. Facebook Login הוא התנאי היחיד לקבלת total_views, שכולל מדיה ממומנת.

המשיכו לקרוא

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-