Mənim saytım: öz saytınızda vidcetlər

«Mənim saytım» bölməsi saytı artıq olan istifadəçilər üçündür. Bizim mağazaya köçmək və nəyisə daşımaq lazım deyil: mövcud saytınıza bir sətir kod yerləşdirirsiniz və bundan sonra hesabda lazımi məhsulları açarlarla işə salırsınız.

Açılır: Admin panel → Marketinq → «Mənim saytım» (admin.cenaly.com).

<script> yerləşdirmək mümkün olan istənilən platformada işləyir: WordPress, Tilda, Wix, Shopify, Webflow, Bitrix, InSales, OpenCart, özünün yazdığı sayt, konstruktor açılış səhifəsi.

Saytın ünvanı və quraşdırma kodu#

Bölmənin başlığındakı «🌐 Saytınız» bloku üç addımla aparır: ünvan → saytda kod → yoxlama, əsas düymə isə həmişə növbəti bağlanmamış addımı təklif edir. Birinci — saytınızın ünvanı (məsələn, example.com): onunla quraşdırmanı yoxlayırıq və vidcetlərdə düzgün keçidlər qururuq.

İkinci — quraşdırma kodu. Bu, bir sətirdir:

<script src="https://cdn.cenaly.com/site/v1.js" data-domain="SİZİN-DOMEN" async></script>

Onu bir dəfə yerləşdirin — <head> içinə və ya </body>-dən əvvəl. Bir daha saytın koduna qayıtmaq lazım deyil: vidcetlərin tərkibi səhifədəki teqlərlə deyil, hesabdakı açarlarla müəyyən edilir. Vidceti işə saldınız — bir neçə dəqiqə ərzində saytda görünür, söndürdünüz — yox olur.

Əvvəllər ayrı-ayrı vidcet teqlərini əl ilə yerləşdirmişsinizsə, onlar işləməyə davam edəcək: vahid yükləyici onları görür və vidceti ikinci dəfə qaldırmır.

Populyar platformalarda quraşdırma#

«Quraşdırma kodu» pəncərəsində hər platforma üçün ayrıca vərəq var — addımlar aşağıdakı kimidir.

Burada hər platformanın öz lövbəri var və linki təkrar danışmaq əvəzinə saytı redaktə edən şəxsə göndərə bilərsiniz: #html, #google-tag-manager, #wordpress, #tilda, #wix, #shopify, #webflow, #squarespace — məsələn, /ru/docs/site-widgets#tilda.

Hər bənddə təkrarlamamaq üçün bütün platformalar üçün ümumi olan:

• teq bütün sayt üçün bir dəfə qoyulur — ayrıca səhifəyə deyil, ümumi şablona;
• konstruktorlarda (Tilda, Wix, Webflow, Squarespace) düzəliş sayt yenidən dərc olunana qədər redaktorda qalır;
• canlı saytı yoxlamaq lazımdır, redaktorun önizləməsini deyil;
• saytın qarşısında keş və ya CDN varsa, onu sıfırlayın: həm ziyarətçiyə, həm də bizim yoxlamaya teqsiz saxlanmış səhifə kopyası verilə bilər;
• quraşdırma yoxlamasının bununla nəyi görmədiyi — aşağıda ayrıca izah.

HTML#

Şablonuna girişiniz olan istənilən sayt: özünüz yazdığınız, açılış səhifəsi, statik generator.

1. Kod sətrini kopyalayın: Marketinq → «Mənim saytım».
2. Onu saytın ümumi şablonunun <head> hissəsinə və ya </body> teqindən əvvəl yerləşdirin.
3. Ümumi şablon yoxdursa (səhifələr ayrı-ayrı fayllardır) — hər səhifəyə yerləşdirin.
4. Dəyişiklikləri serverə yükləyin, saytı açın və «Quraşdırmanı yoxla» düyməsini basın.

Google Tag Manager#

Şablona giriş olmadıqda və saytda artıq GTM varsa uyğundur.

1. Teqlər → Yarat → növ «Fərdi HTML».
2. Kod sətrini yerləşdirin, tetik — «Bütün səhifələr», yadda saxlayın.
3. «Dərc et» düyməsini basın: konteyner versiyası dərc olunana qədər canlı saytda teq yoxdur.

⚠️ GTM-dən qaldırılan teqi bizim «Quraşdırmanı yoxla» funksiyamız heç vaxt görməyəcək — bu xəta deyil, metodun nəticəsidir: «Quraşdırma yoxlaması nəyi görmür». Saytı açın və gözlərinizlə baxın.

WordPress#

1. WordPress konsolu (saytınız/wp-admin), administrator hüquqları lazımdır.
2. Etibarlı yol: Plaginlər → Əlavə et → header/footer-ə kod yerləşdirmək üçün istənilən plagin → onun parametrlərində sətri Header sahəsinə yerləşdirin → yadda saxlayın.
3. Plaginsiz yol: Görünüş → Tema fayllarının redaktoru → header.php (bağlayıcı </head>-dən əvvəl) və ya footer.php (bağlayıcı </body>-dən əvvəl) → «Faylı yenilə».
4. Saytı açın və «Quraşdırmanı yoxla» düyməsini basın.

⚠️ Valideyn temanın fayllarına edilən düzəliş onun yenilənməsi zamanı itir — WordPress sənədləri də bu barədə xəbərdarlıq edir. Kod yerləşdirmə plagini və ya törəmə tema yenilənmədən sağ çıxacaq. Keşləmə plagini (W3 Total Cache, WP Rocket və bənzərləri) varsa — keşi təmizləyin, əks halda yoxlama səhifənin köhnə kopyasını görəcək.

