DM Champ Docs

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, DM Champ 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.dmchamp.com/v1/ad-visit/YOUR_SITE_KEY.js" async></script>
  1. İ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.
  2. 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.
  3. 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.

Ajanslar: her müşteri hesabının kendi site anahtarı ve kodu vardır, bu nedenle her müşterinin web sitesi kendi hesabına raporlama yapar. Diğer tüm ayarlar bölümlerinde olduğu gibi, menü görünürlüğü ile bir müşteri için bölümü gizleyebilirsiniz.


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 DM Champ 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. DM Champ'ı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.dmchamp.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 DM Champ tarafından eklenen IP adresi ve zaman

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, DM Champ ö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.

Sınırlar:

  • İlk eşleşme kazanır. Bir kişi bir kez eşleştiğinde, bu eşleşme asla üzerine yazılmaz.
  • Yalnızca 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

  • Kişi paneli: Kampanya veya kaynak ve tarih ile birlikte Bir reklam tıklamasından geldi. Detaylar için üzerine gelin.
  • Web kancaları: temsilci etiketi web kancalarında contact.ad_attribution ve bir kişi taşıyan her web kancası abonelik etkinliğinde.
  • 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şide aynı nesne.

Kişinin eşleşmesi olmadığında değer null şeklindedir.

Alan Nedir
visit_at Ziyaretçinin WhatsApp butonuna dokunduğu zaman.
matched_at Ziyaretin kişiyle eşleştirildiği zaman.
match_method reference (sorgu numarasıyla eşleşti) veya text (aynı mesaj metniyle eşleşti).
reference Sorgu numarası veya kapalı olduğunda null.
fbc / fbp Varsa, kendi Meta pikselinizden gelen Meta tıklaması ve tarayıcı çerezleri.
fbclid Sayfa adresinden gelen Meta reklam tıklama kimliği.
gclid / gbraid / wbraid Sayfa adresinden gelen Google reklam tıklama kimlikleri.
utm_source / utm_medium / utm_campaign / utm_content / utm_term Sayfa adresinden gelen kampanya etiketleri.
landing_url Ziyaretçinin ulaştığı sayfa.
referrer Ziyaretçinin geldiği sayfa.
client_ip Ziyaretçinin IP adresi.
user_agent Ziyaretçinin tarayıcısı.
site_key Ziyareti kaydeden betiğin site anahtarı.
visit_id Ziyaret kaydının kimliği.

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

DM Champ'ı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, Dönüşümler API’si, Erişim belirteci oluştur altında 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ğini ve Erişim belirtecini girin. Test ederken Meta’nın Test etkinlikleri sekmesinden Test etkinlik kodunu ekleyebilirsiniz; işiniz bittiğinde temizleyin. Meta detaylarını kaydet’e tıklayın.
  3. 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, Kişi, Randevu, Satın Alma veya özel bir ad. İsteğe bağlı olarak bir değer ve para birimi ekleyin.

O andan itibaren, bu etiket bir kişiye uygulandığında (Yapay Zeka tarafından, elle, API aracılığıyla veya bir otomasyonla), DM Champ etkinliği, kişinin saklanan tıklama verileri (fbc, fbp, IP adresi, tarayıcı, açılış sayfası) ve ayrıca Meta’nın reklamla ilişkilendirebilmesi için karma hale getirilmiş telefon, e-posta ve ad bilgileriyle birlikte Meta’ya gönderir. Eşleşmesi olmayan bir kişi, yine de sadece karma hale getirilmiş telefon, e-posta ve ad ile etkinliği gönderir.

  • Çift sayım yok: 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 sadece 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 sonra 7 gündür. Haftalar sonra kapanan bir anlaşma kendi başına sayılmaz, bu yüzden daha erken bir etkinlik de gönderin; örneğin, rezerve edilmiş veya ödenmiş danışmanlık için bir etiket.

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.