WhatsApp için reklam tıklaması ilişkilendirme #

Kendi web sitenizdeki bir sayfaya Meta veya Google reklamları veriyorsanız ve bu sayfada bir WhatsApp butonu varsa, Your AI Connector her bir WhatsApp görüşmesinin hangi reklam tıklamasından geldiğini size söyleyebilir. Web sitenize küçük bir kod parçacığı yapıştırırsınız. Bir ziyaretçi WhatsApp butonunuza tıkladığında, tıklama hatırlanır ve size gönderdikleri ilk mesajla eşleştirilir. Kişi daha sonra geldiği kampanyayı gösterir ve tıklama verileri web kancaları, API ve dilerseniz Meta’ya geri gönderilmek üzere kişiyle birlikte taşınır.

Bu, WhatsApp butonu olan her sayfa için çalışır: bir açılış sayfası, rezervasyon sayfası, fiyat sayfası veya “Cevaplarımı WhatsApp’tan gönder” ile biten bir anket.

Bu sayfa, insanları önce web sitenize yönlendiren reklamlarla ilgilidir. Reklamlarınız doğrudan WhatsApp’ı açıyorsa (Meta’nın “WhatsApp’a Tıkla” reklamları), bu durum WhatsApp’a Tıkla Reklam İlişkilendirme bölümünde bir kod parçacığına gerek kalmadan otomatik olarak ele alınır.

Kurulum #

1. Ayarlar → Reklam tıklaması takibi (Entegrasyonlar grubu) bölümüne gidin.
2. Aç ve kodumu al seçeneğine tıklayın. Hesabınız kendi site anahtarını ve tek satırlık bir kod parçacığını alır.
3. Kodu kopyalayın ve WhatsApp butonu olan her sayfada kapanış </body> etiketinden hemen önce yapıştırın:

<script src="https://api.youraiconnector.com/v1/ad-visit/YOUR_SITE_KEY.js" async></script>

4. İsteğe bağlı: WhatsApp numarası altında, butonlarınızın bağlantı verdiği numarayı yazın. Yalnızca o numaraya giden bağlantılar takip edilir. Sitedeki her WhatsApp bağlantısını takip etmek için boş bırakın.
5. Sorgu numarasının ifadesini seçin (aşağıya bakın) ve Kaydet’e tıklayın. Ayar değişikliğinden sonra web sitenizdeki kodu değiştirmeniz gerekmez.
6. Test edin: sayfanızı üzerinde kampanya etiketi olan bir bağlantıdan açın, örneğin https://yoursite.com/?utm_source=test&utm_campaign=setup-check, kendi WhatsApp butonunuza dokunun ve mesajı gönderin. Sohbetler’de o kişiyi açın: kişi paneli kampanya ile birlikte Bir reklam tıklamasından geldi bilgisini gösterir.

Site anahtarı zaten kodun içindedir. Bir şifre değildir, bu nedenle herkese açık bir sayfada bulunmasında sakınca yoktur.

Kod ne işe yarar #