💡 Vidcetlər üçün ayrıca plagin quraşdırmaq lazım deyil: onları bir teq qoşur. Cenaly Consent plagini başqa şeylə bağlıdır, o sizin üçün yalnız cookie bannerinin teqini qoyur (bax: Cookies və razılıq).

Tilda#

1. Layihələr siyahısında lazımi saytın «Sayt parametrləri» (səhifənin deyil, layihənin parametrləri).
2. «Digər» bölməsi (bəzi hesablarda «Kod yerləşdirmə» kimi imzalanıb) → «Head daxilinə yerləşdirmək üçün HTML kodu» sahəsi.
3. Sətri yerləşdirin və yadda saxlayın.
4. Layihənin bütün səhifələrini yenidən dərc edin — bu olmadan kod yalnız redaktorda qalır.
5. Canlı saytı açın və «Quraşdırmanı yoxla» düyməsini basın.

💡 Teq yalnız bir səhifədə lazımdırsa — həmin sahə «Səhifə parametrləri» → «Əlavə» bölməsində də var; o zaman yalnız həmin səhifəni yenidən dərc etmək lazımdır.

Wix#

1. Sayt dərc olunmalı, domen isə qoşulmalıdır: bu, Wix-in öz kodu üçün şərtidir.
2. Settings (Parametrlər) → Development & integrations (İnkişaf və inteqrasiyalar) → Custom Code.
3. «+ Add Custom Code» → sətri yerləşdirin, fraqmentə aydın ad verin.
4. Bütün səhifələrə (All pages) tətbiq edin, bir dəfə yüklənsin, yerləşdirmə yeri — Head. Yadda saxlayın.
5. Publish düyməsini basın, canlı saytı açın və «Quraşdırmanı yoxla» düyməsini basın.

⚠️ Wix-də kod fraqmentləri domenə bağlıdır: sayta başqa domen təyin etmisinizsə — fraqmentlər silinir, teqi yenidən yerləşdirməli olacaqsınız.

Shopify#

1. Shopify admin paneli → Onlayn mağaza (Online Store) → Temalar.
2. Lazımi temanın «…» → Duplicate: temanın kopyası — geri qayıtma yolunuz.
3. Yenə «…» → Kodu redaktə et (Edit code).
4. Solda Layout qovluğu → theme.liquid faylı → sətri bağlayıcı </head>-dən əvvəl (və ya </body>-dən əvvəl) yerləşdirin → Save.
5. Mağazanın vitrinini açın və «Quraşdırmanı yoxla» düyməsini basın.

⚠️ Düzəliş mağazaya deyil, temaya aiddir: temanı dəyişmisinizsə və ya yenidən yaratmısınızsa — teqi yenisinə yerləşdirin, əks halda vidcetlər köhnə temayla birlikdə yox olacaq. Shopify-ın sifariş rəsmiləşdirmə səhifələri temanın ixtiyari skriptləri üçün bağlıdır — vidcetlər vitrin üçün nəzərdə tutulub.

Webflow#

1. Lazımi layihənin Site settings → Custom code vərəqi.
2. Head code sahəsi → sətri yerləşdirin və yadda saxlayın. Bu sahəyə yalnız skriptin özü yazılır: html, head, body teqlərini əlavə etmək lazım deyil.
3. Publish düyməsini basın — redaktorda və önizləmədə öz kodunuz işləmir.
4. Dərc olunmuş saytı açın və «Quraşdırmanı yoxla» düyməsini basın.

⚠️ Webflow-un sayt parametrlərində öz kod sahələri ödənişli Site plan-da açılır. Vidcet yalnız bir səhifədə lazımdırsa — səhifənin öz parametrlərində öz kod sahələri var.

Squarespace#

1. Sayt paneli → Website → Website Tools → Code Injection.
2. Header sahəsi (hər səhifənin <head> hissəsinə düşür) → sətri yerləşdirin → Save.
3. Canlı saytı açın və «Quraşdırmanı yoxla» düyməsini basın.

⚠️ Code Injection paneli Core, Plus, Advanced planlarında və Squarespace-in bəzi köhnə planlarında mövcuddur. Səhifədəki kod bloku (Code Block) onu əvəz etmir: o, kodu bir səhifənin daxilinə qoyur, vidcetlər isə bütün saytda lazımdır.

Addımlar platformaların rəsmi yardım sənədləri ilə yoxlanılıb. Platforma menyu bəndinin adını dəyişibsə — bizə deyil, onun yardım sənədlərinə güvənin və bizə yazın: düzəldək.

On iki vidcet#

Hər vidcet ayrıca kartdır — üzərində açar və ayarlar dişli çarxı var. Vidcetlərin topladığı məlumatlar kabinetin adi bölmələrinə düşür — ayrıca «sayt üçün inboks» yaratmaq lazım deyil.

Yükləmə sırası təsadüfi deyil: cookie banneri bizim vidcetlərimiz arasında birinci yüklənir. Vahid asinxron yükləyici əvvəlcə ayarları oxuyur və saytın artıq işə saldığı analitikanı qabaqlaya bilmir. Əgər trekerlərdən əvvəl bloklama lazımdırsa, ayrıca consent/v1.js teqini <head>-də birinci, async və defer olmadan quraşdırın — razılıq haqqında məqalədə təsvir edildiyi kimi. Çoxdüymə aqreqasiya olunan vidcetlərdən sonra gəlir, «Canlı mağaza» isə ən sonuncu: onun nişanları həmin küncdəki düymələri nəzərə alır.

cenaly.ru-dakı cookie bannerinin məhdudiyyətləri var: razılıqlar jurnalı və CSV hələ toplanmır, cookies skaneri əlçatan deyil, bəyannamə əl ilə aparılır. Konfiq əlçatan olmadıqda cari versiya trekerlərin bloklanmasını götürür; quraşdırmadan sonra banneri və səhifənin faktiki sorğularını yoxlayın. Tam şərtlər — Cookies və razılıq-da.

