Appearance
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
| Skenario | Hasil yang diharapkan |
|---|---|
| Buka PDP | page_key=pdp dan product UUID benar |
| Pindah PDP A → B | page_entity_id berubah, page_view_id baru, identitas browser tetap |
| Impression | Tidak terkirim sebelum threshold; sekali per identitas/item/position dalam page visit |
| Klik satu kali | Satu event; tidak ada manual+auto double send |
| Toggle Off | Event tersebut tidak dikirim; fungsi UI tetap berjalan |
| Global/page Off | Tracking terhenti sesuai config |
| ID kosong | Tidak memakai ID parent atau fallback hardcode |
| ID konflik | Ditolak dengan error yang dapat dipahami, tidak memilih record secara acak |
| Edit label | ID tetap, label tersimpan setelah reload |
| Edit ID section | Public binding berubah; event baru memakai ID baru |
| FAQ/tab/carousel | Nama event dan item/position sesuai aksi; autoplay bukan user navigation |
| UTM + WA | Acquisition benar, reference 5 karakter, UUID journey tersimpan |
| Retry | Event ID sama, tidak menambah duplikasi logis |
| GA tidak tersedia | Butics tidak gagal hanya karena callback identitas GA belum ada |
| Form hasil error | Tidak 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
- Uji lokal terhadap environment collector yang jelas. Jangan menyebutnya staging end-to-end jika hanya collector yang staging.
- Dapatkan izin memakai staging yang sedang dipakai engineer lain. Jangan mengganti PDP pengembangan dengan legacy PDP.
- Backup dan jalankan migration yang diperlukan, kemudian backend/config compatible.
- Deploy CMS dan website dengan commit yang disetujui. Verify workflow, container/bundle revision, health dan browser secara terpisah.
- Uji save/reload CMS dengan perubahan label sementara; restore nilai semula dan bandingkan config.
- Uji UI desktop/mobile dan request. Simpan event_id test, bukan data pribadi.
- Tunggu exporter dan Dataform; periksa raw, staging, core, join GA dan Metabase.
- Pisahkan reference prepared, message received, customer matched, dan paid order. Tidak adanya transaksi bukan bukti collector gagal.
- Laporkan hasil, batas verifikasi, rollback point dan source revision. Jangan hapus migration history/backup saat menutup UAT.
Troubleshooting decision tree
| Gejala | Periksa berurutan |
|---|---|
| UI bekerja tetapi tidak ada request | Global/page/component aktif? ID terdaftar? binding di DOM? detail page entity siap? event didukung? |
| Request ditolak | Config version/ID, allowed properties, ID format, origin/environment, timestamp, batch size |
| Raw ada, core belum ada | Freshness exporter/Dataform, hasil workflow/assertion, filter environment/mode, malformed payload |
| Butics ada, GA tidak cocok | bm_event_id pada raw GA, property/hostname, delay export, GA enabled/tag/blocker; jangan join hanya timestamp |
| WA reference ada, message link kosong | Apakah pesan benar-benar dikirim dengan kode? CRM/Yellow sudah teringest? UTM ID+kode sama? |
| Customer link kosong | Profiling sudah refresh? Identitas confirmed? Shared phone/ambiguity sengaja dikeluarkan? |
| Revenue terlalu besar | Apakah order digandakan banyak event/session? Apakah order lama ikut? Model kredit mana yang dipilih? |
| Tracking ID berubah tetapi report lama tetap | Perubahan 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.