آیا حالت پیشنمایش (Preview Mode) در Google Tag Manager برای شما کار نمیکند؟ احتمالاً شما هم مثل بسیاری از کاربران حداقل یکبار با این مشکل روبهرو شدهاید. حالت Preview و Debug فعال میشود، اما روی سایت نه دیده میشود و نه درست کار میکند. در ادامه، چند راهحل کاربردی برای برطرف کردن این مشکل ارائه میدهم که احتمالاً حداقل یکی از آنها به درد شما میخورد.
اگر در حین بررسی، راهحلی پیدا کردید که در این مقاله به آن اشاره نشده، حتماً در بخش نظرات با ما به اشتراک بگذارید. من این محتوا را بهروزرسانی میکنم تا افراد بیشتری بتوانند از تجربیات شما بهرهمند شوند.
۱. کد GTM بهدرستی روی سایت اضافه نشده است
یکی از رایجترین دلایل کار نکردن حالت پیشنمایش، اضافه نشدن صحیح کد تگ منیجر به وبسایت است. فرض کنید از توسعهدهنده خواستهاید که کد GTM را مطابق دستورالعملهای گوگل روی سایت شما قرار دهد. او هم اعلام میکند که کار تمام شده؛ اما همچنان حالت پیشنمایش نمایش داده نمیشود.
پس مشکل کجاست؟ احتمال زیاد این است که کد GTM فقط در نسخهی پیشنویس (draft) ذخیره شده و به نسخهی نهایی و زندهی سایت منتشر نشده است. این اشتباه ساده اما رایج، باعث میشود هیچ اتفاقی روی سایت شما نیفتد.
چگونه بررسی کنیم که کد GTM درست نصب شده؟
چند راه ساده برای این کار وجود دارد:
- استفاده از افزونهی Tag Assistant در مرورگر کروم: این افزونه بررسی میکند که آیا تگهای گوگل مثل Google Analytics، Google Ads یا GTM روی صفحه فعال هستند یا نه.
- بررسی سورس کد سایت: کافیست در مرورگر خود کلیدهای
Ctrl + U
را فشار دهید (یا روی مک،CMD + Option + U
) و دنبال کد کانتینر GTM بگردید.
۲. کد نادرست یا اشتباه GTM روی سایت قرار گرفته
شاید عجیب بهنظر برسد، اما وارد کردن کد اشتباه GTM هم یکی از دلایل رایج است. برای بررسی این موضوع، وارد حساب کاربری Google Tag Manager شوید و در گوشهی بالا سمت راست، شناسهی GTM (Container ID) را بررسی کنید.
حالا کد GTM موجود در سایت خود را با آن مقایسه کنید. میتوانید از همان افزونهی Tag Assistant هم برای مقایسه کمک بگیرید.
نکته مهم: هرگز نباید کدی که از GTM کپی میکنید را تغییر دهید. این کد باید دقیقاً به همان صورت در سایت قرار گیرد؛ هرگونه تغییر، باعث اختلال در عملکرد آن خواهد شد.
۳. پیشنمایش را روی کانتینر اشتباه فعال کردهاید
وقتی چندین اکانت یا کانتینر GTM دارید، ممکن است بهاشتباه حالت پیشنمایش را روی کانتینر اشتباه فعال کنید. این یکی از رایجترین خطاهاست که حتی برای حرفهایها هم پیش میآید. پس همیشه دوباره بررسی کنید که پیشنمایش را روی کانتینر درست فعال کردهاید. برای این کار، میتوانید از روش توضیح داده شده در مرحله دوم راهنمای رسمی گوگل استفاده کنید.
۴. استفاده از مرورگر متفاوت ممنوع!
زمانی که حالت Preview & Debug فعال میشود، یک تب یا پنجره جدید در همان مرورگر باز میکند که سایت را با حالت دیباگ نمایش میدهد. اگر بعد از آن، مرورگر را تغییر دهید یا وارد حالت ناشناس (Incognito) شوید، ممکن است دیباگ به درستی کار نکند. بنابراین، حتماً از همان مرورگری که حالت پیشنمایش را فعال کردهاید استفاده کنید.
۵. پاک کردن کش و کوکی مرورگر
اگر با وجود رعایت نکات بالا، همچنان مشکلاتی دارید، شاید لازم باشد کش (Cache) و کوکی (Cookies) مرورگر را پاکسازی کنید. روش انجام این کار در مرورگرهای مختلف متفاوت است. برای مثال میتوانید در گوگل جستجو کنید:
“نحوه پاک کردن کش و کوکی مرورگر کروم / فایرفاکس / سافاری”
اگر از مرورگر کروم استفاده میکنید، این گزینه در بخش تنظیمات > حریم خصوصی و امنیت در دسترس است.
۶. حذف پارامتر پیشنمایش از آدرس URL
در حالت Preview & Debug، بهطور پیشفرض پارامتر gtm_debug=x
به انتهای آدرس سایت اضافه میشود. اما بعضی وبسایتها ممکن است با این پارامتر به درستی کار نکنند و حتی خطای 404 نمایش دهند. اگر چنین مشکلی دارید، تیک گزینه مربوط به پارامتر دیباگ را در تنظیمات Preview بردارید. این کار ممکن است مشکل را حل کند.
۷. تداخل Cloudflare با بارگذاری فایل gtm.js
یکی از رایجترین CDNهایی که در ایران و جهان استفاده میشود، Cloudflare است. وظیفهی CDN این است که محتوای استاتیک سایت شما (مثل فایلهای CSS، JS و تصاویر) را از نزدیکترین سرور به کاربر نهایی ارائه دهد و این کار باعث افزایش سرعت بارگذاری صفحات میشود.
اما این نکته را در نظر داشته باشید که Cloudflare ممکن است در بارگذاری فایل JavaScript مخصوص GTM (یعنی gtm.js
) اختلال ایجاد کند. مخصوصاً اگر قابلیت Rocket Loader در تنظیمات فعال باشد. این ویژگی با هدف بهینهسازی بارگذاری JS طراحی شده، اما گاهی باعث بههمریختگی عملکرد GTM میشود. از برنامهنویس سایت خود بخواهید بررسی کند که Rocket Loader در Cloudflare غیرفعال باشد.
۸. تغییر ناخواسته کد GTM هنگام کپیبرداری
شاید برایتان پیش آمده باشد که قصد دارید کد کانتینر GTM را برای توسعهدهنده سایت ارسال کنید. معمولاً این کد را از پنل GTM کپی میکنید، در یک فایل Word یا Google Docs قرار میدهید و سپس آن را میفرستید. اما همین کار ساده ممکن است باعث خراب شدن کد شود!
چرا؟ چون ابزارهای ویرایش متن ممکن است برخی از نمادهای کد، مثل نقلقولها (‘ ’)، فاصلهها یا حتی علائم نگارشی را بهصورت خودکار تغییر دهند. در نتیجه، هرچند ظاهر کد تغییری نکرده، ولی GTM دیگر کار نمیکند؛ حالت Preview و Debug هم نمایش داده نمیشود.
✅ راهحل بهتر: کد را در یک فایل .txt
(مثلاً با Notepad) قرار دهید و فایل را مستقیماً برای توسعهدهنده بفرستید. یا از سایت pastebin.com استفاده کنید تا کد بهصورت خام و بدون تغییر در دسترس برنامهنویس باشد.
۹. مسدود شدن پاپآپها و ریدایرکتها توسط مرورگر
یکی دیگر از مشکلاتی که کاربران GTM ممکن است با آن مواجه شوند، مسدود شدن پنجره پیشنمایش (Preview) توسط مرورگر است. وقتی دکمهی Preview را در محیط GTM میزنید، یک تب جدید باز میشود که به سایت tagassistant.google.com متصل میشود.
گاهی مرورگر (مثل Chrome) این پنجره را مسدود میکند. اگر این اتفاق افتاد، کافیست روی آیکن هشدار در نوار آدرس کلیک کنید و گزینهی:
“Always allow popups and redirects from tagassistant.google.com”
را انتخاب کرده و روی “Done” بزنید. این تنظیم فقط برای GTM اعمال میشود و امنیت مرورگر شما را به خطر نمیاندازد.
۱۰. کانتینر را منتشر کنید (حتی اگر جدید نیست)
برخی کاربران گفتهاند که قبل از فعالسازی حالت پیشنمایش، کانتینر را منتشر کردهاند و همین کار به عملکرد بهتر پیشنمایش کمک کرده است. هرچند این مورد تایید قطعی ندارد، اما ارزش امتحان کردن را دارد.
از حالت پیشنمایش خارج شده و دوباره وارد شویدگاهی تنها بستن تب حالت پیشنمایش و تب سایت و سپس ورود مجدد از طریق دکمه “Preview” در پنل GTM، مشکل را حل میکند. این راهحل در چندین مورد مؤثر بوده است.
۱۱. افزونههای مرورگر مانند AdBlock یا Ghostery ممکن است GTM را مسدود کنند
با افزایش استفاده از افزونههای مسدودکننده تبلیغات، ابزارهایی مانند GTM نیز در معرض مسدود شدن قرار گرفتهاند. افزونههایی نظیر Ghostery، AdGuard، AdBlock Plus و حتی uBlock Origin ممکن است مانع اجرای صحیح حالت پیشنمایش شوند.
🔒 اگر یکی از این افزونهها روی مرورگر شما فعال است، موقتاً آن را غیرفعال کرده و دوباره پیشنمایش را بررسی کنید.
۱۲. سیستم شما ممکن است بهصورت خودکار از تنظیم کوکیها جلوگیری کند
در پی اجرای قوانین مربوط به حریم خصوصی مانند GDPR، برخی وبسایتها از ابزارهایی برای بلاککردن خودکار کوکیها استفاده میکنند. نمونههایی از این ابزارها:
- OneTrust Auto-blocking
- CookieBot Auto-blocking
در این حالت، باید مطمئن شوید که کوکی با نام _TAG_ASSISTANT مجاز به ذخیرهسازی است. اگر اطلاعات کافی ندارید، با فردی که در زمینه مدیریت کوکی یا ابزارهای رضایتسنجی تخصص دارد مشورت کنید.
۱۳. بررسی کنید که کانتینر صحیح را انتخاب کردهاید
در صورتی که چند کانتینر در یک سایت استفاده میشود، احتمال دارد شما به اشتباه در حال پیشنمایش کانتینر اشتباهی باشید. با کلیک روی آیکن فلش پایین در گوشه بالا سمت چپ پنجره Preview، کانتینر فعال را بررسی و در صورت نیاز، مورد صحیح را انتخاب کنید.
۱۴. توجه به تفاوت Workspace و Environment
اگر در حال استفاده از Google Tag Manager هستید و در زمان فعالسازی حالت Preview با پیام “هیچ تگی در این کانتینر اجرا نشد” مواجه شدید، احتمال زیادی وجود دارد که در حال پیشنمایش محیط (environment) نیستید، بلکه صرفاً ورکاسپیس (workspace) را مشاهده میکنید. این مسئله میتواند کاربران زیادی را گیج کند. در این مقاله به زبان ساده توضیح میدهیم که دلیل این مشکل چیست و چطور میتوانید آن را برطرف کنید.
تفاوت Workspace و Environment در GTM چیست؟
وقتی Google Tag Manager روی یک وبسایت نصب میشود، معمولاً توسعهدهندگان از اسنیپتی استفاده میکنند که در رابط کاربری GTM و با کلیک روی Container ID قابل دسترسی است. این اسنیپت پیشفرض، پارامترهای اضافی مربوط به Environment را ندارد.
اما گوگل تگ منیجر قابلیتی به نام محیطها (Environments) هم ارائه میدهد که به شما اجازه میدهد نسخههای مختلفی از تگها را برای محیطهای متفاوت مثل توسعه (development)، تست (staging) یا حتی نسخه زنده (live) داشته باشید. هرکدام از این محیطها اسنیپت مخصوص به خودشان را دارند.
مشکل زمانی پیش میآید که…
گاهی اوقات توسعهدهندگان به اشتباه اسنیپت مربوط به محیط Live را روی وبسایت نصب میکنند، در حالی که این اسنیپت با نسخه پیشفرض GTM تفاوتهایی دارد. حالا اگر شما در رابط GTM دکمهی PREVIEW را بزنید، در واقع پیشنمایش ورکاسپیس فعلی فعال میشود، نه محیط خاصی که روی وبسایت نصب شده است. در نتیجه، هیچ تگی لود نمیشود و پیامی شبیه به این دریافت میکنید:
«No tags were evaluated in this container»
راهحل چیست؟
برای اینکه پیشنمایش به درستی عمل کند، باید لینک مخصوص به پیشنمایش همان محیطی که روی سایت نصب شده را ایجاد و استفاده کنید:
- به بخش Admin > Environments در GTM بروید.
- محیط مورد نظر (مثلاً Live) را انتخاب کنید.
- روی Actions > Share Link کلیک کنید.
- حالا با استفاده از این لینک وارد حالت Preview شوید.
نکته مهم: باید حداقل یک نسخهی منتشرشده از GTM روی کانتینر شما وجود داشته باشد تا گزینه Share Link در دسترس قرار بگیرد.
چطور متوجه شویم که کدام اسنیپت روی سایت نصب شده؟
برای این کار:
- به وبسایت بروید.
- روی صفحه راستکلیک کرده و گزینه View Page Source را انتخاب کنید.
- کد GTM را پیدا کرده و با اسنیپت پیشفرض GTM مقایسه کنید.
اگر اسنیپت شامل پارامترهای اضافی بود، یعنی مربوط به یکی از محیطهاست. در این صورت، باید از روش توضیحدادهشده برای فعالسازی پیشنمایش استفاده کنید.
۱۵. از مرورگر Brave برای کار با GTM استفاده نکنید
مرورگر Brave با اینکه به خاطر حفظ حریم خصوصی محبوب شده، اما در کار با ابزارهایی مثل Google Tag Manager (GTM) دردسرساز است. این مرورگر بهطور پیشفرض بسیاری از درخواستهای مرتبط با سرویسهای گوگل، از جمله Google Analytics، Google Ads و همین GTM را مسدود میکند.
اگر Brave مرورگر اصلیتان است، دو راه پیشرو دارید:
- از مرورگر دیگری مثل Chrome یا Microsoft Edge فقط برای کار با GTM استفاده کنید (چون افزونههای زیادی برای این مرورگرها در دسترس است)
- یا قابلیت امنیتی اصلی Brave یعنی Shields را غیرفعال کنید
پیشنهاد حرفهای ما؟ از یک مرورگر دیگر استفاده کنید. چون اگر بخواهید Shields را غیرفعال کنید، عملاً Brave را بیاثر کردهاید.
۱۶. دامنه سایتتان هنوز از HTTP استفاده میکند؟
اگر وبسایت شما هنوز روی HTTP است و نه HTTPS، احتمالاً با مشکل در حالت پیشنمایش GTM مواجه خواهید شد. این قابلیت فقط روی سایتهایی که گواهینامه امنیتی SSL دارند (و آدرسشان با https شروع میشود) به درستی کار میکند.
✅ راهحل ساده است:
از توسعهدهنده یا مدیر وبسایت خود بخواهید که SSL را فعال کرده و مطمئن شود سایت فقط از طریق HTTPS لود میشود. این کار نه تنها برای GTM لازم است، بلکه برای اعتماد کاربران و سئو سایتتان هم حیاتی است.
۱۷. سیاست امنیتی محتوا (CSP) مانع بارگذاری GTM میشود
اگر وبسایتتان از Content Security Policy (CSP) استفاده میکند، ممکن است همین تنظیمات باعث شود حالت پیشنمایش GTM لود نشود. برای تشخیص این موضوع، میتوانید از کنسول توسعهدهنده مرورگر استفاده کنید.
مراحل کار (در ویندوز و مرورگر کروم):
وارد منوی مرورگر شوید → More Tools → Developer Tools → زبانه Console
صفحه را رفرش کنید و دنبال ارورهایی با محتوای “Content Security Policy” بگردید.
اگر چنین خطایی را دیدید، باید با توسعهدهنده سایت تماس بگیرید تا CSP را اصلاح کند. اینجا دیگر راه میانبری وجود ندارد و حتماً نیاز به تغییر در تنظیمات سمت سرور دارید.
۱۸. افزونه GA Debugger را غیرفعال کنید
اگر هنگام استفاده از GA4، در حالت Preview فقط آیدی را میبینید ولی جزئیاتی نمایش داده نمیشود، احتمالاً افزونه GA Debugger در مرورگر شما فعال است. این افزونه باعث میشود حالت دیباگ مخصوص GA4 کار نکند، اما تأثیری روی دیباگ کلی GTM ندارد و تگهای شما همچنان اجرا میشوند.
راهحل: افزونه GA Debugger را غیرفعال کنید تا بتوانید اطلاعات دقیق GA4 را در حالت پیشنمایش مشاهده کنید.
۱۹. مرورگر را کامل ببندید و دوباره باز کنید
گاهی اوقات فقط بستن تب کافی نیست. باید مرورگر را کاملاً ببندید (در Chrome از منوی سهنقطهای گزینه Exit را انتخاب کنید) و مطمئن شوید که فرآیند آن در پسزمینه هم بسته شده است. سپس مرورگر را مجدد باز کنید و وضعیت را بررسی نمایید.
۲۰. سیستم مدیریت رضایت کوکی (Cookie Consent)
اگر از ابزارهایی مثل OneTrust استفاده میکنید و این ابزارها تا زمانی که کاربر روی «موافقم» کلیک نکرده باشد، GTM را بلاک میکنند، حالت Preview نیز تا آن لحظه فعال نخواهد شد.
راهحل: پس از ورود به سایت در حالت پیشنمایش، روی گزینه «موافقم» یا مشابه آن در نوار کوکی کلیک کنید.
۲۱. آرایهای که Data Layer را خراب میکند
گاهی یک قطعه کد اشتباه میتواند Data Layer را مختل کند. مثلاً اگر آرایهای به شکل نادرست به Data Layer پوش داده شود، حالت Preview چیزی نشان نخواهد داد.
راهحل: با توسعهدهنده سایت همکاری کرده و کدی که مشکل ایجاد میکند را حذف یا افزونهای که آن را اضافه میکند، غیرفعال کنید.
۲۲. VPN میتواند مانع GTM شود
برخی سرویسهای VPN بهمنظور افزایش امنیت، دسترسی به سرویسهایی مثل GTM را مسدود میکنند. اگر از VPN استفاده میکنید و حالت Preview درست عمل نمیکند، VPN را غیرفعال کرده و مجدد تست کنید.
۲۳. افزونه TikTok Pixel Helper را غیرفعال کنید
طبق گزارشها، افزونه TikTok Pixel Helper میتواند باعث اختلال در حالت Preview شود. این احتمال وجود دارد که باگ موقتی باشد، اما تا زمان رفع آن، بهتر است افزونه را غیرفعال کنید.
۲۴. حذف افزونه Tag Assistant
در برخی موارد مشاهده شده که افزونه Tag Assistant باعث ایجاد مشکل در حالت Preview میشود. بهطور خاص، حالت پیشنمایش فقط برای اولین بازدید از صفحه کار میکند و پس از آن قطع میشود.
راهحل: این افزونه را حذف یا غیرفعال کرده و عملکرد مجدد را بررسی نمایید.