Phiên bản API Đồ thị

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

Đối tượng này biểu thị nhóm số liệu thông tin chi tiết về một Bài viết tức thì, dựa trên URL chính tắc. Bạn có thể truy vấn các số liệu ở cấp độ bài viết, cũng như các số liệu về từng tài sản phương tiện trong bài viết.

Để 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 bài viết tức thì.

Thông tin chi tiết về bài viết

Điểm cuối dùng để truy vấn thông tin chi tiết ở cấp độ bài viết sẽ được xác định bằng URL chính tắc của bài viết đang truy vấn và số liệu được tra cứu. Tất cả số liệu có sẵn đều được liệt kê dưới đây.

Trình khám phá API Đồ thị

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

Quyền

Mã truy cập trang có quyềnread_insights có thể truy xuất số liệu về 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ố

Tên	Mô tả	Loại	Bắt buộc
`id`	URL chính tắc của Bài viết tức thì.	`url`	`yes`
`metric`	Số liệu được yêu cầu.	Xem các số liệu có sẵn dưới đây	`yes`
`period`	Khoảng thời gian mà số liệu được tổng hợp.	`enum{day, week, days_28, month, lifetime}`	`yes`
`since`	Giới hạn dưới của khoảng thời gian cần xem xét. Giá trị mặc định: `2 weeks ago`	`datetime`	`no`
`until`	Giới hạn trên của khoảng thời gian cần xem xét. Giá trị mặc định: `Current time`	`datetime`	`no`
`breakdown`	Tách biệt kết quả theo nền tảng (iOS hoặc Android) mà số liệu đó xuất hiện. Nếu không được chỉ định, kết quả sẽ bao gồm cả hai nền tảng.	`enum{platform}`	`no`

Trường

Khi đọc 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. Các trường sau đây sẽ được thêm vào từng đối tượng được trả về:

Tên Mô tả Loại

Tên	Mô tả	Loại
thời gian	Điểm bắt đầu của khoảng thời gian hoặc điểm kết thúc của khoảng thời gian trọn đời.	`datetime`
giá trị	Số lượng, giá trị trung bình, tỷ lệ hoặc phần trăm của số liệu trong khoảng thời gian.	`numeric`
số liệu chia nhỏ	Nhóm chứa giá trị (ví dụ: khi số liệu `all_view_durations` được dùng hoặc nếu thông số `breakdown(platform)` được chỉ định rõ ràng).	`map<string, string>`

thời gian

Điểm bắt đầu của khoảng thời gian hoặc điểm kết thúc của khoảng thời gian trọn đời.

datetime

giá trị

Số lượng, giá trị trung bình, tỷ lệ hoặc phần trăm của số liệu trong khoảng thời gian.

numeric

số liệu chia nhỏ

Nhóm chứa giá trị (ví dụ: khi số liệu

all_view_durations

được dùng hoặc nếu thông số

breakdown(platform)

được chỉ định rõ ràng).

map<string, string>

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. Các số liệu được thu thập từ cả thiết bị iOS và Android.

Tên	Mô tả	Giá trị của khoảng thời gian
`all_views`	Số lượt xem	`day`
`all_view_durations`	Thời lượng xem với số liệu chia nhỏ	`week`
`all_view_durations_average`	Thời lượng xem trung bình	`week`
`all_scrolls`	Độ sâu cuộn với số liệu chia nhỏ	`week`
`all_scrolls_average`	Độ sâu cuộn trung bình	`week`

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 lượt xem chia nhỏ hàng ngày của một trong các Bài viết tức thì trong 7 ngày qua, hãy gửi yêu cầu GET sau đây:

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

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

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

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 lượt xem chia nhỏ hàng ngày của một trong các Bài viết tức thì 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 /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

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

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

Thời lượng xem bài viết hàng tuần trong 7 ngày qua

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

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

Yêu cầu này sẽ trả về phản hồi sau. Lưu ý rằng dữ liệu trả về trong phản hồi này là theo nhóm:

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