google-analytics-api
API temps réel

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


Syntaxe

Paramètres

(Obligatoire) Nom du paramètre La description
les identifiants ID de table unique pour la récupération des données Analytics. L'ID de la table est de la forme ga: XXXX, où XXXX est l'ID de la vue analytique (profil).
métrique Une liste de métriques Analytics séparées par des virgules. Par exemple, 'rt: activeUsers'. Au moins une métrique doit être spécifiée.
(Facultatif) Nom du paramètre La description
dimensions Une liste de dimensions en temps réel séparées par des virgules. Par exemple, 'rt: medium, rt: city'.
les filtres Une liste de filtres de dimension ou de métrique séparés par des virgules à appliquer aux données en temps réel.
max-result Le nombre maximal d'entrées à inclure dans ce flux.
Trier Liste de dimensions ou de métriques séparées par des virgules qui déterminent l'ordre de tri des données en temps réel.
(Standard) Nom du paramètre La description
rappeler Nom de la fonction de rappel JavaScript qui gère la réponse. Utilisé dans les requêtes JavaScript JSON-P.
jolieImprimer Renvoie la réponse dans un format lisible si true. Valeur par défaut: true. Si c'est faux, cela peut réduire la taille de la charge utile de la réponse, ce qui peut améliorer les performances dans certains environnements.
quotaUser Vous permet d'appliquer des quotas par utilisateur à partir d'une application côté serveur, même lorsque l'adresse IP de l'utilisateur est inconnue. Cela peut se produire, par exemple, avec des applications qui exécutent des tâches cron sur App Engine pour le compte d'un utilisateur. Vous pouvez choisir n'importe quelle chaîne arbitraire qui identifie de manière unique un utilisateur, mais elle est limitée à 40 caractères.Overrides userIp si les deux sont fournis. En savoir plus sur le plafonnement de l'utilisation
userIp Vous permet d'appliquer des quotas par utilisateur lors de l'appel de l'API à partir d'une application côté serveur. En savoir plus sur le plafonnement de l'utilisation

Remarques

L'API de génération de rapports en temps réel, en version bêta limitée, est disponible uniquement pour un aperçu des développeurs. Inscrivez-vous pour accéder à l'API.

L' API de génération de rapports en temps réel vous permet de demander des données en temps réel, par exemple une activité en temps réel sur votre propriété, pour un utilisateur authentifié.

Vous pouvez utiliser l'API de reporting en temps réel pour:

  • Afficher les visualiseurs actifs d'une page et créer un sentiment d'urgence pour les utilisateurs qui regardent un élément avec un inventaire fini.
  • Affichez le contenu le plus populaire, tel que les 10 premières pages actives.
  • Créez et affichez un tableau de bord en temps réel.

Autorisation

Les appels à l'API en temps réel de Google Analytics nécessitent une autorisation avec au moins l'une des portées suivantes (pour en savoir plus sur l'authentification et l'autorisation).

Portée accès autorisé
https://www.googleapis.com/auth/analytics Accès complet aux comptes Google Analytics jusqu'au niveau d'accès des utilisateurs authentifiés.
https://www.googleapis.com/auth/analytics.readonly Accès en lecture seule aux comptes Google Analytics des utilisateurs authentifiés

Exemple PHP

Utilise la bibliothèque 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;
}

Version originale extraite de la documentation officielle



Modified text is an extract of the original Stack Overflow Documentation
Sous licence CC BY-SA 3.0
Non affilié à Stack Overflow