Takwimu za Instagram Story kupitia API
Endpoint ya takwimu za media ya Instagram hurudisha metriki hizi za Story wakati iko hewani: reach, views, replies, shares, navigation, follows, profile_visits, profile_activity, reposts na total_interactions. navigation hugawanywa kwa story_navigation_action_type kuwa TAP_FORWARD, TAP_BACK, TAP_EXIT na SWIPE_FORWARD. Metriki za Story zinapatikana kwa saa 24, thamani chini ya 5 hurudisha hitilafu 10, na Instagram Login haina webhook ya story_insights.
easyCoexistence husoma takwimu za Story kwa get_social_insights wakati iko hewani, ili Claude, ChatGPT au msimbo wako mwenyewe uweze kuuliza Stories za leo zimefanyaje na kupata ufikiaji, maonyesho, majibu, kushirikiwa na kuvinjari moja kwa moja kutoka Meta kwa akaunti iliyounganishwa.
Muda ambao metriki za media ya Story zinapatikana kupitia API.
Hurudishwa badala ya thamani pale metriki ya Story iko chini ya 5: watazamaji hawatoshi kwa media kuonyesha takwimu.
Mpangilio pekee ambao mwongozo wa takwimu wa Meta unatoa kwa story_insights webhook; haitumiki kwa Instagram Login.
Thamani ya replies kwa Story iliyoundwa na akaunti barani Ulaya au Japani.
Meta ilipoongeza link_clicks kwa Stories, ikihesabu kugusa viungo kama link stickers, kwa Facebook Login pekee.
Story hurudisha metriki zipi?
Zile ambazo rejeleo la takwimu za media la Meta linaorodhesha kwa media_product_type STORY, zinazosomwa kwa GET /<STORY_MEDIA_ID>/insights wakati Story iko hewani. Kwa Instagram Login ombi huenda graph.instagram.com kwa token yenye instagram_business_basic na instagram_business_manage_insights, na period huwa lifetime kila wakati:
Unasomaje navigation kwa kitendo?
Omba navigation peke yake kwa breakdown=story_navigation_action_type. Jumla inarudi katika total_value.value na kila kitendo katika total_value.breakdowns[].results, ambavyo vinajumlisha hadi jumla hiyo: TAP_FORWARD (Mbele), TAP_BACK (Nyuma), TAP_EXIT (Toka) na SWIPE_FORWARD (Story Inayofuata). Mfano wa jibu la Meta unaandika thamani kwa herufi ndogo:
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"
}
]
}Metriki za Story zinapatikana kwa muda gani?
Saa 24. Meta inafanya metriki za media ya Story zipatikane kwa saa 24 tu, yaani maisha yake yenyewe, ingawa data nyuma yake inaweza kuchelewa hadi saa 48. Zisome kwa ratiba wakati Story iko hewani na uhifadhi thamani za mwisho ulizopata. Meta inabainisha kwamba data bado inaweza kufika baada ya Story kuisha muda ikiwa imeongezwa kwenye highlight, na kwamba wito wa API, webhooks na programu zinaweza kuonyesha matokeo tofauti.
Kwa nini metriki ya Story inarudisha hitilafu 10?
Kwa sababu thamani yake ni chini ya 5. Meta inarudisha msimbo wa hitilafu 10 na ujumbe (#10) Not enough viewers for the media to show insights badala ya nambari ndogo, hivyo Story iliyoonwa na watu wachache inaweza kushindwa wakati nyingine yenye watazamaji wengi inafanikiwa.Ichukulie kama idadi ndogo, si hitilafu ya mfumo, na usiijaribu tena mfululizo.
Kwa nini replies za Story ni 0?
Sheria za kikanda. Majibu kutoka kwa watu barani Ulaya, tangu 1 Desemba 2020, na nchini Japani, tangu 14 Aprili 2021, yanaachwa nje ya metriki ya replies, na Story iliyoundwa na akaunti katika moja ya maeneo hayo hurudisha 0. Rejeleo la Meta linafafanua replies kama IG Comments kwenye kitu cha media ya Story.
Je, kuna webhook ya story_insights?
Si kwa Instagram Login. Jedwali la sehemu la Meta linaweka alama ya story_insights kuwa haipatikani hapo, rejeleo lake la takwimu za media linasema webhook ya takwimu haitumiki kwa Instagram Login, na mwongozo wake wa takwimu unaorodhesha story_insights kwa Facebook Login pekee. Kwa Facebook Login sehemu hiyo huchochewa Story inapoisha muda, hubeba metriki za saa 24 za kwanza tu, na hurudisha idadi chini ya 5 kama -1.
Ni metriki zipi za Story zimestaafishwa au kuwekewa mipaka?
Majina machache bado yanaonekana kwenye msimbo wa zamani au kwenye changelog ya Meta:
- impressions: imekatishwa kwa media iliyoundwa baada ya 2 Julai 2024, kwa hiyo Story ya sasa huripoti views badala yake.
taps_forward,taps_backna exits: zilistaafishwa tarehe 11 Desemba 2023; navigation, iliyogawanywa kwastory_navigation_action_type, inaripoti vitendo hivyo hivyo.link_clicks: kugusa viungo kama link stickers, iliongezwa tarehe 22 Juni 2026 kwa Facebook Login pekee.total_views: maonyesho kwenye majukwaa yote, pamoja na media iliyotangazwa, yanatolewa kwa Facebook Login pekee.
get_social_insights inasomaje Story?
Kwa media ID ya Story kama object_id, ambayo publish_instagram_post hurudisha kama media_id inapochapisha Story, na metriki kama orodha. Omba navigation kwenye wito tofauti ukiweka params kuwa breakdown story_navigation_action_type, kwa sababu breakdown ambayo metriki moja iliyoombwa haiungi mkono inashindwa wito mzima. Hitilafu za Meta, pamoja na hitilafu 10, zinarudi jinsi Meta ilivyoziandika.
{
"account_id": "<ACCOUNT_ID>",
"object_id": "<STORY_MEDIA_ID>",
"metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}Makosa ya kawaida
- Kusoma metriki za Story siku iliyofuata. Meta inazifanya zipatikane kwa saa 24 tu, kwa hiyo zikusanye Story ikiwa bado iko hewani.
- Kurudia hitilafu 10 mfululizo. Inamaanisha thamani chini ya 5, watazamaji hawatoshi, na haitabadilika hadi watu zaidi waone Story.
- Kuomba navigation pamoja na breakdown kando ya metriki nyingine. story_navigation_action_type inafanya kazi kwa navigation pekee, na breakdown isiyoungwa mkono inashindwa wito mzima.
- Kusubiri story_insights kwa Instagram Login. Meta haitoi webhook hiyo hapo, kwa hiyo uliza endpoint ya takwimu mara kwa mara kabla Story haijaisha muda.
Stories hutumwa kwa publish_instagram_post. US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, inashuka unapoongeza miunganisho, huku siku 3 za kwanza zikiwa bila malipo.
Maswali yanayoulizwa mara kwa mara
Je, takwimu za Story hubadilika baada ya Story kuongezwa kwenye highlight?
Zinaweza. Meta inasema Story iliyoongezwa kwenye highlight inaweza kuendelea kupokea data baada ya kuisha muda, kwa hiyo API, webhooks na programu zinaweza kutofautiana kwa muda.
Je, total_views inafanya kazi kwa Stories za Instagram Login?
Hapana. total_views, inayohesabu maonyesho kwenye majukwaa yote pamoja na media iliyotangazwa, inatolewa kwa Facebook Login pekee; kwa Instagram Login omba views.
Je, API inaweza kusoma kugusa kwa link sticker kwenye Story ya Instagram?
Kwa Facebook Login pekee. Meta iliongeza link_clicks kwa Stories tarehe 22 Juni 2026, ikihesabu kugusa viungo kama link stickers, na haitoi kwa Instagram Login.
Nini kilichochukua nafasi ya taps_forward, taps_back na exits?
navigation, iliyogawanywa kwa story_navigation_action_type kuwa TAP_FORWARD, TAP_BACK, TAP_EXIT na SWIPE_FORWARD. Metriki za zamani zilistaafishwa tarehe 11 Desemba 2023.
Endelea kusoma
Unganisha chaneli yako ya kwanza ndani ya dakika mbili.
Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.
- Siku 3 bila malipo
- Ghairi wakati wowote
- API rasmi pekee
- Hufuatiliwa saa 24/7
Imethibitishwa kwenye