תובנות סטורי של Instagram דרך ה-API
נקודת הקצה של media insights ב-Instagram מחזירה עבור סטורי, כל עוד הוא פעיל, את המדדים הבאים: reach, views, replies, shares, navigation, follows, profile_visits, profile_activity, reposts וגם total_interactions. המדד navigation מתפצל לפי story_navigation_action_type לפעולות TAP_FORWARD, TAP_BACK, TAP_EXIT ואת SWIPE_FORWARD. מדדי סטורי זמינים 24 שעות, ערכים מתחת ל-5 מחזירים קוד שגיאה 10, ועם Instagram Login, וובהוק (Webhook) עבור story_insights לא קיים.
easyCoexistence קורא את תובנות הסטורי עם get_social_insights כל עוד הסטורי פעיל, כך ש-Claude, ChatGPT או הקוד שלכם יכולים לשאול איך עברו הסטוריז של היום ולקבל הגעה, צפיות, תשובות, שיתופים וניווט ישירות מ-Meta עבור החשבון המחובר.
משך הזמן שבו מדדי מדיה של סטורי זמינים דרך נקודת הקצה.
הערך שמוחזר במקום מספר כשמדד סטורי נמוך מ-5: אין מספיק צופים כדי שהמדיה תציג תובנות.
ההגדרה היחידה שמדריך התובנות של Meta מציין לוובהוק story_insights. עם Instagram Login היא לא נתמכת.
הערך של replies לסטורי שנוצר בחשבון באירופה או ביפן.
עם Facebook Login בלבד, Meta הוסיפה לסטוריז את link_clicks, שסופר הקשות על קישורים כמו מדבקות קישור.
אילו מדדים מחזיר סטורי?
אלה המדדים שמופיעים בהפניית ה-media insights של Meta עבור media_product_type STORY, שנקראים עם GET /<STORY_MEDIA_ID>/insights כל עוד הסטורי פעיל. עם Instagram Login הקריאה הולכת אל graph.instagram.com עם אסימון גישה (Access Token) שכולל את ההרשאות instagram_business_basic ואת instagram_business_manage_insights, והפרמטר period הוא תמיד lifetime, כמו בדוגמה הבאה:
כיצד קוראים ניווט לפי פעולה?
מבקשים את navigation לבד עם breakdown=story_navigation_action_type. הסך מוחזר בשדה total_value.value, וכל פעולה מוחזרת בשדה total_value.breakdowns[].results, והפעולות מסתכמות לאותו סך: TAP_FORWARD (קדימה), TAP_BACK (אחורה), TAP_EXIT (יציאה) ואת SWIPE_FORWARD (לסטורי הבא). בדוגמת התגובה של Meta הערכים כתובים באותיות קטנות:
GET https://graph.instagram.com/<STORY_MEDIA_ID>/insights
?metric=navigation
&breakdown=story_navigation_action_type
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{
"data": [
{
"name": "navigation",
"period": "lifetime",
"values": [{ "value": 25 }],
"total_value": {
"value": 25,
"breakdowns": [
{
"dimension_keys": ["story_navigation_action_type"],
"results": [
{ "dimension_values": ["tap_forward"], "value": 19 },
{ "dimension_values": ["tap_back"], "value": 4 },
{ "dimension_values": ["tap_exit"], "value": 1 },
{ "dimension_values": ["swipe_forward"], "value": 1 }
]
}
]
},
"id": "<STORY_MEDIA_ID>/insights/navigation/lifetime"
}
]
}כמה זמן מדדי סטורי זמינים?
24 שעות. Meta מאפשרת לקרוא מדדי מדיה של סטורי רק במשך 24 שעות, כלומר במשך חייו של הסטורי עצמו, אף שהנתונים שמאחוריהם עשויים להתעכב עד 48 שעות. לכן כדאי לקרוא אותם לפי לוח זמנים בזמן שהסטורי פעיל, ולשמור את הערכים האחרונים שהתקבלו. Meta מציינת שנתונים עשויים להגיע גם אחרי שהסטורי פג, אם הוא נוסף להדגשה, ושקריאות ה-API, הוובהוקים והאפליקציה יכולים אז להציג תוצאות שונות.
למה מדד סטורי מחזיר קוד שגיאה 10?
כי הערך שלו נמוך מ-5. ה-API מחזיר קוד שגיאה 10 עם ההודעה (#10) Not enough viewers for the media to show insights, במקום מספר קטן, ולכן סטורי שנצפה על ידי מעט אנשים עלול להיכשל, בעוד סטורי עמוס יותר מצליח. יש לראות בזה ספירה נמוכה ולא תקלה, ולא לנסות שוב בלולאה.
למה replies של סטורי מחזיר ערך אפס?
סיבה אזורית. תשובות מאנשים באירופה, מאז 1 בדצמבר 2020, ומיפן, מאז 14 באפריל 2021, אינן נכללות במדד replies, ולכן סטורי שנוצר בחשבון באחד האזורים האלה מחזיר ערך אפס. לפי ההגדרה של Meta, replies הם תשובות IG Comments על אובייקט המדיה של הסטורי.
האם וובהוק story_insights קיים?
לא. עם Instagram Login אין וובהוק כזה. בטבלת השדות של Meta, story_insights מסומן כלא זמין שם. בהפניה ל-media insights נכתב שהוובהוק של insights אינו נתמך עם Instagram Login, ובמדריך התובנות מופיע story_insights רק עם Facebook Login. עם Facebook Login הוובהוק נשלח כשסטורי פג, נושא רק את 24 השעות הראשונות של המדדים, ומחזיר ערך -1 במקום ספירות נמוכות מ-5 בשדה התוצאה.
אילו מדדי סטורי הוצאו משימוש או מוגבלים?
אלו שמות שעדיין מופיעים בקוד ישן או ביומן השינויים של Meta:
- impressions: הוצא משימוש למדיה שנוצרה אחרי 2 ביולי 2024, ולכן סטורי עדכני מדווח views במקום.
taps_forward,taps_backוגם exits: הוסרו ב-11 בדצמבר 2023, ואילו navigation, שמפורק לפיstory_navigation_action_type, מדווח את אותן הפעולות.link_clicks: עם Facebook Login בלבד, ספירת הקשות על קישורים כמו מדבקות קישור, שנוספה ב-22 ביוני 2026 לסטוריז.total_views: צפיות בכל המשטחים, כולל מדיה ממומנת, וזמין עם Facebook Login בלבד.
איך get_social_insights קורא סטורי?
מזהה המדיה של הסטורי מועבר בשדה object_id, והערך הזה הוא מה שהפונקציה publish_instagram_post מחזירה בשם media_id כשמפרסמים את הסטורי. המדדים מוחזרים כרשימה. מבקשים את navigation בקריאה נפרדת, עם breakdown מסוג story_navigation_action_type בתוך params, כי breakdown שמדד אחד שהתבקש בקריאה אינו תומך בו מכשיל את הקריאה כולה. השגיאות של Meta, כולל קוד שגיאה 10, מוחזרות כפי ש-Meta כתבה אותן.
{
"account_id": "<ACCOUNT_ID>",
"object_id": "<STORY_MEDIA_ID>",
"metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}טעויות נפוצות
- קריאת מדדי הסטורי למחרת. Meta מאפשרת אותם רק במשך 24 שעות, ולכן יש לאסוף אותם כל עוד הסטורי פעיל.
- ניסיון חוזר בלולאה על קוד שגיאה 10. המשמעות היא ערך מתחת ל-5, כלומר מעט מדי צופים, והוא לא ישתנה עד שיראו את הסטורי יותר אנשים.
- בקשה למדד navigation עם breakdown לצד מדדים אחרים. story_navigation_action_type עובד רק עם navigation, וערך breakdown שאינו נתמך מכשיל את הקריאה כולה.
- להמתין לוובהוק story_insights עם Instagram Login, שלא קיים. Meta לא מציעה אותו שם, ולכן יש לשלוח שאילתות לנקודת המדדים לפני שהסטורי פג.
את הסטוריז עצמם מפרסמים עם publish_instagram_post, באותו מקום. מ-US$ 9 עד US$ 0.75 לחיבור בחודש, כשהמחיר יורד ככל שמוסיפים חיבורים, עם תקופת ניסיון חינמית של 3 ימים.
שאלות נפוצות
האם תובנות סטורי משתנות אחרי שהסטורי נוסף להדגשה?
הן יכולות להשתנות. Meta מציינת שסטורי שנוסף להדגשה עשוי להמשיך לקבל נתונים אחרי שפג, ולכן ה-API, הוובהוקים והאפליקציה עלולים לא להסכים זה עם זה במשך זמן מסוים.
עם Instagram Login, האם total_views זמין לסטוריז?
לא. total_views, שסופר צפיות בכל המשטחים כולל מדיה ממומנת, זמין רק עם Facebook Login. עם Instagram Login יש לבקש את views בלבד.
ב-Instagram, האם ה-API יכול לקרוא קליקים על מדבקות קישור בסטורי?
רק עם Facebook Login. Meta הוסיפה את link_clicks לסטוריז ב-22 ביוני 2026, לספירת הקשות על קישורים כמו מדבקות קישור, ואילו עם Instagram Login זה לא זמין.
מה בא במקום taps_forward, taps_back וגם exits?
navigation, שמפורק לפי story_navigation_action_type לפעולות TAP_FORWARD, TAP_BACK, TAP_EXIT ואת SWIPE_FORWARD, מחליף אותם. המדדים הישנים הוסרו ב-11 בדצמבר 2023 ואינם זמינים עוד.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-