Mějte metriky NowMetrix v Google Sheets

Tabulka funguje jako malý datový most pod vaší kontrolou:

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

Data se neimportují do Google Analytics. Apps Script požádá vybraný endpoint NowMetrix o data pomocí vašeho API klíče a zapíše vrácené řádky do tabulky. Looker Studio pak může tento list použít jako samostatný zdroj dat.

1. V NowMetrix otevřete Nastavení → API a vytvořte samostatný klíč s označením Google Sheets.
2. Po zobrazení zkopírujte celý klíč. Později ho už nebude možné znovu zobrazit.
3. Poznamenejte si ID trackeru webu, který chcete exportovat.
4. Vytvořte nový Google Sheet, například NowMetrix Export.
5. Nastavte časové pásmo tabulky na stejné časové pásmo, jaké používá tracker NowMetrix.

Níže uvedený příklad exportuje posledních 30 denních řádků z /v1/overview. Každý řádek obsahuje datum, tracker, časové pásmo trackeru, zobrazení stránek a návštěvy.

V Google Sheetu vyberte Rozšíření → Apps Script. Potom:

1. Pomocí ikony ozubeného kola otevřete Nastavení projektu.
2. V části Vlastnosti skriptu vyberte Přidat vlastnost skriptu.
3. Přidejte následující dvě vlastnosti:

Nahraďte obsah souboru Code.gs tímto skriptem. Skript kontroluje konfiguraci, omezuje přístup tabulky na aktuální dokument, zpracovává chyby API a list nahradí pouze po úspěšné odpovědi.

/**
 * @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);
}

Nenahrazujte NOWMETRIX_API_KEY skutečným klíčem ve zdrojovém kódu. Skript ho při spuštění načte z vlastností skriptu. Ponechte @OnlyCurrentDoc nahoře: Google tak požádá o přístup k této tabulce, nikoli ke všem tabulkám ve vašem účtu.

1. V levém horním rohu pojmenujte projekt NowMetrix Google Sheets Export.
2. Uložte projekt Apps Scriptu pomocí ikony disku nebo klávesové zkratky.
3. V nabídce funkcí na panelu nástrojů editoru vyberte syncNowMetrixDaily.
4. Vedle nabídky funkcí vyberte Spustit.

Google při prvním spuštění skriptu požádá o oprávnění. Vyberte Prohlédnout oprávnění a zvolte účet Google, který vlastní tabulku.

U soukromého projektu Apps Scriptu, který jste vytvořili sami, se očekává upozornění Google tuto aplikaci neověřil. E-mail vývojáře zobrazený Googlem by měl patřit vašemu účtu Google. Projekt není aplikací Google ani NowMetrix a neposkytuje NowMetrix přístup k vašemu účtu Google.

1. Potvrďte, že jste projekt Apps Scriptu vytvořili vy a že e-mail vývojáře patří vám.
2. Na obrazovce s upozorněním vyberte Rozšířené.
3. Pokračujte do svého pojmenovaného projektu. Google může tento odkaz označit jako nebezpečný, protože soukromý projekt není ověřený.
4. Prohlédněte si požadovaná oprávnění a vyberte Povolit nebo Pokračovat.

Pokud jste již schválili širší přístup k tabulkám, odeberte projekt v části Účet Google → Zabezpečení → Připojení k aplikacím a službám třetích stran a uložený skript znovu spusťte, aby požádal o omezená oprávnění.

Google tento proces autorizace a omezení @OnlyCurrentDoc popisuje v příručce k autorizaci Apps Scriptu.

Po autorizaci Apps Script pokračuje ve spuštění. V protokolu spuštění počkejte na Spuštění dokončeno, vraťte se do tabulky a otevřete nový list Daily. Výsledek by měl vypadat podobně:

V Apps Scriptu otevřete pomocí ikony hodin Spouštěče a přidejte spouštěč:

Spouštěč běží pod účtem Google, který ho vytvořil. Tento účet udržujte aktivní a kontrolujte oznámení o chybách Apps Scriptu. Vyhněte se zbytečně častým požadavkům: veřejné API NowMetrix aktuálně umožňuje 20 požadavků za minutu na tracker, sdílených mezi klíči a uživateli.

Příklad při každém úspěšném spuštění nahradí průběžnou tabulku za posledních 30 dní. Zabrání tak duplicitním datům a udrží tabulku přehlednou.

1. Vytvořte nebo otevřete přehled v Looker Studio.
2. Vyberte Přidat data → Google Sheets.
3. Vyberte tabulku a list Daily.
4. Použijte první řádek jako záhlaví a připojte zdroj dat.
5. Ověřte, že date je datum a pageviews a visits jsou číselné metriky.

Nyní můžete vytvářet časové grafy, karty s hodnotami, tabulky a vypočítaná pole, například pageviews / visits. Looker Studio tato data načítá jako samostatný zdroj dat; hodnoty NowMetrix nepřevádí na události Google Analytics.

Zbývající nastavení přehledu Google popisuje v příručce ke konektoru Google Sheets.

• Pro export používejte samostatný API klíč NowMetrix a udělte mu pouze potřebný přístup k trackeru.
• Klíč ukládejte pouze do vlastností skriptu nebo jiného úložiště tajných údajů na serveru.
• Ponechte ve skriptu @OnlyCurrentDoc, aby se přístup omezil na tento dokument Google Sheets.
• Klíč nikdy neuvádějte v buňkách, vzorcích, parametrech přehledů, URL, snímcích obrazovky ani protokolech.
• Omezte přístup k úpravám projektu Apps Scriptu. S editory zacházejte jako s důvěryhodnými uživateli.
• Skript autorizujte pouze tehdy, když Google jako vývojáře zobrazuje váš vlastní účet.
• Pro každý účet NowMetrix používejte samostatný spreadsheet vlastněný zákazníkem.
• Před zveřejněním přehledu zkontrolujte nastavení sdílení Google Sheetu i Looker Studio.
• Pokud může být tabulka, skript nebo účet Google napaden, API klíč okamžitě zneplatněte.