NowMetrix-Metrike in Google Sheets aktuell halte

D’Tabelle dient als chliini, vo Ihne verwalteti Datenbrugg:

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

D’Daten werded nöd in Google Analytics importiert. Apps Script fordert de uusgwählte NowMetrix- Endpoint mit Ihrem API-Key aa und schribt d’zrugggehne Zeile i d’Tabelle. Looker Studio cha das Tabellenblatt nachher als separati Datenquelle verwände.

1. Öffned Si in NowMetrix Iistellige → API und erstelled Si en separate Key mit de Bezeichnig Google Sheets.
2. Kopiered Si de vollständigi Key, sobald er azeigt wird. Spöter cha er nöd nomal azeigt werde.
3. Notiered Si d’Tracker-ID vo de Website, wo Si exportiere möchted.
4. Erstelled Si es nöis Google Sheet, zum Biispil NowMetrix Export.
5. Stelled Si d’Ziitzone vo de Tabelle uf die gliichi Ziitzone wie de NowMetrix-Tracker.

S’Biispil exportiert d’letschte 30 täglichi Ziile vo /v1/overview. Jede Zeile enthaltet s’Datum, de Tracker, d’Tracker-Ziitzone, Pageviews und Bsüech.

Wähled Si im Google Sheet Erwiiterige → Apps Script uus. Denn:

1. Öffned Si mit em Zahnrad-Symbol d’Projektiistellige.
2. Wähled Si under Skripteigeschafte Skripteigeschaft dezuefüege uus.
3. Füeged Si die zwei Properties i:

Ersetzed Si de Inhalt vo Code.gs mit dem Script. Es prüeft d’Konfiguration, beschränkt de Zuegriff uf s’aktuelle Dokument, verarbeitet API-Fehler und ersetzt s’Tabellenblatt erst nach ere erfolgreiche 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);
}

Ersetzed Si NOWMETRIX_API_KEY nöd im Quelltext mit em echte Key. S Script liist de Key während de Uusfüehrig us de Skripteigeschafte. Lönd Si @OnlyCurrentDoc obe stah: De Eintrag seit Google, dass nur uf das Google Sheet und nöd uf alli Tabelle i Ihrem Konto zuegriffe werde söll.

1. Gebed Si em Projekt obe links de Name NowMetrix Google Sheets Export.
2. Speichered Si s’Apps-Script-Projekt mit em Disk-Symbol oder em Tastaturkürzel.
3. Wähled Si im Funktionsmenü i de Editor-Werkzügliiste syncNowMetrixDaily uus.
4. Wähled Si näbed em Funktionsmenü Uusfüehre uus.

Google fragt bim erschte Lauf nach de Berechtigung. Wähled Si Berechtigunge prüefe und denn s’Google-Konto, wo d’Tabelle ghört.

E Warnig wie Google het die App nöd verifiziert isch bi eme private, sälber erstellte Apps-Script-Projekt normal. D’Entwickler-E-Mail, wo Google azeigt, söll zu Ihrem eigene Google-Konto ghöre. S’Projekt isch kei NowMetrix-Google-App und git NowMetrix kei Zuegriff uf Ihr Google-Konto.

1. Bestätiged Si, dass Si s’Apps-Script-Projekt erstellt händ und d’Entwickler-E-Mail Ihri isch.
2. Wähled Si uf de Warnigsiite Erwiiteret uus.
3. Fahred Si mit Ihrem benannte Projekt fort. Google cha de Link als unsicher bezeichne, will s’private Projekt nöd verifiziert isch.
4. Prüefed Si d’verlangte Berechtigung und wähled Si Zuelah oder Wiiter uus.

Wenn Si breiteri Tabellenberechtigung scho bestätigt händ, entferned Si s’Projekt under Google-Konto → Sicherheit → Verbindige zu Drittanbieter-Apps und -Dienscht. Füehred Si s’gspeicherete Script nachher nomal uus, zum d’reduzierte Berechtigung aafordere.

Google beschreibt dä Autorisierigsablauf und d’Beschränkig mit @OnlyCurrentDoc i de Apps-Script-Autorisierigsanleitig.

Nach de Autorisierig setzt Apps Script de Lauf fort. Warted Si im Uusfüehrigslog uf Uusfüehrig abgschlosse, gönd Si zrugg zur Tabelle und öffned Si s’neue Daily-Tabellenblatt. S’Ergebnis sött ungefähr so uusgseh:

Öffned Si in Apps Script mit em Uhr-Symbol Triggers und füeged Si en Trigger i:

De Trigger lauft under em Google-Konto, wo en erstellt het. Lönd Si das Konto aktiv und prüefed Si d’Fehler-Nochrichte vo Apps Script. Vermeided Si unnötig hüüfigi Requests: D’öffentligi NowMetrix-API erlaubt aktuell 20 Requests pro Minute und Tracker, über alli Keys und Nutzer teilt.

S’Biispil ersetzt d’rollendi 30-Täg-Tabelle bi jedem erfolgreiche Lauf. So verhindered Si doppeldi Datum und halted s’Tabellenblatt kompakt.

1. Erstelled Si en Bericht oder öffned Si en im Looker Studio.
2. Wähled Si Date dezuefüege → Google Sheets uus.
3. Wähled Si d’Tabelle und s’Daily-Tabellenblatt uus.
4. Verwänded Si d’erscht Zeile als Überschrifte und verbinded Si d’Datenquelle.
5. Prüefed Si, dass date es Datum isch und pageviews sowie visits numerischi Metrike sind.

Jetzt chönd Si Ziitreihe-Diagramm, Kennzahlkarte, Tabelle und berechneti Fälder wie pageviews / visits erstellä. Looker Studio liist das als separati Datenquelle i; NowMetrix-Wert werded nöd zu Google-Analytics-Events.

Google beschreibt d’weitere Bericht-Iistellige i de Google-Sheets-Connector-Anleitig.

• Verwänded Si en separate NowMetrix-API-Key für de Export und gebed Si nur de nötige Tracker-Zuegriff frei.
• Speichered Si de Key nur i de Skripteigeschafte oder eme andere serverseitige Secret Store.
• Lönd Si @OnlyCurrentDoc im Script, zum de Google-Sheets-Zuegriff uf das Dokument z’beschränke.
• Nehmed Si de Key nie i Zelle, Formle, Berichtparameter, URLs, Screenshots oder Logs uf.
• Beschränked Si de Bearbeitigs-Zuegriff uf s’Apps-Script-Projekt. Behandled Si Bearbeiter als vertrauenswürdig.
• Autorisiered Si s’Script nur, wenn Google Ihr eigets Konto als Entwickler azeigt.
• Verwänded Si für jedes NowMetrix-Konto es separates, vom Kunde verwaltets Tabellenblatt.
• Prüefed Si vor em Veröffentliche vo eme Bericht d’Teile-Iistellige vom Google Sheet und vo Looker Studio.
• Sperred Si de API-Key sofort, wenn s’Tabellenblatt, s’Script oder s’Google-Konto möglicherwiis kompromittiert isch.