google-analytics-api
Realtime API

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


Syntaxis

parameters

(Vereist) Parameternaam Beschrijving
ids Unieke tabel-ID voor het ophalen van Analytics-gegevens. Tabel-ID heeft de vorm ga: XXXX, waarbij XXXX de ID van de Analytics-weergave (profiel) is.
metriek Een door komma's gescheiden lijst met Analytics-statistieken. Bijvoorbeeld 'rt: activeUsers'. Er moet ten minste één waarde worden opgegeven.
(Optioneel) Parameternaam Beschrijving
dimensies Een door komma's gescheiden lijst met realtime dimensies. Bijvoorbeeld: 'rt: medium, rt: city'.
filters Een door komma's gescheiden lijst met dimensie- of metriekfilters die op realtime gegevens moeten worden toegepast.
max-resultaten Het maximale aantal vermeldingen dat in deze feed moet worden opgenomen.
soort Een door komma's gescheiden lijst met dimensies of statistieken die de sorteervolgorde voor realtime gegevens bepalen.
(Standaard) Parameternaam Beschrijving
Bel terug Naam van de JavaScript-callback-functie die het antwoord afhandelt. Gebruikt in JavaScript JSON-P-aanvragen.
prettyprint Retourneert het antwoord in een voor mensen leesbaar formaat indien true. Standaardwaarde: waar. Wanneer dit niet waar is, kan dit de respons-payloadgrootte verminderen, wat in sommige omgevingen tot betere prestaties kan leiden.
quotaUser Hiermee kunt u quota per gebruiker afdwingen vanuit een server-side applicatie, zelfs in gevallen waarin het IP-adres van de gebruiker onbekend is. Dit kan bijvoorbeeld voorkomen bij applicaties die cron-taken uitvoeren op App Engine namens een gebruiker. U kunt elke willekeurige tekenreeks kiezen die een gebruiker op unieke wijze identificeert, maar deze is beperkt tot 40 tekens. Overschrijft userIp als beide worden verstrekt. Meer informatie over aftoppinggebruik.
userip Hiermee kunt u quota per gebruiker afdwingen wanneer u de API aanroept vanuit een server-side applicatie. Meer informatie over aftoppinggebruik.

Opmerkingen

De Real Time Reporting API, in beperkte bèta, is alleen beschikbaar voor preview van de ontwikkelaar. Meld u aan voor toegang tot de API.

Met de Real Time Reporting API kunt u realtime gegevens (bijvoorbeeld realtime activiteit op uw eigendom) opvragen voor een geverifieerde gebruiker.

U kunt de Real Time Reporting API gebruiken om:

  • Geef actieve kijkers van een pagina weer en creëer een gevoel van urgentie voor gebruikers die naar een item met eindige inventaris kijken.
  • Geef de meest populaire inhoud weer, zoals de top 10 actieve pagina's.
  • Creëer en toon een realtime dashboard.

machtiging

Voor oproepen naar de Google Analytics Real-time API is autorisatie vereist met ten minste een van de volgende bereiken (lees meer over authenticatie en autorisatie).

strekking toegang verleend
https://www.googleapis.com/auth/analytics Volledige toegang tot Google Analytics-accounts tot het niveau van de geverifieerde toegang van gebruikers.
https://www.googleapis.com/auth/analytics.readonly Alleen-lezen toegang tot de Google Analytics-accounts van geverifieerde gebruikers

PHP Voorbeeld

Gebruikt de PHP-clientbibliotheek 

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

Originele versie overgenomen uit officiële documentatie



Modified text is an extract of the original Stack Overflow Documentation
Licentie onder CC BY-SA 3.0
Niet aangesloten bij Stack Overflow