Semust Metrik

Framework Kurulumları

Next.js, React ve tek sayfa uygulamalarında Metrik kurulumu ve komut kuyruğu.

Metrik tek sayfa uygulamalarını hiçbir ek ayar gerektirmeden destekler: rota değiştiğinde yeni bir sayfa görüntüleme kaydedilir.

Ürün sayfası: Semust Metrik.

Tek sayfa uygulamaları

Adres çubuğundaki yol değiştiğinde Metrik otomatik olarak yeni bir sayfa görüntüleme kaydeder. React Router, Next.js router ve history API kullanan tüm kütüphaneler desteklenir.

Yalnızca # değişirse sayılmaz

/fiyatlar#sss gibi yalnızca # kısmının değiştiği geçişler yeni sayfa görüntüleme oluşturmaz. Bu, aynı sayfadaki bağlantıların ziyaret sayınızı şişirmesini engeller.

Next.js

Script'i kök layout dosyanıza ekleyin:

import Script from "next/script";

export default function RootLayout({ children }) {
  return (
    <html lang="tr">
      <body>
        {children}
        <Script
          src="https://unpkg.com/semust-js@latest/dist/semust-js.min.js"
          data-token="mk_ornek-anahtariniz"
          strategy="afterInteractive"
        />
      </body>
    </html>
  );
}

Dosya adını değiştirmeyin

Script kendini dosya adından tanır. Dosyayı kendi sunucunuza kopyalayıp adını değiştirirseniz veya bir paketleyiciyle birleştirirseniz erişim anahtarı okunamaz ve hiçbir veri kaydedilmez. Adres değişebilir, dosya adı semust-js.min.js kalmalıdır.

Komut kuyruğu

Uygulama kodunuz script yüklenmeden çalışabiliyorsa çağrılarınızı kuyruğa alın. Script yüklendiğinde kuyruktaki çağrılar sırayla çalıştırılır:

window.semustMetrik = window.semustMetrik || { q: [] };
window.semustMetrik.q = window.semustMetrik.q || [];

window.semustMetrik.q.push(["identify", "[email protected]", { plan: "pro" }]);
window.semustMetrik.q.push(["track", "kayit_tamamlandi"]);

Dizinin ilk elemanı metot adı, kalanlar o metodun parametreleridir. Bu yöntem identify, track ve trackPayment için çalışır.

Güvenli bir yardımcı fonksiyon:

function metrik(method, ...args) {
  const w = window;
  if (w.semustMetrik && w.semustMetrik.initialized) {
    w.semustMetrik[method](...args);
    return;
  }
  w.semustMetrik = w.semustMetrik || { q: [] };
  w.semustMetrik.q = w.semustMetrik.q || [];
  w.semustMetrik.q.push([method, ...args]);
}

metrik("track", "kayit_tamamlandi");

Alan adları arası takip

Ziyaretçi example.com üzerinden magaza.example.com adresine geçiyorsa, kimliğin taşınması için alan adlarını tanımlayın:

<script src="https://unpkg.com/semust-js@latest/dist/semust-js.min.js"
        data-token="mk_ornek-anahtariniz"
        data-allowed-hostnames="magaza.example.com,blog.example.com"></script>

Script'i her iki sitede de aynı erişim anahtarıyla kurmanız gerekir.

Google Tag Manager

GTM üzerinden kurulumda ayarlar data-* yerine window.semustMetrikConfig ile verilir; ayrıntılar Kurulum sayfasında.

Son güncelleme: 2026-08-26