Skip to content

Event contract and examples ​

Butics memiliki 10 event names. Jenis banner, menu, card, tab dan CTA adalah variasi komponen—bukan event name baru. Daftar ini adalah kemampuan runtime; bukan jaminan semua komponen di semua halaman telah memasang setiap event.

Shared envelope ​

Browser mengirim { "events": [event, ...] } ke /api/tracking/events. Setiap contoh pada halaman event di bawah adalah satu objek di dalam array itu, dengan ID sintetis.

FieldTipeKewajiban dan cara baca
schema_versionintegerRequired, saat ini 1; versi kontrak payload
config_versionintegerRequired; versi pengaturan CMS saat event dibuat
event_idUUID stringRequired; satu event, retry tidak membuat ID baru
anonymous_id, session_id, page_view_idUUID stringRequired; tiga level identitas berbeda
occurred_atISO timestamp UTCRequired; jam browser saat aksi, bukan waktu load BigQuery
event_nameenum stringSalah satu dari 10 nama berikut
page_keyenum stringTipe halaman terdaftar, bukan URL bebas
page_entity_idID stringRequired untuk detail/jenis konten tertentu seperti PDP/artikel/klinik; opsional pada Home
component_idID stringRequired untuk event komponen; tidak dikirim pada page_view
entity_idID stringOpsional; item banner/FAQ/card, sesuai implementasi
ga_client_id, ga_session_idstringOpsional, harus valid sebagai pasangan jika dikirim
bm_click_idUUID stringKhusus klik WA yang dipersiapkan melalui journey
acquisitionobjectOpsional, hanya lima field UTM yang diizinkan
analytics_consentbooleanRequired; baca bersama collection_mode
collection_modeenum stringRuntime sekarang automatic; explicit untuk kompatibilitas
propertiesobjectRequired; hanya field yang diizinkan untuk event tersebut

ID komponen/item: 1–96 karakter, diawali alphanumeric, selanjutnya alphanumeric, _, ., :, -. page_entity_id adalah ID record, bukan judul bebas.

Event catalog ​

EventMaknaVariasi / parameter
page_viewHalaman/navigation teramatiproperties={}
component_impressionElemen terlihat sesuai thresholdposition opsional untuk item
component_clickTombol/card/menu/link diklikdestination_type: internal, external, whatsapp, bbc, maps
carousel_navigationPengunjung memindah slidetrigger swipe/arrow/indicator; direction next/previous; position
accordion_openPanel accordion dibukaentity_id item; position opsional
tab_selectTab dipilihentity_id/position bila dipasang
article_scrollMilestone scroll artikeldepth_percent 25/50/75/90; hanya page_key article
page_scrollMilestone scroll halamandepth_percent 25/50/75/90
search_submitForm pencarian dikirimTidak ada search keyword
form_submit_resultHasil submit aplikasi diketahuistatus success/validation_error/server_error

position adalah indeks 0-based, integer 0–10000; bukan judul item. Field tersebut diizinkan pada event selain page_view, tetapi tidak wajib selalu tersedia. Property yang tidak relevan harus tidak dikirim, bukan diisi string kosong atau object bebas.

From JSON to columns ​

Di raw, envelope tersimpan pada payload JSON. Di staging_butics.stg_events, field umum dijadikan kolom SQL dan properties dipilih satu per satu:

PayloadKolom staging/core
properties.depth_percentdepth_percent integer
properties.triggerinteraction_trigger
properties.statusform_status
properties.positionposition integer
properties.destination_typedestination_type
properties.directiondirection
acquisition.utm_campaignutm_campaign
bm_click_idwhatsapp_click_id

NULL pada depth_percent untuk event klik adalah normal. NULL pada anonymous_id bukan normal. Query harian memakai DATE(occurred_at,'Asia/Jakarta'); received_at dipakai untuk menilai keterlambatan pengiriman.

GA representation ​

Contoh mirror GA setelah export (disederhanakan; bukan request collector):

json
{
  "event_name": "bm_component_click",
  "event_timestamp": 1789785600000000,
  "user_pseudo_id": "123456789.1789785000",
  "event_params": [
    {"key":"bm_event_id","value":{"string_value":"00000000-0000-4000-8000-000000000001"}},
    {"key":"ga_session_id","value":{"int_value":1789785000}},
    {"key":"page_key","value":{"string_value":"pdp"}},
    {"key":"component_id","value":{"string_value":"btn-product-order-example"}}
  ]
}

GA memakai array key/value dengan tipe nilai. staging_ga.stg_events mengekstrak parameter yang dipakai core. Tidak semua property Butics telah diproyeksikan ke staging_ga; untuk detail depth/position gunakan Butics atau raw GA jika perlu. bm_event_id adalah kunci matching, bukan event_timestamp.

Bumame Engineering · Butics — Butech Analytics