Clew

ЖИ көмегімен жасалған қолданбадағы турлар мен онбординг

Қолданбаны Lovable, Cursor немесе Claude Code-та жасадыңыз, енді жаңа пайдаланушыларға бағыт көрсету керек пе? Бір промпт жіберіп, бір ғана файл өзгергенін тексеріп, жариялаңыз — турлар, чек-парақтар мен апгрейд терезелерін жаңа промптпен емес, Clew-де жасаңыз.

Уақыты
● 5 минут
Кім орындайды
Сіз және ЖИ-ассистентіңіз
Қадам саны
6

Қадам-қадаммен

  1. Қадам 01

    Clew-ден кодты көшіріңіз

    Clew-ге тіркеліңіз немесе кіріңіз де, Admin → Шолу бөлімін ашыңыз. «Виджеттен әлі сигнал келген жоқ.» карточкасында сайт кілті бар жол тұр — көшіру үшін басыңыз. Кілт 3-қадамда керек болады.

    Clew админкасындағы Шолу бөлімі: «Виджеттен әлі сигнал келген жоқ» карточкасы және кілті жасырылған код жолы
    Қадам 1 · интерфейс сызбасы
  2. Қадам 02

    Жобаны файлдарды өңдейтін режимде ашыңыз

    • Claude Code: жоба қалтасында claude командасын іске қосыңыз.
    • Cursor: Agent режиміндегі чат.
    • Lovable, Bolt.new, v0: жоба чаты.
    • Replit: Agent немесе Assistant.
    Кодтың жанында ЖИ-ассистент чаты ашылған қолданба жобасы
    Қадам 2 · интерфейс сызбасы
  3. Қадам 03

    Промптты өз кілтіңізбен қойыңыз

    Промптты көшіріп, САЙТ_КІЛТІН_ҚОЙЫҢЫЗ орнына өз кілтіңізді қойып, жіберіңіз. Промпт ағылшын тілінде — кодтау ассистенттері оны ең дәл түсінеді. Онда әр стекке дұрыс файл көрсетілген, сондықтан ассистент тегті компоненттерге шашыратпайды.

    Add the Clew onboarding widget to this app.
    
    Insert this exact tag so it loads once on every page, including after client-side route changes:
    <script src="https://tryclew.io/widget/САЙТ_КІЛТІН_ҚОЙЫҢЫЗ.js" async></script>
    
    Where to put it (pick what matches this project):
    - Plain HTML, React + Vite, Vue + Vite: index.html, right before </head>
    - Next.js App Router: app/layout.tsx, with next/script: <Script src="(same URL)" strategy="afterInteractive" /> inside <body>
    - Next.js Pages Router: pages/_app.tsx, the same next/script component
    - Nuxt 3: nuxt.config.ts, app.head.script: [{ src: "(same URL)", async: true }]
    - SvelteKit: src/app.html, right before %sveltekit.head%
    - Astro: the <head> of the shared layout
    - Anything else: the root HTML template or root layout rendered on every page
    
    Rules:
    - Use the URL exactly as given. Do not download the script, bundle it or install an npm package.
    - Add it in one place only, never inside a component that re-renders.
    - If the project sets a Content-Security-Policy, allow https://tryclew.io in script-src and connect-src.
    - Change nothing else, then show me the diff.
    Clew орнату промпты бар ЖИ-ассистент чаты
    Қадам 3 · интерфейс сызбасы
  4. Қадам 04

    Тек бір файл өзгергенін тексеріңіз

    Қабылдамас бұрын diff-ті қараңыз. Күтілетіні: кілтіңіз бар бір файл және бір қосылған жол (немесе Next.js-те шағын <Script> блогы). Ассистент компоненттерді түзесе, пакет орнатса немесе скриптті жобаға көшірсе, оны кері қайтарып, тек тегті қалдыруды сұраңыз.

    Diff: index.html ішінде жабылатын head алдында скрипті бар бір жол қосылған
    Қадам 4 · интерфейс сызбасы
  5. Қадам 05

    Жариялаңыз немесе деплой жасаңыз

    Тег тек жарияланған қолданбада жұмыс істейді. Lovable, Bolt.new, v0 немесе Replit-те Publish не Deploy батырмасын басыңыз. Claude Code мен Cursor-да, хостинг git-тен деплой жасаса, әдеттегідей коммит пен пуш жасаңыз.

    Publish батырмасы ерекшеленген қолданба конструкторының панелі
    Қадам 5 · интерфейс сызбасы
  6. Қадам 06

    Бәрі жұмыс істейтініне көз жеткізіңіз

    Жарияланған қолданбаны браузердің қарапайым терезесінде ашып, Clew-дегі Шолу бөліміне оралыңыз. Бір минут ішінде карточка жасылға айналады: «Виджет жұмыс істеп тұр.»

    Clew админкасындағы Шолу бөлімі: жасыл «Виджет жұмыс істеп тұр» карточкасы
    Қадам 6 · интерфейс сызбасы

