Masuk Mulai paket →
BerandaFiturHargaFAQDocsBlogKontak
Masuk Mulai paket →
D01 · DOCUMENTATIONSCANFENCE / DOCUMENTATIONQUICKSTART · API · RECIPES

Cara kerjanya.

Panduan penyiapan, referensi API, resep integrasi. Mulai dari quickstart, lalu lanjut ke referensi teknis saat Anda siap.

Daftar Isi

1. Memulai

1.1 Membuat Akun Anda
  1. Kunjungi halaman pendaftaran GeoTrack di /signup
  2. Pilih paket langganan Anda (Basic, Starter, atau Professional)
  3. Masukkan alamat email dan buat kata sandi yang aman
  4. Klik “Create Account”
  5. Anda akan otomatis masuk dan diarahkan ke dasbor Anda

Catatan: Semua paket mencakup uji coba gratis 7 hari. Kartu Anda tidak akan ditagih hingga masa uji coba berakhir.

Saat pertama kali login, Anda akan melihat:

  • Dasbor Anda dengan statistik ringkas (saat ini nol)
  • Menu navigasi di sebelah kiri dengan fitur yang tersedia
  • Pesan sambutan yang mendorong Anda membuat kode QR pertama

Paket Basic ($4.99/month)

  • 20 kode QR
  • 5,000 pemindaian per bulan
  • 1 anggota tim
  • Retensi data 7 hari
  • Dukungan email (respons 48 jam)

Paket Starter ($14.99/month)

  • 100 kode QR
  • 25,000 pemindaian per bulan
  • 2 anggota tim
  • Retensi data 30 hari
  • Dukungan email prioritas (24 jam)

Paket Professional ($44.99/month)

  • 500 kode QR
  • 250,000 pemindaian per bulan
  • 10 anggota tim
  • Retensi data 90 hari
  • Dukungan prioritas + akses API

2. Ikhtisar Dasbor

2.1 Komponen Dasbor
Dasbor Anda menampilkan: Metrik Utama: • Total Kode QR: Jumlah kode QR yang telah Anda buat • Total Pemindaian: Jumlah pemindaian sepanjang waktu di semua kode QR • Geofence Aktif: Jumlah geofence yang saat ini aktif • Pemindaian Bulan Ini: Pemindaian yang tercatat dalam bulan kalender berjalan

3. Membuat Kode QR

3.1 Kode QR Standar

Tujuan: Kode QR sederhana yang mengarahkan ke satu URL.

Langkah:

  1. Buka “QR Codes” di menu navigasi
  2. Klik “Create New QR Code”
  3. Pilih “Standard” sebagai tipe
  4. Masukkan nama untuk kode QR Anda (mis., “Product Brochure”)
  5. Masukkan URL tujuan
  6. Klik “Create QR Code”

Kasus Penggunaan:

  • Halaman informasi produk
  • Pendaftaran acara
  • Informasi kontak
  • Profil media sosial

Tujuan: Mengarahkan pengguna ke URL yang berbeda berdasarkan lokasi fisik mereka.

Langkah:

  1. Buka “QR Codes” → “Create New QR Code”
  2. Pilih “Geofence” sebagai tipe
  3. Masukkan nama untuk kode QR Anda
  4. Masukkan URL default (digunakan saat pengguna berada di luar semua geofence)
  5. Klik “Create QR Code”
  6. Buka menu “Geofences” lalu klik “Create Geofence”
  7. Pilih kode QR Anda, atur lokasi dan radius
  8. Masukkan URL pengalihan untuk lokasi ini

Kasus Penggunaan:

  • Toko ritel multi-lokasi
  • Pengiriman konten regional
  • Penawaran khusus lokasi
  • Navigasi tempat acara

Tujuan: Secara otomatis mengarahkan pengguna ke lokasi terdekat dari daftar yang telah ditentukan.

Cara Kerjanya:

  1. Pengguna memindai kode QR
  2. Sistem mendeteksi koordinat GPS pengguna
  3. Menghitung jarak ke semua lokasi
  4. Mengarahkan ke lokasi terdekat

Kasus Penggunaan:

  • Bisnis waralaba
  • Restoran berjaringan
  • Penyedia layanan dengan banyak kantor
  • Pencari lokasi toko

Anda dapat menambahkan perutean berbasis waktu ke kode QR mana pun untuk mengarahkan pengguna berdasarkan waktu mereka memindai.

