Dokumentasi
Panduan Lengkap Onecy Flow
Untuk tim marketing yang pemula & developer yang ingin integrasi
📖 Apa itu Onecy Flow?
Onecy Flow adalah platform analitik produk yang melacak perilaku pengunjung secara otomatis. Setiap pengunjung mendapat AnonymousID unik, dan saat Developer mengirim FixedID melalui identify(), sistem otomatis membuat atau menghubungkan ke FixedProfile permanen.
Onecy Flow membantu kamu memahami pelanggan dengan cara:
Pelacakan Otomatis Pengunjung
Setiap pengunjung baru otomatis mendapat AnonymousID unik. Aktivitas mereka langsung tercatat bahkan sebelum login.
Pengikatan Identitas (Identity Linkage)
Saat pengunjung memasukkan data identitas, Developer mengirim FixedID via onecy.identify() untuk membuat atau menghubungkan ke FixedProfile permanen.
Konsolidasi Profil
Satu FixedProfile bisa membawahi banyak AnonymousID dari sesi berbeda. Semua riwayat aktivitas tergabung.
Analisis Perilaku Mendalam
Grafik funnel, retensi, dan insight yang menunjukkan pola perilaku pelanggan secara real-time.
🚀 Panduan Marketing — Mulai dari Mana?
Buat API Key👩💻 Developer
Minta developer kamu untuk pergi ke menu Integrations dan membuat API Key.
Tanam SDK di Website👩💻 Developer
Developer menanamkan (embed) JS Script ke dalam platform. Cukup 1 script tag dan panggil onecy.init(). SDK otomatis membuat AnonymousID unik per pengunjung.
Data Mulai Masuk📊 Marketing
Setelah terpasang, setiap pengunjung baru otomatis mendapat AnonymousProfile. Aktivitas tercatat bahkan sebelum mereka login atau mengisi data.
Buat Segmen📊 Marketing
Buat grup pelanggan di menu Segments — misal "pelanggan yang pernah beli" atau "dari Jakarta".
Analisis Data📊 Marketing
Buka Insights, Funnels, dan Retention untuk melihat tren dan pola pelanggan kamu.
💻 Panduan Integrasi 👩💻 Untuk Developer
Bagian ini untuk developer kamu. Berikan link halaman ini ke developer untuk memasang tracking di website/app bisnis kamu.
Cara kerja: SDK otomatis membuat AnonymousID (UUID unik) saat onecy.init() dipanggil. ID ini tersimpan di localStorage browser. Saat pengunjung memasukkan data identitas (email/HP/dll), Developer mengirim fixedId melalui onecy.identify({ fixedId }) — sistem otomatis membuat FixedProfile permanen baru. Jika fixedId sudah pernah terdaftar, profil anonim saat ini akan dihubungkan (linked) ke FixedProfile yang sudah ada. Panggil onecy.logout() saat pengunjung logout — sistem langsung membuat AnonymousID baru untuk sesi selanjutnya.
Langkah 1: Pasang Script
<script src="https://your-app.com/sdk/onecy.js"></script>Langkah 2: Inisialisasi
onecy.init('YOUR_API_KEY');
// SDK auto-creates anonymousId and stores in localStorageLangkah 3: Gunakan Fungsi
onecy.identify({
fixedId: 'budi@toko.com',
name: 'Budi Santoso',
email: 'budi@toko.com',
company: 'Toko Maju',
phone: '08123456789',
attributes: {
kota: 'Jakarta',
tipe: 'reseller'
}
});onecy.track({
event: 'beli_produk',
channel: 'web',
properties: {
produk: 'Kaos Polos',
jumlah: 3,
total: 150000
}
});Contoh Lengkap (Copy-Paste ke HTML)
<!-- Add to your HTML -->
<script src="https://your-app.com/sdk/onecy.js"></script>
<script>
// 1. Initialize — AnonymousID auto-created
onecy.init('YOUR_API_KEY');
// 2. Track visitor behavior
onecy.track({
event: 'lihat_produk',
properties: { produk: 'Kaos Polos', harga: 50000 }
});
// 3. Bind identity with fixedId — creates FixedProfile or links to existing
onecy.identify({
fixedId: 'budi@toko.com',
name: 'Budi Santoso',
email: 'budi@toko.com'
});
// 4. On logout — new AnonymousID for next session
// onecy.logout();
</script>Referensi Fungsi
| Function | Usage | Parameters |
|---|---|---|
onecy.init(apiKey) | Initialize SDK, create AnonymousID | apiKey (string) |
onecy.identify(data) | Bind identity with fixedId — create/link FixedProfile | fixedId (to bind identity) |
onecy.track(data) | Record visitor event | event (required) |
onecy.getAnonymousId() | Get active AnonymousID | — |
onecy.logout() | End session, create new AnonymousID | — |
onecy.reset() | Alias for logout() | — |
Parameter Reference
| Parameter | Type | Required | Description |
|---|---|---|---|
anonymousId | string | Auto ✅ | Auto by SDK. For cURL, generate UUID. |
fixedId | string | ✅ (identify) | Permanent identity key. Required to create/bind FixedProfile. |
event | string | ✅ (track) | Event name, e.g. "purchase" |
email | string | — | Customer email (profile data) |
name | string | — | Customer name |
company | string | — | Company name |
phone | string | — | Phone number (profile data) |
channel | string | — | Source: "web", "mobile" |
attributes | object | — | Extra customer data (merged) |
properties | object | — | Extra event data |
💡 Contoh Penggunaan
Toko Online (E-Commerce)
Track setiap langkah belanja. Bahkan sebelum login, aktivitas tercatat via anonymousId. Buat funnel untuk lihat drop-off.
Cara menggunakan di Onecy Flow:
SaaS / Aplikasi
Track aktivasi user baru. Lihat retention. Panggil logout() saat user keluar agar sesi baru mendapat AnonymousID baru.
Cara menggunakan di Onecy Flow:
Marketing Campaign
Track performa campaign. Funnel dari klik iklan sampai jadi lead. Bandingkan channel.
Cara menggunakan di Onecy Flow:
Membership / Loyalty
Track loyalitas member. Lihat retention per bulan. Segmen member yang hampir expired.