Dəstək mərkəzi «Məqalələr və səhifələr» bölməsində hazırlanmalı və ya bilik bazasından dərc edilməli olan dərc edilmiş məqalələri göstərir. Düymə məqalələri özü yaratmır. Kömək analitikasında bu panel daxilindəki səhifə hadisələri «sayt» mənbəyinə aid edilir; «vidcet» mənbəyi çatdakı kömək tabını bildirir.

Hüquqi sənədlər əvvəlcə bizim hostinqimizdə dərc edilməlidir. Vidcet dərc edilmiş versiyaları link, pəncərə və ya səhifədə mətn kimi göstərir; kabinetdə yenidən dərc onları yeniləyir. Bu, qanunvericilikdəki dəyişikliklərin avtomatik izlənməsi deyil.

Çoxdüymə sadəcə link siyahısı deyil: onun dəvət buludcuğu («Sualınız var?»), göstərilmə şərtləri (hansı səhifələrdə, neçə saniyədən sonra, yalnız telefonda və ya hər yerdə), messencerlər üçün ilk mesaj qaralaması və kanallar üzrə öz klik statistikası var.

«Canlı mağaza» sosial sübutu sizin öz məlumatlarınızda — sifarişlər, rezervasiyalar və görüşlər — göstərir və bunu dürüst edir: nişanda ad və telefon yoxdur, hadisələr aqreqasiya olunub, köhnəlmiş hadisələr isə müəssisənin təqviminə görə göstərilməsini dayandırır (dünən bağlanmış müəssisə dünənki sifarişləri «satmır»).

«Pop-uplar və formalar» kartında açar və dişli çarxın yanında «✨ Şablondan yarat» düyməsi var: o, vidcetin eyni ayarlar pəncərəsini açır, amma dərhal hazır ssenarilər qalereyası ilə — və siz «Hazırdır» düyməsini basmayana qədər heç nə saxlamır.

«Hüquqi sənədlər» paneli artıq beş addımlı masterə göndərmir: ölkə, sənəd dəsti, fəaliyyətinizlə bağlı suallar, rekvizitlər və dil bir ekrandadır, avtodoldurma və önizləmə yığılıb, aşağıda — «Dərc ediləcək sənədlər: N» sayğacı. Artıq verilmiş cavablara zidd olan seçim, səbəbi izah edilməklə kilidlənir.

Habın açıq pəncərələri səhifənin ünvanında yaşayır: vidcetin dişli çarxı ?widget=<vidcet> yazır, quraşdırma kodu pəncərəsi — ?panel=install. Deməli, konkret vidcetin ayarına linki həmkarınıza göndərə bilərsiniz və o, F5-i və «geri» düyməsini keçəcək.

Bəzi vidcetlərə açar azdır — məzmun da lazımdır:

• Onlayn görüş saytda o zaman görünəcək ki, menyuda «Xidmət» tipli ən azı bir maddə var və rezervasiya aktivdir (masa rezervasiyasındakı eyni açar);
• Dəstək mərkəzi açar ilə dərhal işə düşür, amma dərc edilmiş məqalə olmadan boş kömək səhifəsi açacaq — vidcetin ayarlarında neçə məqalənin dərc edildiyi görünür.

Rezervasiya məhdudiyyətləri. Hazırda masa rezervasiyası vidceti seçilmiş tarix və vaxtı qonağın brauzerinin saat qurşağında çevirir. Başqa qurşaqdan olan ziyarətçi üçün jurnaldakı vaxt müəssisənin gözlədiyi vaxtdan fərqlənə bilər — təsdiqləyərkən onu yoxlayın. Müraciətin göndərilməsi barədə mesaj da həmişə serverin rezervasiyanı artıq təsdiqlədiyini bildirmir. Əgər onlayn görüş təsdiqin gecikməsi barədə xəbər verirsə, əvvəlcə görüşlər jurnalını yoxlayın: yeni cəhd dublikat yarada bilər.

Söndürmənin yoxlanması. Vidceti söndürdükdən sonra saytı yoxlayın və məlumatlar yeniləndikdən sonra ayarları yenidən açın. Cari versiyada açar lokal olaraq sönə bilər, amma əvvəlki aktivləşdirmə serverdə qala bilər. Ayrıca vidceti təcili dayandırmaq lazımdırsa, onun ayrıca teqini silin və ya dəstəyə müraciət edin; ümumi teqi silmək onun qoşduğu bütün dəsti dərhal dayandıracaq.

Hər kartın düymələrinin üstündə — 7 günlük mini-statistika: göstərilmələr, açılmalar və vidcetin mənasına görə üçüncü rəqəm (müraciətlər, sifarişlər, rezervasiyalar, görüşlər, söhbətlər, dialoqlar, kliklər). «—» məlumatın heç olmadığını, «0» isə telemetriyanın olduğunu, amma hadisənin baş vermədiyini bildirir; «Ətraflı →» «Sayt vidcetləri» daşbordunda aparır.

Onlayn sifariş ayarlar pəncərəsində başqasının saytı üçün daha bir düymə var — «🔔 Mövcudluq barədə bildir»: siz öz kataloqunuzdan mal və variant seçirsiniz, satılıb qurtarmış malın səhifəsindəki düyməni işarələyirsiniz, qonaq isə poçtunu qoyur, linklə təsdiqləyir və mal yenidən mövcud olduqda bir məktub alır. Başqasının kataloqunu oxumuruq və başqa səhifədən qalıqları götürmürük — mal əl ilə bağlanır. Ətraflı — Öz saytınızda onlayn sifariş məqaləsində.

Saytınızda artıq olan formalar#

