Your AI Connector Docs

Atribusi Iklan Click-to-WhatsApp

Jika Anda menjalankan iklan “Klik ke WhatsApp” Meta (Facebook/Instagram), Your AI Connector dapat memberi tahu Anda dari iklan mana setiap prospek WhatsApp berasal — dan memberikan pengenal klik Meta yang Anda perlukan untuk melaporkan konversi nyata kembali ke Meta. Hal ini memungkinkan kampanye iklan Anda dioptimalkan untuk penjualan dan pemesanan yang sebenarnya, bukan hanya untuk “orang yang memulai obrolan.”

Ingin menjalankan iklan ke halaman di situs web Anda sendiri dengan tombol WhatsApp? Lihat Atribusi klik iklan untuk WhatsApp.


Apa yang Ditangkap

Saat seseorang mengetuk iklan Klik-ke-WhatsApp dan mengirim pesan ke bisnis Anda, Meta melampirkan informasi rujukan tersembunyi ke pesan pertama tersebut. Your AI Connector membacanya secara otomatis dan menyimpannya pada kontak. Tanpa pengaturan, tanpa konfigurasi — itu terjadi begitu saja.

Informasi yang ditangkap disimpan pada kontak sebagai ad_referral dan berisi:

Bidang Penjelasan
ctwa_clid Pengidentifikasi klik Meta. Ini adalah nilai yang Anda kirim ke Conversions API Meta untuk mengatribusikan konversi hilir kembali ke klik iklan yang tepat. Kosong untuk rujukan postingan organik (lihat di bawah).
source_id ID iklan (atau postingan) yang diklik orang tersebut.
source_type Entah ad (iklan Click-to-WhatsApp berbayar) atau post (postingan Facebook/Instagram organik).
source_url Tautan yang terkait dengan konten iklan.
headline Teks utama iklan.
body Teks isi iklan.
channel Saluran tempat rujukan tiba: whatsapp, instagram atau messenger.
captured_at Kapan rujukan pertama kali dicatat pada kontak.

Anda dapat melihatnya tanpa pengaturan apa pun: halaman kontak menampilkan label Berasal dari iklan di bawah nama mereka (arahkan kursor ke label tersebut untuk melihat detail iklan), panel kontak di samping obrolan juga menampilkannya, dan Aktivitas kontak dimulai dengan ketukan iklan. Anda juga dapat membacanya melalui webhook dan API (lihat di bawah). Ini bukan kolom dalam tabel Kontak.

Satu hal yang tidak diberitahukan oleh payload kepada Anda: nomor mana yang digunakan untuk menerima percakapan tersebut. Tidak ada id halaman atau id Akun WhatsApp Business di dalamnya. Dengan satu nomor, hal itu tidak masalah; jika Anda menjalankan beberapa nomor di Halaman Facebook yang berbeda, Anda perlu memetakannya di sisi Anda.


Prospek yang Masuk Tanpa Nomor Telepon

Beberapa orang yang mengirim pesan kepada Anda dari iklan menyembunyikan nomor telepon mereka di WhatsApp. Dalam kasus tersebut, Meta memberikan id pribadi untuk orang tersebut alih-alih nomor, dan kontak dibuat dengan bidang telepon kosong. Hal ini sudah semestinya. Balasan, jawaban AI, dan tindak lanjut otomatis tetap akan sampai ke orang tersebut, karena Your AI Connector menghubungi mereka melalui id tersebut.

Biarkan bidang telepon kosong pada kontak tersebut. Jangan masukkan nomor bisnis Anda sendiri ke dalamnya: pesan tidak dapat dikirim dari suatu nomor ke nomor itu sendiri, sehingga tindak lanjut otomatis berikutnya akan gagal dan kontak akan dijeda. Your AI Connector kini menolak untuk menyimpan salah satu nomor Anda yang terhubung sebagai nomor telepon kontak. Jika orang tersebut nantinya membagikan nomor mereka, atau mengirim pesan lagi kepada Anda dengan nomor yang terlihat, bidang tersebut akan diisi secara otomatis.


Koneksi Mana yang Mendukung Ini

Ini hanya berfungsi pada koneksi API WhatsApp resmi. Meta hanya mengirimkan informasi rujukan terstruktur (termasuk ctwa_clid) melalui API WhatsApp Business resmi. Koneksi WhatsApp (web) tidak resmi tidak menerimanya — tidak ada data klik iklan yang tersedia pada koneksi tersebut, sesuai dengan cara kerjanya.

Jadi, jika atribusi iklan loop tertutup penting bagi Anda, jalankan kampanye Click-to-WhatsApp Anda melalui nomor yang terhubung via API WhatsApp resmi.


Iklan Click-to-Instagram dan Click-to-Messenger

Iklan yang membuka DM Instagram atau obrolan Messenger dicatat dengan cara yang sama, pada Halaman Facebook dan akun Instagram yang Anda hubungkan dengan kartu Instagram & Messenger. Saat seseorang memulai obrolan dari salah satu iklan tersebut, kontak akan mendapatkan ad_referral dengan channel diatur ke instagram atau messenger, source_type diatur ke ad dan source_id diatur ke ID iklan. Hal itu memberi Anda informasi iklan di balik setiap kontak, sehingga Anda dapat menghitung biaya per pemesanan per iklan.

