Ekspor · Microsoft Excel

Simpan metrik NowMetrix di Microsoft Excel

Gunakan Power Query untuk mengimpor data NowMetrix ke tabel Excel biasa. Anda tidak memerlukan plug-in atau pengalaman pemrograman: buat API key, tempel kueri yang telah disiapkan, lalu muat hasilnya.

Cara kerja koneksi

Excel meminta data yang dipilih langsung dari REST API NowMetrix:

NowMetrix REST API → Power Query → Excel table → charts, formulas, or PivotTables

Contoh dalam panduan ini mengimpor 30 baris harian terakhir yang tersedia dari /v1/overview. Setiap baris berisi tanggal, tracker, zona waktu tracker, pageviews, dan kunjungan. Saat kueri diperbarui, tabel yang diimpor akan diganti dengan respons API terbaru.

Data ini adalah himpunan data pelaporan yang diimpor, bukan aliran data realtime. Pembaruan setiap jam atau setiap hari biasanya sudah memadai. Untuk laporan yang terus diperbarui, pertimbangkan Microsoft Power BI.

Sebelum memulai

Anda memerlukan:

  • akun NowMetrix dengan akses REST API,
  • akses ke tracker yang ingin diekspor,
  • Microsoft Excel dengan Power Query, dan
  • izin untuk membuat dan memperbarui koneksi data eksternal.

Di Windows, Power Query tersedia melalui Data → Dapatkan Data. Pada Microsoft 365 versi terbaru untuk macOS, gunakan Data → Dapatkan Data (Power Query). Nama menu dapat sedikit berbeda bergantung pada versi dan bahasa Excel.

Jika Power Query Editor tidak ditemukan di Mac, perbarui Microsoft 365 terlebih dahulu. Microsoft menjelaskan alur kerja Mac terbaru dalam panduan Power Query untuk Excel di Mac.

1. Buat API key khusus

  1. Masuk ke NowMetrix.
  2. Buka Pengaturan → API.
  3. Buat key baru dengan label yang jelas, misalnya Microsoft Excel.
  4. Segera salin key lengkap. Key hanya ditampilkan satu kali.
  5. Catat ID tracker untuk situs yang ingin diekspor.
Placeholder Ganti dengan Contoh
nm_YOUR_KEY API key NowMetrix lengkap milik Anda nm_…
TRACKER_ID ID tracker yang akan diekspor news-example-com
Perlakukan API key seperti kata sandi. Jangan mengirimkannya melalui email atau chat, menaruhnya di sel Excel, atau menyertakannya dalam tangkapan layar. Gunakan key terpisah agar dapat dicabut tanpa memengaruhi integrasi lain.

2. Buka Power Query kosong

Excel untuk Windows

  1. Buat buku kerja baru atau buka buku kerja yang akan memuat ekspor.
  2. Pilih Data → Dapatkan Data → Dari Sumber Lain → Kueri Kosong.
  3. Di Power Query Editor, pilih Beranda → Editor lanjutan.

Excel untuk macOS

  1. Buat buku kerja baru atau buka buku kerja tujuan.
  2. Pilih Data → Dapatkan Data (Power Query) → Buka Editor Power Query.
  3. Buat Kueri kosong, lalu buka Beranda → Editor lanjutan.

3. Tempel kueri yang telah disiapkan

  1. Hapus konten yang ada dari Advanced Editor.
  2. Tempel kueri lengkap di bawah ini.
  3. Ganti nm_YOUR_KEY dan TRACKER_ID pada dua baris pertama.
  4. Biarkan tanda kutip di sekitar kedua nilai tersebut.
  5. Pilih Done.
let
    ApiKey = "nm_YOUR_KEY",
    TrackerId = "TRACKER_ID",

    Response = Json.Document(
        Web.Contents(
            "https://api.nowmetrix.com",
            [
                RelativePath = "v1/overview",
                Query = [
                    site = TrackerId,
                    days = "30"
                ],
                Headers = [
                    Authorization = "Bearer " & ApiKey,
                    Accept = "application/json"
                ],
                Timeout = #duration(0, 0, 0, 30)
            ]
        )
    ),

    DailyRows = if List.IsEmpty(Response[daily]) then
        #table(type table [date = text, pageviews = Int64.Type, visits = Int64.Type], {})
    else
        Table.FromRecords(Response[daily]),

    AddTracker = Table.AddColumn(
        DailyRows,
        "tracker",
        each Response[site],
        type text
    ),
    AddTimezone = Table.AddColumn(
        AddTracker,
        "timezone",
        each Response[timezone],
        type text
    ),
    ReorderedColumns = Table.ReorderColumns(
        AddTimezone,
        {"date", "tracker", "timezone", "pageviews", "visits"}
    ),
    TypedColumns = Table.TransformColumnTypes(
        ReorderedColumns,
        {
            {"date", type date},
            {"tracker", type text},
            {"timezone", type text},
            {"pageviews", Int64.Type},
            {"visits", Int64.Type}
        }
    )
in
    TypedColumns

URL dasar yang tetap, ditambah RelativePath dan Query, membuat alamat tetap mudah dibaca dan mencegah API key muncul di URL. Key hanya dikirim dalam header HTTPS Authorization.

4. Konfirmasi pengaturan sumber data

Excel mungkin menanyakan cara menghubungkan ke https://api.nowmetrix.com.

  1. Pilih Anonim.
  2. Terapkan pengaturan ke https://api.nowmetrix.com.
  3. Pilih Connect.
  4. Jika diminta memilih tingkat privasi, pilih tingkat yang diwajibkan organisasi Anda. Private memberikan pemisahan paling ketat dari sumber data lain.