Kartlar şəbəkəsinin altındakı «📝 Saytınızda artıq olan formalar» bloku «saytda müraciət forması artıq var və onu heç kim dəyişməyəcək» halı üçündür. Biz onu əvəz etmirik və saxlamırıq: forma əvvəlki kimi sizin backendinizə göndərilir, müraciətin surəti isə kabinetə düşür.

Qayda — formanın CSS seçicisi, «ad / telefon / poçt» sahələrinin ünvanları (dəyər sadəcə sahə adı da ola bilər, məsələn phone, seçici də ola bilər input[name="tel"]), istəyə bağlı səhifə maskaları və açar. Bir filiala 10-a qədər qayda, hər formaya bir qayda. Forma seçicisi və ya telefon, yaxud poçt olmayan qaydanı işə salmaq mümkün deyil — onun toplayacağı heç nə yoxdur. Hər sətrin «Yoxla» düyməsi var: server səhifəni oxuyur və formanın tapılıb-tapılmadığını, qaydanın sahələrinin orada olub-olmadığını və ümumiyyətlə hansı sahə adlarının olduğunu cavablandırır.

Məhz nə gedir. Düz üç sahə — ad, telefon, poçt — üstəgəl parametrsiz və ankorsuz səhifə ünvanı. «Göndər» basılmadan əvvəlki daxiletmə oxunmur, öz yoxlamamızı və gecikmələrimizi əlavə etmirik, brauzerin öz yoxlamasından keçməyən forma isə müraciət yaratmır. Server eyni kontaktla eyni formanın təkrarını 10 dəqiqə ərzində boğur; eyni vaxtda göndərmələr və ya markerin yazılmasında nasazlıq zamanı dublikat mümkündür. Öz vidcetlərimizin formaları dinlənilmir.

Tutma müraciətin surətini serverin cavabını gözləmədən göndərir. Şəbəkə kəsildikdə və ya sorğu brauzer tərəfindən bloklandıqda surət çatmaya bilər: əlaqə bərpa olunduqdan sonra çatdırılma növbəsi hazırda yoxdur. Eyni səhifədə eyni kontaktla təkrar da səhifə yenidən yüklənənə qədər boğulur. Göndərmə işarəsi tutma cəhdini bildirir, daxil olmanı isə inboksda yoxlayın.

Harada axtarmaq. «Müraciətlər» bölməsi və kontakt-mərkəzin «Müraciətlər» vərəqi — «Saytdakı formalar: <qaydanın başlığı>» qrupu ilə. Hər belə müraciətin yanında dürüst işarə var: biz «Göndər» basılmasını görürük, sizin backendinizdəki məlumatın taleyini yox.

⚠️ «Yoxla» düyməsi HTML-i brauzersiz təhlil edir: JavaScript-in çəkdiyi formanı görməyəcək — qonağın brauzerindəki tutma isə onu görəcək. Panel bunu açıq deyir.

Fəaliyyətlərə linklər və QR#

Kartlar şəbəkəsinin altındakı «🔗 Fəaliyyətlərə linklər və QR» bloku saytınızda bir konkret fəaliyyəti açan link düzəldir: https://ваш-сайт/#cenaly=book — rezervasiya forması, #cenaly=appointment:<xidmət> — birbaşa xidmətə görüş, #cenaly=order:<məhsul> — məhsul kartı, həmçinin çat, geri zəng, arayış, sənəd (legal:<tip>), çoxdüymə yelpazəsi və dəstəyə müraciət (#cenaly=support — çatın «Müraciətlər» vərəqi, #cenaly=support:<kateqoriya> — dərhal həmin kateqoriya ilə forma). Belə link adətən QR-kodla çap olunur: masada, qəbzdə, qablaşdırmada, oflayn reklamda.

Necə yığılır: fəaliyyəti seçin, istəyə bağlı — konkret obyekti (xidmət və ya dərc edilmiş menyudan maddə, dərc edilmiş sənəd) və «harada yerləşdirirsiniz» — sizin analitikanız üçün UTM işarələri bundan asılıdır (utm_source=qr&utm_medium=<yer>&utm_campaign=<fəaliyyət>; biz onları oxumuruq). Nəticədə — «Kopyala» düyməsi olan link və PNG və SVG kimi yüklənən QR-kod. Linkin bazası saytınızın ünvanıdır, göstərilməyibsə — bizim mağazamız. Hər vidcetin kartında artıq seçilmiş fəaliyyətlə qısa «🔗 Link» düyməsi var.

Niyə ? parametri deyil, # ankoru: yad CMS-lər, keş plaginləri və CDN naməlum parametrləri kəsir və kanonik ünvanı dəyişir, ankoru isə brauzer serverə göndərmir — o, mütləq bizim kodumuza çatır. Onu vahid teq icra edir: ankoru yükləmə zamanı bir dəfə oxuyur, ünvandan çıxarır və lazımi vidceti o qalxdıqda açır. Vidcetlərin tək teqləri ankoru oxumur.

Blok tiraj çapından əvvəl xəbərdarlıq edir: fəaliyyət vidceti söndürülüb, son yoxlamada saytda quraşdırma kodu tapılmadı. Link söndürülmüşü işə salmır və olmayan sənədi əvəz etmir — bu halda o, sadəcə heç nə etmir: yad saytda bu xətadan yaxşıdır. İstisna birdir və qəsdən edilib: müraciətlər söndürülmüş halda müraciətə link adi çatı açır — qonaq yenə də yaza bilər, blok isə əvvəlcədən xəbərdarlıq edir ki, müraciətlər söndürülüb. Həmin link müəssisənin bizim mağazamızda da işləyir, o cümlədən arayış, sənədlər və çoxdüymə — stiker bir dəfə çap olunur, sayt isə dəyişə bilər.

Vidcet onlayn görüş haqqında ətraflı#

