Saglabājiet NowMetrix rādītājus Google Sheets

Izklājlapa darbojas kā neliels, Jūsu pārvaldīts datu tilts:

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

Dati netiek importēti pakalpojumā Google Analytics. Apps Script, izmantojot Jūsu API atslēgu, nosūta pieprasījumu atlasītajam NowMetrix endpoint un ieraksta saņemtās rindas izklājlapā. Pēc tam Looker Studio šo darblapu var izmantot kā atsevišķu datu avotu.

1. Atveriet NowMetrix sadaļu Iestatījumi → API un izveidojiet atsevišķu atslēgu ar nosaukumu Google Sheets.
2. Kad atslēga tiek parādīta, nokopējiet to pilnībā. Vēlāk to vairs nevarēs parādīt.
3. Pierakstiet tās vietnes tracker ID, kuras datus vēlaties eksportēt.
4. Izveidojiet jaunu Google Sheet, piemēram, NowMetrix Export.
5. Iestatiet izklājlapai to pašu laika joslu, kas izmantota NowMetrix tracker.

Tālāk sniegtajā piemērā no /v1/overview tiek eksportētas pēdējās 30 dienas rindas. Katrā rindā ir datums, tracker, tracker laika josla, pageviews un visits.

Google Sheet izvēlieties Paplašinājumi → Apps Script. Pēc tam:

1. Atveriet Projekta iestatījumi, izmantojot zobrata ikonu.
2. Sadaļā Skripta rekvizīti izvēlieties Pievienot skripta rekvizītu.
3. Pievienojiet šos divus rekvizītus:

Aizstājiet Code.gs saturu ar šo skriptu. Tas pārbauda konfigurāciju, ierobežo piekļuvi izklapjlapai līdz pašreizējam dokumentam, apstrādā API kļūdas un aizstāj darblapu tikai pēc veiksmīgas atbildes saņemšanas.

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

Neaizstājiet NOWMETRIX_API_KEY ar faktisko atslēgu pirmkodā. Skripts to izpildes laikā nolasa no skripta rekvizītiem. Atstājiet @OnlyCurrentDoc augšpusē: tas norāda Google pieprasīt piekļuvi šai izklājlapai, nevis visām Jūsu konta izklājlapām.

1. Augšējā kreisajā stūrī piešķiriet projektam nosaukumu NowMetrix Google Sheets Export.
2. Saglabājiet Apps Script projektu, izmantojot disketes ikonu vai tastatūras saīsni.
3. Redaktora rīkjoslas funkciju izvēlnē atlasiet syncNowMetrixDaily.
4. Blakus funkciju izvēlnei izvēlieties Run.

Pirmajā skripta palaišanas reizē Google lūgs atļauju. Izvēlieties Pārskatīt atļaujas un Google kontu, kuram pieder izklājlapa.

Privātam, paša izveidotam Apps Script projektam ir paredzēts brīdinājums, piemēram, Google nav verificējis šo lietotni. Google norādītajam izstrādātāja e-pastam jābūt Jūsu Google kontam. Šis nav NowMetrix Google lietotnes projekts, un tas nepiešķir NowMetrix piekļuvi Jūsu Google kontam.

1. Apstipriniet, ka esat izveidojis Apps Script projektu un izstrādātāja e-pasts pieder Jums.
2. Brīdinājuma ekrānā izvēlieties Papildu.
3. Turpiniet uz projektu ar piešķirto nosaukumu. Google var apzīmēt šo saiti kā nedrošu, jo privātais projekts nav verificēts.
4. Pārskatiet pieprasītās atļaujas un izvēlieties Allow vai Turpināt.

Ja jau apstiprinājāt plašāku piekļuvi izklājlapām, noņemiet projektu sadaļā Google konts → Drošība → Savienojumi ar trešo pušu lietotnēm un pakalpojumiem un pēc tam vēlreiz palaidiet saglabāto skriptu, lai pieprasītu ierobežotās atļaujas.

Google šo autorizācijas procesu un @OnlyCurrentDoc ierobežojumu apraksta savā Apps Script autorizācijas rokasgrāmatā.

Pēc autorizācijas Apps Script turpinās izpildi. Izpildes žurnālā uzgaidiet ziņojumu Izpilde pabeigta, atgriezieties izklājlapā un atveriet jauno Daily darblapu. Rezultātam vajadzētu izskatīties līdzīgi:

Apps Script atveriet Aktivizētāji, izmantojot pulksteņa ikonu, un pievienojiet aktivizētāju:

Aktivizētājs darbojas tā Google konta vārdā, kurš to izveidoja. Uzturiet šo kontu aktīvu un pārskatiet Apps Script paziņojumus par kļūmēm. Izvairieties no nevajadzīgi biežiem pieprasījumiem: NowMetrix publiskais API pašlaik katram tracker atļauj 20 pieprasījumus minūtē, kas tiek dalīti starp atslēgām un lietotājiem.

Piemērā pēc katras veiksmīgas izpildes tiek aizstāta slīdošā 30 dienu tabula. Tādējādi netiek veidoti dublēti datumi un izklājlapa paliek kompakta.

1. Izveidojiet vai atveriet pārskatu pakalpojumā Looker Studio.
2. Izvēlieties Pievienot datus → Google Sheets.
3. Izvēlieties izklājlapu un darblapu Daily.
4. Izmantojiet pirmo rindu kā galvenes rindu un savienojiet datu avotu.
5. Pārbaudiet, vai date ir datums un pageviews un visits ir skaitliski rādītāji.

Tagad varat veidot laikrindu diagrammas, kopsavilkuma kartītes, tabulas un aprēķinātos laukus, piemēram, pageviews / visits. Looker Studio to nolasa kā atsevišķu datu avotu; tas nepārvērš NowMetrix vērtības Google Analytics notikumos.

Atlikušos pārskata iestatījumus Google apraksta savā Google Sheets savienotāja rokasgrāmatā.

• Eksportam izmantojiet atsevišķu NowMetrix API atslēgu un piešķiriet piekļuvi tikai nepieciešamajiem tracker.
• Saglabājiet atslēgu tikai skripta rekvizītos vai citā servera puses slepeno datu glabātavā.
• Lai ierobežotu Google Sheets piekļuvi šim dokumentam, atstājiet skriptā @OnlyCurrentDoc.
• Nekad neiekļaujiet atslēgu šūnās, formulās, pārskatu parametros, URL, ekrānuzņēmumos vai žurnālos.
• Ierobežojiet rediģēšanas piekļuvi Apps Script projektam. Redaktori jāuzskata par uzticamām personām.
• Autorizējiet skriptu tikai tad, ja Google kā izstrādātāju rāda Jūsu kontu.
• Katram NowMetrix kontam izmantojiet atsevišķu, klientam piederošu izklājlapu.
• Pirms pārskata publicēšanas pārskatiet gan Google Sheet, gan Looker Studio kopīgošanas iestatījumus.
• Nekavējoties atsauciet API atslēgu, ja izklājlapa, skripts vai Google konts varētu būt apdraudēts.