Buat laporan Power BI dengan data NowMetrix

Koneksi ini memiliki dua tahap opsional:

NowMetrix REST API → Power Query → Power BI Desktop → optional Power BI Service

• Power BI Desktop membuat query, model data, dan laporan.
• Power BI Service memublikasikan laporan agar dapat diakses melalui browser, dibagikan, dan di-refresh secara terjadwal.

Contoh yang telah disiapkan mengimpor 30 baris harian terakhir yang tersedia dari /v1/overview. Setiap baris berisi tanggal, tracker, zona waktu tracker, pageviews, dan visits.

Anda memerlukan:

• akun NowMetrix dengan akses REST API,
• akses ke tracker yang ingin Anda gunakan dalam laporan,
• Microsoft Power BI Desktop untuk membuat laporan, dan
• akun Power BI dan workspace yang sesuai jika Anda ingin memublikasikan laporan atau menjadwalkan refresh.

Microsoft dan administrator organisasi Anda mengelola lisensi Power BI, izin workspace, serta frekuensi refresh yang tersedia. Anda dapat menyelesaikan penyiapan Desktop tanpa memublikasikan laporan.

1. Masuk ke NowMetrix.
2. Buka Pengaturan → API.
3. Buat key baru dengan label Microsoft Power BI.
4. Segera salin seluruh key. Key hanya ditampilkan satu kali.
5. Catat ID tracker untuk situs yang ingin Anda impor.

1. Buka Power BI Desktop dan buat laporan kosong.
2. Pilih Beranda → Dapatkan data → Kueri kosong. Jika tidak tercantum, pilih Dapatkan data → Lainnya, lalu cari Kueri kosong.
3. Power Query Editor terbuka dengan query baru.
4. Pilih Beranda → Editor lanjutan.

Untuk contoh ini, jangan pilih dialog dasar Web. Advanced Editor digunakan karena NowMetrix memerlukan header otorisasi Bearer dan respons harus dikonversi dari JSON menjadi baris tabel.

1. Hapus isi yang ada dari Advanced Editor.
2. Tempel seluruh query di bawah.
3. Ganti nm_YOUR_KEY dan TRACKER_ID pada dua baris pertama.
4. Pastikan kedua nilai tetap berada di dalam tanda kutip.
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

Query ini menggunakan URL dasar tetap bersama RelativePath dan Query. Dengan begitu, sumber data tetap konsisten saat refresh berikutnya dan API key hanya dikirim dalam header HTTPS Authorization.

Power BI mungkin menanyakan cara terhubung ke https://api.nowmetrix.com.

1. Pilih Anonim.
2. Terapkan pengaturan ke https://api.nowmetrix.com.
3. Pilih Connect.
4. Jika diminta menentukan tingkat privasi, pilih tingkat yang diwajibkan organisasi Anda. Private memberikan pemisahan paling ketat dari sumber data lain.

1. Tunggu hingga pratinjau query menampilkan date, tracker, timezone, pageviews, dan visits.
2. Ganti nama query menjadi NowMetrix Daily.
3. Pilih Beranda → Tutup & Terapkan.
4. Buka tampilan Data dan pastikan baris serta tipe kolom sudah benar.

Laporan sederhana memastikan kolom yang diimpor berfungsi dengan benar:

1. Kembali ke tampilan Report.
2. Tambahkan Grafik garis.
3. Tempatkan date pada sumbu X.
4. Tempatkan pageviews dan visits pada sumbu Y.
5. Tambahkan dua visual Card untuk jumlah pageviews dan visits.
6. Jika model nantinya berisi beberapa tracker, tambahkan tracker sebagai slicer.

Pilih Beranda → Segarkan untuk menguji refresh Desktop secara menyeluruh. Visual yang ada akan diperbarui setelah query selesai.

1. Simpan file PBIX di lokasi yang terlindungi.
2. Di Power BI Desktop, pilih Beranda → Publikasikan.
3. Masuk menggunakan akun Power BI organisasi Anda.
4. Pilih workspace yang sesuai.
5. Buka laporan yang telah dipublikasikan dari dialog konfirmasi.

Publikasi membuat laporan dan model semantik terkait. Refresh terjadwal dikonfigurasi pada model semantik, bukan pada bagan atau halaman laporan tertentu.

1. Buka workspace di Power BI Service.
2. Temukan model semantik yang dibuat oleh file PBIX yang telah dipublikasikan.
3. Buka Pengaturan atau pilih Segarkan → Jadwalkan pembaruan.
4. Di bagian Kredensial sumber data, edit kredensial untuk https://api.nowmetrix.com.
5. Pilih Anonim sebagai metode autentikasi dan pilih tingkat privasi yang diwajibkan organisasi Anda.
6. Aktifkan jadwal refresh, lalu pilih frekuensi dan zona waktu yang sesuai.
7. Aktifkan notifikasi kegagalan refresh untuk pemilik model semantik atau penanggung jawab lainnya.
8. Simpan pengaturan, pilih Segarkan sekarang, lalu periksa Riwayat pembaruan.

Frekuensi refresh yang tersedia bergantung pada lisensi Power BI dan kapasitas workspace. Microsoft menjelaskan kontrol, batas, perilaku kegagalan, dan riwayat refresh terbaru dalam panduan refresh terjadwal.

Parameter Power Query memudahkan Anda mengganti tracker atau merotasi key tanpa mengedit seluruh query. Parameter meningkatkan kemudahan pemeliharaan, tetapi bukan penyimpanan rahasia.

1. Di Power Query Editor, pilih Beranda → Kelola Parameter → Parameter Baru.
2. Buat parameter Text wajib bernama pNowMetrixApiKey dan masukkan API key sebagai nilai saat ini.
3. Buat parameter Text wajib lainnya bernama pNowMetrixTrackerId dan masukkan ID tracker.
4. Ganti dua baris pertama query dengan baris di bawah.

    ApiKey = pNowMetrixApiKey,
    TrackerId = pNowMetrixTrackerId,

Setelah dipublikasikan, parameter yang dapat diedit mungkin muncul di pengaturan model semantik. Akses workspace tetap harus dibatasi karena pengguna dengan izin yang memadai dapat melihat atau mengubah parameter tersebut.

Buat Power Query terpisah untuk setiap dataset dan gunakan relasi dalam model jika sesuai:

• Gunakan API key NowMetrix khusus untuk setiap model semantik Power BI.
• Berikan pengguna NowMetrix hanya akses tracker yang diperlukan laporan.
• Simpan file PBIX di lokasi yang terlindungi dan jangan pernah memublikasikannya sebagai unduhan publik.
• Anggap editor PBIX dan pemilik model semantik sebagai pengguna tepercaya yang dapat melihat query.
• Jangan menempatkan key di visual, filter laporan, URL, tangkapan layar, atau dokumentasi.
• Gunakan audiens workspace Power BI terkecil yang memenuhi kebutuhan pelaporan.
• Tinjau izin laporan, workspace, aplikasi, build, berbagi ulang, dan unduhan sebelum distribusi.
• Segera cabut key jika file PBIX, workspace, atau akun pemilik diduga telah disusupi.
• Saat kepemilikan berubah, pastikan kredensial refresh dan notifikasi kegagalan tetap berfungsi.