Tənzimləmələr — “Onlayn görüş” kartı → dişli çarx: düymənin rəngi, mətni, ekran küncü və dili. Elə orada, tənzimləmələrin altında yalnız bu vidcet üçün hazır kod sətri var — yalnız onu quraşdırdığınız hal üçün.

Dil. Standart olaraq — avto: vidcet yerləşdiyi səhifənin dilində danışır və 45 dil bilir. Lüğətdən yalnız lazım olan yüklənir, buna görə bu, saytın sürətinə təsir etmir. Siyahıda bir dili birdəfəlik sabitləmək olar — məsələn, sayt ikidillidirsə, amma görüşləri bir dildə qeyd etmək istəyirsinizsə.

Konkret xidmətə və ya ustaya keçidlər. Vidcetin teqinə atributlar əlavə etmək olar — qonaq dərhal lazımi addıma düşəcək:

Köhnəlmiş identifikator (xidmətin adı dəyişdirilib, usta işdən çıxıb) vidceti sındırmır: o, səssizcə birinci addımdan adi seçimi göstərir.

Görüşə qədər daha az addım:

• yeganə xidmət və ya yeganə uyğun usta — artıq ekran göstərilmir;
• “⚡ Ən yaxın: bu gün 17:30” çipi bir toxunuşla qeyd edir, təqvim isə özü boş vaxtı olan ilk gündə açılır;
• ad, telefon və e-poçt qonağın cihazında yadda saxlanılır: təkrar qeyd zamanı sahələr artıq doldurulub, “Mən deyiləm” keçidi isə onları silir;
• telefonda panel tam ekranda açılır, qeyd düyməsi klaviaturanın altında gizlənmir;
• vidcetdən klaviatura ilə istifadə etmək olar, o, ekran oxuyan proqram tərəfindən düzgün oxunur.

Poçt. E-poçt sahəsi məcburi deyil; qonaq ünvanı qoyubsa — vizitin təfərrüatları və “Görüşü idarə et” keçidi olan məktub alacaq, bu keçidlə özü viziti başqa vaxta keçirə və ya ləğv edə bilər. Təfərrüatlar — Görüş jurnalı bölməsində.

Vidcet nə verdi. Görüş jurnalında “🌐 Saytda vidcet” düyməsi 7, 30 və ya 90 gün üçün huni göstərir: düyməni neçə dəfə görüblər, neçə qonaq paneli açıb, kontaktlara qədər çatıb və qeyd olunub, məşğul vaxta görə neçə görüş itirilib. Saytdan gələn görüşlərin özündə “Saytdan” nişanı var.

Quraşdırmanın yoxlanılması#

«Quraşdırmanı yoxla» düyməsi saytınızı açır və səhifənin ilkin HTML-ni oxuyur. Cavabda:

• «Vidcet kodu saytda tapıldı» — vahid teq yerindədir;
• «Yalnız ayrı-ayrı vidcet teqləri tapıldı» — köhnə tək əlavələr işləyir, vahid teq yoxdur;
• «Saytdakı kod başqa filiala aiddir» — teqdə yad data-domain var (bir neçə müəssisə olduqda tez-tez rast gəlinən səhv);
• «Bu səhifədə vidcet kodu yoxdur» — teq görünmür.

⚠️ Yoxlama bir səhifənin ilkin HTML-ni oxuyur. Əgər teqi artıq brauzerdə Google Tag Manager və ya başqa skript əlavə edirsə, yoxlama onu görməyəcək — bu səhv deyil. Metodun hüdudlarından kənarda qalan başqa hallar aşağıda «Yoxlamanın görmədikləri» bölməsində toplanıb.

Həftədə bir dəfə həmin yoxlama özü təkrarlanır — sayt ünvanı göstərilmiş, ən azı bir vidceti aktiv olan və əvvəlki yoxlamada teqi tapan filiallar üçün. Teq səssizcə ölür — sayt yeni temaya keçib, podratçı əlavəsiz kod yerləşdirib, keş plaqini «artıq» skripti atıb — və əvvəllər bunu yalnız müraciətlərin bitməsindən görürdülər. İndi «teq var idi → teq yoxdur» keçidi işçi çata kart kimi (filial üzrə həftədə birdən çox olmamaqla) və «Saytınız» blokunda qırmızı üçüncü addım kimi gəlir. Açılmayan sayt (taymaut, server xətası) nasazlıq sayılmır — gələn həftə yoxlayacağıq; Google Tag Manager vasitəsilə əlavə edilmiş teqi yoxlama heç vaxt görmür, ona görə də onunla bağlı yanlış həyəcan da olmayacaq.

Həmin təhlil ictimai, kabinetə giriş olmadan da əlçatandır — «Saytın yoxlanılması» səhifəsi: ünvanı daxil edin, o, səhifənin HTML-ni oxuyacaq və sayğacları və pikseli adbaad göstərəcək, razılıq banneri var ya yox (bizim, yad və ya heç biri) və aktiv vidcetləri olan teqimiz görünür ya yox. Onunla saytı qoşulmadan əvvəl yoxlamaq və linki tərtibatçıya və ya müştəriyə vermək rahatdır.

Bölmədə vidcet kartlarının altında daha iki blok var: «Öz kodunuzda mağaza (Headless)» — saytı tərtibatçınız yazdıqda və vidcetlərimizə ehtiyac olmadıqda verilənlər, API və vebhuklar üçün, — və hazır tək teqlərlə «Qabaqcıl: hər vidcet üçün ayrı teq». Yəni tək teqi yalnız «keçmişdən gətirmək» deyil, buradan da götürmək olar.

Yoxlamanın görmədikləri#