Konfigurasi:

  • Hari dalam Seminggu: Pilih hari saat aturan ini berlaku
  • Rentang Waktu: Atur waktu mulai dan selesai (format 24 jam)
  • Rentang Tanggal: Rentang tanggal spesifik opsional
  • Prioritas: Angka lebih tinggi lebih diutamakan
  • URL Tujuan: Ke mana harus diarahkan selama periode ini

Contoh:

  • Menu restoran (sarapan, makan siang, makan malam)
  • Informasi jam kerja vs. di luar jam kerja
  • Konten musiman
  • Pengalihan khusus acara

Ciptakan kelangkaan dan urgensi dengan batas pemindaian.

Kasus Penggunaan:

  • Penawaran terbatas waktu (“First 100 customers get 20% off”)
  • Kode akses eksklusif
  • Manajemen kapasitas acara
  • Kampanye promosi

4. Mengelola Geofence

4.1 Membuat Geofence
  1. Buka “Geofences” di navigasi
  2. Klik “Create Geofence”
  3. Pilih kode QR yang ingin Anda beri geofence
  4. Masukkan informasi lokasi (alamat atau koordinat)
  5. Atur radius dalam meter (default: 100m)
  6. Masukkan URL pengalihan untuk geofence ini
  7. Klik “Create Geofence”

Pemilihan Radius:

  • Area perkotaan: 50-100 meter (akurasi GPS tinggi)
  • Area pinggiran kota: 100-300 meter (akurasi sedang)
  • Area pedesaan: 300-1000 meter (akurasi GPS lebih rendah)

Geofence yang Tumpang Tindih:

  • Saat geofence tumpang tindih, sistem menggunakan titik pusat terdekat
  • Gunakan pengaturan prioritas untuk mengontrol perilaku
  • Uji secara menyeluruh di area tempat geofence tumpang tindih

5. Analitik & Pelaporan

5.1 Dasbor Analitik

Metrik Ikhtisar:

  • Total pemindaian (sepanjang waktu)
  • Pemindaian unik
  • Pemindaian bulan ini
  • Persentase pertumbuhan pemindaian

Bagan dan Grafik:

  • Linimasa pemindaian (harian/mingguan/bulanan)
  • Distribusi geografis
  • Rincian perangkat (seluler vs. desktop)
  • Statistik peramban

Peta interaktif menampilkan:

  • Penanda pin untuk setiap lokasi pemindaian
  • Penanda klaster saat beberapa pemindaian berdekatan
  • Klik pin untuk melihat detail pemindaian
  • Perbesar dan geser untuk menjelajahi wilayah

Langkah:

  1. Buka halaman Analitik
  2. Atur filter yang Anda inginkan
  3. Klik “Export Data”
  4. Pilih format (CSV)
  5. Unduh file

Data yang Diekspor Mencakup:

  • Stempel waktu, nama kode QR, Lokasi
  • Jenis perangkat, Peramban, Sistem operasi
  • String user agent

6. Manajemen Tim

6.1 Peran Tim

Admin

• Akses penuh ke semua fitur

• Mengundang/menghapus anggota tim

• Mengelola penagihan

• Melihat semua analitik

• Mengakses pengaturan

Manager

• Membuat/mengelola kode QR

• Membuat/mengelola geofence

• Melihat semua analitik

• Tidak dapat mengelola tim

• Tidak dapat mengakses penagihan

Field User

• Membuat kode QR

• Hanya melihat kode QR sendiri

• Akses analitik terbatas

• Tidak dapat mengelola geofence

• Tidak dapat mengakses penagihan

  1. Buka “Team” di navigasi (harus Admin)
  2. Klik “Invite Team Member”
  3. Masukkan alamat email mereka
  4. Pilih peran mereka (Admin, Manager, atau Field User)
  5. Klik “Send Invitation”
  6. Undangan menerima email dengan tautan penerimaan

Catatan: Anda hanya dapat mengundang anggota sebanyak yang diizinkan paket Anda (Basic: 1, Starter: 2, Professional: 10)

7. Langganan & Penagihan

7.1 Melihat Status Langganan

