Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Instagram Story -insightsit API:n kautta

Instagramin media insights -päätepiste palauttaa tälle Storylle nämä mittarit, kun se on näkyvissä: reach, views, replies, shares, navigation, follows, profile_visits, profile_activity, reposts ja total_interactions. navigation jakautuu story_navigation_action_type-kentän mukaan arvoihin TAP_FORWARD, TAP_BACK, TAP_EXIT ja SWIPE_FORWARD. Story-mittarit ovat saatavilla 24 tuntia, alle 5:n arvot palauttavat virhekoodin 10, eikä Instagram Loginissa ole story_insights-webhookia.

easyCoexistence lukee Storyn insightsit get_social_insights-työkalulla, kun Story on näkyvissä, joten Claude, ChatGPT tai oma koodisi voi kysyä, miten tämän päivän Storyt menivät, ja saa tavoittavuuden, katselut, vastaukset, jaot ja navigoinnin suoraan Metalta yhdistetylle tilille.

24 hours

Kuinka kauan Story-median mittarit ovat saatavilla API:n kautta.

Error 10

Palautetaan arvon sijaan, kun Storyn mittari on alle 5: liian vähän katsojia, jotta median insightsit näkyvät.

Facebook Login

Ainoa asetus, jonka Metan insights-ohje antaa story_insights-webhookille. Instagram Loginin kanssa sitä ei tueta.

0

replies-arvo Storylle, joka on luotu Euroopassa tai Japanissa olevalta tililtä.

22 Jun 2026

Kun Meta lisäsi link_clicks-mittarin Storyille, joka laskee napautukset esim. linkkitarroihin, vain Facebook Loginille.

Mitä mittareita Story palauttaa?

Ne, jotka Metan media insights -viite listaa media_product_type STORY -tyypille, luettuna GET /<STORY_MEDIA_ID>/insights -kutsulla, kun Story on näkyvissä. Instagram Loginilla kutsu menee osoitteeseen graph.instagram.com käyttäen tokenia, jolla on oikeudet instagram_business_basic ja instagram_business_manage_insights, ja period on aina lifetime:

reachUnique accounts that saw the Story. Estimated.
viewsTimes the Story was played on Instagram. In development.
repliesReplies to the Story, with regional exceptions.
sharesTimes the Story was shared.
navigationActions taken from the Story: forward, back, exit and next Story.
followsFollows of the account, counted for the Story.
profile_visitsTimes the profile was visited.
profile_activityActions on the profile after engaging, by action_type.
repostsReposts, minus reposts later deleted.
total_interactionsInteractions on the Story, net of removals. In development.
facebook_viewsPlays where the Story was crossposted. Throws if it was not.

Miten navigation luetaan toiminnoittain?

Pyydä navigation yksin parametrilla breakdown=story_navigation_action_type. Kokonaismäärä tulee kentästä total_value.value ja jokainen toiminto kentästä total_value.breakdowns[].results, ja ne summautuvat kokonaismäärään: TAP_FORWARD (Forward), TAP_BACK (Back), TAP_EXIT (Exit) ja SWIPE_FORWARD (Next Story). Metan esimerkkivastaus kirjoittaa arvot pienillä kirjaimilla:

Navigation broken down by action, after Meta's sample
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"
    }
  ]
}

Kuinka kauan Storyn mittarit ovat saatavilla?

24 tuntia. Meta tekee Story-median mittarit saataville vain 24 tunniksi, eli Storyn oman elinajan ajaksi, vaikka taustalla oleva data voi viivästyä jopa 48 tuntia. Lue ne aikataulutetusti, kun Story on näkyvissä, ja säilytä viimeisimmät saamasi arvot. Meta huomauttaa, että dataa voi silti saapua Storyn vanhenemisen jälkeen, jos se lisätään kohokohtaan. Silloin API-kutsut, webhookit ja sovellus voivat näyttää eri tuloksia.

Miksi Storyn mittari palauttaa virhekoodin 10?

Koska sen arvo on alle 5. Meta palauttaa virhekoodin 10 viestillä (#10) Not enough viewers for the media to show insights pienen luvun sijaan, joten vähän nähty Story voi epäonnistua, vaikka vilkkaampi Story onnistuu. Käsittele sitä matalana lukuna, älä vikana, äläkä yritä uudelleen silmukassa.

Miksi Storyn replies on 0?

Alueelliset säännöt. Euroopasta 1. joulukuuta 2020 alkaen ja Japanista 14. huhtikuuta 2021 alkaen tulevat vastaukset jätetään pois replies-mittarista, joten alueen tilin luoma Story palauttaa 0. Metan viitteen mukaan replies tarkoittaa IG Comments -kommentit Story-median objektissa.

Onko story_insights-webhookia?

Ei Instagram Loginilla. Metan kenttätaulukko merkitsee story_insights-kentän ei-saatavilla siellä, sen media insights -viite sanoo insights-webhookin olevan tukematon Instagram Loginin kanssa, ja insights-ohje listaa story_insights-kentän vain Facebook Loginille. Facebook Loginilla kenttä laukeaa, kun Story vanhenee, sisältää vain sen ensimmäiset 24 tunnin mittarit ja palauttaa alle 5:n arvot muodossa -1.

Mitkä Story-mittarit ovat poistuneet tai rajoitettuja?

Muutama nimi näkyy yhä vanhassa koodissa tai Metan muutoslokissa:

  • impressions: vanhentunut median osalta, joka on luotu 2. heinäkuuta 2024 jälkeen, joten nykyinen Story raportoi sen sijaan views-mittarin.
  • taps_forward, taps_back ja exits: poistettu 11. joulukuuta 2023. navigation, jaoteltuna story_navigation_action_type-kentän mukaan, raportoi samat toiminnot.
  • link_clicks: napautukset linkkeihin, kuten linkkitarroihin, lisätty 22. kesäkuuta 2026, vain Facebook Loginille.
  • total_views: katselut kaikilla pinnoilla, mukaan lukien mainostetut mediat, tarjolla vain Facebook Loginilla.

Miten get_social_insights lukee Storyn?

Storyn media-ID:llä object_id-kenttänä. publish_instagram_post palauttaa sen media_id-kenttänä, kun se julkaisee Storyn, ja mittarit listana. Pyydä navigation erillisessä kutsussa, jonka params-kentän arvoksi on asetettu breakdown story_navigation_action_type, koska breakdown, jota yksi pyydetty mittari ei tue, epäonnistaa koko kutsun. Metan virheet, virhekoodi 10 mukaan lukien, palautetaan sellaisina kuin Meta ne kirjoitti.

get_social_insights arguments for one Story
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<STORY_MEDIA_ID>",
  "metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}

Yleiset virheet

  • Storyn mittarien lukeminen seuraavana päivänä. Meta tekee ne saataville vain 24 tunniksi, joten kerää ne, kun Story on näkyvissä.
  • Virhekoodin 10 yrittäminen uudelleen silmukassa. Se tarkoittaa alle 5:n arvoa eli liian vähän katsojia, eikä se muutu ennen kuin useampi näkee Storyn.
  • navigationin pyytäminen breakdownin kanssa muiden mittarien rinnalla. story_navigation_action_type toimii vain navigationin kanssa, ja tukematon breakdown epäonnistaa koko kutsun.
  • story_insights-webhookin odottaminen Instagram Loginilla. Meta ei tarjoa sitä siellä, joten kysele insights-päätepistettä ennen kuin Story vanhenee.
Näin teet tämän EasyCoexistencen avulla

Storyt julkaistaan publish_instagram_post-työkalulla. Hinta on alkaen US$ 9 per yhteys kuukaudessa ja laskee US$ 0,75:een yhteyksien määrän kasvaessa, ilmaisessa kokeilussa ensimmäiset 3 päivää.

Usein kysytyt kysymykset

Muuttuvatko Story-insightsit, kun Story lisätään kohokohtaan?

Voivat. Meta sanoo, että kohokohtaan lisätty Story voi saada dataa vielä vanhenemisen jälkeen, joten API, webhookit ja sovellus voivat olla eri mieltä jonkin aikaa.

Toimiiko total_views Storyille Instagram Loginilla?

Ei. total_views, joka laskee katselut kaikilla pinnoilla mukaan lukien mainostetut mediat, on tarjolla vain Facebook Loginilla. Instagram Loginilla pyydä views.

Voiko API lukea linkkitarran napautukset Instagram-Storyssä?

Vain Facebook Loginilla. Meta lisäsi link_clicks-mittarin Storyille 22. kesäkuuta 2026. Se laskee napautukset linkkeihin, kuten linkkitarroihin, eikä sitä tarjota Instagram Loginilla.

Mitä taps_forward, taps_back ja exits korvasivat?

navigation, jaoteltuna story_navigation_action_type-kentän mukaan arvoihin TAP_FORWARD, TAP_BACK, TAP_EXIT ja SWIPE_FORWARD. Vanhat mittarit poistettiin 11. joulukuuta 2023.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu