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 customerId melalui identify(), sistem otomatis membuat atau menghubungkan ke profil pelanggan yang sudah ada.
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 customerId via onecy.identify() untuk membuat atau menghubungkan ke profil pelanggan yang sudah ada.
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, Developer mengirim customerId melalui onecy.identify({ customerId }) — sistem otomatis membuat atau menghubungkan profil anonim saat ini ke profil pelanggan yang ada. Panggil onecy.logout() saat pengunjung logout — sistem langsung membuat AnonymousID baru untuk sesi selanjutnya.
Setup: Add the script below to your HTML. The SDK automatically creates a unique anonymousId per visitor.
<script src="https://app-flow.onecy.net/sdk/onecy.js"></script>onecy.init(apiKey)Muat & inisialisasi SDK// 1. Add the script to your HTML:
// <script src="https://app-flow.onecy.net/sdk/onecy.js"></script>
// 2. Initialize the SDK (automatically creates anonymousId):
onecy.init('YOUR_API_KEY');/api/v1/trackCatat event pengunjung (anonymous)// Track an event (anonymousId is included automatically):
onecy.track({
event: 'purchase',
channel: 'web',
properties: {
product: 'Plain T-Shirt',
quantity: 3,
total: 150000
}
});/api/v1/identifyTempelkan profil ke anonymous visitor// Attach a profile to the current anonymous visitor:
onecy.identify({
name: 'Budi Santoso',
email: 'budi@toko.com',
company: 'Toko Maju',
attributes: {
city: 'Jakarta',
type: 'reseller'
}
});/api/v1/identifyHubungkan visitor ke ID pelanggan yang diketahui// Link visitor to a known customer ID using fixedId:
onecy.identify({
fixedId: 'user-12345',
name: 'Budi Santoso',
email: 'budi@toko.com'
});onecy.logout()Reset anonymousId (akhir sesi / logout)// Reset the anonymousId — call this when the user logs out:
onecy.logout();Referensi Fungsi
| Function | Usage | Parameters |
|---|---|---|
onecy.init(apiKey) | Initialize SDK, create AnonymousID | apiKey (string) |
onecy.track(data) | Record visitor event | event (required) |
onecy.identify(data) | Attach profile or link to known customerId | customerId (to link identity) |
onecy.logout() | End session, create new AnonymousID | — |
onecy.getAnonymousId() | Get active AnonymousID | — |
onecy.reset() | Alias for logout() | — |
Parameter Reference
| Parameter | Type | Required | Description |
|---|---|---|---|
anonymousId | string | Auto ✅ | Auto by SDK. For cURL, generate UUID v4. |
event | string | ✅ (track) | Event name, e.g. "purchase" |
customerId | string | — (identify) | Known customer ID. Links anonymous visitor to an existing or new profile. |
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.