google-analytics-api
실시간 API
수색…
통사론
- GET https://www.googleapis.com/analytics/v3/data/realtime?ids=[Analytics 보기 ID] & metrics = [실시간 통계] & access_token = [Access_token_from_Authentcation]
- GET https://www.googleapis.com/analytics/v3/data/realtime?ids=[Analytics 보기 ID] & metrics = [실시간 통계] 및 측정 기준 = [실시간 통계] & access_token = [Access_token_from_Authentcation]
매개 변수
(필수) 매개 변수 이름 | 기술 |
---|---|
ID | 웹 로그 분석 데이터를 검색하기위한 고유 한 테이블 ID입니다. 표 ID는 ga : XXXX 형식입니다. 여기서 XXXX는 애널리틱스보기 (프로필) ID입니다. |
측정 항목 | 쉼표로 구분 된 애널리틱스 측정 항목 목록입니다. 예 : 'rt : activeUsers' 하나 이상의 메트릭을 지정해야합니다. |
(선택 사항) 매개 변수 이름 | 기술 |
치수 | 쉼표로 구분 된 실시간 크기 목록입니다. 예 : 'rt : medium, rt : city' |
필터 | 실시간 데이터에 적용 할 쉼표로 구분 된 차원 또는 메트릭 필터 목록입니다. |
최대 결과 | 이 피드에 포함 할 최대 항목 수입니다. |
종류 | 실시간 데이터의 정렬 순서를 결정하는 쉼표로 구분 된 차원 또는 메트릭 목록입니다. |
(표준) 매개 변수 이름 | 기술 |
콜백 | 응답을 처리하는 JavaScript 콜백 함수의 이름입니다. 자바 스크립트 JSON-P 요청에 사용됩니다. |
예쁜 프린트 | true 인 경우 사람이 읽을 수있는 형식으로 응답을 반환합니다. 기본값 : true. 이 값을 false로 설정하면 응답 페이로드 크기가 줄어들어 일부 환경에서 성능이 향상 될 수 있습니다. |
할당 자 | 사용자의 IP 주소를 알 수없는 경우에도 서버 측 응용 프로그램에서 사용자 별 할당량을 적용 할 수 있습니다. 예를 들어, 사용자를 대신하여 App Engine에서 cron 작업을 실행하는 응용 프로그램에서이 문제가 발생할 수 있습니다. 사용자를 고유하게 식별하는 임의의 문자열을 선택할 수 있지만 40 자로 제한됩니다. 둘 다 제공되면 userIp를 오버라이드합니다. 사용 제한에 대해 자세히 알아보십시오. |
userIp | 서버 측 응용 프로그램에서 API를 호출 할 때 사용자 별 할당량을 적용 할 수 있습니다. 사용 제한에 대해 자세히 알아보십시오. |
비고
제한된 베타 버전의 실시간보고 API는 개발자 미리보기에서만 사용할 수 있습니다 . 가입 하여 API에 액세스하십시오.
실시간보고 API를 사용하면 인증 된 사용자에 대해 실시간 데이터 (예 : 부동산의 실시간 활동)를 요청할 수 있습니다.
Real Time Reporting API를 사용하여 다음을 수행 할 수 있습니다.
- 페이지의 활동적인 시청자를 표시하고 유한 재고 목록이있는 항목을 보는 사용자에게 긴박감을줍니다.
- 상위 10 개 활성 페이지와 같이 가장 많이 사용되는 컨텐츠를 표시하십시오.
- 실시간 대시 보드를 만들고 표시합니다.
권한 부여
Google 웹 로그 분석 실시간 API를 호출하려면 다음 범위 중 하나 이상으로 인증해야합니다 (인증 및 승인에 대해 자세히 알아보기).
범위 | 액세스 권한 부여 |
---|---|
https://www.googleapis.com/auth/analytics | Google 애널리틱스 계정에 대한 모든 권한은 인증 된 사용자 액세스 수준까지 제공됩니다. |
https://www.googleapis.com/auth/analytics.readonly | 인증 된 사용자 Google 웹 로그 분석 계정에 대한 읽기 전용 액세스 |
PHP 예제
PHP 클라이언트 라이브러리를 사용합니다.
/**
* 1.Create and Execute a Real Time Report
* An application can request real-time data by calling the get method on the Analytics service object.
* The method requires an ids parameter which specifies from which view (profile) to retrieve data.
* For example, the following code requests real-time data for view (profile) ID 56789.
*/
$optParams = array(
'dimensions' => 'rt:medium');
try {
$results = $analytics->data_realtime->get(
'ga:56789',
'rt:activeUsers',
$optParams);
// Success.
} catch (apiServiceException $e) {
// Handle API service exceptions.
$error = $e->getMessage();
}
/**
* 2. Print out the Real-Time Data
* The components of the report can be printed out as follows:
*/
function printRealtimeReport($results) {
printReportInfo($results);
printQueryInfo($results);
printProfileInfo($results);
printColumnHeaders($results);
printDataTable($results);
printTotalsForAllResults($results);
}
function printDataTable(&$results) {
if (count($results->getRows()) > 0) {
$table .= '<table>';
// Print headers.
$table .= '<tr>';
foreach ($results->getColumnHeaders() as $header) {
$table .= '<th>' . $header->name . '</th>';
}
$table .= '</tr>';
// Print table rows.
foreach ($results->getRows() as $row) {
$table .= '<tr>';
foreach ($row as $cell) {
$table .= '<td>'
. htmlspecialchars($cell, ENT_NOQUOTES)
. '</td>';
}
$table .= '</tr>';
}
$table .= '</table>';
} else {
$table .= '<p>No Results Found.</p>';
}
print $table;
}
function printColumnHeaders(&$results) {
$html = '';
$headers = $results->getColumnHeaders();
foreach ($headers as $header) {
$html .= <<<HTML
<pre>
Column Name = {$header->getName()}
Column Type = {$header->getColumnType()}
Column Data Type = {$header->getDataType()}
</pre>
HTML;
}
print $html;
}
function printQueryInfo(&$results) {
$query = $results->getQuery();
$html = <<<HTML
<pre>
Ids = {$query->getIds()}
Metrics = {$query->getMetrics()}
Dimensions = {$query->getDimensions()}
Sort = {$query->getSort()}
Filters = {$query->getFilters()}
Max Results = {$query->getMax_results()}
</pre>
HTML;
print $html;
}
function printProfileInfo(&$results) {
$profileInfo = $results->getProfileInfo();
$html = <<<HTML
<pre>
Account ID = {$profileInfo->getAccountId()}
Web Property ID = {$profileInfo->getWebPropertyId()}
Internal Web Property ID = {$profileInfo->getInternalWebPropertyId()}
Profile ID = {$profileInfo->getProfileId()}
Profile Name = {$profileInfo->getProfileName()}
Table ID = {$profileInfo->getTableId()}
</pre>
HTML;
print $html;
}
function printReportInfo(&$results) {
$html = <<<HTML
<pre>
Kind = {$results->getKind()}
ID = {$results->getId()}
Self Link = {$results->getSelfLink()}
Total Results = {$results->getTotalResults()}
</pre>
HTML;
print $html;
}
function printTotalsForAllResults(&$results) {
$totals = $results->getTotalsForAllResults();
foreach ($totals as $metricName => $metricTotal) {
$html .= "Metric Name = $metricName\n";
$html .= "Metric Total = $metricTotal";
}
print $html;
}
Modified text is an extract of the original Stack Overflow Documentation
아래 라이선스 CC BY-SA 3.0
와 제휴하지 않음 Stack Overflow