Skip to content

How tracking works ​

From CMS to a recorded event ​

  1. Engineer memasang kemampuan event pada UI dan mendaftarkan konfigurasi yang didukung Go.
  2. Editor menyimpan Tracking ID, label dan switch event di CMS. Tombol konten dan pengaturan Analytics disimpan melalui form yang berbeda.
  3. Next.js mengambil konfigurasi publik. Tracking hanya berjalan bila global, halaman dan event komponen aktif.
  4. Runtime membuat/menggunakan browser ID, session ID dan page-view ID. Halaman detail menunggu identitas record CMS tersedia.
  5. Listener merekam aksi, memvalidasi parameter, lalu mengantrekan envelope event. Batch dikirim ke POST /api/tracking/events; flush berkala 5 detik dan saat halaman disembunyikan/ditinggalkan. Antrean memory bukan penyimpanan offline permanen.
  6. Proxy website meneruskan ke collector Go. Go memvalidasi schema, ID, konfigurasi, tipe event dan parameter; nama field arbitrer ditolak. Event disimpan idempotent berdasarkan event ID.
  7. Exporter memasukkan event ke BigQuery. Dataform memproses raw → staging → core. Metabase membaca tabel hasilnya.
  8. Di sisi browser, GA bridge mengirim event bm_* dengan bm_event_id yang sama. GA export berjalan melalui jalur Google yang terpisah sebelum digabungkan.

CMS controls the Butics and GA pipelines before event matching in core_master_analytics.

Open full-size diagram

Special path: WhatsApp ​

WhatsApp journey: a click creates a reference; only a sent message with matching code becomes a confirmed chat.

Open full-size diagram

  1. Pengunjung menekan CTA yang terkonfigurasi sebagai WA.
  2. Runtime menyiapkan component_click, destination_type=whatsapp, dan UUID bm_click_id.
  3. Journey endpoint menyimpan event dan referensi CRM dalam satu transaksi. Ini bukan klik biasa yang kemudian ditebak hubungannya.
  4. Tujuan WhatsApp memuat kode pendek generated_code, misalnya [Ab12C]. UUID panjang tidak perlu ditampilkan pada pesan.
  5. Pengunjung masih harus mengirim pesan. Pengguna bisa menutup aplikasi atau menghapus kode.
  6. Pipeline Yellow/CRM kemudian mencocokkan crm_utm_info_id, kode, dan keberadaan [kode] di pesan. Baru setelah itu ada baris fact_enrichment_whatsapp_message_links.
  7. Profiling menghubungkan akun Yellow ke customer yang terkonfirmasi. Main marketing menyediakan transaksi dan kredit atribusi.

health.bumame.com/cs tidak membawa identitas dengan sendirinya. Website menggunakan konfigurasi target/template yang dikenali untuk mempersiapkan journey sebelum redirect. Membuka link itu langsung di luar website tidak otomatis menghasilkan identitas Butics dari halaman sebelumnya. Parameter Google _gl bukan bm_click_id.

UTM precedence and limitations ​

Butics mengambil utm_source, utm_medium, utm_campaign, utm_term, utm_content yang lolos validasi. Campaign yang tersedia disimpan bersama session. Ketika journey WA disiapkan, parameter default link CTA dilengkapi/ditimpa acquisition session yang sudah diketahui. Konfigurasi target dan override server juga perlu diperiksa; jangan menganggap setiap parameter pada link selalu menjadi nilai akhir.

Pada PDP, utm_content dapat berupa /product/<slug> yang lolos allowlist. Jangan memasukkan query string atau data pasien. UTM bukan primary key: banyak pengguna dapat memiliki campaign yang sama. Join perjalanan menggunakan ID event/session/journey.

Automatic collection ​

Runtime website saat ini memakai collection_mode=automatic, analytics_consent=false. Nilai false berarti tidak ada bukti izin eksplisit, bukan event invalid. Data historis mode explicit masih diterima bila consent true. Jangan memfilter hanya consent=true. Switch CMS tetap berlaku. Jangan membuat popup atau mengubah kebijakan pengumpulan sebagai bagian dari penambahan komponen.

Expected delays and missing data ​

Raw collector, GA export, Dataform dan Metabase tidak selalu diperbarui pada detik yang sama. Periksa freshness sebelum menyimpulkan bug. Reload/close sangat cepat, jaringan gagal, storage diblokir atau GA diblokir dapat menimbulkan selisih. Tidak ada telemetry yang membuktikan seluruh pengunjung internet tercatat 100%.

Bumame Engineering · Butics — Butech Analytics