Geliştirici ve site kurulumu

Önizleme

Kurulum rehberi

TrailCite bileşenini tek satırlık Shadow DOM betiğiyle veya React SDK paketiyle sitenize nasıl ekleyeceğinizi inceleyin.

Önizleme rehberi — Canlı yayın adımı açılana kadar hazırlık amaçlıdır

Kurulum kodunuzu projenizin Kurulum ekranından alın. Aşağıdaki şablonlar güvenlik politikası (CSP), alan adı izinleri ve entegrasyon yapısını önceden hazırlamanız için sunulmuştur; pk_live_ANAHTARINIZ yer tutucusu canlı anahtar üretilene kadar gerçek ziyaretçi trafiği başlatmaz.

Platform kurulum şablonları

Standart HTML kurulum kodu (Önizleme)

Önizleme — yükleyici ve paketler yayına alma adımında etkinleşir

Sitenizin kapanış </body> etiketinden hemen önce kullanılacak yükleyici şablonudur. Yükleyici yayına alma adımında etkinleştiğinde Shadow DOM içinde çalışır ve sitenizin CSS kurallarını etkilemez.

  1. Proje ayarlarında sitenizin tam alan adını (ör. https://magaza.example.com) İzinli Alan Adları listesine ekleyin.
  2. Canlı yayına geçtiğinizde üretilen yayınlanabilir anahtarı pk_live_ANAHTARINIZ alanına yerleştirin.
  3. Sayfa başlığı ve breadcrumb bağlamının otomatik okunması için otomatik bağlam özniteliğini etkin bırakın.
https://cdn.trailcite.com/widget/c9f0f8c2be6c7baa0f1444aaddcdd4a7/loader.js
<!-- Önizleme — yükleyici ve paketler yayına alma adımında etkinleşir -->
<!-- TrailCite Shadow DOM Yükleyici -->
<script
  src="https://cdn.trailcite.com/widget/c9f0f8c2be6c7baa0f1444aaddcdd4a7/loader.js"
  data-trailcite-publishable-key="pk_live_ANAHTARINIZ"
  data-trailcite-auto-context="true"
  async
></script>
<!-- Özel konumlandırma için isteğe bağlı bileşen etiketi: <assistant-chat-widget></assistant-chat-widget> -->

Canlı yayına geçmeden önce 3 adımlı kontrol listesi

Ziyaretçi trafiğini açmadan önce kurulumu yalnızca sizin görebileceğiniz sahip önizlemesiyle doğrulayın.

  1. Alan adınızı izinli listeye ekleyin ve doğrulayın

    Proje Ayarları ekranından sitenizin tam HTTPS adresini (ör. https://magaza.example.com) ekleyin ve dosya tabanlı sahiplik doğrulamasını tamamlayın.

  2. Yükleyici şablonunu yerleştirip Kurulum Kontrolünü çalıştırın

    Konsoldaki Kurulum Kodu ekranından önizleme betiğini sitenize ekleyin; el sıkışma ve sayfa bağlamı sinyallerinin algılandığını otomatik denetimle görün.

  3. Plan seçip canlı yayınlanabilir anahtara geçin

    Yanıt kalitesini sahip önizlemesinde onayladıktan sonra uygun abonelik planını etkinleştirin ve canlı yayınlanabilir anahtarınızı şablona yerleştirin.

Otomatik sayfa ve breadcrumb bağlamı nasıl okunur?

Yükleyici betiği otomatik bağlam kipi açıkken sayfadaki mevcut semantik işaretleri ek yapılandırma gerektirmeden okur:

Gizlilik ve kapsam ilkesi

İstemci yalnızca sayfa adresi, başlık, aktif bölüm başlığı ve kategori kırılımını gönderir; form alanlarını, çerezleri veya parola girdilerini okumaz.

Veri özniteliği / SDK kancası
data-trailcite-breadcrumb veya usePageBreadcrumb()1. öncelik — dinamik tek sayfa uygulamalar için önerilir
Schema.org yapısal verisi
application/ld+json (BreadcrumbList)2. öncelik — e-ticaret ve katalog şablonlarında otomatik algılanır
Semantik HTML gezinmesi
nav[aria-label*="breadcrumb"] ve ana <h1> başlığı3. öncelik — erişilebilir standart şablonlardan okunur
Temizlenmiş URL dizini
Sayfa yolu segmentleri + <title>4. öncelik — ek işaretleme olmayan sayfalarda yedek olarak kullanılır

Güvenlik politikası, izinli alan adları ve sorun giderme

  • İçerik Güvenlik Politikası başlıkları

    Siteniz sıkı bir Content-Security-Policy başlığı kullanıyorsa script-src yönergesine https://cdn.trailcite.com/widget/c9f0f8c2be6c7baa0f1444aaddcdd4a7 kaynağını ve connect-src yönergesine API uç noktanızı ekleyin.

  • İzinli alan adı kontrolü

    Yayınlanabilir anahtar yalnızca projenizde onayladığınız tam alan adlarından (ör. https://magaza.example.com) gelen isteklere yanıt verir; eşleşmeyen alan adlarında bileşen sessizce kapalı kalır.

  • Bileşen sayfada neden görünmüyor?

    Deneme süresinde bileşen gerçek ziyaretçilere açılmaz. Yalnızca aktif ücretli abonelik ve yayın onayı tamamlandığında genel ziyaretçilere yanıt verir.