Әр стекте тег қайда қойылады

Ассистенттің жұмысын осы кесте бойынша тексеру ыңғайлы. Белгінің орнына — сіздің кілтіңіз.

СтекФайлНе қосылады
Қарапайым HTMLindex.html (әр бетте)</head> алдындағы жол
React + Vite, Vue + Viteжоба түбіріндегі index.html</head> алдындағы жол
Next.js App Routerapp/layout.tsx<body> ішіндегі <Script src="https://tryclew.io/widget/САЙТ_КІЛТІН_ҚОЙЫҢЫЗ.js" strategy="afterInteractive" />
Next.js Pages Routerpages/_app.tsxСол <Script> компоненті
Nuxt 3nuxt.config.tssrc және async: true бар app.head.script элементі
SvelteKitsrc/app.html%sveltekit.head% алдындағы жол
Astroортақ layout<head> ішіндегі жол

Құралдар әдетте не жасайды

Lovable мен Bolt.new жобалары көбіне React + Vite негізінде — тег index.html файлына қойылады. v0 App Router бар Next.js жасайды: app/layout.tsx. Replit-те бәрі шаблонға байланысты. Claude Code мен Cursor репозиторийіңізді оқып, файлды промпттағы тізім бойынша таңдайды.

Бірдеңе жұмыс істемесе

Сайт кілтін ЖИ чатына жіберу қауіпсіз бе?

Иә. Сайт кілті құпиясөз емес: ол жария және бәрібір беттің HTML-іне түседі. Онымен турларды өңдеуге немесе деректеріңізді оқуға болмайды.

Ассистент npm-пакет орнатты немесе скриптті көшірді

Кері қайтаруды сұраңыз. Түзетулер мен жаңа мүмкіндіктер қолданбаға қайта жинаусыз жетуі үшін Clew өз мекенжайынан жүктеледі.

Келесі ЖИ түзетулерінен кейін тег жоғалмай ма?

Әдетте жоғалмайды: ол түбір файлда. Үлкен қайта генерациядан кейін «Шолу» бөлімінде «Виджет жұмыс істеп тұр» күйі жоғалса, промптты қайта жіберіңіз.

Админкада әлі «Виджеттен әлі сигнал келген жоқ» деп тұр

Сайттың бір бетін браузердің қарапайым терезесінде ашып, бір минуттан кейін админканы жаңартыңыз. Көмектеспесе: өзгерістер жай сақталып қана қоймай, жарияланғанын; белгінің орнына өз кілтіңізді қойғаныңызды тексеріңіз; браузердің әзірлеуші құралдарындағы Network қойындысынан widget/…js сұрауын тауып, жауабы 200 екенін қараңыз. 404 жауабы кілттің қате екенін білдіреді.

Сайтта Content Security Policy бапталған

Екі директива, одан басқа ештеңе қажет емес: script-src https://tryclew.io және connect-src https://tryclew.io. Виджет eval, blob: және воркерлерді пайдаланбайды, ал стильдерін таңбалау арқылы емес, CSSOM арқылы қосады — сондықтан Chrome, Edge, Firefox 101+ және Safari 16.4+ браузерлерінде style-src 'unsafe-inline' керек емес. Ескілеу браузерлер қосалқы <style> элементін алады: егер олар сізге маңызды болса және style-src ішінде 'unsafe-inline' болмаса, онда турлар безендірусіз көрінеді. Дайын жол: Content-Security-Policy: script-src 'self' https://tryclew.io; connect-src 'self' https://tryclew.io;

Виджет нұсқасын бекітіп, <code>integrity=</code> қосуға бола ма?

