fix(analitik): görünüm hook'u callback ref + erken olay kuyruğu
useGorunumOlayi useRef + [ad, anahtarEki] deps'li effect kullanıyordu:
eleman ilk commit'te yoksa (kaydet-banner: mount sonrası açılır, portal
içinde) ya da sökülüp yeni düğümle geri geliyorsa (tadımlık satırı) gözlem
hiç kurulmuyordu → kaydet_banner_goruntulendi / tadimlik_goruntulendi = 0.
Hook artık callback ref döner; gözlem düğüm bağlanınca kurulur, sökülünce
React 19 ref temizliğiyle bırakılır. Çağıranlar yalnız ref={…} verdiği
için kullanım yerleri değişmedi.
olay(): Rybbit script'i afterInteractive; sert yüklemede mount anında
atılan olaylar window.rybbit henüz yokken sessizce düşüyordu. Artık en çok
20 olay, 500 ms aralıkla en çok 20 deneme (10 sn) kuyrukta bekler; script
gelmezse (reklam engelleyici, dev) kuyruk atılır.
olayBirKez(): hook'taki sessionStorage tekilleştirmesinin effect'ten
çağrılabilir hâli (anahtar biçimi aynı: kolaytercih.olay.<ad>[.<ek>]).
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
@@ -3,8 +3,9 @@
|
||||
*
|
||||
* Script yalnızca prod build'de yükleniyor (bkz. app/layout.tsx) ve reklam
|
||||
* engelleyiciler tarafından bloklanabiliyor; bu yüzden buradaki her çağrı
|
||||
* `window.rybbit` yoksa sessizce hiçbir şey yapmaz — çağıran taraf asla
|
||||
* varlık kontrolü yapmak zorunda kalmasın.
|
||||
* `window.rybbit` yoksa kullanıcıya hiçbir şey hissettirmez (olaylar kısa
|
||||
* süre kuyrukta bekler, script gelmezse atılır) — çağıran taraf asla varlık
|
||||
* kontrolü yapmak zorunda kalmasın.
|
||||
*
|
||||
* KURAL: Öğrencinin ham başarı sıralaması analitiğe GÖNDERİLMEZ. Sıralama
|
||||
* her zaman `siraKovasi()` ile bantlanır.
|
||||
@@ -48,16 +49,100 @@ declare global {
|
||||
}
|
||||
}
|
||||
|
||||
/** Özel olay gönderir. Script yoksa no-op. */
|
||||
// Erken olay kuyruğu: script `afterInteractive` yüklendiği için sert sayfa
|
||||
// yüklemesinde (OAuth dönüşü, e-postadaki link, yer imi) mount effect'leri
|
||||
// `window.rybbit`'ten önce koşar. Mount anında atılan olaylar
|
||||
// (sonuc_goruntulendi, paket_goruntulendi) kaybolmasın diye script gelene
|
||||
// kadar burada bekletilir. Script hiç gelmezse (reklam engelleyici, dev)
|
||||
// kuyruk 10 sn sonra sessizce atılır ve bir daha doldurulmaz.
|
||||
const KUYRUK_SINIRI = 20;
|
||||
const DENEME_ARALIGI_MS = 500;
|
||||
const DENEME_SINIRI = 20;
|
||||
|
||||
let kuyruk: Array<[OlayAdi, Ozellikler | undefined]> = [];
|
||||
let zamanlayici: ReturnType<typeof setInterval> | null = null;
|
||||
let denemeSayisi = 0;
|
||||
let kuyrukKapali = false;
|
||||
|
||||
function zamanlayiciyiDurdur(): void {
|
||||
if (zamanlayici !== null) clearInterval(zamanlayici);
|
||||
zamanlayici = null;
|
||||
}
|
||||
|
||||
/** Bekleyen olayları geliş sırasıyla gönderir. */
|
||||
function kuyruguBosalt(rybbit: RybbitApi): void {
|
||||
const bekleyenler = kuyruk;
|
||||
kuyruk = [];
|
||||
zamanlayiciyiDurdur();
|
||||
for (const [ad, ozellikler] of bekleyenler) {
|
||||
try {
|
||||
rybbit.event(ad, ozellikler);
|
||||
} catch {
|
||||
// yut
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
function kuyrugaEkle(ad: OlayAdi, ozellikler?: Ozellikler): void {
|
||||
if (kuyrukKapali || kuyruk.length >= KUYRUK_SINIRI) return;
|
||||
kuyruk.push([ad, ozellikler]);
|
||||
if (zamanlayici !== null) return;
|
||||
zamanlayici = setInterval(() => {
|
||||
denemeSayisi += 1;
|
||||
if (window.rybbit) {
|
||||
kuyruguBosalt(window.rybbit);
|
||||
} else if (denemeSayisi >= DENEME_SINIRI) {
|
||||
// Script gelmedi: bekleyenleri at, sonraki olaylar eski no-op'a dönsün
|
||||
kuyruk = [];
|
||||
kuyrukKapali = true;
|
||||
zamanlayiciyiDurdur();
|
||||
}
|
||||
}, DENEME_ARALIGI_MS);
|
||||
}
|
||||
|
||||
/** Özel olay gönderir. Script henüz yoksa kısa süre kuyrukta bekletir. */
|
||||
export function olay(ad: OlayAdi, ozellikler?: Ozellikler): void {
|
||||
if (typeof window === "undefined") return;
|
||||
try {
|
||||
window.rybbit?.event(ad, ozellikler);
|
||||
if (!window.rybbit) {
|
||||
kuyrugaEkle(ad, ozellikler);
|
||||
return;
|
||||
}
|
||||
// Sıra bozulmasın: bekleyen varsa önce onlar gider
|
||||
if (kuyruk.length > 0) kuyruguBosalt(window.rybbit);
|
||||
window.rybbit.event(ad, ozellikler);
|
||||
} catch {
|
||||
// Analitik hiçbir koşulda kullanıcı akışını bozmaz
|
||||
}
|
||||
}
|
||||
|
||||
/** Oturum başına tekilleştirme anahtarı (useGorunumOlayi ile ortak). */
|
||||
export function olayAnahtari(ad: OlayAdi, anahtarEki?: string): string {
|
||||
return `kolaytercih.olay.${ad}${anahtarEki ? `.${anahtarEki}` : ""}`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Olayı oturum (sekme) başına en fazla 1 kez gönderir; "görüntülendi" türü
|
||||
* olaylar yenileme ve geri-ileri gezinmede şişmesin diye. Tekilleştirme
|
||||
* sessionStorage anahtarıyla yapılır.
|
||||
*/
|
||||
export function olayBirKez(
|
||||
ad: OlayAdi,
|
||||
ozellikler?: Ozellikler,
|
||||
/** Aynı olayın farklı yüzeyleri/durumları için tekilleştirme eki. */
|
||||
anahtarEki?: string,
|
||||
): void {
|
||||
if (typeof window === "undefined") return;
|
||||
const anahtar = olayAnahtari(ad, anahtarEki);
|
||||
try {
|
||||
if (window.sessionStorage.getItem(anahtar)) return;
|
||||
window.sessionStorage.setItem(anahtar, "1");
|
||||
} catch {
|
||||
// Storage engelliyse tekilleştirmeden vazgeç, olay yine atılır
|
||||
}
|
||||
olay(ad, ozellikler);
|
||||
}
|
||||
|
||||
/**
|
||||
* Ham sıralamayı analitik için bantlar. Panelde "hangi sıralama bandı
|
||||
* dönüşüyor" sorusunu yanıtlar ama tekil öğrenciyi işaret etmez.
|
||||
|
||||
Reference in New Issue
Block a user