Ö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şirSitenizin 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.
- Proje ayarlarında sitenizin tam alan adını (ör. https://magaza.example.com) İzinli Alan Adları listesine ekleyin.
- Canlı yayına geçtiğinizde üretilen yayınlanabilir anahtarı pk_live_ANAHTARINIZ alanına yerleştirin.
- Sayfa başlığı ve breadcrumb bağlamının otomatik okunması için otomatik bağlam özniteliğini etkin bırakın.
<!-- Ö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> -->WordPress sitelerine ekleme
Önizleme — yükleyici ve paketler yayına alma adımında etkinleşirTema güncellemesinde silinmemesi için alt tema (child theme) altbilgi şablonunu veya kod parçacığı (snippet) yönetim eklentinizi kullanın.
- WordPress yönetim panelinizde site genelinde altbilgi (footer) betiği eklediğiniz alanı açın.
- Aşağıdaki <script> etiketini yalnızca herkese açık sayfalarda çalışacak şekilde yapıştırın (wp-admin yönetim ekranlarına eklemeyin).
- Önbellek eklentisi kullanıyorsanız betiğin eşzamansız (async) özniteliğini koruyarak önbelleği temizleyin.
<!-- Ö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> -->Shopify mağazalarına ekleme
Önizleme — yükleyici ve paketler yayına alma adımında etkinleşirÜrün ve koleksiyon sayfalarındaki breadcrumb yapısını otomatik algılamak için mağaza temanızın ana şablonuna yükleyici betiği ekleyin.
- Mağaza temanızın ana düzen dosyasında (ör. theme.liquid) </body> kapanış etiketinin hemen üstüne betiği yerleştirin.
- Mağaza birincil alan adınızı (ör. https://magaza.example.com) proje izinli origin listesine tanımlayın.
- Yayın öncesi sahip önizlemesi ile ürün sayfalarında kaynak alıntılarını doğrulayın.
<!-- Ö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> -->React ve TypeScript SDK entegrasyonu (Önizleme)
Önizleme — yükleyici ve paketler yayına alma adımında etkinleşirTek sayfa uygulamalarda rota geçişlerini ve aktif sayfa bağlamını doğrudan bileşen ağacınızdan iletin.
Not: Canlı ortamda NPM/React SDK kullanımı seçili abonelik planınızın SDK erişim hakkına tabidir. Plan kapsamlarını Fiyatlandırma sayfasından inceleyebilirsiniz.
- Paket yöneticinizle resmi React ve çekirdek SDK paketlerini projenize ekleyin.
- Yayınlanabilir anahtarınızı ortam değişkeninden okuyun; gizli sunucu anahtarını asla tarayıcı koduna gömmeyin.
- Rota ve kategori değişimlerinde sayfa bağlamını sağlanan kanca ile güncelleyin.
// Önizleme — yükleyici ve paketler yayına alma adımında etkinleşir
// pnpm add @chatsaas/react @chatsaas/sdk
import { AssistantProvider, useAssistant, usePageBreadcrumb } from '@chatsaas/react';
import type { ReactNode } from 'react';
export function AppAssistantBoundary({ children }: { readonly children: ReactNode }) {
return (
<AssistantProvider
publishableKey="pk_live_ANAHTARINIZ"
apiBaseUrl="https://api.trailcite.com"
autoCaptureContext
>
{children}
</AssistantProvider>
);
}
export function ProductPageContextSync({
currentUrl,
pageTitle,
breadcrumbs
}: {
readonly currentUrl: string;
readonly pageTitle: string;
readonly breadcrumbs: readonly string[];
}) {
const assistant = useAssistant();
usePageBreadcrumb(breadcrumbs, { url: currentUrl, title: pageTitle });
return (
<button
type="button"
onClick={() => {
assistant.setContext({ url: currentUrl, title: pageTitle });
}}
>
Sayfa bağlamını güncelle ({assistant.getContext().breadcrumbs?.join(' / ') ?? pageTitle})
</button>
);
}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.
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.
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.
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.