API দিয়ে Instagram স্টোরি ইনসাইটস
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-এ story_insights ওয়েবহুক নেই।
easyCoexistence চালু থাকা অবস্থায় get_social_insights দিয়ে একটি স্টোরির ইনসাইটস পড়ে, যাতে Claude, ChatGPT বা আপনার নিজের কোড জিজ্ঞেস করতে পারে আজকের স্টোরিগুলো কেমন গেল, এবং সংযুক্ত অ্যাকাউন্টের জন্য সরাসরি Meta থেকে রিচ, ভিউ, রিপ্লাই, শেয়ার ও নেভিগেশন পায়।
API-তে স্টোরি মিডিয়ার মেট্রিক কতক্ষণ পাওয়া যায়।
স্টোরির কোনো মেট্রিকের মান 5-এর কম হলে মানের বদলে ফেরত আসে: মিডিয়াটি ইনসাইট দেখানোর মতো যথেষ্ট ভিউয়ার পায়নি।
Meta-র ইনসাইট গাইড story_insights ওয়েবহুকের জন্য একমাত্র যে সেটআপ দেয়; Instagram Login-এ এটি সমর্থিত নয়।
ইউরোপ বা জাপানের অ্যাকাউন্টে তৈরি স্টোরির রিপ্লাই মান।
link_clicks কখন যোগ হয়েছে: লিংক স্টিকারের মতো লিংকে ট্যাপ গোনে, শুধু Facebook Login-এ।
কোন মেট্রিক একটি স্টোরি ফেরত দেয়?
Meta-র মিডিয়ার রেফারেন্সে media_product_type STORY-এর জন্য যে মেট্রিকগুলো তালিকাভুক্ত, সেগুলো স্টোরি চালু থাকা অবস্থায় GET /<STORY_MEDIA_ID>/insights দিয়ে পড়া যায়। Instagram Login-এ কল যায় graph.instagram.com-এ, এমন একটি টোকেন দিয়ে যাতে instagram_business_basic ও instagram_business_manage_insights থাকে, এবং period সবসময় lifetime:
navigation কীভাবে অ্যাকশন অনুযায়ী পড়বেন?
navigation-কে আলাদাভাবে breakdown=story_navigation_action_type সহ অনুরোধ করুন। মোট মান আসে total_value.value-তে, আর প্রতিটি অ্যাকশন total_value.breakdowns[].results-এ, যেগুলো মিলে মোটের সমান: TAP_FORWARD (Forward), TAP_BACK (Back), TAP_EXIT (Exit) এবং SWIPE_FORWARD (Next Story)। 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-এর কম। সংখ্যার বদলে Meta ত্রুটির কোড 10 ফেরত দেয়, বার্তা (#10) Not enough viewers for the media to show insights, তাই কম মানুষ দেখা স্টোরি ব্যর্থ হতে পারে, যেখানে বেশি দেখা স্টোরি সফল হয়। এটিকে সমস্যা নয়, কম গণনা হিসেবে ধরুন এবং লুপে বারবার চেষ্টা করবেন না।
কেন স্টোরির রিপ্লাই 0?
অঞ্চলের নিয়মের কারণে। ইউরোপের মানুষের রিপ্লাই 1 ডিসেম্বর 2020 থেকে, এবং জাপানের মানুষের রিপ্লাই 14 এপ্রিল 2021 থেকে, replies মেট্রিক থেকে বাদ যায়, তাই এই অঞ্চলের কোনো অ্যাকাউন্টে তৈরি স্টোরি 0 ফেরত দেয়। Meta-র রেফারেন্স replies-কে স্টোরি মিডিয়া অবজেক্টের IG Comments হিসেবে সংজ্ঞায়িত করে।
কোনো story_insights ওয়েবহুক আছে কি?
Instagram Login-এ নেই। Meta-র ফিল্ড টেবিলে story_insights সেখানে অনুপলব্ধ দেখানো, মিডিয়া ইনসাইটস রেফারেন্স বলে ইনসাইটস ওয়েবহুক Instagram Login-এ সমর্থিত নয়, এবং ইনসাইটস গাইড story_insights শুধু Facebook Login-এর জন্য তালিকাভুক্ত করে। Facebook Login-এ ফিল্ডটি স্টোরির মেয়াদ শেষ হলে চলে, শুধু প্রথম 24 ঘণ্টার মেট্রিক বহন করে, এবং 5-এর কম গণনা -1 হিসেবে ফেরত দেয়।
কোন স্টোরি মেট্রিক বাতিল বা সীমিত?
কিছু নাম এখনো পুরোনো কোড বা Meta-র চেঞ্জলগে থেকে গেছে:
- impressions: 2 জুলাই 2024-এর পরে তৈরি মিডিয়ার জন্য বাতিল ঘোষিত, তাই বর্তমান স্টোরি বদলে views দেখায়।
taps_forward,taps_backএবং exits: 11 ডিসেম্বর 2023-এ বাতিল হয়েছে;story_navigation_action_typeদিয়ে ভাগ করা navigation একই অ্যাকশনগুলো দেখায়।link_clicks: লিংক স্টিকারের মতো লিংকে ট্যাপ, 22 জুন 2026-এ যোগ হয়েছে, শুধু Facebook Login-এর জন্য।total_views: সব সারফেস জুড়ে ভিউ, প্রচারিত মিডিয়াসহ, শুধু Facebook Login-এ পাওয়া যায়।
get_social_insights কীভাবে স্টোরি পড়ে?
স্টোরির মিডিয়া ID-কে object_id হিসেবে নিয়ে, যা publish_instagram_post স্টোরি প্রকাশের সময় media_id হিসেবে ফেরত দেয়, এবং মেট্রিকগুলো একটি তালিকা হিসেবে। navigation আলাদা কলে চান, params-এ breakdown story_navigation_action_type সেট করে, কারণ যে মেট্রিকটি breakdown সমর্থন করে না তার জন্য সেই breakdown পুরো কলটি ব্যর্থ করে। Meta-র ত্রুটি, ত্রুটির কোড 10 সহ, যেমন লেখা তেমনই ফেরত আসে।
{
"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 পুরো কলটি ব্যর্থ করে।
- Instagram Login-এ story_insights ওয়েবহুকের জন্য অপেক্ষা করা। সেখানে Meta এই ওয়েবহুক দেয় না, তাই স্টোরির মেয়াদ শেষ হওয়ার আগে ইনসাইটস এন্ডপয়েন্ট পোল করুন।
স্টোরি প্রকাশ হয় publish_instagram_post দিয়ে। প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ার সঙ্গে কমে, প্রথম 3 দিন ফ্রি ট্রায়াল।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
হাইলাইটে যোগ করা স্টোরির ইনসাইটস কি বদলায়?
বদলাতে পারে। Meta বলে, হাইলাইটে যোগ হওয়া স্টোরি মেয়াদ শেষ হওয়ার পরও ডেটা পেতে থাকতে পারে, তাই কিছু সময় API, ওয়েবহুক ও অ্যাপ আলাদা ফল দিতে পারে।
total_views কি Instagram Login-এর স্টোরিতে কাজ করে?
না। total_views, যা প্রচারিত মিডিয়াসহ সব সারফেস জুড়ে ভিউ গোনে, শুধু Facebook Login-এ পাওয়া যায়; Instagram Login-এ views অনুরোধ করুন।
API কি Instagram স্টোরির লিংক স্টিকারের ক্লিক পড়তে পারে?
শুধু Facebook Login-এ। Meta 22 জুন 2026-এ স্টোরির জন্য link_clicks যোগ করেছে, যা লিংক স্টিকারের মতো লিংকে ট্যাপ গোনে, এবং 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 পর্যবেক্ষণ
যাচাই করা হয়েছে