NowMetrix-Kennzahlen in Google Sheets aktuell halten

Die Tabelle dient als kleine, von Ihnen kontrollierte Datenbrücke:

NowMetrix REST API → Google Apps Script → Google Sheet → optional Looker Studio report

Die Daten werden nicht in Google Analytics importiert. Apps Script ruft den ausgewählten NowMetrix- endpoint mit Ihrem API-Schlüssel ab und schreibt die zurückgegebenen Zeilen in die Tabelle. Looker Studio kann dieses Tabellenblatt anschliessend als separate Datenquelle verwenden.

1. Öffnen Sie in NowMetrix Einstellungen → API und erstellen Sie einen separaten Schlüssel mit der Bezeichnung Google Sheets.
2. Kopieren Sie den vollständigen Schlüssel, sobald er angezeigt wird. Später kann er nicht erneut angezeigt werden.
3. Notieren Sie die Tracker ID der Website, die Sie exportieren möchten.
4. Erstellen Sie ein neues Google Sheet, zum Beispiel NowMetrix Export.
5. Stellen Sie die Zeitzone der Tabelle auf dieselbe Zeitzone wie den NowMetrix Tracker ein.

Das folgende Beispiel exportiert die letzten 30 Tageszeilen aus /v1/overview. Jede Zeile enthält das Datum, den Tracker, die Zeitzone des trackers, Pageviews und Besuche.

Wählen Sie im Google Sheet Erweiterungen → Apps Script. Anschliessend:

1. Öffnen Sie über das Zahnradsymbol die Projekteinstellungen.
2. Wählen Sie unter Script Properties die Option Add script property.
3. Fügen Sie die folgenden beiden Eigenschaften hinzu:

Ersetzen Sie den Inhalt von Code.gs durch dieses Script. Es prüft die Konfiguration, beschränkt den Tabellenzugriff auf das aktuelle Dokument, verarbeitet API-Fehler und ersetzt das Tabellenblatt erst nach einer erfolgreichen Antwort.

/**
 * @OnlyCurrentDoc
 */

const NOWMETRIX_BASE_URL = 'https://api.nowmetrix.com';

function fetchNowMetrix(path) {
  const properties = PropertiesService.getScriptProperties();
  const apiKey = properties.getProperty('NOWMETRIX_API_KEY');
  const trackerId = properties.getProperty('NOWMETRIX_TRACKER_ID');

  if (!apiKey || !trackerId) {
    throw new Error('NOWMETRIX_API_KEY or NOWMETRIX_TRACKER_ID is missing.');
  }

  const separator = path.includes('?') ? '&' : '?';
  const url = NOWMETRIX_BASE_URL
    + path
    + separator
    + 'site=' + encodeURIComponent(trackerId);

  const response = UrlFetchApp.fetch(url, {
    method: 'get',
    headers: {
      Authorization: 'Bearer ' + apiKey,
      Accept: 'application/json'
    },
    muteHttpExceptions: true
  });

  const status = response.getResponseCode();
  const body = response.getContentText();

  if (status < 200 || status >= 300) {
    throw new Error('NowMetrix API returned HTTP ' + status + ': ' + body);
  }

  return JSON.parse(body);
}

function toSheetDate(value) {
  const parts = value.split('-').map(Number);
  return new Date(parts[0], parts[1] - 1, parts[2]);
}

function syncNowMetrixDaily() {
  const result = fetchNowMetrix('/v1/overview?days=30');
  const rows = result.daily.map(day => [
    toSheetDate(day.date),
    result.site,
    result.timezone,
    day.pageviews,
    day.visits
  ]);

  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = spreadsheet.getSheetByName('Daily')
    || spreadsheet.insertSheet('Daily');
  const values = [
    ['date', 'tracker', 'timezone', 'pageviews', 'visits'],
    ...rows
  ];

  sheet.clearContents();
  sheet.getRange(1, 1, values.length, values[0].length).setValues(values);
  sheet.setFrozenRows(1);
  sheet.getRange(1, 1, 1, values[0].length).setFontWeight('bold');

  if (rows.length > 0) {
    sheet.getRange(2, 1, rows.length, 1).setNumberFormat('yyyy-mm-dd');
    sheet.getRange(2, 4, rows.length, 2).setNumberFormat('#,##0');
  }

  sheet.autoResizeColumns(1, values[0].length);
}

Ersetzen Sie NOWMETRIX_API_KEY im Quelltext nicht durch den tatsächlichen Schlüssel. Das Script liest ihn zur Laufzeit aus den Script Properties. Lassen Sie @OnlyCurrentDoc am Anfang stehen: Dadurch fordert Google Zugriff auf dieses Tabellenblatt statt auf alle Tabellenblätter Ihres Kontos an.

1. Benennen Sie das Projekt oben links in NowMetrix Google Sheets Export um.
2. Speichern Sie das Apps-Script-Projekt über das Diskettensymbol oder das Tastaturkürzel.
3. Wählen Sie im Funktionsmenü der Editor-Symbolleiste syncNowMetrixDaily aus.
4. Wählen Sie neben dem Funktionsmenü Ausführen.