Yoxlamanın metodu sadə və dürüstdür: bir ünvandan ilkin HTML üçün bir sorğu, brauzersiz. Biz serverin verdiyini oxuyur və işarələmədə yollarımızla <script src="…"> axtarırıq. Buradan onun bacarmadıqlarının bütün siyahısı çıxır — və bu nasazlıq deyil, metodun hüdududur.

Yoxlamanın yaxşı gördüyü: ilkin işarələmədə teqimiz var ya yox, vahiddir ya tək teqlər toplusudur və içində kimin data-domain-i dayanır — yəni «kodu qonşu filialdan kopyalamışam» kimi ən tez-tez rast gəlinən səhvi tutur.

İctimai «Saytın yoxlanılması» səhifəsinin də hüdudu eynilə budur: o da ilkin HTML-ni oxuyur və skriptləri icra etmir. Real cookies və artıq brauzerdə yüklənənləri yalnız CMP skaneri toplayır — bax Cookies və razılıq.

Nasazlıqların aradan qaldırılması#

Bütün on iki vidcet üçün ümumi siyahı — ən tez-tez rast gəlinən səbəbdən nadir hallara qədər. Konkret vidcetin xüsusiyyətləri onun məqaləsində təsvir olunub.

1. «Quraşdırmanın yoxlanılması» kodun olmadığını bildirir. Teq yeridilməyib, şablonun bütün səhifələrinə yeridilməyib və ya sayt yeridildikdən sonra dərc olunmayıb (Tilda, Wix, Webflow yenidən dərc tələb edir). Bölmənin başlığındakı sayt ünvanını da yoxlayın: yoxlama məhz onun üzrə gedir — və yalnız onun üzrə, bir səhifə ilə. Nəyisə düzəltməzdən əvvəl «Quraşdırmanın yoxlanılması nəyi görmür» siyahısı ilə tutuşdurun: «kod yoxdur» hallarının yarısı saytın nasazlığı deyil, metodun sərhədidir.

2. Saytdakı kod başqa filiala aiddir. Teqdə başqa data-domain dayanır — bu, bir neçə müəssisə olduqda və kod qonşu kartdan kopyalandıqda tez-tez rast gəlinən səhvdir. Kodu lazımi filial seçilmiş halda götürün.

3. Yoxlama Google Tag Manager vasitəsilə yeridilmiş teqi görmür. Bu səhv deyil. Yoxlama səhifənin ilkin HTML-ni oxuyur — serverin verdiyini —, GTM isə teqi artıq brauzerdə yeridir. Saytı açın və gözlə baxın: vidcet ya var, ya yox. Yoxlama metodunun göstərmədiyi hər şeyin tam siyahısı (GTM, saytın ikinci səhifəsi, SPA, qapalı sayt) — «Quraşdırmanın yoxlanılması nəyi görmür».

4. Dəyişikliklər saytda görünmədi. Vidcet faylları 5 dəqiqə keşi olan CDN vasitəsilə verilir. Açarı yandırdıqdan və ya tənzimləmələri düzəltikdən sonra bir neçə dəqiqə gözləyin və səhifəni keşi təmizləyərək yeniləyin (Ctrl+F5). Brauzer inadla köhnəni göstərirsə — inkognito rejimində yoxlayın.

5. Vidcet yandırılıb, amma səhifədə görünmür. Siyahı ilə keçin:

• vidcet ödənişlidir və ödənilməyib — ödənilməmiş genişləndirmə serverdə saytın məlumatlarından kəsilir, ona görə açar yandırılmış olsa da səhifəyə düşməyəcək;
• vidcetin göstərilmə şərtləri var (multidüymə, geri zəng, «Canlı mağaza»): səhifə maskası, gecikmə, cihaz filtri və ya cədvəl məhz bu səhifəni və bu anı kənarlaşdıra bilərdi;
• vidcetə məzmun çatmır: onlayn görüş menyuda ən azı bir xidmət mövqeyi olduqda və rezervasiya yandırıldıqda görünür; dərc olunmuş məqaləsi olmayan dəstək mərkəzi boş panel açacaq; tək kanalı olmayan multidüymə heç cür çəkilmir; «Canlı mağaza» isə rəqəmlər həddən aşağı olduqca susur;
• multidüymə qonşunun düyməsini udub: onun yelpazəsində «Çatı aç» və ya «Geri zəng» bəndi varsa, həmin vidcetlərin öz düymələri qəsdən söndürülür — onlar artıq yelpazənin içindədir.

6. Ekranın küncündə bir neçə düymə bir-birini itələyir. Multidüyməni yandırın və yelpazəsinə lazımi vidcetlərin hərəkətlərini əlavə edin — onların ayrı-ayrı düymələri özləri sönəcək.

7. Saytımızın konstruktoru ilə hazırlanmış saytda vidcetlər yoxdur. Orada quraşdırma kodu şablona tikilib və kabinetdə kod bloku göstərilmir — bu normaldır. Vidcetlərin açarlarını yoxlayın: yeni yaradılmış sayt yandırılmış cookie-banner, hüquqi sənədlər və çatla gəlir, qalanı əl ilə yandırılır. Səthlərin fərqini də nəzərə alın: multidüymə bizim mağazada yalnız ayrı «Bizim mağazada da göstər» açarı ilə göstərilir (o, səhifənin doğma düymələrini udur), «Canlı mağaza» isə başqa saytdakı kimi həmin bir açar ilə işləyir.

Content-Security-Policy ilə sayt#

Əgər serveriniz Content-Security-Policy başlığını göndərirsə, quraşdırma kodumuzun nəyi yükləyə biləcəyinə brauzer özü qərar verir. Teqin özü işləyir — siz ona icazə vermisiniz — amma onun dartdığı hər şey səssizcə bloklana bilər: kənardan bu, "vidcetlər yoxa çıxdı" kimi görünür. Brauzerin konsolunda isə Refused to load the script tipli sətirlər görünür.