Beberapa perbedaan dari WhatsApp:

  • Tidak ada ctwa_clid; kolom tersebut kosong. Meta hanya menerbitkan pengenal klik tersebut untuk WhatsApp.
  • headline adalah judul iklan saat Meta mengirimkannya, dan source_url adalah tautan gambar atau video iklan jika ada. body kosong.
  • Jika kontak pertama kali berasal dari satu iklan dan kemudian memulai obrolan dari iklan yang berbeda, ad_referral akan menampilkan iklan yang lebih baru.
  • Kontak iklan Messenger menyertakan iklan mulai 14 Oktober 2026 dan seterusnya. Kontak yang berasal dari iklan Messenger sebelum tanggal tersebut tidak memiliki ad_referral, karena detail iklan tidak dicatat saat itu dan tidak dapat diisi setelahnya.
  • Obrolan Messenger yang dimulai dengan mengetuk tombol Mulai (Get Started) di Halaman tidak dicatat. Hapus tombol Mulai dari Halaman Anda (Meta Business Suite, pengaturan Kotak Masuk) agar orang memulai obrolan dengan mengetik, dan iklan akan dicatat pada pesan pertama mereka.

Perilaku Sentuhan Pertama

Rujukan ditangkap pada pesan pertama yang dikirim kontak dari iklan. Jika kontak yang sama nantinya mengeklik iklan yang berbeda dan klik yang lebih baru tersebut membawa pengenal klik, ad_referral yang tersimpan akan diperbarui sehingga ID klik tetap terkini untuk pelaporan. Rujukan postingan organik (yang tidak memiliki ctwa_clid) tidak akan pernah menimpa ID klik iklan berbayar yang telah ditangkap sebelumnya.


Memasukkan Data ke Meta atau Google Ads

Your AI Connector menangkap data atribusi dan mengeksposnya. Untuk iklan yang mengarahkan orang ke situs web Anda sendiri terlebih dahulu, Your AI Connector dapat mengirimkan hasil ke Meta untuk Anda saat tag diterapkan: lihat Kirim hasil ke Meta. Untuk iklan Click-to-WhatsApp, Anda meneruskan data menggunakan webhook ditambah alat otomatisasi.

Objek ad_referral disertakan dalam bagian contact dari peristiwa webhook keluar (misalnya Pesan Baru, Kontak Dilanjutkan, Tag Kontak Diperbarui, dan peristiwa analitik seperti Janji Temu Dipesan).

Pengaturan loop tertutup yang umum:

  1. Prospek mengeklik iklan Klik-ke-WhatsApp Anda dan mengirim pesan kepada Anda. Your AI Connector mencatat ad_referral (termasuk ctwa_clid) pada kontak tersebut.
  2. Saat prospek berkembang — memesan panggilan, menjadi pelanggan, atau hilang — Anda menandai hasil tersebut (lihat “Membawa tahap corong” di bawah).
  3. Webhook dipicu ke alat otomatisasi Anda (Zapier, Make, atau Pabbly) yang membawa hasil tersebut dan ctwa_clid kontak.
  4. Alat otomatisasi Anda memanggil Conversions API Meta (menggunakan action_source = business_messaging dan ctwa_clid) atau Google Ads (Impor Konversi Offline / Konversi yang Ditingkatkan untuk Prospek) untuk melaporkan konversi.

Dengan cara ini, Meta dan Google mempelajari iklan mana yang menghasilkan hasil nyata dan melakukan pengoptimalan terhadapnya.


Membawa Tahap Corong

Untuk melaporkan konversi, Anda biasanya memerlukan dua hal: id klik (ditangkap secara otomatis) dan hasil (yang Anda tetapkan). Cara paling andal untuk melampirkan hasil adalah dengan tag, karena menerapkan tag akan memicu webhook contact_tags_updated — dan payload tersebut menyertakan ad_referral kontak. (Menghapus tag tidak akan memicunya; lihat Tag Kontak Diperbarui.)

Anda dapat menerapkan tag secara otomatis:

  • Biarkan Agen AI Anda menandai kontak selama percakapan — siapkan aturan penandaan otomatis dalam konfigurasi agen. Beginilah cara pola “satu halaman landas per iklan → satu pesan masuk → satu tag” bekerja jika Anda ingin melabeli sumbernya sendiri.
  • Atau tandai secara manual dari Obrolan atau halaman Kontak.

Setiap kali tag yang relevan berubah, webhook akan terpicu dengan id klik yang terlampir, siap untuk diteruskan sebagai konversi.

URL webhook diatur pada tag itu sendiri, di tab Tags pada editor agen AI tempat kontak tersebut ditugaskan, bukan di Pengaturan. Setiap tag mendapatkan URL-nya sendiri, dan semuanya dapat mengarah ke titik akhir yang sama jika Anda menginginkan satu tempat untuk menerima semuanya.

Membaca id klik yang sudah terlewat

ad_referral juga dikembalikan oleh API pada GET /v1/contacts/{id} (sebagai adReferral) dan titik akhir daftar kontak (sebagai ad_referral), jadi jika penerima Anda sedang tidak aktif, atau Anda melakukan rekonsiliasi setelahnya, Anda dapat membaca kembali id klik tersebut alih-alih menunggu webhook berikutnya. Kontak yang tiba sebelum id klik direkam pada mereka memiliki null di sini — nilainya hanya dapat diambil dari pesan masuk itu sendiri, jadi tidak ada yang dapat diisi secara retroaktif.


Batasan

  • Hanya koneksi API WhatsApp resmi (bukan koneksi web tidak resmi).
  • Fitur bawaan Kirim hasil ke Meta mengirimkan data klik yang direkam oleh skrip situs web; fitur ini tidak mengirimkan ctwa_clid dari iklan Click-to-WhatsApp. Untuk iklan tersebut, dan untuk Google Ads, Anda meneruskan data melalui Zapier/Make/Pabbly. Jika Anda menginginkan integrasi asli, beri tahu dukungan di hi@youraiconnector.com.
  • Atribusi ditangkap ke depan, sejak saat fitur ini aktif. Data tidak dapat diisi kembali ke percakapan yang terjadi sebelumnya.

Langkah Selanjutnya