google-analytics-api
API w czasie rzeczywistym
Szukaj…
Składnia
- POBIERZ https://www.googleapis.com/analytics/v3/data/realtime?ids=[Analytics view ID] & metrics = [metryki w czasie rzeczywistym] & access_token = [Access_token_from_Authentcation]
- POBIERZ https://www.googleapis.com/analytics/v3/data/realtime?ids=[Identyfikator widoku analizy] & metrics = [Dane w czasie rzeczywistym] i wymiary = [Dane w czasie rzeczywistym] & access_token = [Access_token_from_Authentcation]
Parametry
(Wymagane) Nazwa parametru | Opis |
---|---|
identyfikatory | Unikalny identyfikator tabeli do pobierania danych Analytics. Identyfikator tabeli ma postać ga: XXXX, gdzie XXXX jest identyfikatorem widoku (profilu) Analytics. |
metryka | Rozdzielona przecinkami lista danych Analytics. Np. „Rt: activeUsers”. Należy podać co najmniej jedną metrykę. |
(Opcjonalnie) Nazwa parametru | Opis |
wymiary | Rozdzielona przecinkami lista wymiarów w czasie rzeczywistym. Np. „Rt: medium, rt: city”. |
filtry | Rozdzielona przecinkami lista filtrów wymiarów lub danych, które mają być stosowane do danych w czasie rzeczywistym. |
maksymalne wyniki | Maksymalna liczba wpisów do uwzględnienia w tym kanale. |
sortować | Rozdzielona przecinkami lista wymiarów lub danych, które określają porządek sortowania danych w czasie rzeczywistym. |
(Standard) Nazwa parametru | Opis |
oddzwonić | Nazwa funkcji zwrotnej JavaScript, która obsługuje odpowiedź. Używany w żądaniach JSON-P JavaScript. |
prettyPrint | Zwraca odpowiedź w formacie czytelnym dla człowieka, jeśli ma wartość true. Wartość domyślna: true. Gdy jest to fałsz, może zmniejszyć rozmiar ładunku odpowiedzi, co może prowadzić do lepszej wydajności w niektórych środowiskach. |
quotaUser | Pozwala egzekwować przydziały dla poszczególnych użytkowników z aplikacji po stronie serwera, nawet w przypadkach, gdy adres IP użytkownika jest nieznany. Może się tak zdarzyć na przykład w przypadku aplikacji uruchamiających zadania cron w App Engine w imieniu użytkownika. Możesz wybrać dowolny dowolny ciąg, który jednoznacznie identyfikuje użytkownika, ale jest ograniczony do 40 znaków. Zastępuje userIp, jeśli oba są podane. Dowiedz się więcej o ograniczaniu użycia. |
userIp | Umożliwia egzekwowanie limitów dla poszczególnych użytkowników podczas wywoływania interfejsu API z aplikacji po stronie serwera. Dowiedz się więcej o ograniczaniu użycia. |
Uwagi
Interfejs API raportowania w czasie rzeczywistym, w ograniczonej wersji beta, jest dostępny tylko do podglądu dla programistów. Zarejestruj się, aby uzyskać dostęp do interfejsu API.
Interfejs API raportowania w czasie rzeczywistym umożliwia żądanie danych w czasie rzeczywistym - na przykład aktywności w czasie rzeczywistym w Twojej nieruchomości - dla uwierzytelnionego użytkownika.
Możesz użyć interfejsu API raportowania w czasie rzeczywistym, aby:
- Wyświetlaj aktywnych przeglądających stronę i spraw, aby użytkownicy pilnie patrzyli na przedmiot ze skończonymi zasobami reklamowymi.
- Wyświetl najpopularniejsze treści, takie jak 10 najlepszych aktywnych stron.
- Utwórz i wyświetl pulpit nawigacyjny w czasie rzeczywistym.
Upoważnienie
Połączenia z interfejsem API Google Analytics w czasie rzeczywistym wymagają autoryzacji w co najmniej jednym z następujących zakresów (więcej informacji na temat uwierzytelniania i autoryzacji).
Zakres | Dostęp przyznany |
---|---|
https://www.googleapis.com/auth/analytics | Pełny dostęp do kont Google Analytics do poziomu dostępu uwierzytelnionych użytkowników. |
https://www.googleapis.com/auth/analytics.readonly | Dostęp tylko do odczytu do kont Google Analytics uwierzytelnionych użytkowników |
Przykład PHP
Korzysta z biblioteki klienta 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;
}
Oryginalna wersja skopiowana z oficjalnej dokumentacji