يمكنك استخدام واجهة Instagram Graph API للحصول على أدوات قياس التفاعلات على مواقع التواصل الاجتماعي لدى مستخدمي IG وكائنات وسائط IG الخاصة بهم. يتم حساب مقدار كل أداة قياس وفقًا لطلب واجهة API.
نظرًا لقواعد الخصوصية، لن يتم تضمين تفاعلات وسائط IG للقصص المتعلقة بالمراسلة والتي تم إجراؤها بواسطة مستخدمين داخل مناطق معينة، في بعض عمليات حساب أدوات القياس. وتتضمن هذه المناطق: أوروبا اعتبارًا من 1 ديسمبر 2020، واليابان اعتبارًا من 14 أبريل 2021.
replies
الآن على إرجاع القيمة 0
.replies
على إرجاع عدد من الردود، ولكن لن يتم تضمين الردود التي أنشأها المستخدمون داخل المناطق المتأثرة في عملية الحساب.Instagram
والاشتراك في الحقل story_insights
.0
بالنسبة لأدوات القياس الفردية.تستخدم الطوابع الزمنية في استجابات واجهة API التوقيت العالمي الموحد (UTC) بدون إزاحة، ويتم تنسيقها باستخدام ISO-8601. فعلى سبيل المثال: 2019-04-05T07:56:32+0000
تتكون API من نقاط النهاية التالية:
GET /{ig-media-id}/insights
— يمكن الحصول على أدوات قياس حول كائن الوسائطGET /{ig-user-id}/insights
— يمكن الحصول على أدوات قياس حول حساب Instagram للأعمال أو حساب منشئ المحتوى على Instagram.يمكنك الرجوع إلى الوثائق المرجعية لكل نقطة نهاية للحصول على المعلمات وأدوات القياس المتوفرة، وكذلك متطلبات الأذونات.
للحصول على أدوات قياس حول حساب Instagram للأعمال أو حساب منشئ المحتوى على Instagram، استعلم عن عنصر الربط GET /{ig-user-id}/insights
وحدد أدوات القياس التي تريد إرجاعها.
GET graph.facebook.com/17841405822304914/insights ?metric=impressions,reach,profile_views &period=day
{ "data": [ { "name": "impressions", "period": "day", "values": [ { "value": 32, "end_time": "2018-01-11T08:00:00+0000" }, { "value": 32, "end_time": "2018-01-12T08:00:00+0000" } ], "title": "Impressions", "description": "Total number of times the Business Account's media objects have been viewed", "id": "instagram_business_account_id/insights/impressions/day" }, { "name": "reach", "period": "day", "values": [ { "value": 12, "end_time": "2018-01-11T08:00:00+0000" }, { "value": 12, "end_time": "2018-01-12T08:00:00+0000" } ], "title": "Reach", "description": "Total number of times the Business Account's media objects have been uniquely viewed", "id": "instagram_business_account_id/insights/reach/day" }, { "name": "profile_views", "period": "day", "values": [ { "value": 15, "end_time": "2018-01-11T08:00:00+0000" }, { "value": 15, "end_time": "2018-01-12T08:00:00+0000" } ], "title": "Profile Views", "description": "Total number of users who have viewed the Business Account's profile within the specified period", "id": "instagram_business_account_id/insights/profile_views/day" } ] }
للحصول على أدوات قياس حول كائن الوسائط، استعلم عن عنصر الربط GET /{ig-media-id}/insights
وحدد أدوات القياس التي تريد إرجاعها.
GET graph.facebook.com/{media-id}/insights ?metric=engagement,impressions,reach
{ "data": [ { "name": "engagement", "period": "lifetime", "values": [ { "value": 8 } ], "title": "Engagement", "description": "Total number of likes and comments on the media object", "id": "media_id/insights/engagement/lifetime" }, { "name": "impressions", "period": "lifetime", "values": [ { "value": 13 } ], "title": "Impressions", "description": "Total number of times the media object has been seen", "id": "media_id/insights/impressions/lifetime" }, { "name": "reach", "period": "lifetime", "values": [ { "value": 13 } ], "title": "Reach", "description": "Total number of unique accounts that have seen the media object", "id": "media_id/insights/reach/lifetime" } ] }