google-analytics-api => API in tempo reale

Sintassi

OTTIENI https://www.googleapis.com/analytics/v3/data/realtime?ids=[Indagine vista analitica Id] e metriche = [Metriche in tempo reale] e access_token = [Access_token_from_Authentcation]
OTTIENI https://www.googleapis.com/analytics/v3/data/realtime?ids=[Indagine vista analitica Id] e metriche = [Metriche in tempo reale] e dimensioni = [Metriche in tempo reale] e access_token = [Access_token_from_Authentcation]

Parametri

(Richiesto) Nome del parametro	Descrizione
ids	ID tabella univoco per il recupero dei dati di Analytics. L'ID della tabella è del formato ga: XXXX, dove XXXX è l'ID della vista Analytics (profilo).
metrica	Un elenco separato da virgole delle metriche di Analytics. Ad esempio, 'rt: activeUsers'. È necessario specificare almeno una metrica.
(Opzionale) Nome del parametro	Descrizione
dimensioni	Un elenco separato da virgole di dimensioni in tempo reale. Ad esempio, 'rt: medium, rt: city'.
filtri	Un elenco separato da virgole di filtri dimensione o metrica da applicare ai dati in tempo reale.
max-risultati	Il numero massimo di voci da includere in questo feed.
ordinare	Un elenco separato da virgole di dimensioni o metriche che determinano l'ordinamento per i dati in tempo reale.
(Standard) Nome del parametro	Descrizione
richiama	Nome della funzione di callback JavaScript che gestisce la risposta. Utilizzato nelle richieste JSON-P JavaScript.
prettyPrint	Restituisce la risposta in un formato leggibile dall'uomo se è vero. Valore predefinito: true. Quando ciò è falso, può ridurre la dimensione del payload della risposta, il che potrebbe portare a prestazioni migliori in alcuni ambienti.
quotaUser	Consente di imporre quote per utente da un'applicazione lato server anche nei casi in cui l'indirizzo IP dell'utente è sconosciuto. Ciò può verificarsi, ad esempio, con applicazioni che eseguono lavori cron su App Engine per conto di un utente. È possibile scegliere qualsiasi stringa arbitraria che identifica univocamente un utente, ma è limitata a 40 caratteri. Consente di ignorare l'utente se entrambi vengono forniti. Ulteriori informazioni sulla limitazione dell'utilizzo.
userip	Consente di imporre quote per utente quando si chiama l'API da un'applicazione lato server. Ulteriori informazioni sulla limitazione dell'utilizzo.

Osservazioni

L'API Real Time Reporting, in versione beta limitata, è disponibile solo per l' anteprima dello sviluppatore. Registrati per accedere all'API.

L' API Real Time Reporting consente di richiedere dati in tempo reale, ad esempio attività in tempo reale sulla proprietà, per un utente autenticato.

Puoi utilizzare l'API di Real Time Reporting per:

Mostra i visualizzatori attivi di una pagina e crea un senso di urgenza per gli utenti che guardano un articolo con inventario finito.
Visualizza i contenuti più popolari come le prime 10 pagine attive.
Crea e visualizza una dashboard in tempo reale.

Autorizzazione

Le chiamate all'API in tempo reale di Google Analytics richiedono l'autorizzazione con almeno uno dei seguenti ambiti (maggiori informazioni su autenticazione e autorizzazione).

Scopo	accesso garantito
https://www.googleapis.com/auth/analytics	Accesso completo agli account Google Analytics fino al livello dell'accesso degli utenti autenticati.
https://www.googleapis.com/auth/analytics.readonly	Accesso in sola lettura agli account Google Analytics degli utenti autenticati

Esempio PHP

Utilizza la libreria client 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;
}

La versione originale faceva fronte alla documentazione ufficiale

Modified text is an extract of the original Stack Overflow Documentation

Autorizzato sotto CC BY-SA 3.0

Non affiliato con Stack Overflow

google-analytics-api
API in tempo reale

Ricerca…

Sintassi

Parametri

Osservazioni

Esempio PHP