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.”

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:

Anda dapat melihat ini pada panel tampilan cepat kontak jika Anda telah mengonfigurasi bidang kustom untuknya, atau membacanya secara langsung melalui webhook dan API (lihat di bawah) — ini tidak dipisahkan sebagai bidang berlabel tersendiri di 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.

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.

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, tetapi saat ini tidak secara bawaan mengirimkan konversi ke Meta atau Google untuk Anda. Anda meneruskan data tersebut 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 dari agen (atau kampanye) tempat kontak tersebut berada — 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).
• Belum ada integrasi Meta CAPI atau Google Ads asli sekali klik — Anda meneruskan data melalui Zapier/Make/Pabbly. Jika Anda menginginkan integrasi asli, beri tahu dukungan di hi@youraiconnector.com.
• Atribusi ditangkap mulai saat ini, sejak fitur ini aktif. Atribusi tidak dapat diisi kembali ke percakapan yang terjadi sebelumnya.

Langkah Selanjutnya #

• Webhook — lihat payload lengkap dan peristiwa mana yang menyertakan ad_referral.
• Menggunakan Tag untuk Melabeli Kontak — atur tag yang membawa tahapan corong Anda.