Boşluq yalnız bir rejimdə yaranır: siyasət skriptlərə yalnız birdəfəlik nonce ilə icazə verir, 'strict-dynamic' olmadan və CDN hostumuz siyahıda olmadan. Aşağıda bunu bağlamağın üç yolu var — ən sadədən başlayaraq.

Variant 1 — teqimizdə nonce#

Serveriniz hər cavabda yeni təsadüfi dəyər yaradır, onu həm başlığa, həm də teqə qoyur:

Content-Security-Policy: script-src 'nonce-r4nd0m...'

<script nonce="r4nd0m..." src="https://cdn.<ваш бренд>/site/v1.js" data-domain="ВАША-ЛОКАЦИЯ" async></script>

Vahid teq öz teqinin nonce-unu oxuyur və onu yerləşdirdiyi hər vidcet bundluna ötürür — onlar script-src yoxlamasından keçir. Sorğular, stillər və daxili səhifələr üçün də aşağıdakı cədvəldən icazələr lazımdır. Ayrıca "Mədaxil barədə məlumat ver" formasının aşağıda təsvir olunan məhdudiyyəti var.

⚠️ Bütün cavablarda eyni olan sabit dəyər nonce deyil: səhifəyə kod yerləşdirə bilən hər kəs onu öz skriptinə köçürəcək. Hər cavab üçün serverdə yaradın.

Variant 2 — 'strict-dynamic'#

Content-Security-Policy: script-src 'nonce-r4nd0m...' 'strict-dynamic'

'strict-dynamic' ilə teqimizə olan etimad onun yerləşdirdiyi skriptlərə, o cümlədən "Ağıllı pop-uplar"ın tənbəl hissələrinə şamil olunur. Bu, skriptlər üçün direktiv nümunəsidir: default-src, connect-src, style-src və ya frame-src məhdudiyyətləri olduqda aşağıdakı cədvəldən uyğun icazələri əlavə edin.

Variant 3 — host siyahısı#

Nonce sizin üçün əlçatan deyilsə (sayt konstruktorlarında belə olur), hostlarımıza açıq icazə verin:

Content-Security-Policy: script-src https://cdn.<ваш бренд>;
  connect-src https://cdn.<ваш бренд> https://api.<ваш бренд> wss://ws.<ваш бренд> https://o.<ваш бренд>;
  img-src https://cdn.<ваш бренд> https://i.<ваш бренд>;
  frame-src https://cdn.<ваш бренд> https://ваша-локация.<ваш бренд>;
  style-src 'unsafe-inline'

Brendinizin və lokasiyanızın hostları yerinə qoyulmuş hazır snippet kabinetdədir: Marketinq → Mənim saytım, quraşdırma kodunun altındakı "Content-Security-Policy olan sayt?" bloku — orada həm də "Kopyala" düyməsi və hər hostun hansı vidcetə lazım olduğunu göstərən qeyd var.

Nə kimə lazımdır:

Bunun əhatə etmədikləri — dürüstcə#

• Stillər. Pəncərələrin tərtibatı Shadow DOM daxilində inline <style>-dır, ona görə style-src 'unsafe-inline' lazımdır. Bu, script-src-ə təsir etmir: skriptlər üçün 'unsafe-inline' və 'unsafe-eval' istəmirik.
• Vidcetlərin tənbəl hissələri (genişləndirilmiş pop-uplar və "Ağıllı pop-uplar"ın slotları, razılıq bannerinin yaş qapısı, çoxdüymənin mobil barı, formaların tutulması) öz yükləyiciləri ilə yüklənir və nonce alır — onlar əsas bundlla eyni yoxlamadan keçir. İstisna "Mədaxil barədə məlumat ver" düyməsinin formasıdır (stock/form-v1.js): bu, vahid yükləyicidən kənar ayrıca teqdir və nonce-u hələ ötürmür — yalnız nonce ilə siyasət olduqda, CDN hostumuz olmadan, abunəlik forması açılmayacaq.
• Sayt konstruktorları (Tilda, Wix və bənzərləri) başlığı özləri göndərir və orada öz teqiniz üçün birdəfəlik nonce yaza bilməzsiniz. Host siyahısı variantı qalır — əgər platforma ümumiyyətlə siyasəti redaktə etməyə imkan verirsə.
• Saytdan zəng səsi WebRTC axını ilə ötürür və media faylları yükləmir, ona görə ona media-src lazım deyil; mikrofona Permissions-Policy və HTTPS icazə verir, CSP yox.

Vidceti ayrı bölmə kimi çıxarmaq#

Əgər vidcetlərdən biri əsas məhsulunuzdursa (məsələn, yalnız pop-uplardan və ya yalnız cookie bannerindən istifadə edirsinizsə), "Marketinq → Mənim saytım → kart → dişli çarx" yolu çox uzundur. Kartda "Yan panelə çıxar" düyməsi var — vidcet öz menyu bəndini alacaq və bir kliklə açılacaq.

Bu, interfeysinizin tənzimləməsidir: yalnız bölmənin görünməsinə nəzarət edir, vidcetin saytdakı işinə yox.

Saytın ümumi tənzimləmələri — ünvan, quraşdırma kodu və yoxlama — "Mənim saytım"da qalır: bu bənd menyuda vidcet bölməsinin yanında durur, ona görə çıxarılmış bölmədə "← Saytın bütün vidcetləri" keçidi yoxdur. Vidceti yan paneldən çıxarsanız, keçid qayıdır.

Vidcetin öz səhifəsində həmin düymə tənzimləmə blokunun yuxarı çərçivəsində, sağda durur. Çıxarılmış vidcetdə o, "Yan paneldə" kimi imzalanıb — bəndi menyudan çıxarmaq üçün ona basın; düymə isə yerində qalır.

