الرؤى

يمكنك استخدام واجهة Instagram Graph API للحصول على أدوات قياس التفاعلات على مواقع التواصل الاجتماعي لدى مستخدمي IG وكائنات وسائط IG الخاصة بهم. يتم حساب مقدار كل أداة قياس وفقًا لطلب واجهة API.

نظرًا لقواعد الخصوصية، لن يتم تضمين تفاعلات وسائط IG للقصص المتعلقة بالمراسلة والتي تم إجراؤها بواسطة مستخدمين داخل مناطق معينة، في بعض عمليات حساب أدوات القياس. وتتضمن هذه المناطق: أوروبا اعتبارًا من 1 ديسمبر 2020، واليابان اعتبارًا من 14 أبريل 2021.

  • بالنسبة للقصص التي أنشأها المستخدمون داخل المناطق المتأثرة، ستعمل أداة القياس replies الآن على إرجاع القيمة 0.
  • بالنسبة للقصص التي أنشأها المستخدمون خارج المناطق المتأثرة، ستعمل أداة القياس replies على إرجاع عدد من الردود، ولكن لن يتم تضمين الردود التي أنشأها المستخدمون داخل المناطق المتأثرة في عملية الحساب.

التقييدات

  • تكون بعض أدوات القياس متوفرة لدى مستخدمي IG بعدد متابعين أقل من 100 متابع.
  • تعمل API على إعداد تقارير حول أدوات قياس التفاعلات العادية فقط، ولا يتم احتساب التفاعلات على الإعلانات التي تحتوي على كائن وسائط.
  • يتم تخزين بيانات أدوات قياس الوسائط لمدة تصل إلى عامين. يتم تخزين بيانات أدوات قياس المستخدم لمدة تصل إلى 90 يومًا.
  • يمكنك الحصول على الرؤى الخاصة بمستخدم واحد فقط في المرة الواحدة.
  • لا يمكنك الحصول على رؤى صفحات فيسبوك.
  • تتوفر رؤى القصص لمدة 24 ساعة فقط حتى إذا تمت أرشفة القصص أو تمييزها. وإذا كنت تريد الحصول على أحدث الرؤى لقصة ما قبل انتهاء صلاحيتها، يمكنك إعداد حدث Webhook لموضوع Instagram والاشتراك في الحقل story_insights.
  • تكون الرؤى حول وسائط IG للصور الفرعية في الألبوم غير مدعومة.
  • إذا كانت بيانات الرؤى التي تطلبها غير موجودة أو غير متوفرة حاليًا، فستعمل API على إرجاع مجموعة بيانات فارغة بدلًا من القيمة 0 بالنسبة لأدوات القياس الفردية.

التوقيت العالمي الموحد (UTC)

تستخدم الطوابع الزمنية في استجابات واجهة 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"
    }
  ]
}