أدوات قياس الرؤى للمقالات الفورية المجمّعة

يمثل هذا الكائن مجموعة أدوات قياس الرؤى المجمّعة عبر كل المقالات الفورية المنشورة بواسطة صفحة فيسبوك. لمزيد من المعلومات حول المقالات الفورية، يمكنك قراءة وثائق المطوّرين للمقالات الفورية.

القراءة

تتكون نقطة النهاية هذه من معرف الصفحة وأداة القياس التي يتم البحث عنها. كل أدوات القياس المتوفرة مدرجة أدناه.

GET /v19.0/{page-id}?fields=instant_articles_insights.metric(metric-name) HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{page-id}?fields=instant_articles_insights.metric(metric-name)',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/{page-id}?fields=instant_articles_insights.metric(metric-name)",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}?fields=instant_articles_insights.metric(metric-name)",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}?fields=instant_articles_insights.metric(metric-name)"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

الأذونات

• يمكن لرمز وصول الصفحة الذي يتوفر لديه الإذن read_insights استرداد أدوات القياس لتلك الصفحة. لمزيد من المعلومات حول رموز وصول الصفحة، راجع وثائق رموز وصول الصفحة.

المعلمات

الحقول

ستؤدي القراءة من عنصر الربط هذا إلى إرجاع نتيجة بتنسيق JSON:

{
  "data": []
}

data

قائمة بكائنات InsightsQueryResult. ستتم إضافة الحقول التالية إلى كل كائن تم إرجاعه:

أدوات القياس المتوفرة

فيما يلي الفترات المجمّعة المتوفرة لأدوات القياس المختلفة. يتم جمع أدوات القياس من كل من أجهزة iOS وAndroid.

أمثلة

مشاهدات المقالات اليومية على مدار آخر 7 أيام

للاستعلام عن التقسيمات اليومية لعدد المشاهدات لكل المقالات الفورية من الصفحة على مدار آخر 7 أيام، يمكنك إجراء طلب GET التالي:

GET /v19.0/{page-id}?fields=instant_articles_insights.metric(all_views).period(day).since(7 day ago).until(now)&access_token={your-page-access-token} HTTP/1.1
Host: graph.facebook.com

سيرجع هذا الطلب الاستجابة التالية:

{
   "instant_articles_insights": {
      "data": [
        {
          "time": "2015-11-30T08:00:00+0000",
          "value": "224067"
        },
        {
          "time": "2015-12-01T08:00:00+0000",
          "value": "467846"
        },
        {
          "time": "2015-12-02T08:00:00+0000",
          "value": "849467"
        },
        {
          "time": "2015-12-03T08:00:00+0000",
          "value": "188502"
        },
        {
          "time": "2015-12-04T08:00:00+0000",
          "value": "321942"
        },
        {
          "time": "2015-12-05T08:00:00+0000",
          "value": "622841"
        },
        {
          "time": "2015-12-06T08:00:00+0000",
          "value": "198124"
        }
      ]
   },
   "id": "<page-id>"
}

مشاهدات المقالات اليومية على مدار آخر 7 أيام بتقسيم المنصة

للاستعلام عن التقسيمات اليومية لعدد المشاهدات لكل المقالات الفورية من الصفحة على مدار آخر 7 أيام، والتي يتم تقسيمها بشكل أكبر حسب المنصة التي تمت مشاهدتها عليها، يمكنك إرسال طلب GET التالي:

GET /v19.0/{page-id}?fields=instant_articles_insights.metric(all_views).breakdown(platform).period(day).since(7 day ago).until(now)&access_token={your-page-access-token} HTTP/1.1
Host: graph.facebook.com

سيرجع هذا الطلب الاستجابة التالية:

{
   "instant_articles_insights": {
      "data": [
        {
          "time": "2015-11-30T08:00:00+0000",
          "value": "112033",
          "breakdowns": {
            "platform": "ANDROID"
          }
        },
        {
          "time": "2015-11-30T08:00:00+0000",
          "value": "112034",
          "breakdowns": {
            "platform": "IOS"
          }
        },
        {
          "time": "2015-12-01T08:00:00+0000",
          "value": "233923",
          "breakdowns": {
            "platform": "ANDROID"
          }
        },
        {
          "time": "2015-12-01T08:00:00+0000",
          "value": "233923",
          "breakdowns": {
            "platform": "IOS"
          }
        },
        {
          "time": "2015-12-02T08:00:00+0000",
          "value": "424733",
          "breakdowns": {
            "platform": "ANDROID"
          }
        },
        {
          "time": "2015-12-02T08:00:00+0000",
          "value": "424734",
          "breakdowns": {
            "platform": "IOS"
          }
        }
      ]
   },
   "id": "<page-id>"
}

أعماق تمرير المقالة الأسبوعية على مدار آخر 7 أيام

للاستعلام عن التقسيمات الأسبوعية لأعماق التمرير ذات الفئات لكل المقالات الفورية من الصفحة على مدار آخر 7 أيام، يمكنك إرسال طلب GET التالي:

GET /v19.0/{page-id}?fields=instant_articles_insights.metric(all_scrolls).period(week).since(7 day ago).until(now)&access_token={your-page-access-token} HTTP/1.1
Host: graph.facebook.com

سيرجع هذا الطلب الاستجابة التالية. لاحظ أن البيانات التي يتم إرجاعها في هذه الاستجابة تكون مجمعة. يتم إرجاع الزائرين في الفترة المطلوبة عبر القيمة ونسب عمق التمرير عبر المجموعة:

{
   "instant_articles_insights": {
    "data": [
      {
        "time": "2015-11-26T08:00:00+0000",
        "value": "334606",
        "breakdowns": {
          "bucket": "100"
        }
      },
      {
        "time": "2015-11-26T08:00:00+0000",
        "value": "27339",
        "breakdowns": {
          "bucket": "94"
        }
      },
      {
        "time": "2015-11-26T08:00:00+0000",
        "value": "26746",
        "breakdowns": {
          "bucket": "95"
        }
      },
      {
        "time": "2015-11-26T08:00:00+0000",
        "value": "26727",
        "breakdowns": {
          "bucket": "93"
        }
      },
      {
        "time": "2015-11-26T08:00:00+0000",
        "value": "26512",
        "breakdowns": {
          "bucket": "96"
        }
      }
     ]
   }, 
   "id": "<page-id>"
}