Skip to content

Testing, release and troubleshooting ​

Before writing code ​

  • [ ] Tulis page type, record ID, UI control, event, parameter, dan tujuan analisis.
  • [ ] Pilih ID konten yang sudah ada atau binding section yang disimpan CMS.
  • [ ] Pastikan tidak ada data pribadi/free text yang ikut dikirim.
  • [ ] Tentukan apakah perubahan membutuhkan Go, migration, CMS, Next.js, dan Dataform.
  • [ ] Catat sumber branch dan commit; pisahkan perubahan fitur lain.

Local tests ​

SkenarioHasil yang diharapkan
Buka PDPpage_key=pdp dan product UUID benar
Pindah PDP A → Bpage_entity_id berubah, page_view_id baru, identitas browser tetap
ImpressionTidak terkirim sebelum threshold; sekali per identitas/item/position dalam page visit
Klik satu kaliSatu event; tidak ada manual+auto double send
Toggle OffEvent tersebut tidak dikirim; fungsi UI tetap berjalan
Global/page OffTracking terhenti sesuai config
ID kosongTidak memakai ID parent atau fallback hardcode
ID konflikDitolak dengan error yang dapat dipahami, tidak memilih record secara acak
Edit labelID tetap, label tersimpan setelah reload
Edit ID sectionPublic binding berubah; event baru memakai ID baru
FAQ/tab/carouselNama event dan item/position sesuai aksi; autoplay bukan user navigation
UTM + WAAcquisition benar, reference 5 karakter, UUID journey tersimpan
RetryEvent ID sama, tidak menambah duplikasi logis
GA tidak tersediaButics tidak gagal hanya karena callback identitas GA belum ada
Form hasil errorTidak ditandai success sebelum API berhasil

Unit test minimum: serializer/patch widget, resolver dan collision Go, validator event/property, route identity, serta dedup/GA mirroring runtime. Jalankan perintah test dari package/repo terkait dan simpan hasil aktual; jangan menyalin jumlah test historis sebagai hasil terbaru.

Inspect one request ​

Di DevTools Network, cari /api/tracking/events atau journey endpoint. Baca envelope menggunakan Event contract. Pastikan ID yang dikirim berasal dari public config/CMS. Inspect request bukan bukti seluruh pipeline: lanjut cek record collector dan BigQuery.

Staging and production release ​

  1. Uji lokal terhadap environment collector yang jelas. Jangan menyebutnya staging end-to-end jika hanya collector yang staging.
  2. Dapatkan izin memakai staging yang sedang dipakai engineer lain. Jangan mengganti PDP pengembangan dengan legacy PDP.
  3. Backup dan jalankan migration yang diperlukan, kemudian backend/config compatible.
  4. Deploy CMS dan website dengan commit yang disetujui. Verify workflow, container/bundle revision, health dan browser secara terpisah.
  5. Uji save/reload CMS dengan perubahan label sementara; restore nilai semula dan bandingkan config.
  6. Uji UI desktop/mobile dan request. Simpan event_id test, bukan data pribadi.
  7. Tunggu exporter dan Dataform; periksa raw, staging, core, join GA dan Metabase.
  8. Pisahkan reference prepared, message received, customer matched, dan paid order. Tidak adanya transaksi bukan bukti collector gagal.
  9. Laporkan hasil, batas verifikasi, rollback point dan source revision. Jangan hapus migration history/backup saat menutup UAT.

Troubleshooting decision tree ​

GejalaPeriksa berurutan
UI bekerja tetapi tidak ada requestGlobal/page/component aktif? ID terdaftar? binding di DOM? detail page entity siap? event didukung?
Request ditolakConfig version/ID, allowed properties, ID format, origin/environment, timestamp, batch size
Raw ada, core belum adaFreshness exporter/Dataform, hasil workflow/assertion, filter environment/mode, malformed payload
Butics ada, GA tidak cocokbm_event_id pada raw GA, property/hostname, delay export, GA enabled/tag/blocker; jangan join hanya timestamp
WA reference ada, message link kosongApakah pesan benar-benar dikirim dengan kode? CRM/Yellow sudah teringest? UTM ID+kode sama?
Customer link kosongProfiling sudah refresh? Identitas confirmed? Shared phone/ambiguity sengaja dikeluarkan?
Revenue terlalu besarApakah order digandakan banyak event/session? Apakah order lama ikut? Model kredit mana yang dipilih?
Tracking ID berubah tetapi report lama tetapPerubahan ID tidak menulis ulang event historis; history config lengkap tidak tersedia

Stable correlation identifiers ​

CMS dan helper aplikasi memakai Butics, dengan dataset *_butics. Event GA bm_*, storage key, bm_event_id dan bm_click_id tidak berubah: semuanya merupakan kontrak korelasi historis. Uji kontinuitas anonymous/session identity, event ingestion, GA bridge, dan WhatsApp setelah perubahan.

Bumame Engineering · Butics — Butech Analytics