# WhatsApp'a Tıkla Reklam İlişkilendirmesi Meta (Facebook/Instagram) "WhatsApp'a Tıkla" reklamları yayınlıyorsanız, Your AI Connector her bir WhatsApp potansiyel müşterisinin hangi reklamdan geldiğini size söyleyebilir ve gerçek dönüşümleri Meta'ya geri raporlamak için ihtiyacınız olan Meta tıklama tanımlayıcısını size sunabilir. Bu, reklam kampanyalarınızın sadece "sohbet başlatan kişiler" için değil, gerçek satışlar ve rezervasyonlar için optimize edilmesini sağlar. --- ## Neler Yakalanır Birisi bir WhatsApp'a Tıkla reklamına dokunup işletmenize mesaj gönderdiğinde, Meta bu ilk mesaja gizli bir yönlendirme bilgisi ekler. Your AI Connector bunu otomatik olarak okur ve kişi üzerinde saklar. Herhangi bir kurulum veya yapılandırma gerekmez; sadece gerçekleşir. Yakalanan bilgiler kişi üzerinde `ad_referral` olarak saklanır ve şunları içerir: | Alan | Nedir | |---|---| | `ctwa_clid` | Meta tıklama tanımlayıcısı. Bu, bir alt dönüşümü tam olarak reklam tıklamasına geri ilişkilendirmek için Meta'nın Dönüşüm API'sine gönderdiğiniz değerdir. Organik gönderi yönlendirmeleri için boştur (aşağıya bakın). | | `source_id` | Kişinin tıkladığı reklamın (veya gönderinin) kimliği. | | `source_type` | `ad` (ücretli bir WhatsApp'a Tıkla reklamı) veya `post` (organik bir Facebook/Instagram gönderisi). | | `source_url` | Reklam içeriğiyle ilişkili bağlantı. | | `headline` | Reklamın başlık metni. | | `body` | Reklamın gövde metni. | | `channel` | Yönlendirmenin geldiği kanal (şu anda her zaman `whatsapp`). | | `captured_at` | Yönlendirmenin kişi üzerinde ilk kaydedildiği zaman. | Bunu, bir kişi için özel bir alan yapılandırdıysanız kişinin [hızlı görünüm panelinde](../get-started/creating-contacts.md) görebilir veya doğrudan web kancaları ve API aracılığıyla okuyabilirsiniz (aşağıya bakın) — Kişiler tablosunda kendi etiketli alanı olarak ayrılmamıştır. > **Payload'un size söylemediği bir şey:** görüşmenin hangi numaranız üzerinden geldiği. İçerisinde herhangi bir sayfa kimliği veya WhatsApp İşletme Hesabı kimliği bulunmaz. Tek bir numara kullanıyorsanız bu önemli değildir; ancak farklı Facebook Sayfalarında birden fazla numara çalıştırıyorsanız, bunu kendi tarafınızda eşleştirmeniz gerekecektir. --- ## Hangi Bağlantıda Çalışır > Bu, **yalnızca resmi WhatsApp API bağlantısında** çalışır. Meta, yapılandırılmış yönlendirme bilgilerini ( `ctwa_clid` dahil) yalnızca resmi WhatsApp Business API aracılığıyla iletir. **Resmi olmayan WhatsApp (web) bağlantısı bunu almaz** — çalışma şekli gereği, bu bağlantıda herhangi bir reklam tıklama verisi mevcut değildir. Bu nedenle, kapalı döngü reklam ilişkilendirmesi sizin için önemliyse, WhatsApp'a Tıkla kampanyalarınızı resmi WhatsApp API aracılığıyla bağlanan bir numara üzerinden yürütün. --- ## İlk Temas Davranışı Yönlendirme, bir kişinin bir reklamdan gönderdiği **ilk** mesajda yakalanır. Aynı kişi daha sonra farklı bir reklama tıklarsa ve bu yeni tıklama bir tıklama tanımlayıcısı taşıyorsa, saklanan `ad_referral` yenilenir, böylece tıklama kimliği raporlama için güncel kalır. Organik gönderi yönlendirmeleri (hiçbir `ctwa_clid` içermeyenler), daha önce yakalanmış bir ücretli reklam tıklama kimliğinin üzerine asla yazılmaz. --- ## Verileri Meta veya Google Ads'e Aktarma Your AI Connector ilişkilendirme verilerini yakalar ve gösterir, ancak bugün itibarıyla dönüşümleri sizin yerinize yerel olarak Meta veya Google'a göndermez. Verileri web kancaları (webhooks) ve bir otomasyon aracı kullanarak iletirsiniz. `ad_referral` nesnesi, giden [web kancası](webhooks.md) etkinliklerinin `contact` bölümüne dahil edilir (örneğin Yeni Mesaj, Kişi Devam Etti, Kişi Etiketleri Güncellendi ve Randevu Alındı gibi analiz etkinlikleri). Tipik bir kapalı döngü kurulumu: 1. Bir potansiyel müşteri, WhatsApp'a Tıkla reklamınıza tıklar ve size mesaj gönderir. Your AI Connector, kişi üzerinde `ad_referral` ( `ctwa_clid` dahil) kaydeder. 2. Potansiyel müşteri ilerleme kaydettikçe (arama rezervasyonu yaptı, müşteri oldu, kaybedildi), bu sonucu işaretlersiniz (aşağıdaki "Huni aşamasını taşıma" bölümüne bakın). 3. Bir web kancası, hem sonucu hem de kişinin `ctwa_clid` bilgisini taşıyarak otomasyon aracınıza (Zapier, Make veya Pabbly) tetiklenir. 4. Otomasyon aracınız, dönüşümü raporlamak için Meta'nın Dönüşüm API'sini (`action_source = business_messaging` ve `ctwa_clid` kullanarak) veya Google Ads'i (Çevrimdışı Dönüşüm İçe Aktarma / Potansiyel Müşteriler için Gelişmiş Dönüşümler) çağırır. Bu sayede Meta ve Google, hangi reklamların gerçek sonuçlar ürettiğini öğrenir ve bunları optimize eder. --- ## Huni Aşamasını Taşıma Bir dönüşümü bildirmek için genellikle iki şeye ihtiyacınız vardır: tıklama kimliği (otomatik olarak yakalanır) ve sonuç (sizin belirlediğiniz). Bir sonuç eklemenin en güvenilir yolu **etiketler** kullanmaktır, çünkü bir etiket uygulamak `contact_tags_updated` web kancasını tetikler ve bu yük, kişinin `ad_referral` bilgisini içerir. (Bir etiketi kaldırmak bunu tetiklemez; bkz. [Kişi Etiketleri Güncellendi](webhooks.md#contact-tags-updated-webhook).) Etiketleri otomatik olarak uygulayabilirsiniz: - Yapay Zeka Temsilcinizin görüşme sırasında kişiyi etiketlemesini sağlayın — temsilcinin yapılandırmasında otomatik etiketleme kuralları oluşturun. Kaynağı kendiniz etiketlemek istiyorsanız, "reklam başına bir açılış sayfası → bir giriş mesajı → bir etiket" düzeni bu şekilde çalışır. - Veya Sohbetler veya Kişiler sayfasından manuel olarak etiketleyin. İlgili bir etiket her değiştiğinde, webhook tıklama kimliği eklenmiş olarak tetiklenir ve dönüşüm olarak iletilmeye hazır hale gelir. Webhook URL'si, Ayarlar'da değil, kişinin ait olduğu temsilcinin (veya kampanyanın) **Etiketler** sekmesinde, etiketin kendisi üzerinde ayarlanır. Her etiket kendi URL'sine sahiptir ve her şeyi tek bir yerden almak isterseniz hepsi aynı uç noktayı işaret edebilir. ### Zaten kaçırdığınız bir tıklama kimliğini okuma `ad_referral`, API tarafından hem `GET /v1/contacts/{id}` ( `adReferral` olarak) hem de kişi listesi uç noktasında (`ad_referral` olarak) döndürülür; bu nedenle alıcınız kapalıysa veya sonradan mutabakat yapıyorsanız, bir sonraki webhook'u beklemek yerine tıklama kimliğini geri okuyabilirsiniz. Üzerlerine tıklama kimliği kaydedilmeden önce gelen kişilerin burada `null` değeri bulunur; değer yalnızca gelen mesajın kendisinden yakalanabildiği için geriye dönük olarak doldurulabilecek bir şey yoktur. --- ## Sınırlamalar - Yalnızca resmi WhatsApp API bağlantısı (resmi olmayan web bağlantısı değil). - Henüz yerel, tek tıkla Meta CAPI veya Google Ads entegrasyonu yok; verileri Zapier/Make/Pabbly aracılığıyla iletiyorsunuz. Yerel bir entegrasyon isterseniz, destek ekibine hi@youraiconnector.com adresinden bildirin. - İlişkilendirme, bu canlıya geçtiği andan itibaren ileriye dönük olarak yakalanır. Daha önce gerçekleşmiş konuşmalar için geriye dönük veri doldurulamaz. --- ## Sonraki Adımlar - [Web kancaları](webhooks.md) — tam yükü ve hangi etkinliklerin `ad_referral` içerdiğini görün. - [Kişileri Etiketlemek İçin Etiketleri Kullanma](../get-started/creating-tags.md) — huni aşamalarınızı taşıyan etiketleri ayarlayın.