Indikator Status:

  • Active: Langganan berlaku dan aktif
  • Trial: Dalam masa uji coba 7 hari
  • Past Due: Pembayaran gagal, sedang dicoba ulang
  • Canceled: Dibatalkan tetapi masih aktif hingga akhir periode
  • Expired: Langganan telah berakhir
  1. Buka halaman “Pricing” atau Dasbor
  2. Klik “Upgrade” pada paket yang diinginkan
  3. Tinjau fitur dan batas paket baru
  4. Konfirmasi peningkatan
  5. Biaya prorata diterapkan segera
  6. Batas baru aktif segera

8. Fitur Lanjutan

8.1 Menggabungkan Geofence dan Aturan Waktu

Contoh Kasus Penggunaan: Jaringan Restoran

  1. Buat kode QR multi-lokasi
  2. Tambahkan geofence untuk setiap lokasi restoran
  3. Tambahkan aturan berbasis waktu untuk menu (sarapan, makan siang, makan malam)

Sistem Prioritas:

  • Kecocokan Geofence + Aturan Waktu = prioritas tertinggi
  • Kecocokan Geofence saja = prioritas sedang
  • Kecocokan aturan waktu saja = prioritas rendah
  • Tidak ada kecocokan = URL default

Teruskan informasi tentang pemindaian ke URL tujuan Anda:

Parameter yang Tersedia:

  • {scan_id} – Pengenal pemindaian unik
  • {qr_code_id} – Pengenal kode QR
  • {timestamp} – Stempel waktu Unix
  • {lat} – Lintang
  • {lng} – Bujur

https://example.com/track?scan={scan_id}&location={lat},{lng}&time={timestamp}

9. Pemecahan Masalah

9.1 Kode QR Tidak Terbaca

Kemungkinan Penyebab:

  • Kualitas gambar kode QR terlalu rendah
  • Kondisi pencahayaan buruk
  • Masalah fokus kamera
  • Kode QR terlalu kecil atau terlalu besar

Solusi:

  • Unduh kode QR resolusi lebih tinggi (300×300 atau 500×500)
  • Pastikan kontras yang baik (gelap di atas latar terang)
  • Pertahankan ukuran minimum 2cm x 2cm untuk pencetakan

Penyebab:

  • GPS dinonaktifkan pada perangkat
  • Lokasi dalam ruangan (sinyal GPS lemah)
  • Akurasi GPS perangkat rendah
  • Pengguna menolak izin lokasi

Solusi:

  • Minta pengguna mengaktifkan layanan lokasi
  • Tingkatkan radius geofence untuk penggunaan dalam ruangan
  • Sediakan URL cadangan untuk kegagalan lokasi

Daftar Periksa:

  • Apakah geofence aktif? (Periksa status di dasbor)
  • Apakah tipe kode QR diatur ke “Geofence”?
  • Apakah radius sesuai untuk area tersebut?
  • Sudahkah Anda menguji di perangkat dengan lokasi aktif?
  • Apakah koordinatnya benar? (Verifikasi di peta)

10. Praktik Terbaik

10.1 Desain Kode QR

✓ Lakukan:

  • Gunakan kontras tinggi (hitam di atas putih ideal)
  • Sisakan ruang putih di sekitar kode (zona sunyi)
  • Uji sebelum pencetakan massal
  • Sertakan teks ajakan bertindak yang jelas

✗ Jangan:

  • Gunakan warna yang mengurangi kontras
  • Membuat kode QR terlalu kecil (min 2cm x 2cm)
  • Menempatkan pada permukaan melengkung
  • Menggunakan gambar resolusi rendah

Perencanaan:

  • Petakan semua lokasi terlebih dahulu
  • Tentukan radius yang sesuai untuk masing-masing
  • Pertimbangkan akurasi GPS di setiap area
  • Uji skenario tumpang tindih

Optimasi:

  • Mulai dengan radius lebih besar, persempit setelah pengujian
  • Gunakan analitik untuk memverifikasi akurasi geofence
  • Sesuaikan berdasarkan data pemindaian dunia nyata

Melindungi Akun Anda:

  • Gunakan kata sandi yang kuat dan unik
  • Aktifkan autentikasi dua faktor (segera hadir)
  • Jangan bagikan kredensial login
  • Tinjau akses anggota tim secara berkala

Privasi Pengguna:

  • Hanya kumpulkan data lokasi yang diperlukan
  • Patuhi peraturan GDPR/privasi
  • Amankan URL tujuan dengan HTTPS