OneTrace.ru 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','setLanguage','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.ru/tracker/cdp.js');
cdp.init('cdp_wk_…', { host: 'https://cdp.onetrace.ru' });
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.

Tek sayfalı uygulamalar (SPA ve PWA)

React, Vue, Angular ve benzerleriyle yapılan uygulamalarda sayfa yeniden yüklenmez, bu yüzden sayfa görüntülemelerini uygulamanın kendisi göndermelidir: her ekran değişiminden sonra cdp.page() çağırın, ancak ilk yükleme için iki kez çağırmayın — onu kurulum kodu zaten gönderdi. Yönlendirici kancası ilk yüklemede de çalışıyorsa (Vue Router'da afterEach, React'te useEffect), bunun yerine kurulum kodundan cdp.page() çağrısını kaldırın — Kurulum sekmesinde bir örnek var.

// her ekran değişiminden sonra, yönlendirici adresi güncellediğinde
cdp.page();

// kendi adresi olmayan bir ekran veya adres henüz değişmedi
cdp.page('Sepet', { path: '/cart', title: 'Sepet' });

Bir ekranın kendi adresi yoksa (bir pencere, ödeme adımı, adres kullanmayan bir PWA) veya yönlendirici adresi daha sonra değiştiriyorsa sayfayı açıkça iletin: path veya url (göreli olabilir) ve başlık. Bu sayfa hem görüntülemeye hem de sonraki olayların bağlamına girer — örneğin sepete ekleme sepet ekranına bağlanır — ta ki bir sonraki cdp.page() çağrısına kadar. İzleyici ikinci ve sonraki ekranlarda yönlendiren olarak önceki ekranı kabul eder ve ziyaretin UTM etiketlerini sekme kapanana kadar saklar.

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: 'anna@example.com' });

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.

Her kanalın hangi tanımlayıcılara ihtiyaç duyduğunu ve bunların profile nasıl girdiğini Ürün olayları sekmesindeki Müşteri tanımlama tablosu gösterir: e-posta kampanyaları için email, numaraya SMS, WhatsApp ve Viber için uluslararası biçimde phone, Telegram ve Viber botları için ise sunucunuzun oluşturduğu bağlantıyla sohbetin bağlanması. Müşteri hakkında bildiğiniz her şeyi iletin: tanımlayıcı ne kadar çoksa o kadar çok kanal kullanılabilir.

Müşteri dili

İzleyici tarayıcı dilini gönderir ve dil açıkça belirlenene kadar müşteri profiline (language özelliği) kaydedilir. Yolculuklar ve kampanyalar bu dile göre şablonun dil sürümünü seçer. Proje dilleri Kurulum sekmesindeki Müşteri dili bloğunda görünür.

Sitede dil seçici varsa ziyaretçinin seçimini bildirin; seçim hatırlanır ve profile kaydedilir:

cdp.setLanguage('de');

Başka bir dil kaynağı başlatma sırasında belirlenir: language: 'page' — <html> öğesinin lang özniteliği, dil kodu — tüm site için tek dil, false — dili gönderme. Sisteminizde bilinen dili özellik olarak iletebilirsiniz: cdp.identify('user-42', { language: 'de' }).

Ürün olayları

Ürün olayları sekmesi beş eylem için hazır çağrıları gösterir: Ürün görüntüleme, Sepete ekleme, Sipariş, Favoriler 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 }],
});

Favoriler isteğe bağlıdır: add_to_wishlist ve remove_from_wishlist olaylarını, favorilerdeki ürünlerin fiyat düşüşünü ve yeniden stoğa girmesini bildiren yolculuklar kullanır. cdp.addToWishlist('SKU-1') ve cdp.removeFromWishlist('SKU-1') çağrılarını yapın ya da kodsuz yapın: düğmeye data-cdp-wishlist="SKU-1" (ekle) veya data-cdp-wishlist-remove="SKU-1" (çıkar) özniteliğini ekleyin; izleyici olayı tıklamada gönderir.

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.

Davet bağlantıları

Sadakat programında davetler açıksa her üyenin sitenize ?ref=KOD parametreli bir bağlantısı vardır. İzleyici bu parametreyi kendisi fark eder: kodu cdp_ref çerezinde 30 gün saklar ve referral_visited olayını bir kez gönderir. Arkadaş, kaydolduğunda veya siteye giriş yaptığında sayılır. Mağaza eklentileri kayıt sırasında kodu çerezden iletir, kendi siteniz ise API üzerinden.

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.ru/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.ru 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.

“Yapay zekâ ajanı” sekmesi: yapay zekâ ajanı için proje verilerini içeren skill

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

Bilmeniz gerekenler

  • Arama motoru botları, mesajlaşma uygulamalarının bağlantı önizlemeleri, site kontrol hizmetleri ve otomatik tarayıcılar sayılmaz: izleyici onların olaylarını göndermez ve çerez bırakmaz, ancak öneri widget'larını gösterir. Tüm ziyaretçileri saymak için kurulum koduna seçeneği ekleyin: cdp.init('…', { host: '…', ignoreBots: false }).
  • İ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ı.
← YZ asistanları (MCP) Web sitesinde öneri widget'ları →