API Statistik Klik per Jam (v3)

Mengambil jumlah klik per jam (00:00–23:59) dalam rentang tanggal tertentu.

Analisis distribusi trafik per jam untuk link, grup, atau seluruh akun.
Gunakan untuk mengukur performa campaign, menemukan waktu terbaik, dan memahami pola aktivitas pengguna.

API ini tersedia mulai paket Personal ke atas.

GET

/api/statistics/v3/clicks-by-hour?startYmd={startYmd}&endYmd={endYmd} 


GET /api/statistics/v2/clicks-by-date
     ?startYmd=2025-04-01
     &endYmd=2025-04-30

Request Parameters

startYmd date required
Tanggal mulai pencarian (contoh: 2025-12-01)
endYmd date required
Tanggal akhir pencarian (contoh: 2025-12-31). Rentang maksimum antara tanggal mulai dan akhir adalah 1 bulan.
Paket Personal: hingga 7 hari
Paket Premium: hingga 14 hari
linkId string
ID tautan. Jika berisi karakter khusus atau Unicode, wajib menggunakan URL encoding.
Paket Personal: linkId dan domain wajib diisi, hanya bisa mengambil klik dari tautan individual.
Paket Premium ke atas: opsional.
domain string
Domain tautan.
grpIdx integer
Grup tautan. IDX grup dapat diperoleh dengan memanggil API Daftar Grup atau memeriksanya di dasbor.
Jika ditentukan, total jumlah klik semua tautan dalam grup tersebut akan dikembalikan. Hanya tersedia di paket Premium ke atas. 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "ymd": "2025-04-01",
            "hour": 0,
            "acesCnt": 24,
            "pernCnt": 17
        },
        {
            "ymd": "2025-04-02",
            "hour": 1,
            "acesCnt": 121,
            "pernCnt": 198
        },
        {
            "ymd": "2025-04-03",
            "hour": 2,
            "acesCnt": 84,
            "pernCnt": 68
        },
        {
            "ymd": "2025-04-04",
            "hour": 3,
            "acesCnt": 21,
            "pernCnt": 15
        },
        {
            "ymd": "2025-04-05",
            "hour": 4,
            "acesCnt": 1950,
            "pernCnt": 1621
        },
        {
            "ymd": "2025-04-10",
            "hour": 5,
            "acesCnt": 7,
            "pernCnt": 7
        }
    ]
}

Response Parameters

codeinteger
Kode respons: 0 = Berhasil, nilai lain = Error
messagestring
Pesan respons. Jika kode tidak sama dengan 0, pesan kesalahan akan dikembalikan.
resultarray
ymddate
Tanggal.
hourinteger
Jam (0–23).
acesCntinteger
Total klik pada rentang waktu tersebut.
pernCntinteger
Jumlah pengguna unik yang mengklik tautan pada rentang waktu itu.

Kapan menggunakan API ini

Gunakan API ini untuk mengetahui kapan klik link paling banyak terjadi dalam sehari.

Cocok untuk mengoptimalkan waktu campaign, menjadwalkan iklan, dan menganalisis pola aktivitas pengguna.

Anda dapat menganalisis satu link atau data agregat per grup.
Tidak hanya statistik, tetapi juga untuk analisis perilaku berbasis waktu.

Cara menentukan cakupan data

Cakupan data dapat ditentukan dengan tiga cara.

Gunakan linkId dan domain untuk mengambil klik per jam pada link tertentu.
Gunakan grpIdx untuk mengambil total klik dari semua link dalam grup.
Jika keduanya tidak diisi, data seluruh akun akan dikembalikan.

Fitur utama dan metrik analisis

API ini menyediakan data analitik berbasis waktu, bukan sekadar jumlah klik.

Klik per jam (accsCnt)

  • Total klik untuk setiap jam
  • Mengetahui waktu dengan trafik tertinggi

Jumlah pengguna (pernCnt)

  • Jumlah pengguna unik per jam
  • Analisis rasio klik terhadap pengguna

Dengan membandingkan klik dan pengguna, Anda dapat menganalisis klik berulang dan pola perilaku pengguna.

Contoh penggunaan

  • Optimasi waktu campaign: Fokus pada jam dengan klik tertinggi berdasarkan data historis
  • Penjadwalan iklan: Menyesuaikan waktu tayang berdasarkan accsCnt
  • Analisis pengguna: Menemukan waktu dengan banyak pengguna baru menggunakan pernCnt
  • Analisis grup: Mengukur performa campaign per jam menggunakan grpIdx

Hal yang perlu diperhatikan

  • startYmd dan endYmd adalah parameter wajib dan harus mengikuti format yyyy-MM-dd.
  • Rentang tanggal maksimum tergantung pada paket. Permintaan yang melebihi batas akan menghasilkan error.
  • Jika linkId mengandung karakter khusus atau Unicode, gunakan URL encoding.
  • Jumlah klik dan jumlah pengguna bisa berbeda.