Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Statistik Story Instagram melalui API

Endpoint insights media Instagram memulangkan metrik ini bagi sebuah Story selagi ia aktif: reach, views, replies, shares, navigation, follows, profile_visits, profile_activity, reposts dan total_interactions. navigation dibahagikan mengikut story_navigation_action_type kepada TAP_FORWARD, TAP_BACK, TAP_EXIT dan SWIPE_FORWARD. Metrik Story tersedia selama 24 jam, nilai di bawah 5 memulangkan ralat 10, dan Instagram Login tiada webhook story_insights.

easyCoexistence membaca statistik Story dengan get_social_insights selagi ia aktif, supaya Claude, ChatGPT atau kod anda sendiri boleh bertanya bagaimana Story hari ini dan mendapat capaian, tontonan, balasan, kongsi serta navigasi terus daripada Meta bagi akaun yang disambungkan.

24 hours

Tempoh metrik media Story tersedia melalui API.

Error 10

Dipulangkan dan bukannya nilai apabila metrik Story di bawah 5: penonton tidak mencukupi untuk media memaparkan statistik.

Facebook Login

Satu-satunya persediaan yang diberikan panduan statistik Meta untuk webhook story_insights; ia tidak disokong dengan Instagram Login.

0

Nilai balasan bagi Story yang dicipta oleh akaun di Eropah atau Jepun.

22 Jun 2026

Apabila Meta menambah link_clicks untuk Story, mengira ketikan pada pautan seperti pelekat pautan, untuk Facebook Login sahaja.

Apakah metrik yang dipulangkan oleh Story?

Metrik yang disenaraikan dalam rujukan statistik media Meta untuk media_product_type STORY, dibaca dengan GET /<STORY_MEDIA_ID>/insights selagi Story aktif. Dengan Instagram Login, panggilan dibuat ke graph.instagram.com dengan token yang memegang instagram_business_basic dan instagram_business_manage_insights, dan period sentiasa 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.

Bagaimana membaca navigasi mengikut tindakan?

Minta navigation secara berasingan dengan breakdown=story_navigation_action_type. Jumlahnya dipulangkan dalam total_value.value dan setiap tindakan dalam total_value.breakdowns[].results, yang apabila dijumlahkan sama dengan jumlah itu: TAP_FORWARD (Ke hadapan), TAP_BACK (Ke belakang), TAP_EXIT (Keluar) dan SWIPE_FORWARD (Story Seterusnya). Contoh respons Meta menulis nilai dalam huruf kecil:

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"
    }
  ]
}

Berapa lamakah metrik Story tersedia?

24 jam. Meta hanya menyediakan metrik media Story selama 24 jam, iaitu tempoh hayat Story itu sendiri, manakala data di belakangnya boleh tertangguh sehingga 48 jam. Baca metrik mengikut jadual selagi Story aktif dan simpan nilai terakhir yang anda perolehi. Meta menyatakan data mungkin masih tiba selepas Story tamat tempoh jika ia ditambah ke sorotan, dan panggilan API, webhook serta aplikasi boleh kemudian menunjukkan hasil yang berbeza.

Mengapa metrik Story memulangkan ralat 10?

