Số liệu thông tin chi tiết về Bài viết tức thì tổng hợp

Đối tượng này biểu thị nhóm số liệu thông tin chi tiết được tổng hợp trên tất cả Bài viết tức thì mà một Trang Facebook đã đăng. Để biết thêm thông tin về Bài viết tức thì, hãy đọc Tài liệu dành cho nhà phát triển về Bài viết tức thì của chúng tôi.

Đọc

Điểm cuối này bao gồm ID trang và số liệu đang được tra cứu. Tất cả số liệu có sẵn được nêu bên dưới.

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

Quyền

• Mã truy cập trang có quyềnread_insights có thể truy xuất số liệu cho Trang đó. Để biết thêm thông tin về mã truy cập trang, hãy tham khảo tài liệu về Mã truy cập Trang của chúng tôi.

Thông số

Trường

Khi đọc từ cạnh này, bạn sẽ nhận được kết quả ở định dạng JSON:

{
  "data": []
}

data

Danh sách các đối tượng InsightsQueryResult. Sau đây là các trường sẽ được thêm vào từng đối tượng được trả về:

Số liệu có sẵn

Dưới đây là khoảng thời gian tổng hợp áp dụng cho những số liệu khác nhau. Số liệu được thu thập từ cả thiết bị iOS và Android.

Ví dụ

Số lượt xem bài viết hàng ngày trong 7 ngày qua

Để truy vấn số liệu chia nhỏ hàng ngày về số lượt xem của tất cả Bài viết tức thì từ Trang của bạn trong 7 ngày qua, hãy gửi yêu cầu GET sau đây:

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

Yêu cầu này sẽ trả về phản hồi sau đây:

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

Số lượt xem bài viết hàng ngày trong 7 ngày qua với số liệu chia nhỏ theo nền tảng

Để truy vấn số liệu chia nhỏ hàng ngày về số lượt xem của tất cả Bài viết tức thì từ Trang của bạn trong 7 ngày qua, được chia nhỏ thêm theo nền tảng xem bài viết đó, hãy gửi yêu cầu GET sau đây:

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

Yêu cầu này sẽ trả về phản hồi sau đây:

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

Độ sâu cuộn hàng tuần của bài viết trong 7 ngày qua

Để truy vấn số liệu chia nhỏ hàng tuần về độ sâu cuộn theo nhóm của tất cả Bài viết tức thì từ Trang của bạn trong 7 ngày qua, hãy gửi yêu cầu GET sau đây:

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

Yêu cầu này sẽ trả về phản hồi sau đây. Lưu ý rằng dữ liệu trả về trong phản hồi này là theo nhóm. Khách truy cập trong khoảng thời gian yêu cầu được trả về thông qua giá trị và tỷ lệ phần trăm độ sâu cuộn thông qua nhóm:

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