Özel olaylar

Tıklama işleyicisi bağlayabildiğiniz her şey bir olay olabilir.

window.seean.track("signup");
window.seean.track("download", { file: "pricing.pdf" });

Olaylar Genel bakışta (Events kartı), Olaylar etkinlik günlüğünde, hunilerde adım olarak ve etkin dönüşüm hedefleriyle eşleştiklerinde (veya hiçbir hedef etkin değilse tüm özel olaylar) kampanya raporlarında görünür. Özellikler olayla birlikte gönderilir ancak mevcut etkinlik günlüğü tablosu bunları göstermez.

Adlandırma

Kısa, kararlı adlar kullanın: signup, cta_click, newsletter_signup. Sonradan yeniden adlandırmak geçmişinizi böler.

Çağırmadan önce yükleyin

track çağrısını oluşturulan izleyici scripti çalıştıktan sonra yapın. Yüklemeden önce yapılan çağrılar için yerleşik bir kuyruk yoktur. Düz HTML için uygulamanızın ertelenmiş (defer) scriptini ertelenmiş Seean scriptinin arkasına yerleştirin; bir çerçeve için kurulum rehberini izleyin.

Bir indirme düğmesi için işleyiciyi o düğme var olduktan sonra bağlayın:

document.querySelector("#download-pricing")?.addEventListener("click", () => {
  window.seean?.track("download", { file: "pricing.pdf" });
});

Bu tıklamayı sayar, bir indirmenin tamamlandığının kanıtı değildir. İsteğe bağlı zincirleme (optional chaining) izleyici kullanılamadığında bir istisnayı önler ancak olayı kaydetmez veya yeniden denemez. Yoksayılan bir ziyaretçinin izleyici yöntemleri işlevsiz olabilir; bu yüzden window.seean nesnesinin varlığı tek başına toplamanın kanıtı değildir.

Bir form için izleyiciyi mevcut başarılı gönderim yolunuzda çağırın:

// After your server has confirmed the newsletter signup succeeded:
window.seean?.track("newsletter_signup", { form: "footer" });

Bu başarı olayını gönder düğmesinin tıklamasından da göndermeyin: doğrulama veya istek başarısız olabilir ve her ikisini bağlamak başarılı gönderimleri iki kez sayar. Formunuzun normal doğrulamasını ve hata işlemesini koruyun.

Bildirimsel tıklamalar ve formlar

Bir düğmeye veya bağlantıya data-seean-event="signup" ekleyerek o olayı tıklamada, iç içe öğelerine yapılan tıklamalar dahil, gönderin. Bir formda öznitelik, alanlarına tıklama yerine gönderimde gönderir. Dinamik öğeler yetkilendirilmiş dinleyicilerle çalışır. Otomatik dönüşüm ön ayarları çift sayımı önlemek için işaretli öğeleri atlar; aynı eylem için ayrıca seean.track() çağırmayın. Bildirimsel öznitelikler data-conversions kaydı gerektirmez. Adlar boş olmamalı, en fazla 64 karakter olmalı ve pageview olmamalıdır.

<button data-seean-event="download" data-seean-event-source="footer">Download</button>
<form data-seean-event="contact_submit">…</form>

Bir özellik göndermek için aynı işaretli öğeye data-seean-event-PROPERTY="value" ekleyin. Yukarıdaki örnek { "source": "footer" } gönderir. Öznitelik değerleri dize olarak kalır ("2", 2 sayısı değildir); HTML öznitelik adlarını küçük harfe normalleştirir. Yalnızca o öğedeki açıkça önekli öznitelikler okunur. Üst veya alt öğelerdeki özellikler, form alanı değerleri ve ilgisiz öznitelikler toplanmaz. Sonraki bir etkileşimden önce bir özniteliği değiştirmek yeni değerini kullanır.

Aşağıdaki mevcut özellik sınırları geçerlidir. Geçersiz bir anahtar, çok fazla özellik veya aşırı büyük değer toplayıcının olayı reddetmesine neden olur; değerler sessizce kesilmez. Türlü sayı, boolean veya null değerler için JavaScript API’sini kullanın.

Bir tıklama veya gönderim olayı sunucunuzun eylemi tamamladığını doğrulamaz. Bu doğrulamaya ihtiyacınız olduğunda yukarıdaki başarı işleyicisi yöntemini kullanın.

Oturum açmış kullanıcıları tanımlayın

window.seean?.identify("user_42", { plan: "pro" });

identify(id, properties?), kendi kullanıcı kimliğinizi (A–Z a–z 0–9 _ . : @ - karakterlerinden 1–64 karakter, hiçbir zaman e-posta değil) açık sayfadan gelen sonraki her kayda ekler ve isteğe bağlı özelliklerle bir identify olayı kaydeder. Yalnızca Settings → Installation altında Identify users seçeneğini açan web siteleri için etkilidir; bkz. Kişiler ve elde tutma.

Özellik sınırları

Olay adları en fazla 64 karakter kabul eder. Her olay en fazla 20 özellik içerebilir; serileştirilmiş özellikler nesnesi 4.096 karakteri aşmamalıdır. Özellik anahtarları bir harfle başlar ve yalnızca harf, rakam veya alt çizgi içerir, en fazla 64 karakter. Değerler en fazla 512 karakterlik bir dize, sonlu bir sayı, bir boolean veya null olabilir. İç içe nesneler ve diziler reddedilir.

Form konumu veya ürün kategorisi gibi hassas olmayan etiketler kullanın. Hiçbir zaman parola, e-posta adresi, ödeme ayrıntısı veya özel belirteç göndermeyin. Özellikler şu anda etkinlik günlüğü sütunu veya panel özellik filtresi olarak kullanılamaz; bir özellik göndermek yeni bir rapor denetimi oluşturmaz.

Bir olayı doğrulayın

Eylemi bir kez gerçekleştirin ve seçili web sitesinin Events activity log bölümünü geçerli dönemde açın. Adını, yol adını ve sayısını kontrol edin. Özel olaylar sayfa görüntülemeleriyle aynı gizlilik sinyallerini, hariç tutmaları ve toplama kotasını kullanır; reddedilen veya yoksayılan bir istek hiçbir satır bırakmayabilir. pageview adlı bir olay özel olay yerine görüntüleme olarak sayılır.

Bir satır eksikse script hazırlığını, istek yükünü ve kurulum sorun gidermeyi kontrol edin. track() depolamanın başarılı olduğuna dair bir onay döndürmez ve izleyici kalıcı bir yeniden deneme kuyruğu sağlamaz.

404 sayfaları

Bulunamadı sayfanıza <meta name="seean:status" content="404"> ekleyin; otomatik sayfa görüntülemesi status: 404 taşır ve ikinci bir olay olmadan Pages → 404s altında görünür.

Bunun yerine track("pageview", { status: 404 }) çağırmak ikinci bir sayfa görüntülemesi ekler. Bkz. 404 izleme.

Anlaşılmayan bir yer mi var? Destekle iletişime geçin.