Kerana nilainya di bawah 5. Meta memulangkan kod ralat 10 dengan mesej (#10) Not enough viewers for the media to show insights dan bukannya nombor kecil, jadi Story yang dilihat oleh segelintir orang boleh gagal manakala Story yang lebih ramai ditonton berjaya. Anggap ini sebagai kiraan rendah dan bukan gangguan, serta jangan cuba semula dalam gelung.

Mengapa replies bagi Story ialah 0?

Peraturan wilayah. Balasan daripada orang di Eropah, sejak 1 Disember 2020, dan di Jepun, sejak 14 April 2021, dikecualikan daripada metrik replies, dan Story yang dicipta oleh akaun di salah satu wilayah tersebut memulangkan 0. Rujukan Meta mentakrifkan replies sebagai IG Comments pada objek media Story.

Adakah webhook story_insights wujud?

Tidak dengan Instagram Login. Jadual medan Meta menandakan story_insights tidak tersedia di sana, rujukan statistik media menyatakan webhook statistik tidak disokong dengan Instagram Login, dan panduan statistiknya menyenaraikan story_insights untuk Facebook Login sahaja. Dengan Facebook Login, medan ini dicetuskan apabila Story tamat tempoh, hanya membawa 24 jam pertama metrik, dan memulangkan kiraan di bawah 5 sebagai -1.

Metrik Story yang manakah telah ditamatkan atau terhad?

Beberapa nama masih muncul dalam kod lama atau dalam log perubahan Meta:

  • impressions: tidak digunakan lagi untuk media yang dicipta selepas 2 Julai 2024, jadi Story semasa melaporkan views sebagai gantinya.
  • taps_forward, taps_back dan exits: ditamatkan pada 11 Disember 2023; navigation, dibahagikan mengikut story_navigation_action_type, melaporkan tindakan yang sama.
  • link_clicks: ketikan pada pautan seperti pelekat pautan, ditambah pada 22 Jun 2026 untuk Facebook Login sahaja.
  • total_views: tontonan merentas permukaan, termasuk media yang dipromosikan, ditawarkan dengan Facebook Login sahaja.

Bagaimana get_social_insights membaca Story?

Dengan ID media Story sebagai object_id, yang dipulangkan oleh publish_instagram_post sebagai media_id apabila Story diterbitkan, dan metrik sebagai senarai. Minta navigation dalam panggilan berasingan dengan params ditetapkan kepada breakdown story_navigation_action_type, kerana breakdown yang tidak disokong oleh satu metrik yang diminta menyebabkan keseluruhan panggilan gagal. Ralat Meta, termasuk ralat 10, dipulangkan sebagaimana Meta menulisnya.

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

Kesilapan biasa

  • Membaca metrik Story pada hari berikutnya. Meta hanya menyediakannya selama 24 jam, jadi kumpulkan semasa Story masih aktif.
  • Mencuba semula ralat 10 dalam gelung. Ia bermaksud nilai di bawah 5, penonton tidak mencukupi, dan tidak akan berubah sehingga lebih ramai melihat Story.
  • Meminta navigation dengan breakdown bersama metrik lain. story_navigation_action_type hanya berfungsi dengan navigation, dan breakdown yang tidak disokong menyebabkan keseluruhan panggilan gagal.
  • Menunggu story_insights dengan Instagram Login. Meta tidak menawarkan webhook itu di sana, jadi tinjau endpoint insights sebelum Story tamat tempoh.
Menggunakan EasyCoexistence untuk ini

Story diterbitkan dengan publish_instagram_post. Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, berkurang apabila anda menambah sambungan, dengan percubaan percuma 3 hari pertama.

Soalan lazim

Adakah statistik Story berubah selepas Story ditambah ke sorotan?

Boleh. Meta menyatakan bahawa Story yang ditambah ke sorotan mungkin terus menerima data selepas tamat tempoh, jadi API, webhook dan aplikasi boleh berbeza pendapat untuk seketika.

Adakah total_views berfungsi untuk Story dengan Instagram Login?

Tidak. total_views, yang mengira tontonan merentas permukaan termasuk media yang dipromosikan, ditawarkan dengan Facebook Login sahaja; dengan Instagram Login, mohon views.

Bolehkah API membaca klik pada pelekat pautan Story Instagram?

Dengan Facebook Login sahaja. Meta menambah link_clicks untuk Story pada 22 Jun 2026, mengira ketikan pada pautan seperti pelekat pautan, dan tidak menawarkannya dengan Instagram Login.

Apakah yang menggantikan taps_forward, taps_back dan exits?

navigation, dibahagikan mengikut story_navigation_action_type kepada TAP_FORWARD, TAP_BACK, TAP_EXIT dan SWIPE_FORWARD. Metrik lama ditamatkan pada 11 Disember 2023.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada