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

يمثل هذا الكائن مجموعة أدوات قياس الرؤى لمقالة فورية واحدة، استنادًا إلى عنوان URL المتعارف عليه. يمكن الاستعلام عن أدوات القياس على مستوى المقالة، بالإضافة إلى أدوات القياس في أصول الوسائط الفردية ضمن المقالة.

لمزيد من المعلومات حول المقالات الفورية، يمكنك قراءة وثائق المطوّرين للمقالات الفورية.

رؤى المقالات

يتم تحديد نقطة النهاية المستخدمة للاستعلام عن الرؤى على مستوى المقالة من خلال عنوان URL المتعارف عليه للمقالة التي يتم الاستعلام عنها وأداة القياس التي يتم البحث عنها. كل أدوات القياس المتوفرة مدرجة أدناه.

GET /v21.0/?fields=instant_article{insights.metric(metric-name)}&id={canonical-url} 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(
    '/?fields=instant_article{insights.metric(metric-name)}&id={canonical-url}',
    '{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(
    "/?fields=instant_article{insights.metric(metric-name)}&id={canonical-url}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

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

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/?fields=instant_article{insights.metric(metric-name)}&id={canonical-url}"
                                      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 /v21.0/?fields=instant_article{insights.metric(all_views).period(day).since(7 day ago).until(now)}&id=http://www.example.com/my-test-page.html&access_token={your-page-access-token} HTTP/1.1
Host: graph.facebook.com

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

{
   "instant_article": {
      "insights": {
         "data": [
            {
               "time": "2015-10-28T08:00:00+0000",
               "value": "3"
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "3"
            },
            {
               "time": "2015-10-30T08:00:00+0000",
               "value": "3"
            },
            {
               "time": "2015-10-31T08:00:00+0000",
               "value": "3"
            },
            {
               "time": "2015-11-01T08:00:00+0000",
               "value": "2"
            },
            {
               "time": "2015-11-02T08:00:00+0000",
               "value": "6"
            },
            {
               "time": "2015-11-03T08:00:00+0000",
               "value": "4"
            }
         ]
      },
      "id": "<article-id>"
   },
   "id": "http://www.example.com/my-test-page.com"
}

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

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

GET /v21.0/?fields=instant_article{insights.metric(all_views).breakdown(platform).period(day).since(7 day ago).until(now)}&id=http://www.example.com/my-test-page.html&access_token={your-page-access-token} HTTP/1.1
Host: graph.facebook.com

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

{
   "instant_article": {
      "insights": {
         "data": [
            {
              "time": "2015-10-28T08:00:00+0000",
              "value": "1",
              "breakdowns": {
                "platform": "ANDROID"
              }
            },
            {
              "time": "2015-10-28T08:00:00+0000",
              "value": "2",
              "breakdowns": {
                "platform": "IOS"
              }
            },
            {
              "time": "2015-10-29T08:00:00+0000",
              "value": "1",
              "breakdowns": {
                "platform": "ANDROID"
              }
            },
            {
              "time": "2015-10-29T08:00:00+0000",
              "value": "2",
              "breakdowns": {
                "platform": "IOS"
              }
            },
            {
              "time": "2015-10-30T08:00:00+0000",
              "value": "1",
              "breakdowns": {
                "platform": "ANDROID"
              }
            },
            {
              "time": "2015-10-30T08:00:00+0000",
              "value": "2",
              "breakdowns": {
                "platform": "IOS"
              }
            }
         ]
      },
      "id": "<article-id>"
   },
   "id": "http://www.example.com/my-test-page.com"
}

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

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

GET /v21.0/?fields=instant_article{insights.metric(all_view_durations).period(week).since(7 day ago).until(now)}&id=http://www.example.com/my-test-page.html&access_token={your-page-access-token} HTTP/1.1
Host: graph.facebook.com

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

{
   "instant_article": {
      "insights": {
         "data": [
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "8",
               "breakdowns": {
                  "bucket": "15"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "2",
               "breakdowns": {
                  "bucket": "225"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "2",
               "breakdowns": {
                  "bucket": "90"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "1",
               "breakdowns": {
                  "bucket": "360"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "1",
               "breakdowns": {
                  "bucket": "240"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "1",
               "breakdowns": {
                  "bucket": "165"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "1",
               "breakdowns": {
                  "bucket": "120"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "1",
               "breakdowns": {
                  "bucket": "75"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "1",
               "breakdowns": {
                  "bucket": "60"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "1",
               "breakdowns": {
                  "bucket": "45"
               }
            },
            {
               "time": "2015-10-29T08:00:00+0000",
               "value": "1",
               "breakdowns": {
                  "bucket": "30"
               }
            }
         ]
      },
      "id": "<article-id>"
   },
   "id": "http://www.example.com/my-test-page.com"
}