Anonim hanya menjelaskan metode kredensial bawaan Excel. Permintaan ini tidak anonim bagi NowMetrix: kueri melakukan autentikasi dengan API key Anda dalam header Bearer.

5. Muat dan periksa tabel

  1. Tunggu hingga pratinjau Power Query menampilkan lima kolom.
  2. Jika perlu, ubah nama kueri menjadi NowMetrix Daily.
  3. Pilih Beranda → Tutup & Muat.
  4. Excel membuat tabel di lembar kerja yang berisi baris yang diimpor.
date tracker timezone pageviews visits
2026-08-22 TRACKER_ID Europe/Zurich 81,240 53,210
2026-08-23 TRACKER_ID Europe/Zurich 77,480 50,195

Kini Anda dapat membuat formula, grafik, PivotTable, atau lembar kerja tambahan yang merujuk ke tabel ini. Simpan catatan dan perhitungan manual di luar tabel yang diimpor karena pembaruan dapat mengubah ukuran atau mengganti barisnya.

6. Perbarui data

Perbarui secara manual

Pilih Data → Segarkan Semua. Excel menjalankan kueri lagi dan mengganti baris yang diimpor.

Perbarui saat buku kerja dibuka

  1. Buka Data → Kueri & Koneksi.
  2. Klik kanan NowMetrix Daily, lalu pilih Properti.
  3. Aktifkan Segarkan data saat membuka file.

Perbarui berdasarkan interval

  1. Buka properti kueri yang sama.
  2. Aktifkan Segarkan setiap dan masukkan interval, misalnya 60 minutes.
  3. Simpan buku kerja.
Pembaruan berdasarkan interval di Excel biasanya hanya berjalan saat buku kerja desktop terbuka. Fitur ini bukan jadwal cloud yang berjalan tanpa pengawasan. Gunakan Power BI Service jika himpunan data harus diperbarui saat tidak ada yang membuka Excel.

Hindari pembaruan yang terlalu sering. Batas API NowMetrix digunakan bersama oleh semua API key dan pengguna untuk satu tracker. Microsoft menjelaskan pengaturan koneksi Excel dalam panduan pembaruan data eksternal.

Ekspor data NowMetrix lainnya

REST API menyediakan beberapa himpunan data untuk kebutuhan pelaporan yang berbeda:

Kebutuhan Contoh endpoint Rekomendasi pembaruan
Pageviews dan kunjungan harian /v1/overview?days=30 Setiap jam atau setiap hari
Halaman teratas kemarin /v1/recap?preset=yesterday&limit=100 Satu kali setelah hari selesai
Snapshot live saat ini /v1/realtime Sesuai kebutuhan laporan
Sumber traffic saat ini /v1/sources Ganti snapshot saat ini
Setiap endpoint mengembalikan struktur JSON yang berbeda. Mengubah RelativePath saja tidak cukup; transformasi Power Query di bawah Response juga harus disesuaikan dengan endpoint yang dipilih. Gunakan contoh respons di halaman referensi endpoint saat menyesuaikan kueri.

Daftar periksa keamanan dan berbagi

  • Gunakan key NowMetrix terpisah yang diberi label untuk buku kerja ini.
  • Berikan pengguna NowMetrix hanya akses ke tracker yang diperlukan untuk ekspor.
  • Jangan menyimpan API key di sel lembar kerja, formula, URL, tangkapan layar, atau komentar.
  • Jangan mengunggah buku kerja ke area unduhan publik.
  • Bagikan buku kerja hanya kepada orang yang diizinkan menggunakan API key.
  • Anggap setiap editor buku kerja dapat memeriksa Power Query dan membaca key-nya.
  • Lindungi akses ke OneDrive atau SharePoint jika buku kerja disimpan di sana.
  • Segera cabut key khusus jika buku kerja atau akun mungkin telah disusupi.
  • Setelah mengganti key, perbarui baris pertama kueri dan perbarui buku kerja.
Menyembunyikan lembar kerja atau kueri tidak membuat API key menjadi rahasia. Power Query menyimpan kueri di dalam buku kerja. Membatasi akses ke file dan menggunakan key khusus yang dapat dicabut adalah perlindungan yang paling penting.

Pemecahan masalah

Masalah Yang perlu diperiksa
Power Query terus meminta kredensial Buka Pengaturan sumber data, hapus izin untuk https://api.nowmetrix.com, hubungkan kembali, lalu pilih Anonim.
401 atau “akses ke sumber daya dilarang” Pastikan API key lengkap telah menggantikan nm_YOUR_KEY, tidak mengandung spasi, dan belum dicabut.
403 Pengguna NowMetrix dari API key tidak dapat mengakses tracker yang dikonfigurasi. Verifikasi TRACKER_ID dan izin tracker.
429 Batas laju untuk seluruh tracker telah terlampaui. Tunggu dan kurangi frekuensi pembaruan.
503 Backend analitik sedang tidak tersedia. Pertahankan tabel yang ada dan coba lagi nanti.
Expression.Error: The field 'daily' wasn't found API mengembalikan struktur yang berbeda atau endpoint telah berubah. Pulihkan v1/overview atau sesuaikan transformasinya.
Format tanggal atau angka salah Periksa lokal yang digunakan Excel. Kueri menetapkan tipe tanggal dan bilangan bulat secara eksplisit, tetapi tampilan lembar kerja tetap mengikuti lokal buku kerja.
Pembaruan berhasil di editor, tetapi tidak setelah buku kerja dibuka kembali Periksa properti kueri, izin sumber data, akses jaringan, dan apakah organisasi Anda memblokir koneksi web eksternal.