CTWA Clid: Arti ctwa_clid, Asalnya, dan Cara Dalekta Menyimpannya

01ctwa_clid adalah ID klik, bukan ID iklan

Setiap kali seseorang mengetuk iklan Click to WhatsApp (CTWA) di Instagram atau Facebook, Meta membuat satu pengenal untuk klik itu. Pengenal tersebut adalah ctwa_clid, singkatan dari Click to WhatsApp click ID. Jadi ctwa_clid adalah pengenal untuk satu klik, bukan untuk satu iklan: dua orang yang mengetuk iklan yang sama mendapat dua ctwa_clid berbeda, sementara ID iklannya sama. Dokumentasi Meta menggambarkannya sebagai pengenal personal yang unik per klik.

Meta tidak mendokumentasikan format maupun panjangnya, jadi perlakukan sebagai token yang tidak perlu ditafsirkan: simpan apa adanya, jangan dipotong, dan jangan menebak polanya. Tabel berikut membedakan ctwa_clid dari pengenal lain yang sering tertukar di iklan ke WhatsApp.

Pembahasan fbclid dan parameter URL untuk alur landing page ada di UTM tracking WhatsApp. Untuk gambaran besar dari klik iklan sampai closing, mulai dari pilar tracking closing WhatsApp dari iklan.

02Dari mana ctwa_clid berasal dan bagaimana sampai ke bisnis

1. Calon customer mengetuk tombol iklan CTWA. Meta membuat ctwa_clid untuk klik itu.
2. WhatsApp membuka chat ke nomor bisnis, lalu calon customer mengirim pesan pertamanya.
3. Saat pesan sampai, data iklan ikut bersama isi pesan. Di WhatsApp Cloud API, data itu berupa objek referral pada webhook pesan.
4. Sistem penerima membaca dan menyimpan ctwa_clid saat pesan tiba. Meta menyarankan menyimpannya bersama percakapan, karena ID ini dipakai lagi nanti untuk melaporkan konversi.
5. Bila Anda melaporkan konversi lewat Conversions API for Business Messaging, ID yang tersimpan dikirim bersama event, misalnya saat closing, supaya konversi itu terhubung ke klik yang benar.

Berikut bentuk potongan webhook pesan yang membawa referral. Semua nilai adalah placeholder ilustrasi, bukan data nyata.

{
  "object": "whatsapp_business_account",
  "entry": [{
    "changes": [{
      "field": "messages",
      "value": {
        "contacts": [{ "wa_id": "<nomor pengirim>", "profile": { "name": "<nama profil>" } }],
        "messages": [{
          "id": "wamid.<id pesan>",
          "from": "<nomor pengirim>",
          "type": "text",
          "text": { "body": "Halo, mau tanya paket layanan" },
          "referral": {
            "source_url": "<URL iklan>",
            "source_id": "<ID iklan>",
            "source_type": "ad",
            "headline": "Konsultasi Gratis 15 Menit",
            "body": "Tanya paket layanan, kami balas hari ini.",
            "media_type": "image",
            "ctwa_clid": "<ctwa_clid dari Meta>"
          }
        }]
      }
    }]
  }]
}

Di Dalekta, source_id menjadi ID sumber atau iklan, headline menjadi judul iklan, body menjadi isi iklan, dan ctwa_clid menjadi CTWA click ID. Dalekta memetakan data ini ke field lead yang sama dari dua jalur. Untuk session yang terhubung lewat QR, Dalekta membaca konteks iklan yang menempel pada pesan masuk. Untuk WhatsApp Cloud API, yang masih pilot terbatas, Dalekta membaca objek referral dari webhook. Isi konteks iklan di session QR bergantung pada apa yang WhatsApp sertakan di pesan, jadi click ID bisa kosong walau ID sumber terisi.

03Apa yang bisa dilakukan dengan ctwa_clid

