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?

1

Buat API Key👩‍💻 Developer

Minta developer kamu untuk pergi ke menu Integrations dan membuat API Key.

2

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.

3

Data Mulai Masuk📊 Marketing

Setelah terpasang, setiap pengunjung baru otomatis mendapat AnonymousProfile. Aktivitas tercatat bahkan sebelum mereka login atau mengisi data.

4

Buat Segmen📊 Marketing

Buat grup pelanggan di menu Segments — misal "pelanggan yang pernah beli" atau "dari Jakarta".

5

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>
SDKonecy.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');
POST/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
  }
});
POST/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'
  }
});
POST/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'
});
SDKonecy.logout()Reset anonymousId (akhir sesi / logout)
// Reset the anonymousId — call this when the user logs out:
onecy.logout();

Referensi Fungsi

FunctionUsageParameters
onecy.init(apiKey)Initialize SDK, create AnonymousIDapiKey (string)
onecy.track(data)Record visitor eventevent (required)
onecy.identify(data)Attach profile or link to known customerIdcustomerId (to link identity)
onecy.logout()End session, create new AnonymousID
onecy.getAnonymousId()Get active AnonymousID
onecy.reset()Alias for logout()

Parameter Reference

ParameterTypeRequiredDescription
anonymousIdstringAuto ✅Auto by SDK. For cURL, generate UUID v4.
eventstring✅ (track)Event name, e.g. "purchase"
customerIdstring— (identify)Known customer ID. Links anonymous visitor to an existing or new profile.
emailstringCustomer email (profile data)
namestringCustomer name
companystringCompany name
phonestringPhone number (profile data)
channelstringSource: "web", "mobile"
attributesobjectExtra customer data (merged)
propertiesobjectExtra event data

💡 Contoh Penggunaan

🛒

Toko Online (E-Commerce)

lihat_produktambah_keranjangcheckoutpembayaran

Track setiap langkah belanja. Bahkan sebelum login, aktivitas tercatat via anonymousId. Buat funnel untuk lihat drop-off.

Cara menggunakan di Onecy Flow:
1. Tanam SDK di website toko — pengunjung langsung mendapat AnonymousID unik, aktivitas tercatat otomatis. 2. Track event di setiap langkah: lihat_produk, tambah_keranjang, checkout, pembayaran. 3. Panggil onecy.identify({ fixedId: email, email, name }) saat checkout — kirim fixedId untuk membuat FixedProfile baru atau menghubungkan ke profil yang sudah ada. 4. Buat Funnel di menu Funnels: lihat_produk → tambah_keranjang → checkout → pembayaran — lihat di mana pelanggan berhenti (drop-off). 5. Buka Retention untuk melihat berapa pelanggan yang beli lagi bulan depan. 6. Buat Segmen seperti "pelanggan yang beli > 3x" atau "checkout tapi belum bayar" di Segments untuk kampanye retargeting. 7. Panggil onecy.logout() saat user logout — AnonymousID baru otomatis dibuat untuk sesi selanjutnya.
🚀

SaaS / Aplikasi

signuponboardingpakai_fiturupgrade

Track aktivasi user baru. Lihat retention. Panggil logout() saat user keluar agar sesi baru mendapat AnonymousID baru.

Cara menggunakan di Onecy Flow:
1. Tanam SDK di aplikasi kamu. Panggil onecy.init() di halaman pertama — pengunjung otomatis mendapat AnonymousID. 2. Panggil onecy.identify({ fixedId: email, name, email }) saat user mendaftar atau login — kirim fixedId untuk membuat FixedProfile atau menghubungkan ke yang sudah ada. 3. Track milestone: onboarding_selesai, pakai_fitur, upgrade. 4. Buat Funnel: signup → onboarding_selesai → pakai_fitur → upgrade untuk melihat di mana user berhenti. 5. Buka Retention dengan event "signup" sebagai awal — berapa user yang kembali minggu ke-2, ke-3, dst? 6. Buat segmen "power users" (misal "pakai 5+ fitur") di Segments untuk dianalisis lebih lanjut. 7. Panggil onecy.logout() saat user keluar — sistem otomatis membuat AnonymousID dan Profile baru untuk sesi selanjutnya.
🎯

Marketing Campaign

klik_iklanlanding_pageisi_formjadi_lead

Track performa campaign. Funnel dari klik iklan sampai jadi lead. Bandingkan channel.

Cara menggunakan di Onecy Flow:
1. Tanam SDK di landing page. Pengunjung dari iklan langsung mendapat AnonymousID dan terlacak otomatis. 2. Track setiap langkah: onecy.track({ event: 'klik_iklan', properties: { channel: 'google_ads', campaign: 'promo_juni' } }). 3. Panggil onecy.identify({ fixedId: email, email, name, phone }) saat pengunjung mengisi form lead — kirim fixedId untuk membuat FixedProfile permanen. 4. Buat Funnel: klik_iklan → lihat_landing_page → isi_form → jadi_lead. 5. Bandingkan channel di Insights: filter berdasarkan channel untuk lihat campaign mana yang paling efektif (Google Ads vs Instagram vs Email). 6. Buat Segmen seperti "lead dari Google Ads" vs "lead dari Instagram" di Segments untuk perbandingan kualitas lead.
👤

Membership / Loyalty

daftar_memberkunjungantukar_poinperpanjang

Track loyalitas member. Lihat retention per bulan. Segmen member yang hampir expired.

Cara menggunakan di Onecy Flow:
1. Panggil onecy.identify({ fixedId: email, name, email, attributes: { tier: 'gold', poin: 500 } }) saat member mendaftar — FixedProfile otomatis dibuat dengan fixedId yang dikirim. 2. Track aktivitas member: kunjungan, tukar_poin, perpanjang. 3. Buka Retention — berapa persen member yang aktif kembali per bulan? 4. Buat segmen "member yang belum kunjungan 30 hari" atau "member expired bulan depan" di Segments untuk kirim reminder. 5. Buat Dashboard khusus dengan widget: total member aktif, rata-rata kunjungan/bulan, dan top member paling loyal. 6. Buat funnel: reminder_email → buka_halaman → perpanjang untuk lihat efektivitas kampanye retensi. 7. Panggil onecy.logout() di perangkat shared agar member berikutnya mendapat AnonymousID baru.