API Klik per Grup (v2)

Mengambil jumlah klik per grup link berdasarkan tanggal tertentu.

API ini menggabungkan klik dari semua link dalam setiap grup dan mengembalikannya dalam bentuk daftar.
Anda dapat membandingkan beberapa grup sekaligus untuk melihat performa campaign secara menyeluruh.

API ini tersedia mulai paket Personal ke atas.

GET

/api/link/v2/clicks-by-group?startYmd={startYmd}&endYmd={endYmd}&grpIdxList={grpIdxList}&pages={pages} 


GET /api/link/v2/clicks-by-group
     ?startYmd=2025-08-01
     &endYmd=2025-08-31
     &grpIdxList=151,207,209
     &pages=1

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
grpIdxList string

Berikan daftar IDX grup yang dipisahkan dengan koma (,). Contoh: 151,207,209

  • Paket Premium: Harus menentukan daftar IDX grup, maksimal 5 grup.
  • Paket Bisnis: Jika dikosongkan, jumlah klik dari semua grup akan diambil. Juga dapat menentukan grup tanpa batas jumlah.
pages integer required
Default:1
Nomor halaman hasil kueri.
Satu halaman mengembalikan 30 hasil secara default. Contoh: jika pages=2, maka hasil dari record ke-31 hingga 30 item akan dikembalikan. 
{
    "code": 0,
    "message": "",
    "result": {
        "extra": {
            "pages": 1,
            "nextPages": 1,
            "nextYn": "N",
            "count": 3,
            "totalCount": 3
        },
        "list": [
            {
                "grpIdx": 151,
                "grpNm": "Electronics",
                "acesCnt": 181,
                "pernCnt": 164
            },
            {
                "grpIdx": 207,
                "grpNm": "Kitchenware",
                "acesCnt": 19847,
                "pernCnt": 18095
            },
            {
                "grpIdx": 209,
                "grpNm": "Brian Smith Advertiser Only",
                "acesCnt": 5730,
                "pernCnt": 5409
            }
        ]
    }
}

Response Parameters

code integer
Kode respons: 0 = Berhasil, nilai lain = Error
message string
Pesan respons. Jika kode bukan 0, pesan error akan dikembalikan.
result object
extra object
Informasi halaman dan jumlah data.
pages integer
Nomor halaman saat ini
nextPages integer
Nomor halaman berikutnya
nextYn string
Apakah ada halaman berikutnya
count integer
Jumlah data pada halaman saat ini
totalCount integer
Jumlah total data
list array
Klik per Grup
grpIdx integer
Grup tautan (IDX).
grpNm string
Nama grup tautan.
acesCnt integer
Jumlah total klik dari semua tautan dalam grup ini.
pernCnt integer
Jumlah pengguna unik yang mengklik tautan dalam grup ini.

Kapan menggunakan API ini

Gunakan API ini untuk membandingkan performa beberapa grup campaign pada tanggal tertentu.

API ini menggabungkan total klik dan jumlah pengguna unik per grup dalam satu permintaan, sehingga cocok untuk analisis perbandingan dan trafik per grup.

Tidak hanya untuk melihat data, tetapi untuk analisis perbandingan performa.

Perbedaan dengan API klik lainnya

Waktu → “kapan”, Tanggal → “tren”, Grup → “sumber”
API grup dioptimalkan untuk perbandingan performa.

Cara mengambil beberapa grup sekaligus

Gunakan grpIdxList dengan nilai IDX yang dipisahkan koma (,) untuk mengambil beberapa grup dalam satu permintaan.
Contoh: 151,207,209. Maksimal 30 grup per permintaan. Untuk lebih banyak, gunakan pages dan lakukan beberapa request.

Kemungkinan mengosongkan grpIdxList tergantung paket.
Pada paket Premium, wajib diisi dan maksimal 5 grup.
Pada paket Business, jika dikosongkan akan mengembalikan semua grup tanpa batas.

Contoh penggunaan

  • Perbandingan campaign: Gunakan grpIdxList untuk membandingkan beberapa grup sekaligus
  • Analisis bulanan: Gunakan startYmd dan endYmd untuk melihat total klik per grup
  • Analisis event: (Business+) kosongkan grpIdxList untuk mengambil semua grup
  • Dashboard: Gunakan paging untuk mengumpulkan seluruh data grup

Hal yang perlu diperhatikan

  • Pagination diperlukan jika jumlah grup yang diambil banyak.
  • Waktu respons dapat meningkat jika volume data besar.
  • Rentang tanggal maksimum tergantung paket. Personal: hingga 7 hari, Premium: hingga 14 hari.
  • Maksimal 30 grup dikembalikan per halaman. Jika total melebihi 30, tingkatkan pages untuk mengambil data tambahan.