Nə pulsuzdur, nə də ödənişli genişlənmədir#

Vidcetlərin bir hissəsi abunəliyə daxildir, bir hissəsi isə "Genişlənmələr" bölməsində genişlənmə kimi qoşulur: Rezervasiya, Pop-up və formalar, Dəstək mərkəzi və Hüquqi sənədlər ödənişli kimi işarələnib — kartında "💳 Ödənişli genişlənmə" çipi var.

Ödənişli vidcet yalnız satın alındıqdan sonra işə düşür. Ödənilməmiş vidcetin açarına basmaq onu işə salmır, bölmənin içində ödəniş pəncərəsini açır; ödənişdən sonra vidcet özü işə düşür. Ödənilməmiş vidcetin "💳 Ödənişli genişlənmə" çipi də ödəniş düyməsidir, ödənilmiş vidcetdə isə o, abunəliyə baxmaq üçün kataloqa aparır. Giriş mövcud alışdan asılıdır. Abunəliyin dəyişdirilməsi və sayt parametrlərinin yenilənməsi ayrı-ayrı əməliyyatlardır: əgər satın almadan sonra vidcet görünməyibsə, açarı yoxlayın və lokasiyanın parametrlərini yadda saxlayın. Beş dəqiqəlik keş yenilənmiş məlumatların dərcindən hesablanır; abunəlik statusunun özünün dəyişməsi hazırda belə dərcə zəmanət vermir.

Bizim konstruktorla hazırlanmış saytda "Hüquqi sənədlər" və cookie-banner pulsuzdur. Onların kartlarında "ödənişli" əvəzinə "🎁 Sayta daxildir" çipi var və ödəniş pəncərəsi ümumiyyətlə göstərilmir: bu upsell deyil, saytdan qanuni istifadə üçün şərtdir. Yeni yaradılmış sayt dərhal işə salınmış cookie-banner, hüquqi sənədlər və çatla gəlir. Yad saytda "Hüquqi sənədlər" genişlənməsi ayrıca ödənilir. Cari habda cookie-banner dörd ödənişli vidcetin siyahısına daxil deyil.

Planlar və ödəniş — Tətbiq mağazası və Abunəlik bölmələrindədir.

Əlaqəli bölmələr#

• Sayt konstruktoru — əgər öz saytınız yoxdursa və bizim mağazaya ehtiyacınız varsa
• Öz kodunuzda mağaza (headless) — əgər saytı tərtibatçınız yazırsa və məlumatları bizdən götürürsə
• Öz domeniniz — öz domeninizin bizim mağazaya qoşulması

Tez-tez verilən suallar#

Öz saytınızdan imtina etmək lazımdır? Xeyr. Vidcetlər saytınızın üzərində işləyir, markalanmanı və hostinqi dəyişmirsiniz.

Bir neçə vidcet varsa, neçə teq yerləşdirmək lazımdır? Bir. Vidcetlərin tərkibi — kabinetdəki açarlardır.

Vidcet saytı yavaşladacaqmı? Yükləyici asinxron (async) qoşulur və səhifənin çəkilməsini bloklamır; hər vidcet ayrı kiçik fayl kimi və yalnız işə salınıbsa yüklənir. Söndürülmüş vidcet ümumiyyətlə yüklənmir.

Vidcet markalanmanı poza bilərmi? Xeyr. Hər vidcet təcrid olunmuş konteynerdə (Shadow DOM) çəkilir: saytınızın stilləri vidcetin içinə axmır, vidcetin stilləri isə bayıra. İstisna qəsdən onlayn-sifariş vidcetidir: o, "Səbətə" düymələrini xüsusi olaraq sizin markalanmanıza yerləşdirir və bu, önizləmə ilə tənzimlənir (bax: Öz saytınızda onlayn-sifariş).

Vidcet hansı dildə danışacaq? O, səhifənin dilinə baxır: əvvəlcə teqdəki data-lang atributuna, əgər onu təyin etmisinizsə, sonra HTML səhifənizin lang atributuna, sonra qonağın brauzer dilinə, ən son halda isə ingilis dilinə. Lüğətlər müxtəlif həcmdədir: cookie-banner, onlayn-qeydiyyat vidceti və çat pəncərəsi 45 dil bilir (çat başlıqları səhifənin dilinə uyğun ayrı dil paketi ilə gəlir), qalanlarında ingilis, rus, gürcü və türk dilləri daxil edilib və ingilis dilinə keçid var. Düymə başlıqlarını və dəvətləri özünüz təyin edirsiniz — saytın hər dili üçün ayrı sətirdə.

Vidcetlərin topladığı məlumatlar harada saxlanılır? Brendinizin buludunda: cenaly.com üçün — AWS, cenaly.ru üçün — Yandex Cloud; rus müəssisələrinin məlumatları Rusiyada qalır. Müraciətlər, sifarişlər, rezervasiyalar və yazışmalar kabinetinizə düşür, publik CDN-ə isə yalnız vidcet parametrləri və onsuz da publik olan şeylər (menyu, iş saatları, dərc edilmiş sənədlər, "Canlı mağaza"nın şəxsiyyətsizləşdirilmiş rəqəmləri) gedir.

Mənim bir neçə müəssisəm var — nə etməliyəm? Vidcetlər lokasiya üzrə tənzimlənir: bölmənin yuxarısındakı siyahıdan onu seçin və onun quraşdırma kodunu götürün. Hər saytın öz data-domain-i var.

Vidcetləri bir neçə fərqli sayta qoymaq olar? Bəli, bir lokasiyanın teqini bir neçə səhifəyə və ya sayta yerləşdirmək olar — məlumatlar bir lokasiyaya gələcək.