CLI

Kueri analitik RevKlik dari terminal dengan perintah revklik: situs, ringkasan, halaman, referrer, pendapatan, perjalanan pengunjung, Search Console, dan token API.

Perintah revklik membungkus REST API, sehingga Anda bisa membaca analitik tanpa membuka dashboard atau menjalankannya lewat skrip di CI.

Instalasi

CLI membutuhkan Node.js 22 atau lebih baru.

npm install -g @revklik/cli
revklik --version

Masuk

Buat token akun (rvt_) di Share → API tokens (lihat berbagi dan akses) dengan minimal cakupan sites:read dan analytics:read, lalu:

revklik login --token rvt_TOKEN_ANDA

CLI memeriksa token lewat whoami dan menyimpannya di ~/.config/revklik/config.json. Tanpa --token, revklik login meminta Anda menempelkan token. Token situs (rv_) juga diterima, tetapi revklik gsc membutuhkan token akun.

revklik whoami

menampilkan pengguna, paket, jenis token, cakupan, dan untuk token situs, situs yang terikat.

Perintah

PerintahFungsi
revklik loginMenyimpan token API
revklik whoamiMenampilkan token aktif, paket, dan cakupan
revklik sites listDaftar situs Anda
revklik analytics overviewPageview, pengunjung, sesi, bounce rate, pendapatan, konversi
revklik analytics timeseriesPageview dan pengunjung per hari
revklik analytics pagesHalaman teratas
revklik analytics referrersSumber trafik
revklik analytics geoNegara, wilayah, dan kota
revklik analytics devicesRincian perangkat, OS, dan browser
revklik analytics revenuePendapatan per sumber dan per negara
revklik analytics eventsLog event mentah
revklik analytics journeysRingkasan perjalanan pengunjung
revklik gsc queriesKueri Google Search Console yang tersimpan
revklik gsc syncMenarik 7 hari terakhir dari Search Console
revklik tokens listDaftar token API
revklik tokens createMembuat token
revklik tokens revoke <id>Mencabut token

Setiap perintah analytics dan gsc butuh -s, --site <situs>. Isi dengan ID situs, awalan ID yang unik, atau domain persis:

revklik sites list
revklik analytics overview --site situssaya.com --range 7d

-r, --range menerima 24h, 7d, 30d, atau 90d dan bawaannya 7d.

Mata uang di terminal

Tabel mencetak pendapatan dengan awalan $ apa pun mata uang situs Anda. Angkanya dalam mata uang situs itu sendiri; gunakan API untuk mendapat kolom currency.

Event

revklik analytics events --site situssaya.com --type conversion --range 30d --limit 100
FlagKeteranganBawaan
-t, --typepageview, conversion, custom, atau allall
-l, --limitJumlah event maksimal (sampai 10000)50

Perjalanan pengunjung

revklik analytics journeys --site situssaya.com --sort revenue --limit 10 --range 30d
FlagKeteranganBawaan
--sortsteps, revenue, source, device, atau datesteps
-l, --limitJumlah perjalanan maksimal (sampai 100)20

Pengunjung yang teridentifikasi ditandai *.

Search Console

Hubungkan Search Console di dashboard terlebih dahulu (lihat integrasi).

revklik gsc sync --site situssaya.com
revklik gsc queries --site situssaya.com --limit 20

gsc queries menggabungkan jendela 30 hari yang tersimpan. Data Search Console datang dengan jeda sekitar dua hari.

Token

revklik tokens create --name "CI" --type account --scopes sites:read,analytics:read
revklik tokens create --name "Blog" --type site --site SITE_ID
revklik tokens revoke TOKEN_ID

--site wajib untuk token situs. Tanpa --scopes, token mendapat cakupan bawaan sesuai jenisnya (lihat cakupan REST API). Token lengkap dicetak sekali saja.

Keluaran JSON

--json mencetak JSON mentah untuk analytics events dan analytics journeys:

revklik analytics events --site situssaya.com --json --limit 100
revklik analytics journeys --site situssaya.com --json --limit 5

Flag yang sama pada gsc queries juga mencetak JSON. Perintah lain hanya mencetak tabel; untuk JSON dari perintah tersebut, panggil REST API dengan curl lalu salurkan ke jq:

curl -s "https://app.revklik.com/api/v1/analytics/overview?site_id=SITE_ID&range=7d" \
  -H "Authorization: Bearer $REVKLIK_TOKEN" | jq .data.bounceRate

--verbose mencetak basis API dan beberapa karakter pertama token sebelum perintah berjalan.

Konfigurasi

VariabelKeteranganBawaan
REVKLIK_TOKENToken API; menimpa token yang tersimpantidak ada
REVKLIK_API_BASEURL dasar API, untuk instalasi self-hostedhttps://app.revklik.com/api

Pengaturan tersimpan ada di ~/.config/revklik/config.json:

{
	"token": "rvt_...",
	"apiBase": "https://app.revklik.com/api"
}

Jalankan revklik login lagi untuk mengganti token.

Contoh CI

# GitHub Actions
env:
  REVKLIK_TOKEN: ${{ secrets.REVKLIK_API_TOKEN }}
steps:
  - run: npx @revklik/cli analytics overview --site situssaya.com --range 24h

Terkait