OneTrace.pro Yardım merkezi

Web sitesini bağlama

İzleyici, web sitenizin sayfalarındaki küçük bir betiktir. Sayfa görüntülemelerini sayar, müşterilerin eylemlerini (ürün görüntüleme, sepet, sipariş, giriş) gönderir, öneri widget'larını gösterir ve ziyaretçileri Web Push'a abone eder. Bağlantı için gereken her şey İletişim → Web sitesi bölümünde toplanmıştır.

Bölüm projenin tüm üyelerine açıktır. Web sitesi alan adlarını ve widget'ları “Sahip”, “Yönetici” ve “Müdür” değiştirebilir. Web sitesi için anahtarı “Sahip” ve “Yönetici” oluşturabilir.

İzleyiciyi kurma

Kurulum sekmesinde üç adım vardır.

1. Her sayfa için kod

  1. Yazma anahtarı alanında bir anahtar seçin. Anahtar yoksa Web sitesi anahtarı oluştur düğmesine tıklayın.
  2. Kodu kopyalama düğmesiyle kopyalayın.
  3. Kodu web sitesinin tüm sayfalarının <head> bölümüne yapıştırın; genellikle ortak başlık şablonuna.

Kod şöyle görünür (bölümde adres ve anahtar zaten eklenmiştir):

<script>
!function(w,d,u){var c=w.cdp=w.cdp||[];if(c.version)return;['init','page','track','identify','alias','reset','widgets','renderRecommendations'].forEach(function(m){c[m]=c[m]||function(){c.push([m].concat([].slice.call(arguments)))}});var s=d.createElement('script');s.async=1;s.src=u;d.head.appendChild(s)}(window,document,'https://cdp.onetrace.pro/tracker/cdp.js');
cdp.init('cdp_wk_…', { host: 'https://cdp.onetrace.pro' });
cdp.page();
</script>

Betik eşzamansız yüklenir ve web sitesini yavaşlatmaz. cdp.track() çağrılarını koddan hemen sonra yapabilirsiniz: izleyicinin yüklenmesini beklerler. İzleyici her tarayıcıya kalıcı bir ziyaretçi tanımlayıcısı verir (bir yıllık cdp_aid çerezi) ve ziyaretin UTM etiketlerini kaydeder.

Yazma anahtarı sayfa kodunda görünür ve bu normaldir: yalnızca olay gönderebilir. Listede anahtarlar kullanılamıyorsa bunlar bu bölüm eklenmeden önce oluşturulmuştur ve tam olarak gösterilemez. Yeni bir web sitesi anahtarı oluşturun veya anahtarı web sitesinde zaten bulunan koddan alın.

“Kurulum” sekmesi: izleyici kodu ve kurulum kontrolü

2. Kontrol

Kurulumdan sonra web sitesinin herhangi bir sayfasını açın. Birkaç saniye içinde Kontrol bloğunda bir tablo görünür: Alan adı, 7 gündeki olaylar ve son olayın zamanı. Olay olmadığı sürece bölüm “İlk olaylar bekleniyor” mesajını gösterir. Bölüm açık olduğu sürece kontrol her 10 saniyede bir kendiliğinden güncellenir.

3. Web sitesi alan adları

Başka bir sitenin projeniz adına olay gönderememesi ve önerileri alamaması için kendi web sitenizin alan adlarını belirtin:

  1. Bir alan adı girin, örneğin shop.example.com, ve + düğmesine tıklayın. Kontrol tablosundaki bir alan adı Alan adlarına ekle düğmesiyle eklenir.
  2. Kaydet düğmesine tıklayın.

Bir alan adı kendi alt alan adlarına da izin verir: shop.com.tr, www.shop.com.tr adresini de kabul eder. Liste boş olduğu sürece anahtar her web sitesinde çalışır (“Kısıtlama yok”). Sunucunuzdan gelen istekler bu kısıtlamadan etkilenmez. En fazla 20 alan adı belirtebilirsiniz.

Müşterinin girişi ve çıkışı

Giriş veya kayıttan sonra cdp.identify() fonksiyonunu sisteminizdeki kullanıcı id'siyle çağırın; ziyaret geçmişi müşterinin profiline bağlanır:

cdp.identify('user-42', { email: '[email protected]' });

User ID'yi yalnızca giriş yapmış kullanıcılar için gönderin ve 0 veya guest gibi ortak değerler kullanmayın: aynı User ID'ye sahip profiller birleştirilir. Hesaptan çıkışta, bu bilgisayardaki bir sonraki kişinin yeni bir tanımlayıcı alması için cdp.reset() çağırın.

Ürün olayları