• Membedakan satu klik dari klik lain. ID iklan menunjuk iklan mana, sedangkan ctwa_clid membedakan klik yang satu dari klik lain pada iklan yang sama. Dua chat dari iklan yang sama punya ctwa_clid berbeda.
• Memasangkan konversi ke klik saat dikirim ke Meta. Ini kegunaan yang didokumentasikan Meta untuk Conversions API for Business Messaging: bisnis menyimpan ctwa_clid bersama percakapan, lalu mengirimkannya bersama event ketika konversi terjadi.
• Bukti bahwa chat datang dari iklan. Chat dengan ctwa_clid terisi berasal dari klik pada iklan CTWA. Untuk mengetahui iklan yang mana, cocokkan ID sumber (source_id) pada lead dengan ID iklan di Ads Manager. ctwa_clid sendiri tidak bisa dicari di Ads Manager.

Bentuk event untuk jalur business messaging berbeda dari event CAPI untuk website. Contoh berikut mengikuti struktur di dokumentasi Meta, dengan nilai placeholder ilustrasi. Nama event, izin token, dan syarat dataset mengikuti dokumentasi Meta terbaru.

{
  "data": [{
    "event_name": "Purchase",
    "event_time": 1790000000,
    "action_source": "business_messaging",
    "messaging_channel": "whatsapp",
    "user_data": {
      "whatsapp_business_account_id": "<ID WhatsApp Business Account>",
      "ctwa_clid": "<ctwa_clid yang tersimpan di lead>"
    },
    "custom_data": { "currency": "IDR", "value": 1500000 }
  }]
}

Dua catatan dari dokumentasi Meta untuk jalur ini. Pertama, ia punya prasyarat tersendiri, termasuk dataset yang dibuat lewat Dataset API dan izin token tertentu. Kedua, Meta menyatakan tidak membantu deduplikasi event di jalur ini, jadi Anda perlu memastikan satu tahap dikirim satu kali per percakapan sebelum mengirim. Halaman dokumentasinya juga tidak menyebut batas waktu antara klik dan event, jadi jangan berasumsi ada jendela waktu tertentu.

04Bagaimana Dalekta menyimpan ctwa_clid

Dalekta membaca ctwa_clid dari pesan masuk yang membawa metadata iklan dan menyimpannya bersama field CTWA lain di lead. Alur pembuatan lead CTWA, dari pesan pertama sampai status Masuk WA, dijelaskan di CTWA tracking. Bagian ini fokus pada apa yang terjadi dengan ID-nya.

Satu lead menyimpan satu nilai ctwa_clid. Jika kontak yang sama mengetuk iklan lagi dan pesannya kembali membawa metadata, field CTWA pada lead yang sama dapat terisi ulang dengan nilai terbaru, sementara tipe sumber dan atribusi campaign lead tetap mengikuti chat pertama. Akibatnya ctwa_clid dan ID sumber di panel CTWA bisa berbeda dari iklan yang pertama kali membuat lead itu. Baca nilainya sebagai klik iklan terakhir yang terbaca, bukan riwayat semua klik.

05Cara memeriksa ctwa_clid di lead Anda

1. Pastikan nomor tujuan iklan adalah session WhatsApp Dalekta yang berstatus connected. Langkahnya ada di dokumentasi WhatsApp Session.
2. Buka iklan CTWA yang sedang tayang dari akun Facebook atau Instagram pribadi, bukan lewat pratinjau di Ads Manager. Ketuk tombol WhatsApp, lalu kirim pesan dari nomor yang berbeda dengan nomor tujuan.
3. Buka halaman Leads dan cari lead terbaru. Kodenya biasanya berformat CTWA-XXXXX.
4. Buka detail lead dan cari panel Atribusi CTWA. Periksa baris CTWA click ID dan ID sumber atau iklan, lalu cocokkan ID sumber dengan ID iklan yang Anda ketuk di Ads Manager.
5. Ulangi dari penempatan iklan yang berbeda bila Anda memakai lebih dari satu. Baris yang kosong tidak ditampilkan, jadi bila baris CTWA click ID tidak ada tetapi ID sumber terisi, click ID tidak terbaca pada chat itu. Penyebabnya bisa penempatan WhatsApp Status, atau jalur koneksi session yang tidak meneruskan click ID. Bila panel Atribusi CTWA tidak muncul sama sekali, chat itu tidak terbaca membawa metadata iklan.

06Bacaan lanjutan

07Pertanyaan umum