Болады. Нұсқаулықтардағы жол — /widget/САЙТ_КІЛТІН_ҚОЙЫҢЫЗ.js — «жылжымалы»: ол әрқашан ағымдағы виджетті береді, сондықтан оған Subresource Integrity хэшін қосу мүмкін емес (байттар өзгереді). Оның қатарында әр нұсқа мазмұн хэші бар өзгермейтін мекенжай бойынша да беріледі. https://tryclew.io/api/v1/widget-version?site=СІЗДІҢ_КІЛТІҢІЗ сұрауын жіберіңіз — жауапта version, path және integrity болады; екеуін тегке қойыңыз: <script src="https://tryclew.io/widget/v/<нұсқа>/СІЗДІҢ_КІЛТІҢІЗ.js" integrity="sha384-…" crossorigin="anonymous" async></script>. Бекітілген мекенжай өзгермейді, сондықтан бір байт бөлек болса, браузер файлды орындамайды. Нұсқаны қашан жаңартуды өзіңіз шешесіз — сол сұрауды деплой скриптінен жіберуге болады. Қалғаны бұрынғыдай: турлар сайтты түзетпей-ақ Clew редакторында жарияланады.

Жарнама бөгегіші виджетті жасырып қоя ма?

Жоқ. Біздің домен ірі тізімдердің ешқайсысында жоқ — EasyList, EasyPrivacy, AdGuard, uBlock Origin, — сондықтан турлар, қалқымалы кеңестер мен чеклистер бөгегіші қосулы келушілерге де көрінеді. Нәзігірегі — статистика: EasyPrivacy кез келген сыртқы ping сұрауын бөгейді, сол себепті виджет оқиғаларын кәдімгі сұраумен жібереді — оны бұл тізімдер өткізеді. Кез келген жеке тізімнен мүлде тыс қалу үшін виджетті өз доменіңізден таратыңыз: CDN немесе nginx ішінде https://сіздің-сайт/clew/* мекенжайын https://tryclew.io/* дегенге бағыттап, жолды <script src="/clew/widget/СІЗДІҢ_КІЛТ.js" async></script> деп ауыстырыңыз. Виджет API-ға сол префикспен жүгінеді де, бәрі first-party болады.

SPA-да (React, Vue, Next.js) жұмыс істей ме?

Иә. Жолды бір рет — түбір HTML-ге немесе түбір шаблонға қосыңыз. Бетті қайта жүктемей ауысуды виджет өзі қадағалайды (History API және hash өзгерістері), сондықтан оны әр маршрутқа қоспаңыз. Қайта жүктеу еленбейді, бірақ бұл браузерге артық жұмыс.

Cookie келісімі баннері ше?

Clew келуші қай турлардан өткенін есте сақтау және өтулерді санау үшін өз cookie файлын және localStorage жазбаларын сақтайды. Деректер жарнама жүйелеріне жіберілмейді. Виджетті келісімге дейін іске қосуға бола ма — оны деректерді өңдеу саясатыңыз шешеді; баннер оны келісімге дейін бұғаттаса, турлар келісімнен кейін басталады.

Кэштеу немесе оңтайландыру плагині тұр

Орнатқаннан кейін кэшті тазалаңыз, әйтпесе келушілер жолы жоқ ескі беттерді ала береді. Плагин JavaScript-ті кейінге қалдырса, біріктірсе немесе минификацияласа (WP Rocket, LiteSpeed Cache, Битрикстің композиттік режимі), tryclew.io/widget мекенжайын бұл оңтайландырулардан шығарыңыз.

Сайт баяулап кете ме?

Жоқ. Жолда async атрибуты бар: браузер виджетті параллель жүктейді және бетті бұғаттамайды. Виджеттің тәуелділіктері жоқ.

Қолданбам онбординг қадамының бітгенін Clew-ге өзі айта ала ма?

Иә, бұл бір жол. Чек-парақ тармағында келуші ештеңе баспай-ақ оны белгілейтін ереже болуы мүмкін: ол кірген бет, CSS селектормен көрсеткен элементті басу немесе өз кодыңыз жіберетін оқиға — Clew.complete('invited'), мұндағы invited — редакторда тармақтың қасына жазған кілт. Іс шынымен біткен сәтте шақырыңыз, мысалы API жауап бергеннен кейін. Кез келген уақытта шақыруға қауіпсіз: бетте сондай кілті бар чек-парақ болмаса, false қайтады. Ескі TutorKit атауы әлі де жұмыс істейді.

Сайтта бір жол — содан кейін турлар, кеңестер мен чек-парақтар релизсіз.

Турлар, попаптар және ЖИ дәуіріндегі онбординг

Қадам саны, мәтін ережелері мен метрикалары бар 7 паттерн, ЖИ нені өзгертеді және жариялау алдындағы чек-лист. PDF, 2 бет. Ішінде не бар →

Нұсқаулық ағылшын тілінде.