Ürün olayları sekmesi dört eylem için hazır çağrıları gösterir: Ürün görüntüleme, Sepete ekleme, Sipariş ve Giriş ve kayıt. Olay adları ve ürün id özelliği (varsayılan olarak product_id) Öneriler bölümünün ayarlarından alınır. Orada olaylar seçilmemişse bir uyarı görürsünüz ve örneklerde varsayılan adlar kullanılır: product_viewed, add_to_cart, order_completed.

Sipariş örneği; tüm ürünler products dizisinde gönderilir:

cdp.track('order_completed', {
  order_id: 'A-1001',
  amount: 9980,
  products: [{ product_id: 'SKU-1', quantity: 2, price: 4990 }],
});

Her adımın bir işareti vardır: 7 günde kaç olay geldiği ve sonuncusunun ne zaman geldiği ya da “7 gündür olay yok”. Böylece hangi çağrıların henüz çalışmadığı görülür. Ürün id'si, ürün kataloğundaki id ile aynı olmalıdır.

Alınan olay işaretleriyle “Ürün olayları” sekmesi

Siparişleri ve kayıtları sunucunuzdan göndermek daha güvenilirdir; bkz. Sunucu entegrasyonu.

Web Push

Web Push sekmesi kanalın bağlı olup olmadığını ve kaç abonelik bulunduğunu gösterir. Kanal yoksa Entegrasyonları aç bağlantısıyla oluşturun; anahtarlar kendiliğinden oluşur (bkz. Entegrasyonlar ve kanallar). Ardından:

  1. Service worker dosyası. Web sitesinin kök dizininde tek satırlık bir cdp-sw.js dosyası oluşturun: 
    importScripts('https://cdp.onetrace.pro/tracker/cdp-sw.js');
  2. Abone olma düğmesi. Web sitesine, tıklandığında cdp.push.subscribe() çağıran bir düğme ekleyin. Tarayıcı bildirim iznini yalnızca ziyaretçinin bir eylemi üzerine ister.

Bildirimler yalnızca HTTPS kullanan web sitelerinde çalışır. Abonelik ziyaretçinin profiline bağlanır.

“Web Push” sekmesi: kanal durumu ve web sitesi kodu

CMS ve Google Tag Manager

CMS ve GTM sekmesinde kendi web siteniz, Google Tag Manager, 1C-Bitrix, Tilda, WordPress ve WooCommerce, InSales için adım adım talimatlar bulunur: kurulum kodunun, olayların ve widget'ların nereye ekleneceği.

Örneğin Google Tag Manager'da kurulum kodunu içeren ve “Tüm Sayfalar” tetikleyicisini kullanan bir “Özel HTML” etiketi oluşturun. Ürün olayları için cdp.track çağıran ve dataLayer olaylarında (view_item, add_to_cart, purchase) tetiklenen ayrı etiketler gerekir. Kapsayıcıyı yayınladıktan sonra olayların gelmeye başladığını Kurulum sekmesinde kontrol edin.

Yapay zekâ ajanıyla bağlama

Sitenizi bir geliştirici yapay zekâ ajanıyla (Claude Code, Codex, Cursor ve diğerleri) yapıyorsa ajana hazır bir skill verin. Yapay zekâ ajanı sekmesinde SKILL.md indir düğmesine tıklayın. Dosyada ajan için İngilizce talimatlar ve projenizin verileri bulunur: OneTrace.pro adresi, seçilen yazma anahtarı, ürün olaylarının adları, widget'lar ve Web Push durumu. Ajan bunlarla kurulum kodunu, ürün olaylarını, giriş ve çıkışı, widget'ları ve bildirim aboneliğini kendisi ekler.

  1. Birden fazla yazma anahtarı varsa gerekeni seçin.
  2. Dosyayı indirip sitenin projesine koyun: Claude Code için .claude/skills/<skill adı>/SKILL.md, Agent Skills destekleyen diğer ajanlar için kendi skill klasörlerine, örneğin .agents/skills/<skill adı>/SKILL.md. Tam yol sekmede gösterilir. Dosyayı ajana yazdığınız mesaja eklemeniz de yeterlidir.
  3. Ajana görevi yazın; sekmede örnek bir metin vardır.

Gizli anahtarlar skill'e asla eklenmez. Öneri ayarlarında olayları değiştirirseniz veya widget eklerseniz skill'i yeniden indirin.

Bilmeniz gerekenler

  • İzleyici olayları biriktirir ve gruplar halinde gönderir. Bağlantı koparsa olaylar tarayıcıda saklanır ve daha sonra gönderilir.
  • Web sitesinin tüm olayları Olaylar bölümünde gerçek zamanlı olarak görünür.
  • Öneri widget'ları Widget'lar sekmesinde ayarlanır; bkz. Web sitesinde öneri widget'ları.
← API anahtarları Web sitesinde öneri widget'ları →