• Sayfa yüklendiğinde, sayfa adresindeki reklam tıklama kimliklerini ve kampanya etiketlerini (utm_ parametreleri) tarayıcı sekmesinin oturum depolama alanında tutar, böylece ziyaretçi önce başka bir sayfaya bakarsa bunlar orada kalmaya devam eder. Çerez ayarlamaz, başka hiçbir şey yüklemez ve hiçbir şey göndermez.
• Ziyaretçi bir WhatsApp bağlantısına dokunduğunda (wa.me, api.whatsapp.com/send veya whatsapp://send), mesaja sorgu numarasını ekler, ziyareti kaydeder ve dokunmanın normal şekilde WhatsApp’a devam etmesine izin verir.

Dokunmadan önce Your AI Connector adresine hiçbir şey gönderilmez.

Sorgu numarası #

Bir mağazanın veya kliniğin size verdiği referans numarası gibi kısa bir numara, ziyaretçinin WhatsApp mesajına eklenir. Your AI Connector'ın hangi reklam tıklamasının hangi görüşmeye ait olduğunu tam olarak bu şekilde bilmesini sağlar. Bir mesaj şu şekilde görünür:

Hi, I would like to know more.
Enquiry no. 4827

• İfade: Varsayılan olarak “Sorgu no.” şeklindedir. “Rezervasyon ref” veya “Ref” gibi işletmeniz için doğal gelen herhangi bir tek satırlık metni kullanabilirsiniz. Rakam içermez.
• Konum: Kendi son satırında (varsayılan) veya Metnin sonunda. Ayarlar sayfası canlı bir önizleme gösterir.
• Uzunluk: 4 haneli veya siteniz çok yoğunsa 5 haneli.
• Yapay zeka temsilciniz bunu asla görmez ve asla tekrarlamaz. Gelen kutusu, numara dahil tüm mesajı gösterir.

Sorgu numarasını kapatabilirsiniz. Bu durumda eşleştirme yalnızca mesaj metni üzerinden çalışır; dolayısıyla tam olarak aynı metni (örneğin aynı sınav cevaplarını) gönderen iki ziyaretçi birbirinden ayırt edilemez ve bazı tıklamalar eşleştirilemez.

Kendi sınav veya buton kodunuz #

Sayfanız WhatsApp mesajını kendisi oluşturuyorsa (metne cevapları yerleştiren bir sınav veya kendi buton kodunuz), script etiketine data-manual ekleyin:

<script src="https://api.youraiconnector.com/v1/ad-visit/YOUR_SITE_KEY.js" data-manual async></script>

data-manual ile script artık WhatsApp bağlantılarını kendiliğinden değiştirmez. Kendi kodunuz, WhatsApp’ı açmadan hemen önce onu çağırır, böylece her ziyaret bir kez kaydedilir:

• window.ChatAttribution.text(finalText, number), metninizi sorgu numarası eklenmiş şekilde döndürür ve ziyareti kaydeder. Döndürülen metni WhatsApp bağlantınızda kullanın.
• window.ChatAttribution.link(finalText, number) aynı işlemi yapar ve bu metni içeren hazır bir wa.me bağlantısı döndürür. Ayarlardaki WhatsApp numarası altında yer alanı kullanmak için numarayı boş bırakın.

<script>
  function sendAnswers(answers) {
    var text = "Hi, my answers: " + answers.join(", ");
    if (window.ChatAttribution) {
      window.location.href = window.ChatAttribution.link(text, "+15551234567");
    } else {
      window.location.href = "https://wa.me/15551234567?text=" + encodeURIComponent(text);
    }
  }
</script>

else dalı, script yüklenmediğinde (örneğin bir tarayıcı eklentisi engellediğinde) butonun çalışmaya devam etmesini sağlar. Script tarafından zaten bir numara atanmış bir metin asla ikinci kez değiştirilmez.

Neler kaydedilir #

Dokunma anında, ziyaret kaydı şunları tutar:

• sayfa adresindeki reklam tıklama kimlikleri, örneğin fbclid (Meta) ve gclid (Google)
• kendi Meta pikseliniz sitenizde ayarladıysa _fbc ve _fbp çerezleri (script bunları okur, asla ayarlamaz)
• kampanya etiketleri (utm_source, utm_medium, utm_campaign, utm_content, utm_term)
• açılış sayfası, ziyaretçinin geldiği sayfa, tarayıcı ve mesaj metni
• ziyaret ulaştığında Your AI Connector tarafından eklenen IP adresi ve zaman

Bir ziyaret eşleştiğinde, Your AI Connector bu verilerden ziyaretçinin yaklaşık olarak nerede olduğunu (IP adresinden elde edilen yaklaşık şehir ve ülke bilgisi) ve hangi cihazı kullandığını (örneğin telefon, tablet veya bilgisayar, işletim sistemi ve tarayıcı, Instagram uygulama içi tarayıcısı gibi) da belirler. Mobil ağlarda yaygın olduğu üzere, konum belirlenemediğinde bu alan boş kalır.

Ziyaret kayıtları 90 gün boyunca saklanır. Bir ziyaret eşleştirildiğinde, tıklama verilerinin bir kopyası kişi üzerinde saklanır ve siz silene kadar kişiyle birlikte kalır.

Gizlilik bildiriminiz: script web sitenizde çalıştığı için, web sitenizin gizlilik bildiriminde bundan bahsedilmelidir: nelerin kaydedildiği (yukarıdaki liste) ve bir ziyaretçi WhatsApp butonuna dokunduğunda bunun gerçekleştiği belirtilmelidir.

Eşleştirme nasıl çalışır #

Bir kişinin ilk mesajı ulaştığında, Your AI Connector önceki 15 dakika içindeki bir ziyareti arar:

1. Önce sorgu numarasına göre. Script tarafından verilen bir numarayı taşıyan mesaj, o ziyaretle eşleştirilir.
2. Aksi takdirde aynı metne göre. Bir ziyaretle tamamen aynı metne sahip bir mesaj, o ziyaretle eşleştirilir. İki farklı ziyaretçi aynı zaman aralığında aynı metni gönderdiğinde, bir kişinin yanlış reklama atfedilmemesi için kasten hiçbiri eşleştirilmez.

Sorgu numarasını taşıyan daha sonraki bir mesaj, kişinin henüz bir eşleşmesi yoksa yine eşleştirilir.

Zaten bir eşleşmesi olan bir kişi başka bir reklam üzerinden geri gelip daha yeni bir sorgu numarası içeren bir mesaj gönderdiğinde, bu tıklama kişinin en son tıklaması olarak saklanır. İlk eşleşme olduğu gibi kalır.

• Raporlamanız için ilk tıklama: kişi, potansiyel müşterinin ilk olarak nereden geldiğini göstermeye devam eder. Bu asla değişmez.
• Meta için en son tıklama: Meta’ya gönderilen etkinlikler en yeni tıklamayı kullanır, çünkü Meta kişiyi geri getiren reklamı yalnızca kendi ilişkilendirme penceresi içinde kredilendirir. Eski bir tıklamanın raporlanması yanlış reklamı veya hiçbir reklamı kredilendirmez.
• En son tıklama yalnızca bir sorgu numarasından alınır, asla sadece eşleşen metinden alınmaz ve daha eski bir ziyaret asla daha yenisinin yerini almaz.

Sınırlar:

• İlk eşleşme asla üzerine yazılmaz. Daha yeni tıklamalar en son tıklamaya gider.
• Sadece WhatsApp: WhatsApp Business API ve WhatsApp Web kanalları.
• 15 dakika: butona dokunan ancak mesajı çok daha sonra gönderen bir ziyaretçi eşleştirilmez.
• Sadece ileriye dönük: betiği yüklemeden önceki kişilerin eşleşmesi yoktur.

Nerede görürsünüz #

• İletişim paneli: Kampanya veya kaynak ve ilk tıklama tarihi ile Bir reklam tıklamasından geldi. Detaylar için üzerine gelin: kampanya, Reklam (utm_content) ve Reklam seti (utm_term), yaklaşık Konum ve Cihaz (her biri yalnızca bilindiğinde), ayrıca varsa son tıklama için de aynı bilgiler. Hiç doldurulmamış kampanya etiketleri (reklam önizleme dokunuşu, isimler yerine etiket şablonunu gönderir) hariç tutulur. Bir ziyaret, yalnızca sayfa bir reklam bağlantısından (bir Meta veya Google tıklama kimliği ya da kampanya etiketleri) açıldığında reklam tıklaması olarak sayılır. Sayfaya başka bir yolla ulaşan herkes, örneğin Google aramasından, adresinizi yazarak veya sitenizde tıklayarak gelenler, Web sitenizden geldi ifadesiyle ve nereden geldikleriyle (örneğin Google araması veya tarayıcı belirtmediğinde Web sitesi ziyareti, yönlendiren kaydedilmedi) gösterilir.
• İletişim sayfası: Aynı satır, Kişiler bölümünde kişinin adının altında yer alır, böylece telefonunuzda bile hemen görebilirsiniz. Detaylar için üzerine gelin veya dokunun.
• Etkinlik: Kişinin zaman çizelgesi, ilk mesajından önce, tıklama anında Bir reklamdan sonra WhatsApp düğmenize dokundu (veya web sitenizde) ile başlar. Sohbetin iletişim paneli, Etkinlik altında aynı satırı gösterir.
• Web kancaları (Webhooks): temsilci etiketi web kancalarında ve bir kişi taşıyan her web kancası abonelik etkinliğinde contact.ad_attribution.
• API: Kişi listesinde ad_attribution ve API referansının Kişiler bölümünde tek bir kişi üzerinde adAttribution.
• MCP araçları: Döndürdükleri her kişi üzerinde aynı nesne.

Kişinin eşleşmesi olmadığında değer null olur. Aşağıdaki alanlar ilk tıklamayı tanımlar. Daha sonraki bir tıklama eşleştirildiğinde, latest bunu aynı alanlarla tutar; o zamana kadar mevcut değildir.

Sonuçları Meta’ya gönder (isteğe bağlı) #

Your AI Connector'ın sonuçları Meta reklam hesabınıza geri bildirmesini sağlayabilirsiniz, böylece Meta hangi reklamların gerçek potansiyel müşteriler ve satışlar getirdiğini öğrenir ve bunları optimize eder. Bu, kendi Meta Dönüşüm API’si detaylarınızı kullanır.

1. Meta Etkinlik Yöneticisi’nde, Veri kaynakları altında piksel (veri kümesi olarak da adlandırılır) kimliğinizi bulun ve Ayarlar, Conversions API, Erişim belirteci oluştur kısmından bir erişim belirteci oluşturun.
2. Ayarlar → Reklam tıklama takibi bölümünde, Sonuçları Meta’ya gönder (isteğe bağlı) altında, Piksel / veri kümesi kimliği ve Erişim belirteci bilgilerini girin. Meta ayrıntılarını kaydet düğmesine tıklayın.
3. İsteğe bağlı: bağlantıyı kontrol edin. Meta Etkinlik Yöneticisi’nde pikselinizi açın ve Test etkinlikleri sekmesine gidin, orada gösterilen test kodunu kopyalayın, Bir test etkinliği gönder altına yapıştırın ve Test etkinliği gönder düğmesine tıklayın. Düğmenin altındaki satırda “Meta 1 test etkinliği aldı” ifadesi görünür (bunu Meta’daki Test etkinlikleri altında kontrol edin) veya reddedildiğinde Meta’nın nedeni (örneğin yanlış bir belirteç) gösterilir. Kod yalnızca o test için kullanılır ve asla kaydedilmez.
4. Temsilci düzenleyiciyi açın, Etiketler sekmesine gidin ve bir etiket açın. Meta’ya gönder altında, etkinliği seçin: Potansiyel Müşteri (Lead), İletişim (Contact), Randevu (Schedule), Satın Alma (Purchase) veya özel bir ad. İsteğe bağlı olarak bir değer ve para birimi ekleyin.

O andan itibaren, bir kişiye ne zaman (yapay zeka tarafından, elle, API aracılığıyla veya bir otomasyonla) o etiket uygulanırsa, Your AI Connector etkinliği Meta’ya kişinin en yeni tıklama verileriyle (fbc, fbp, IP adresi, tarayıcı, giriş sayfası; varsa en son tıklamadan, yoksa ilk tıklamadan) ve ayrıca Meta’nın reklamla ilişkilendirebilmesi için karma hale getirilmiş telefon, e-posta ve ad bilgileriyle birlikte gönderir. Eşleşmesi olmayan bir kişi bile, yalnızca karma hale getirilmiş telefon, e-posta ve ad bilgileriyle etkinliği göndermeye devam eder.

• Canlı etkinlikler her zaman sayılır: bir test etkinliği kodu Meta ayrıntılarınızla asla saklanmaz, bu nedenle etiketlerinizin ve otomasyonlarınızın gönderdiği etkinlikler her zaman Meta’daki gerçek verilerinize gider, asla Test etkinlikleri sekmesine gitmez.
• Çift sayım olmaz: her etkinliğin, kişi kimliği ve etiket adından oluşan sabit bir kimliği vardır. CRM’niz aynı etkinliği aynı kimlikle Meta’ya gönderirse, Meta yalnızca birini tutar.
• Meta’nın ilişkilendirme penceresi: Meta, bir etkinliği yalnızca ilişkilendirme penceresi içindeki bir reklama atfeder; bu süre varsayılan olarak tıklamadan sonraki 7 gündür. Haftalar sonra kapanan bir anlaşma tek başına sayılmayacaktır, bu nedenle daha erken bir etkinlik de gönderin; örneğin, rezerve edilmiş veya ödenmiş danışmanlık için bir etiket.

Otomasyonlardan dönüşüm gönderme #

Bir etiket, uygulandığında kendi etkinliğini gönderir. Sonuç başka bir yerde gerçekleştiğinde, örneğin CRM’inizde bir anlaşma kapandığında veya bir danışmanlık randevusu alındığında, otomasyonda Meta’ya dönüşüm gönder eylemini kullanın. Bu, Conversions API aracılığıyla Meta veri kümenize bir etkinlik bildirir, böylece Meta reklamlarınızı sadece mesajlara göre değil, gerçek sonuçlara göre optimize eder.

Etiketlerle aynı Meta ayrıntılarını kullanır: Ayarlar → Reklam tıklama takibi altındaki Piksel / veri kümesi kimliği ve Erişim belirteci. Bunlar olmadan adım “Meta bağlı değil” hatasıyla başarısız olur.

Alanlar

Kişi, E-posta veya Telefon alanlarından en az birini doldurun. Kişinin bir rehber kaydı olması gerekmez: Kapandı-Kazanıldı durumuna ulaşan bir HubSpot anlaşması, anlaşma tutarı ve alıcının e-postası ile bir Purchase (Satın Alma) etkinliği gönderebilir.

Bir Kişi seçtiğinizde, telefon, e-posta ve ad bilgileri kullanılır. Eğer bu kişi komut dosyasının eşleştirdiği bir reklam tıklamasından geldiyse, tıklama ayrıntıları da gönderilir; bu, Meta’nın etkinliği reklamla eşleştirmesine yardımcı olur. E-posta, telefon ve adlar gönderilmeden önce karma (hash) işleminden geçirilir. Tıklama kimliği, IP adresi ve tarayıcı bilgileri Meta’nın gerektirdiği şekilde gönderilir.

Etkinlik kimliği ve mükerrer sayım

Meta, aynı etkinlik adına ve aynı Etkinlik kimliğine sahip etkinlikleri bir kez sayar. Başka bir araç da aynı dönüşümü bildirdiğinde veya otomasyon bunun için iki kez çalışabileceğinde, anlaşma kimliği gibi sabit bir kimlik kullanın. Boş bırakırsanız her çalıştırmada yeni bir kimlik oluşturulur, bu nedenle her çalıştırma sayılır.

Etiket etkinliklerinden farkı nedir?

Bir etiketin Meta’ya gönder etkinliği, o etiket için kişi başına bir kez (30 günde en fazla bir kez) gönderilir. Bu eylem ise her çalıştığında gönderim yapar. Bir dönüşümün iki kez sayılmasını engelleyen şey Etkinlik kimliğidir.

Örnek: kapanan bir anlaşma ve alınan bir danışmanlık randevusu

1. Bir anlaşma kazanıldığında çalışan bir otomasyon başlatın: CRM’inizin anlaşma etkinliği üzerinde bir Uygulama etkinliği tetikleyicisi ve yalnızca kazanılan anlaşmaların devam etmesini sağlayan bir Koşul kullanın. HubSpot, geliştirici uygulamalarına yalnızca anlaşma aşaması etkinliklerini gönderir; bu nedenle HubSpot için, son çalıştırmadan bu yana ‘Kazanıldı’ aşamasına ulaşan anlaşmaları arayan bir HubSpot araması içeren bir Zamanlama tetikleyicisi ve bunlar üzerinde bir Döngü kullanın.
2. Meta’ya dönüşüm gönder adımını ekleyin. Etkinlik adı kısmını Satın Alma olarak, Değer kısmını anlaşma tutarı olarak (+ düğmesini kullanarak ekleyin) ve Para birimi kısmını kendi para biriminiz olarak ayarlayın. Alıcının e-postasını E-posta alanına ve anlaşma kimliğini Etkinlik Kimliği alanına girin; böylece aynı anlaşma asla iki kez sayılmaz.
3. Rezerve edilen bir görüşme için, Randevu alındı tetikleyicisiyle ikinci bir otomasyon başlatın ve Etkinlik adı kısmını Planlandı olarak, tetikleyiciden gelen kişiyi de İletişim alanına ayarlayarak Meta’ya dönüşüm gönder adımını ekleyin. İsterseniz, görüşme ücreti gibi sabit bir değerle Satın Alma etkinliği gönderen ikinci bir Meta’ya dönüşüm gönder adımı daha ekleyebilirsiniz.

Ayrıca POST https://api.youraiconnector.com/v1/ad-attribution/meta-event aracılığıyla API üzerinden de dönüşüm gönderebilirsiniz. Aynı alanları snake case formatında alır: event_name, value, currency, contact_id, email, phone, first_name, last_name, external_id, event_id, event_time, event_source_url ve test_event_code.

SSS #

Reklamım doğrudan WhatsApp’ı açarsa bu çalışır mı? Bu reklamlar web sitenizden geçmez, bu yüzden betik asla çalışmaz. Meta, reklam detaylarını bunun yerine ilk mesajla birlikte gönderir, bkz. WhatsApp’a Tıkla Reklam İlişkilendirmesi.

Betik web sitemi yavaşlatır mı veya çerez bırakır mı? Arka planda yüklenir (async), çerez bırakmaz ve başka hiçbir şey yüklemez. Sadece bir ziyaretçi WhatsApp butonuna dokunduğunda bir şey gönderir.

Meta reklamlarının yanı sıra Google Reklamlarını da takip edebilir miyim? Evet. Google tıklama kimlikleri (gclid, gbraid, wbraid) ve tüm kampanya etiketleri kaydedilir ve kişi üzerinde gösterilir. Sonuçları geri gönderme özelliği yalnızca Meta için mevcuttur.

Bir kişi neden eşleşmedi? En yaygın nedenler: mesajın dokunuştan 15 dakika sonra gelmesi, sorgu numarasının mesajdan kaldırılması, sorgu numarasının kapalı olması ve başka bir ziyaretçinin aynı metni göndermesi veya sayfada betiğin bulunmaması.

Web sitem iki WhatsApp numarasına bağlantı veriyor. Sadece birini takip edebilir miyim? Evet. Ayarlarda WhatsApp numarası altına o numarayı yazın. Her WhatsApp bağlantısını takip etmek için boş bırakın.

İfadeleri daha sonra değiştirebilir miyim? Evet. Değişiklikler web sitenize anında uygulanır; betiği tekrar yapıştırmanıza gerek yoktur.