Keitaro adalah salah satu tracker paling populer di kalangan tim affiliate: kampanye, flow, offer dan laporan sudah diatur di sana, dan tidak ada yang mau pindah. Kabar baiknya — memang tidak perlu. ArtisanClo berdiri di samping Keitaro dan hanya mengurus satu tugas: menentukan apakah pengunjung itu manusia atau bot, lalu mencatat alasan keputusannya. Semua hal lain tetap di tracker Anda. Keitaro dipasang di server Anda sendiri; bedanya dengan versi cloud dibahas di tracker cloud atau self-hosted.
Kenapa Keitaro perlu dihubungkan dengan cloaker
Tracker dan cloaker punya tugas berbeda. Tracker menghitung: dari mana klik datang, ke mana ia pergi, berapa biayanya dan berapa hasilnya. Cloaker memutuskan: siapa yang melihat offer dan siapa yang melihat White Page netral. Perbedaannya dijelaskan rinci di beda cloaker dan tracker.
Jika Anda sudah bekerja di Keitaro, yang dibutuhkan bukan sistem pencatatan kedua, tapi jawaban yang andal «loloskan atau tidak» langsung di dalam skema yang biasa. Dari sini lahir dua pilihan integrasi.
| Skema 1: filter di Keitaro | Skema 2: cloaker di landing + Keitaro | |
|---|---|---|
| Siapa yang pertama melihat kunjungan | Keitaro | Landing page Anda dengan tag atau file PHP |
| Di mana pemeriksaan berjalan | Filter flow di kampanye Keitaro | Di halaman landing |
| Siapa yang mengarahkan kunjungan | Flow Keitaro | Flow ArtisanClo, offer berupa link ke Keitaro |
| Pemeriksaan browser (JavaScript, waktu di halaman) | Tidak | Ya |
| Yang perlu dilakukan | Letakkan file filter di server Keitaro | Pasang tag JS atau file PHP dan atur postback |
| Kapan dipilih | Trafik sudah lewat link Keitaro | Butuh pemeriksaan penuh dan konversi di statistik cloaker |
Skema 1: cloaking lewat Keitaro — ArtisanClo sebagai filter flow
Di skema ini link iklan tetap mengarah ke kampanye Keitaro seperti biasa. Sebelum memberi offer ke pengunjung, Keitaro bertanya ke ArtisanClo: loloskan kunjungan ini atau tidak. Jika jawabannya «ya», flow dengan offer berjalan. Jika «tidak», kunjungan turun ke flow di bawahnya, yaitu flow dengan White Page.
Pengaturan langkah demi langkah
- Buat flow di ArtisanClo. Satu flow adalah satu kampanye: sumber, aturan filter, GEO dan proteksi.
- Buka menu flow → Hubungkan → Filter untuk Keitaro dan unduh file filter untuk flow ini.
- Letakkan file di server Keitaro, di folder
/var/www/keitaro/var/filters(di versi lama —application/filters), lalu muat ulang halaman Keitaro. - Di kampanye Keitaro, buka flow dengan offer dan tambahkan filter dengan nama file tersebut dalam mode «Ya».
- Di bawahnya pasang flow dengan White Page Anda — semua yang tidak diloloskan filter akan masuk ke sana.
Perhatikan: alamat offer dan White Page yang diisi di flow ArtisanClo tidak dipakai di skema ini. Ke mana manusia dan bot diarahkan ditentukan oleh flow Anda di Keitaro. ArtisanClo hanya menjawab pertanyaan «loloskan?». Pada dasarnya Keitaro di sini bekerja sebagai sistem TDS — mendistribusikan trafik, sedangkan filter hanya memberinya jawaban.
Keterbatasan filter
Keitaro menghubungi filter sebelum menjawab pengunjung. Pada saat itu tidak mungkin menampilkan halaman pemeriksaan ke browser, sehingga:
- pemeriksaan JavaScript, waktu minimum di halaman dan interaksi nyata tidak berlaku;
- keputusan diambil dari jaringan dan ciri request: alamat IP, provider, data center, VPN dan proxy, header, penanda klik, aturan GEO, perangkat dan jadwal;
- jika layanan tidak menjawab dalam 3 detik, kunjungan diarahkan ke White Page.
Untuk banyak sumber ini sudah cukup: trafik server, data center dan jaringan proxy sudah ketahuan di level jaringan. Bot yang menjalankan browser sungguhan dan berpura-pura jadi manusia tidak selalu terlihat dari jaringan — mereka ditangkap oleh pemeriksaan browser di skema 2.
Shadow mode dan mode «Tracker»
Filter Keitaro mendukung shadow mode: filter tidak menyaring siapa pun, hanya menandai di log siapa yang akan diblokir. Ini berguna saat Anda curiga kehilangan pengunjung asli, atau ingin melihat efek aturan yang lebih ketat tanpa mempertaruhkan trafik. Jangan biarkan shadow mode terlalu lama: selama aktif, offer terbuka untuk semua orang.
Mode flow «Tracker» juga berjalan di filter Keitaro: semua orang ke offer, bot hanya ditandai di laporan. Ini berguna saat Anda ingin tahu porsi bot dalam trafik berbayar, tapi belum siap menyaring.
Tips. Segera setelah terhubung, buka log klik di ArtisanClo dan lihat alasan keputusan untuk kunjungan pertama. Jika semua dipotong oleh alasan yang sama, kemungkinan besar aturan audiens (misalnya GEO) tidak sesuai dengan trafik Anda.
Skema 2: cloaker di landing page dan Keitaro sebagai tracker eksternal
Di skema kedua, situs Anda yang pertama menerima kunjungan. Di situs terpasang tag JS atau file PHP ArtisanClo — situs tetap milik Anda, di hosting dan domain Anda. Cloaker memeriksa pengunjung secara penuh, termasuk browser, lalu memutuskan: White Page atau offer. Dan «offer» di sini adalah link ke kampanye Keitaro Anda; setelah itu semuanya berjalan seperti biasa.
Cara memasang cloaker di situs dijelaskan rinci di memasang cloaker: tag JS atau file PHP.
Cara mengembalikan konversi dari Keitaro ke cloaker
Dalam mode «Cloaking», cloaker sendiri tidak melihat konversi: ia tahu siapa yang diloloskan, tapi tidak tahu siapa yang membeli. Agar CR dan pendapatan muncul di statistiknya, lingkarannya harus ditutup:
- Di flow ArtisanClo buka langkah 3. Tracker → blok Tracker eksternal dan pilih Keitaro dari daftar. Tombol «?» di sebelahnya menampilkan catatan dan link ke dokumentasi tracker.
- Salin parameter untuk link iklan berbentuk
external_id={click_id}. Tombol Tambahkan ke link akan menambahkannya ke semua offer di flow. Kolom menyala hijau jika parameter sudah ada di link offer, dan merah jika belum. - Di Keitaro, terima parameter ini ke salah satu label kampanye agar nomor klik ArtisanClo tersimpan di tracker.
- Buka jendela berisi alamat postback di ArtisanClo dan tempelkan ke pengaturan postback kampanye Keitaro, dengan mengisi label yang tersimpan dan status konversi.
- Kirim konversi tes dan cek baris status.
Link offer di flow akan terlihat kira-kira seperti ini:
https://trk.domain-anda.com/AbCdEf?external_id={click_id}
ArtisanClo akan mengganti {click_id} dengan nomor klik tertentu. Keitaro menyimpannya, dan saat affiliate network mengirim konversi ke tracker, Keitaro meneruskannya — konversi pun terhubung ke klik awal di cloaker. Diagram «Perjalanan pulang-pergi click_id» di dashboard menunjukkan jalurnya secara visual. Jika click ID masih baru bagi Anda, baca Click ID dan Sub ID.
Arti baris status
| Pesan | Yang perlu dilakukan |
|---|---|
| Konversi sudah masuk | Tidak ada — lingkaran sudah tertutup |
| Postback sampai, tapi tidak cocok dengan klik | Keitaro mengirim parameter yang salah: pastikan postback berisi nilai dari external_id, bukan ID klik milik tracker |
| Tinggal arahkan postback tracker ke alamat kami | Postback dari Keitaro belum pernah datang |
Selain itu, buka bagian Penerimaan konversi → Log: di sana ada pesan masuk terakhir beserta hasilnya — «lead tercatat», «klik tidak ditemukan», «tanpa click_id». Dari hasil itu langsung terlihat di langkah mana rantainya putus.
Skema mana yang dipilih
- Kampanye sudah disusun di Keitaro dan tidak ingin mengubah landing page — skema 1: ia masuk ke flow yang ada dan tidak menyentuh halaman.
- Butuh pemeriksaan browser serta CR dan pendapatan langsung di statistik cloaker — skema 2: tag atau file PHP di landing plus postback dari Keitaro.
- Sumber dengan porsi trafik server yang besar (native, push, pop) — skema 1 sering sudah cukup, karena trafik seperti itu terlihat dari jaringan. Selengkapnya tentang platform ada di bagian sumber trafik.
- Hanya perlu menghitung bot tanpa menyaring — skema 1 dengan mode «Tracker» atau shadow mode.
Kedua skema bisa dikombinasikan di kampanye berbeda: satu kampanye, satu flow, masing-masing dengan cara integrasinya sendiri.
Cara mengecek integrasi sebelum trafik berjalan
Sebelum menyalakan budget, uji integrasi secara manual. Hanya butuh sepuluh menit dan menghemat sehari penelusuran masalah.
- Klik Anda sendiri. Buka link iklan dari ponsel lewat internet seluler. Di log klik ArtisanClo harus muncul kunjungan dengan alasan keputusan, dan di Keitaro — klik di flow yang benar. Jika tidak ingin klik tes Anda diperiksa, tambahkan alamat Anda ke whitelist IP flow dengan tombol Tambahkan IP saya.
- Klik dari data center. Buka link yang sama lewat VPN atau dari server. Kunjungan harus masuk ke flow White Page, dan di log mendapat alasan seperti «VPN atau proxy» atau «Jaringan berisiko tinggi».
- Label. Pastikan label kampanye (
utm_campaign,sub1dan lainnya) sampai ke Keitaro tanpa hilang: buka kartu klik di log ArtisanClo dan bandingkan dengan yang dicatat tracker. - Konversi. Untuk skema 2, kirim konversi tes dari Keitaro dan pastikan baris status berubah menjadi «konversi sudah masuk».
Baru setelah itu ubah status flow menjadi «Aktif» dan jalankan iklan.
Kesalahan umum integrasi Keitaro dan cloaker
- Flow White Page berada di atas flow offer. Kunjungan tidak pernah sampai ke filter. Urutannya: flow offer dengan filter «Ya» di atas, White Page di bawah.
- Filter dalam mode «Tidak». Logikanya terbalik: yang disaring cloaker justru masuk ke offer.
- File filter dari flow ArtisanClo lain. File terikat ke flow tertentu, setiap kampanye punya file sendiri.
- Postback memakai ID klik Keitaro, bukan
external_id. Konversi datang, tapi «klik tidak ditemukan». - Membandingkan angka dari tanggal berbeda. Log konversi secara default memfilter berdasarkan tanggal masuk, sedangkan laporan mengaitkan pendapatan ke tanggal klik. Ubah log ke «Tanggal klik», maka angka cloaker akan cocok dengan Keitaro. Cara mencocokkan pendapatan per status dibahas di artikel tentang status konversi.
Apa yang Anda lihat pada akhirnya
Setelah integrasi, di ArtisanClo setiap kunjungan punya alasan keputusan: «Diizinkan», «VPN atau proxy», «Layanan verifikasi iklan atau spy», «Di luar jam kampanye» dan puluhan lainnya. Di Keitaro tetap ada uang, offer dan laporan yang biasa Anda pakai. Jika ada masalah — konversi lebih sedikit dari biasanya, pass rate turun — penelusuran dimulai dari log klik dan diagnostik flow, yang dibahas di kenapa klik masuk ke White Page.
Detail integrasi ada di halaman ArtisanClo dan Keitaro.
Ringkasan
Keitaro dan cloaker tidak bersaing, tapi saling melengkapi. Skema filter flow masuk ke kampanye yang sudah ada dalam beberapa menit dan memutuskan berdasarkan jaringan dan ciri request. Skema tag atau file PHP di landing page memberi pemeriksaan browser penuh, dan postback dari Keitaro mengembalikan konversi serta pendapatan ke cloaker. Pilih berdasarkan di mana kampanye Anda sudah berjalan dan seberapa dalam pemeriksaan yang dibutuhkan trafik Anda.
