그래프 API 버전

인스턴트 아티클의 인사이트 지표

이 개체는 표준 URL을 기반으로 하여 단일 인스턴트 아티클에 대한 인사이트 지표의 세트를 나타냅니다. 아티클 내의 개별적인 미디어 자산에 대한 지표뿐만 아니라 아티클 수준의 지표도 쿼리할 수 있습니다.

인스턴트 아티클에 대한 자세한 내용은 인스턴트 아티클 개발자 문서를 참조하세요.

아티클 인사이트

아티클 수준 인사이트를 쿼리하는 데 사용하는 엔드포인트는 쿼리 대상인 아티클의 표준 URL 및 검색되는 지표에 따라 결정됩니다. 모든 사용 가능한 지표가 아래에 나와 있습니다.

GET /v19.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권한이 있는 페이지 액세스 토큰은 해당 페이지에 대한 지표를 검색할 수 있습니다. 페이지 액세스 토큰에 대한 자세한 내용은 페이지 액세스 토큰 문서를 참조하세요.

매개변수

이름	설명	유형	필수
`id`	인스턴트 아티클의 표준 URL.	`url`	`yes`
`metric`	요청되는 지표.	사용 가능한 지표를 아래에서 참조하세요.	`yes`
`period`	지표를 집계하는 기간.	`enum{day, week, days_28, month, lifetime}`	`yes`
`since`	고려해야 할 시간 범위의 하한. 기본값: `2 weeks ago`	`datetime`	`no`
`until`	고려해야 할 시간 범위의 상한. 기본값: `Current time`	`datetime`	`no`
`breakdown`	지표가 생성된 플랫폼(iOS 또는 Android)에 따라 구분된 결과. 지정하지 않을 경우, 결과에 두 플랫폼이 모두 포함됩니다.	`enum{platform}`	`no`

필드

이 에지에서 읽으면 다음과 같이 JSON 형식의 결과가 반환됩니다.

{
  "data": []
}

data

InsightsQueryResult 개체의 리스트. 반환되는 각 개체에 다음의 필드가 추가됩니다.

이름 설명 유형

이름	설명	유형
시간	기간의 시작 또는 생애 기간의 종료 시간.	`datetime`
값	기간 내 지표의 수, 평균, 비율 또는 백분율.	`numeric`
분석 데이터	값이 속한 버킷(즉, `all_view_durations` 지표가 사용되는 시점, 또는 `breakdown(platform)` 매개변수가 명시적으로 지정되는지 여부).	`map<string, string>`

시간

기간의 시작 또는 생애 기간의 종료 시간.

datetime

값

기간 내 지표의 수, 평균, 비율 또는 백분율.

numeric

분석 데이터

값이 속한 버킷(즉,

all_view_durations

지표가 사용되는 시점, 또는

breakdown(platform)

매개변수가 명시적으로 지정되는지 여부).

map<string, string>

사용 가능한 지표

아래에는 지표별로 사용 가능한 집계 기간이 나와 있습니다. 지표는 iOS 및 Android 기기에서 모두 수집됩니다.

이름	설명	기간 값
`all_views`	조회수	`day`
`all_view_durations`	분석 데이터가 포함된 조회 기간	`week`
`all_view_durations_average`	조회의 평균 기간	`week`
`all_scrolls`	분석 데이터를 포함한 스크롤 깊이	`week`
`all_scrolls_average`	평균 스크롤 깊이	`week`

예

최근 7일 동안의 일일 아티클 조회수

최근 7일 동안 인스턴트 아티클 중 하나의 조회수에 대한 일일 분석 데이터를 쿼리하려면 다음 GET 요청을 보내세요.

GET /v19.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 /v19.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 /v19.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"
}