google-analytics-api
API i realtid

.NET Framework Android C# Language iOS Java Language JavaScript Node.js PHP Python Language R Language
Sök…


Syntax

parametrar

(Obligatoriskt) Parameternamn Beskrivning
ids Unikt tabell-ID för att hämta Analytics-data. Tabell-ID har formen ga: XXXX, där XXXX är Analytics-vyn (profil) ID.
metrik En kommaseparerad lista med Analytics-statistik. Exempelvis 'rt: activeUsers'. Minst ett statistik måste anges.
(Valfritt) Parameternamn Beskrivning
mått En kommaseparerad lista över realtidsdimensioner. Exempelvis 'rt: medium, rt: city'.
filter En kommaseparerad lista över dimensioner eller metriska filter som ska tillämpas på realtidsdata.
max-resultat Det maximala antalet poster som ska inkluderas i detta flöde.
sortera En kommaseparerad lista med dimensioner eller mätvärden som bestämmer sorteringsordningen för realtidsdata.
(Standard) Parameternamn Beskrivning
ring tillbaka Namnet på JavaScript-återuppringningsfunktionen som hanterar svaret. Används i JavaScript JSON-P-förfrågningar.
pretty Returnerar svaret i ett mänskligt läsbart format om det är sant. Standardvärde: sant. När detta är falskt kan det minska storleken på nyttolasten för svaret, vilket kan leda till bättre prestanda i vissa miljöer.
quotaUser Låter dig verkställa kvoter per användare från en serversidan applikation även i fall då användarens IP-adress är okänd. Detta kan till exempel uppstå med applikationer som kör cron-jobb på App Engine för användarens räkning. Du kan välja valfri valfri sträng som identifierar en användare unikt, men den är begränsad till 40 tecken. Övervänder userIp om båda tillhandahålls. Lär dig mer om användning av tak.
userIp Låter dig verkställa kvoter per användare när du ringer API från en server-sida applikation. Lär dig mer om användning av tak.

Anmärkningar

Real Time Reporting API, i begränsad beta, är endast tillgängligt för förhandsgranskning av utvecklare. Registrera dig för att komma åt API.

Med realtidsrapporterings-API kan du begära realtidsdata - till exempel realtidsaktivitet på din egendom - för en autentiserad användare.

Du kan använda API för realtidsrapportering för att:

  • Visa aktiva tittare på en sida och skapa en känsla av brådskande för användare som tittar på ett objekt med begränsad inventering.
  • Visa det mest populära innehållet, till exempel de 10 aktiva sidorna.
  • Skapa och visa en realtids instrumentpanel.

Tillstånd

Samtal till Google Analytics API i realtid kräver godkännande med minst ett av följande områden (läs mer om autentisering och auktorisering).

Omfattning tillgång beviljad
https://www.googleapis.com/auth/analytics Full åtkomst till Google Analytics-konton upp till nivån för den autentiserade användarnas åtkomst.
https://www.googleapis.com/auth/analytics.readonly Läs enbart åtkomst till de autentiserade Google Analytics-kontona

PHP-exempel

Använder PHP-klientbiblioteket 

/**
 * 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;
}

Originalversion kopierad från officiell dokumentation



Modified text is an extract of the original Stack Overflow Documentation
Licensierat under CC BY-SA 3.0
Inte anslutet till Stack Overflow