# 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:
| Bidang | Apa itu |
|---|---|
| `ctwa_clid` | Pengenal klik Meta. Ini adalah nilai yang Anda kirim ke API Konversi Meta untuk mengaitkan 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 (saat ini selalu `whatsapp`). |
| `captured_at` | Kapan rujukan pertama kali dicatat pada kontak. |
Anda dapat melihat ini pada [panel tampilan cepat](../get-started/creating-contacts.md) 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](webhooks.md) 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](webhooks.md#contact-tags-updated-webhook).)
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](webhooks.md) — lihat payload lengkap dan peristiwa mana yang menyertakan `ad_referral`.
- [Menggunakan Tag untuk Melabeli Kontak](../get-started/creating-tags.md) — atur tag yang membawa tahapan corong Anda.