İçeriğe geç
Bize ulaşın
Belgeler menüsüBaşlangıç

Başlangıç. İlk olay altı adımda.

Bu kılavuz bir kaynağı sıfırdan kurar ve ilk olayın Postlip Metrics’e ulaştığını doğrular. Paneldeki kaynak sayfasının Kurulum sekmesi aynı adımları kendi anahtarınız ve adresinizle yazar.

Gerekenler

  • Bir Postlip Metrics organizasyonu. Organizasyonları platform ekibi açar; sahibine bir davet e-postası gider.
  • Organizasyonda bir uygulama (Ayarlar › Uygulamalar): ölçülen ürün, saat dilimi ve para birimiyle.
  • “Kaynakları ve anahtarları yönetme” yetkisi; canlı akış için “Olay şemasını yönetme”. Geliştirici rolünde ikisi de vardır.

  1. Kaynak oluşturun

    Panelde Veri › Kaynaklar › Kaynak oluştur. Kaynak, uygulamaya veri gönderen istemcidir: web sitesi ya da web uygulaması, iOS, Android, sunucu ya da başka bir Segment uyumlu kütüphane. Kaynak türü sonradan değişmez.

    • Ortamı seçin: canlı, hazırlık ya da geliştirme. Ekranlar varsayılan olarak canlı ortamı gösterir.
    • Web kaynaklarında izinli alan adlarını yazın; başka bir Origin’den gelen istek 403 origin_not_allowed alır.
    • Rıza kipini seçin (required, implied, none). Ayrıntı: Rıza ve gizlilik.

  2. Anahtarları alın

    Kaynağın Anahtarlar sekmesinde Anahtar oluştur. Tam anahtar yalnız oluşturulduğu anda bir kez gösterilir; Postlip Metrics yalnız özetini saklar.

    • Yazma anahtarı pk_live_… ya da pk_test_…: tarayıcıda ve mobilde açıkta durabilir, yalnız veri gönderir. Test anahtarıyla gelen olaylar test olarak işaretlenir.
    • Sunucu kaynakları için imza anahtarı sk_live_…: yalnız sunucunun ortam değişkenlerinde (METRICS_SIGNING_SECRET) durur ve istekleri imzalar.

  3. Kurulum kodunu ekleyin

    Kaynağınıza uyan yöntemi seçin. Örnekler SDK belgelerinden ve Tracking API kılavuzundan alınır; <alan> ya da <your-domain> yerine toplama adresinizi, pk_live_… yerine yazma anahtarınızı yazın.

    Sitenin <head> bölümüne · HTML
    <script>
  !function(){var m=window.metrics=window.metrics||[];if(m.load)return;m.q=[];["page","track","identify","group","alias","reset","consent"].forEach(function(k){m[k]=function(){m.q.push([k].concat([].slice.call(arguments)))}});
  var s=document.createElement("script");s.async=1;s.src="https://collect.<your-domain>/m.js";document.head.appendChild(s);
  m.load=function(k,o){m.q.unshift(["load",k,o])};}();
  metrics.load("pk_live_…", { consent: "required" });
  metrics.page();
</script>

  4. Bağlantıyı test edin

    Kurulum sekmesindeki Bağlantıyı test et düğmesi anahtarı ve (varsa) imzayı doğrular, hiçbir şey kaydetmez. Aynı denetimi POST /v1/ping ile kendiniz de yapabilirsiniz; yanıt kaynağı, ortamı ve imzanın durumunu söyler.

    Bağlantı testi · Bash
    curl -X POST https://collect.<alan>/v1/ping \
  -u "$WRITE_KEY:" -H "Content-Type: application/json" -d '{}'

  5. Canlı akışta doğrulayın

    Kodu yayına aldıktan sonra Veri › Canlı akış açın. Gelen her mesaj birkaç saniye içinde doğrulama sonucuyla görünür; satıra tıklayınca saklanan değerler ya da ret sebepleri açılır. Reddedilen mesajlar 7 gün tutulur.

    • Geçerli: olay şemaya uyuyor ve saklandı.
    • Planlanmamış: olay şemada tanımlı değil; esnek ve keşif kiplerinde kabul edildi ve Keşfedilen kutusuna düştü.
    • Dönüştürüldü: bir değer tanımdaki tipe çevrilerek kabul edildi (ör. "12" → 12).
    • Reddedildi: mesaj saklanmadı; sebebi code, path ve açıklamayla yazar (ör. property_required, pii_detected).

  6. Olayları şemaya bağlayın

    Veri › Olay şemaları › Keşfedilen kutusundaki olayları Tanım olarak ekle ile tanımlayın, her iş olayını bir iş rolüne bağlayın. Şema oturunca doğrulama kipini strict’e alın; CI’da metrics validate ile örnek olayları denetleyin, metrics pull ile tipli istemci üretin.

Sırada