google-analytics-api
Echtzeit-API

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


Syntax

Parameter

(Erforderlich) Parametername Beschreibung
Ids Eindeutige Tabellen-ID zum Abrufen von Analytics-Daten. Die Tabellen-ID hat die Form ga: XXXX, wobei XXXX die Analytics-Ansicht (Profil) -ID ist.
Metriken Eine durch Kommas getrennte Liste von Analytics-Messwerten. ZB "rt: activeUsers". Es muss mindestens eine Metrik angegeben werden.
(Optional) Parametername Beschreibung
Maße Eine durch Kommas getrennte Liste von Echtzeitdimensionen. ZB "rt: medium, rt: city".
Filter Eine durch Kommas getrennte Liste von Dimensions- oder Metrikfiltern, die auf Echtzeitdaten angewendet werden sollen.
Max-Ergebnisse Die maximale Anzahl von Einträgen, die in diesen Feed aufgenommen werden sollen.
Sortieren Eine durch Kommas getrennte Liste von Dimensionen oder Metriken, die die Sortierreihenfolge für Echtzeitdaten bestimmen.
(Standard) Parametername Beschreibung
Ruf zurück Name der JavaScript-Callback-Funktion, die die Antwort verarbeitet. Wird in JavaScript-JSON-P-Anforderungen verwendet.
prettyPrint Gibt die Antwort in einem für Menschen lesbaren Format zurück, wenn true. Standardwert: true Wenn dies falsch ist, kann dies die Größe der Antwortnutzlast reduzieren, was in einigen Umgebungen zu einer besseren Leistung führen kann.
quotaUser Ermöglicht das Erzwingen von Benutzerkontingenten von einer serverseitigen Anwendung, selbst wenn die IP-Adresse des Benutzers unbekannt ist. Dies kann beispielsweise bei Anwendungen der Fall sein, die im Auftrag eines Benutzers Cron-Jobs in App Engine ausführen. Sie können eine beliebige Zeichenfolge auswählen, die einen Benutzer eindeutig identifiziert, jedoch auf 40 Zeichen begrenzt ist. Überschreibt userIp, wenn beide angegeben werden Erfahren Sie mehr über die Verwendung von Capping.
userIp Ermöglicht das Erzwingen von Benutzerquoten, wenn Sie die API von einer serverseitigen Anwendung aus aufrufen. Erfahren Sie mehr über die Verwendung von Capping.

Bemerkungen

Die Real Time Reporting-API in der eingeschränkten Betaversion ist nur für die Vorschau des Entwicklers verfügbar . Melden Sie sich an, um auf die API zuzugreifen.

Mit der Echtzeit-Reporting-API können Sie Echtzeitdaten für einen authentifizierten Benutzer anfordern, z. B. Echtzeitaktivitäten für Ihre Immobilie.

Sie können die Echtzeit-Reporting-API verwenden, um:

  • Zeigen Sie aktive Betrachter einer Seite an und erzeugen Sie ein Gefühl der Dringlichkeit für Benutzer, die einen Artikel mit endlichem Inventar betrachten.
  • Zeigen Sie die beliebtesten Inhalte an, z. B. die Top 10 der aktiven Seiten.
  • Erstellen Sie ein Echtzeit-Dashboard und zeigen Sie es an.

Genehmigung

Für Aufrufe der Echtzeit-API von Google Analytics ist eine Autorisierung mit mindestens einem der folgenden Bereiche erforderlich (weitere Informationen zu Authentifizierung und Autorisierung).

Umfang Zugriff gewährt
https://www.googleapis.com/auth/analytics Voller Zugriff auf Google Analytics-Konten bis zur Ebene des Zugriffs authentifizierter Nutzer.
https://www.googleapis.com/auth/analytics.readonly Nur Lesezugriff auf die Google Analytics-Konten der authentifizierten Benutzer

PHP-Beispiel

Verwendet die PHP-Client-Bibliothek 

/**
 * 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 aus der offiziellen Dokumentation übernommen



Modified text is an extract of the original Stack Overflow Documentation
Lizenziert unter CC BY-SA 3.0
Nicht angeschlossen an Stack Overflow