Beim ersten Ausführen des Scripts bittet Google um eine Berechtigung. Wählen Sie Berechtigungen prüfen und anschliessend das Google-Konto, dem die Tabelle gehört.

Eine Warnung wie Google hat diese App nicht bestätigt ist bei einem privaten, selbst erstellten Apps-Script-Projekt zu erwarten. Die von Google angezeigte E-Mail-Adresse des Entwicklers sollte Ihre eigene Google-Adresse sein. Das Projekt ist keine Google-App von NowMetrix und gewährt NowMetrix keinen Zugriff auf Ihr Google-Konto.

1. Bestätigen Sie, dass Sie das Apps-Script-Projekt erstellt haben und dass die E-Mail-Adresse des Entwicklers Ihnen gehört.
2. Wählen Sie auf dem Warnbildschirm Erweitert.
3. Fahren Sie mit Ihrem benannten Projekt fort. Google kennzeichnet diesen Link möglicherweise als unsicher, da das private Projekt nicht bestätigt ist.
4. Prüfen Sie die angeforderten Berechtigungen und wählen Sie Zulassen oder Fortfahren.

Wenn Sie bereits einen umfassenderen Tabellenzugriff genehmigt haben, entfernen Sie das Projekt unter Google-Konto → Sicherheit → Verbindungen zu Drittanbieter-Apps und -Diensten. Führen Sie anschliessend das gespeicherte Script erneut aus, um die eingeschränkten Berechtigungen anzufordern.

Google beschreibt diesen Autorisierungsablauf und die Einschränkung durch @OnlyCurrentDoc in seinem Leitfaden zur Apps-Script-Autorisierung.

Nach der Autorisierung setzt Apps Script die Ausführung fort. Warten Sie im Ausführungsprotokoll auf Ausführung abgeschlossen, kehren Sie zur Tabelle zurück und öffnen Sie das neue Tabellenblatt Daily. Das Ergebnis sollte ähnlich aussehen:

Öffnen Sie in Apps Script über das Uhrsymbol die Trigger und fügen Sie einen Trigger hinzu:

Der Trigger wird unter dem Google-Konto ausgeführt, mit dem er erstellt wurde. Lassen Sie dieses Konto aktiv und prüfen Sie die Fehlermeldungen von Apps Script. Vermeiden Sie unnötig häufige Anfragen: Die öffentliche NowMetrix API erlaubt derzeit 20 Anfragen pro Minute und Tracker, gemeinsam für alle Schlüssel und Benutzer.

Das Beispiel ersetzt die fortlaufende 30-Tage-Tabelle nach jeder erfolgreichen Ausführung. Dadurch werden doppelte Datumsangaben verhindert und das Tabellenblatt bleibt kompakt.

1. Erstellen oder öffnen Sie einen Bericht in Looker Studio.
2. Wählen Sie Daten hinzufügen → Google Sheets.
3. Wählen Sie die Tabelle und das Tabellenblatt Daily aus.
4. Verwenden Sie die erste Zeile als Überschriften und verbinden Sie die Datenquelle.
5. Bestätigen Sie, dass date ein Datum und pageviews sowie visits numerische Kennzahlen sind.

Sie können nun Zeitreihendiagramme, Scorecards, Tabellen und berechnete Felder wie pageviews / visits erstellen. Looker Studio liest dies als separate Datenquelle; die NowMetrix-Werte werden dadurch nicht in Google-Analytics-Ereignisse umgewandelt.

Google beschreibt die übrigen Berichtseinstellungen in seinem Leitfaden zum Google-Sheets-Connector.

• Verwenden Sie für den Export einen separaten NowMetrix-API-Schlüssel und gewähren Sie nur Zugriff auf die erforderlichen Tracker.
• Speichern Sie den Schlüssel nur in Script Properties oder einem anderen serverseitigen Geheimnisspeicher.
• Lassen Sie @OnlyCurrentDoc im Script stehen, um den Google-Sheets-Zugriff auf dieses Dokument zu beschränken.
• Nehmen Sie den Schlüssel niemals in Zellen, Formeln, Berichtsparameter, URLs, Screenshots oder Protokolle auf.
• Beschränken Sie den Bearbeitungszugriff auf das Apps-Script-Projekt. Behandeln Sie Editoren als vertrauenswürdige Benutzer.
• Autorisieren Sie das Script nur, wenn Google Ihr eigenes Konto als Entwickler anzeigt.
• Verwenden Sie für jedes NowMetrix-Konto eine separate, kundeneigene Tabelle.
• Prüfen Sie die Freigabeeinstellungen von Google Sheet und Looker Studio, bevor Sie einen Bericht veröffentlichen.
• Widerrufen Sie den API-Schlüssel sofort, wenn die Tabelle, das Script oder das Google-Konto möglicherweise kompromittiert wurde.