> For the complete documentation index, see [llms.txt](https://docs.cekat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cekat.ai/marketing/events.md).

# Events

## Events

Events adalah tempat Anda membuat dan mengelola **custom event**, yaitu event khusus bisnis Anda yang dikirim dari server atau aplikasi Anda sendiri. Contohnya “Trial started” atau “Subscription renewed”. Custom event bisa dipakai di Analytics dan Segmentation, dan bisa dikirim sebagai konversi ke platform iklan.

Cekat menyediakan beberapa SDK siap pakai untuk bahasa pemrograman populer, ditambah opsi HTTP biasa dan prompt untuk coding assistant. Tim developer Anda tinggal memilih yang sesuai.

### Membuka custom event

1. Di top navigation, klik tab Marketing.
2. Di sidebar kiri, klik ikon Events (ikon petir).
3. Klik tab Custom.
4. Pilih event di daftar, misalnya Custom Event Untuk Test.

Detail event punya tiga tab: Overview, Set up, dan Test & activity. Untuk mengubah event, klik Edit. Untuk menghapusnya, klik ikon tempat sampah.

![Gambar 1. Buka tab Custom (1), pilih event (2), buka tab detail (3), atau Edit/hapus event (4).](https://content.gitbook.com/content/ZNZlvyOVkZXyd3pz2Cql/blobs/yRFxAHLtox0AMlqJAwUd/Unknown%20image)

### Membaca detail custom event

Tab Overview menampilkan status event, kapan terakhir diterima, sumbernya (API), dan tipenya (Custom). Di bawahnya ada dua tabel:

* Who it belongs to: data kontak pemilik event. Kirim `phone_number`, `email`, atau keduanya. Minimal satu wajib ada. `contact_name` opsional.
* What this event records: properti event beserta tipe dan key-nya. Semua properti opsional.

Untuk mengirim event ini sebagai konversi ke Meta, TikTok, atau Google, klik Use it to optimise ads.

![Gambar 2. Data kontak yang wajib dikirim (1), properti event (2), dan tombol untuk mengirim event sebagai konversi iklan (3).](https://content.gitbook.com/content/ZNZlvyOVkZXyd3pz2Cql/blobs/7kC5tCXlJgpSSGDpqpK5/Unknown%20image)

### Membuat custom event

1. Klik New event.
2. Di Name, ketik nama event, misalnya “Trial started”.
3. Di Key, ketik key yang akan dikirim server Anda, misalnya `trial_started`.
4. Opsional: isi Description. Deskripsi ini juga membantu coding assistant tahu kapan event harus dikirim.
5. Opsional: klik Add property untuk data yang ingin Anda saring, tampilkan di grafik, atau kirim sebagai nilai konversi, misalnya nominal, paket, atau order ID.
6. Klik Create event.

Properti dicek tipenya saat event diterima, jadi data yang tidak sesuai tipe akan terdeteksi.

![Gambar 3. Isi nama (1), key (2), dan deskripsi (3), tambah properti (4), lalu klik Create event (5).](https://content.gitbook.com/content/ZNZlvyOVkZXyd3pz2Cql/blobs/qxHB2xhLvVkoIv29viL1/Unknown%20image)

### Memasang custom event

Tab Set up berisi panduan mengirim event dari sistem Anda.

1. Di Send this event from your system, pilih SDK sesuai bahasa yang dipakai tim Anda. Jika tidak ada yang cocok, pilih opsi HTTP. Untuk dibuatkan kode oleh coding assistant, pilih opsi prompt AI.
2. Centang Use my API key untuk memakai API key Anda di contoh kode.
3. Ikuti langkah yang muncul: pasang SDK, lalu kirim event tepat setelah aksinya terjadi.

![Gambar 4. Pilih SDK atau cara pengiriman (1), centang Use my API key (2), lalu ikuti langkah pemasangannya (3).](https://content.gitbook.com/content/ZNZlvyOVkZXyd3pz2Cql/blobs/9vhZYEQJp0eFFh6QhXfe/Unknown%20image)

#### Menghubungkan event ke campaign

Langkah Match events to campaigns (direkomendasikan) membuat Cekat tahu iklan atau campaign mana yang membawa pelanggan tersebut. Pilih salah satu:

* Add middleware (paling mudah): tambahkan satu baris sekali saja, dan semua event otomatis terhubung.
* Without middleware: pakai cara ini jika framework Anda tidak tercantum. Visitor ID dibaca dan dikirim sendiri.

![Gambar 5. Match events to campaigns (1). Pilih Add middleware atau Without middleware (2).](https://content.gitbook.com/content/ZNZlvyOVkZXyd3pz2Cql/blobs/ZGhMyTlznosIEQV36748/Unknown%20image)

### Menguji custom event

Sebelum memasang di server, Anda bisa mengirim event uji langsung dari Cekat.

1. Buka tab Test & activity.
2. Ubah contoh JSON di Editable JSON. JSON dicek saat Anda mengetik. Jika sudah benar, muncul pesan “Looks right. Identifiers and property types check out.”
3. Klik Send test event.

Event uji tercatat sebagai event sungguhan pada kontak di payload, sama seperti event dari server Anda. Untuk mengembalikan contoh awal, klik Reset.

![Gambar 6. Buka Test & activity (1) dan ubah payload JSON (2).](https://content.gitbook.com/content/ZNZlvyOVkZXyd3pz2Cql/blobs/2WqtxtsS49lQgCwN0kUc/Unknown%20image)

Recent events menampilkan 10 event terakhir yang diterima. Permintaan yang ditolak tidak disimpan. Klik ikon refresh untuk memperbarui daftar.

![Gambar 7. Pastikan payload valid (1), klik Send test event (2), lalu cek Recent events (3).](https://content.gitbook.com/content/ZNZlvyOVkZXyd3pz2Cql/blobs/P2JbPLnI1OJ13TwSY50M/Unknown%20image)

### Event bawaan

Selain custom event, Cekat juga mencatat event bawaan secara otomatis, tanpa kode tambahan:

* Website: misalnya page view, klik WhatsApp, dan form submitted. Event ini tercatat setelah snippet terpasang di Website tracking.
* Call: booking, pembatalan, dan no-show dari integrasi Calendly.
* Order: order dibuat dan order dibayar.