google-analytics-api
API en tiempo real

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


Sintaxis

Parámetros

(Requerido) Nombre del parámetro Descripción
ids ID de tabla única para recuperar datos de Analytics. El ID de la tabla tiene el formato ga: XXXX, donde XXXX es el ID de la vista (perfil) de Analytics.
métrica Una lista separada por comas de las métricas de Analytics. Por ejemplo, 'rt: activeUsers'. Se debe especificar al menos una métrica.
(Opcional) Nombre del parámetro Descripción
dimensiones Una lista separada por comas de dimensiones en tiempo real. Por ejemplo, 'rt: medium, rt: city'.
filtros Una lista separada por comas de filtros de dimensiones o métricas que se aplicarán a los datos en tiempo real.
max-resultados El número máximo de entradas para incluir en este feed.
ordenar Una lista separada por comas de dimensiones o métricas que determinan el orden de clasificación de los datos en tiempo real.
(Estándar) Nombre del parámetro Descripción
llamar de vuelta Nombre de la función de devolución de llamada de JavaScript que maneja la respuesta. Utilizado en las solicitudes JavaScript JSON-P.
bonitaImprimir Devuelve la respuesta en un formato legible por humanos si es verdadero. Valor por defecto: verdadero. Cuando esto es falso, puede reducir el tamaño de la carga útil de respuesta, lo que podría conducir a un mejor rendimiento en algunos entornos.
quotaUsuario Le permite imponer cuotas por usuario desde una aplicación del lado del servidor, incluso en los casos en que la dirección IP del usuario es desconocida. Esto puede ocurrir, por ejemplo, con aplicaciones que ejecutan trabajos cron en App Engine en nombre de un usuario. Puede elegir cualquier cadena arbitraria que identifique de forma única a un usuario, pero está limitada a 40 caracteres. Anula el uso de userIp si se proporcionan ambos. Obtenga más información sobre el uso de límites.
userIp Le permite imponer cuotas por usuario al llamar a la API desde una aplicación del lado del servidor. Obtenga más información sobre el uso de límites.

Observaciones

La API de informes en tiempo real, en versión beta limitada, está disponible solo para la vista previa del desarrollador. Regístrese para acceder a la API.

La API de informes en tiempo real le permite solicitar datos en tiempo real, por ejemplo, actividad en tiempo real en su propiedad, para un usuario autenticado.

Puede utilizar la API de informes en tiempo real para:

  • Muestra a los espectadores activos de una página y crea un sentido de urgencia para los usuarios que miran un artículo con un inventario finito.
  • Muestra el contenido más popular, como las 10 mejores páginas activas.
  • Crea y visualiza un panel de control en tiempo real.

Autorización

Las llamadas a la API en tiempo real de Google Analytics requieren autorización con al menos uno de los siguientes ámbitos (lea más acerca de la autenticación y la autorización).

Alcance acceso permitido
https://www.googleapis.com/auth/analytics Acceso completo a las cuentas de Google Analytics hasta el nivel de acceso de los usuarios autenticados.
https://www.googleapis.com/auth/analytics.readonly Acceso de solo lectura a las cuentas de Google Analytics de usuarios autenticados

Ejemplo de PHP

Utiliza la biblioteca de cliente 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;
}

Versión original copiada de documentación oficial.



Modified text is an extract of the original Stack Overflow Documentation
Licenciado bajo CC BY-SA 3.0
No afiliado a Stack Overflow