وبلاگ
SignalHost برای BigCommerce: اپ را نصب کنید، یک بار تأیید کنید و هر فروش را سمت سرور ردیابی کنید
منتشرشده · 7 دقیقه مطالعه
اپ SignalHost بدون هیچ کدی برای چسباندن، Google Tag Manager سمت سرور را روی فروشگاه BigCommerce قرار میدهد. از طریق Script Manager دو اسکریپت اضافه میکند، لایه داده خود BigCommerce را به رویدادهای تجارت الکترونیک Google Analytics تبدیل میکند، هر وقت چیزی در سمت ما تغییر کند هر دو را بهروز نگه میدارد و با حذف اپ، آنها هم میروند. این راهنما به همان ترتیبی پیش میرود که با آن روبهرو میشوید: نصب، اتصال یک کانتینر، تأیید، آزمایش و کارهایی که وقتی چیزی کار نمیکند باید انجام دهید.
پیش از شروع
- یک فروشگاه BigCommerce با پوسته Stencil. اسکریپتها همانجا اجرا میشوند؛ ویترین headless، از جمله Catalyst، نه اسکریپتها را رندر میکند و نه لایه داده BigCommerce را، پس باید کد را مستقیماً به آن اضافه کرد.
- یک حساب SignalHost. طرح رایگان برای امتحان کافی است: ده هزار درخواست در ماه و یک کانتینر. میتوانید حساب را هنگام نصب بسازید.
- فروشگاهی را که هنوز آنلاین نشده هم میتوان وصل کرد. فقط SignalHost تا آنلاین شدنش نمیتواند ویترین آن را بررسی کند.
1. نصب اپ
SignalHost را در BigCommerce App Marketplace باز کنید و نصبش کنید. BigCommerce مجوزهایی را که اپ میخواهد فهرست میکند: Content، برای نوشتن اسکریپتهایش از طریق Script Manager؛ Checkout Content، تا در صفحه پرداخت و تأیید سفارش هم اجرا شوند؛ و Information & Settings، برای نام و ارز فروشگاهتان و روشن کردن لایه داده. تأیید کنید تا صفحه اپ درون پنل کنترل شما باز شود. بعدها آن را در منوی Apps پیدا میکنید.
2. اتصال یک کانتینر
«اتصال به SignalHost» را بزنید. برگهای جدید روی signalhost.io باز میشود؛ وارد شوید یا یک حساب رایگان بسازید (صفحه اپ برای این کار دکمه «ایجاد حساب رایگان» را هم دارد).
صفحه بعدی فهرست میکند که اپ چه کارهایی انجام میدهد و چه کارهایی نه. ردیابی را به همه صفحههای فروشگاهتان، از جمله صفحه پرداخت، اضافه میکند و بهروز نگه میدارد، و بازدید محصولات و رویدادهای سبد خرید، پرداخت و خرید فروشگاهتان را به کانتینر میفرستد. نمیتواند اطلاعات تماس مشتریانتان را بخواند، از حساب Google شما استفاده کند یا صورتحسابتان را ببیند.
یک کانتینر موجود را انتخاب کنید، یا «کانتینر جدید برای فروشگاه شما» را برگزینید و مراحل کوتاه راهاندازی را طی کنید. کانتینر همان سرور تگگذاری خود شماست که در حساب Google خودتان ساخته میشود، پس متعلق به خودتان میماند. ساخت کانتینر جدید چند دقیقه طول میکشد؛ میتوانید بلافاصله وصل کنید و اپ بهمحض آماده شدن آن ردیابی را اضافه میکند. «اتصال» را بزنید. سپس برگه میگوید «تقریباً تمام شد: در BigCommerce تأیید کنید».
3. تأیید در BigCommerce
به صفحه اپ در پنل کنترل برگردید. خودش متوجه بازگشت شما میشود و «اتصال را تأیید کنید» را همراه با حساب شما و کانتینری که انتخاب کردهاید نشان میدهد. «تأیید» را بزنید. پیش از این کار هیچ اسکریپتی به فروشگاه شما اضافه نمیشود.
سپس صفحه میگوید «ردیابی تا چند دقیقه دیگر شروع میشود» و وقتی اسکریپتها سر جایشان قرار گرفتند، «ردیابی فعال است». اگر تا زمان بازگشت شما درخواست منقضی شده باشد، دوباره «اتصال به SignalHost» را بزنید.
4. آزمایش
ویترین فروشگاهتان را باز کنید، محصولی را ببینید، آن را به سبد خرید اضافه کنید و پرداخت را شروع کنید. صفحه اپ «۷ روز گذشته» را میشمارد: «بازدیدهای صفحه»، «افزوده به سبد»، «پرداختهای آغازشده» و «خریدها». وقتی ردیابی فعال شد، نتیجه نگاهی را هم که خود SignalHost به ویترین شما میاندازد گزارش میکند؛ «در صفحه اصلی ویترین فروشگاه شما پیدا شد.» یعنی اسکریپتها آنجا هستند.
«باز کردن آمار و تنظیمات» شما را به صفحه کانتینر میبرد، جایی که زبانه «اخیر» در «تحلیل پیشرفته» 30 دقیقه گذشته را پوشش میدهد. از طرح Growth به بالا، «پایش زندهٔ رویدادها» هم هر رویداد را همان لحظه که میرسد با نامش نشان میدهد.
آنچه اپ به فروشگاه شما اضافه میکند
دو اسکریپت در Script Manager که هر دو را اپ مینویسد و بهروز نگه میدارد:
- SignalHost، در head همه صفحهها، از جمله صفحه پرداخت: بارگذار Google Tag Manager که بهجای googletagmanager.com به نشانی تگگذاری خود شما اشاره میکند. کانتینر Tag Manager شما را از آنجا بارگذاری میکند.
- SignalHost events، در پانویس (footer) همه صفحهها، از جمله صفحه پرداخت و تأیید سفارش: لایه داده BigCommerce را به رویدادهای تجارت الکترونیک Google Analytics تبدیل میکند. بازدید دستهها و محصولات به view_item_list و view_item تبدیل میشوند، سبد خرید به add_to_cart، remove_from_cart و view_cart، و پرداخت به begin_checkout، add_shipping_info، add_payment_info و purchase، همراه با شماره سفارش، مالیات، هزینه ارسال و کوپن.
اسکریپت رویدادها محصولات، مبالغ و شماره سفارش را میخواند، هرگز نام، ایمیل، شماره تلفن یا نشانی مشتری را. بارگذاری دوباره صفحه تأیید سفارش، یک سفارش را در همان مرورگر دو بار نمیشمارد.
لایه داده یک تنظیم فروشگاه است که تا کسی روشنش نکند خاموش میماند. اپ آن را برایتان روشن میکند؛ این کار اسکریپت رویداد خود BigCommerce را به ویترین اضافه میکند و هیچ چیزی را که خریداران شما میبینند تغییر نمیدهد. اگر BigCommerce نپذیرد، صفحه اپ میگوید این کلید کجاست.
هر دو اسکریپت در دسته رضایت Analytics قرار دارند: اگر فروشگاه شما بنر کوکی BigCommerce را نشان میدهد، SignalHost فقط برای خریدارانی اجرا میشود که کوکیهای تحلیلی را مجاز کنند. هر درخواست به شکلی از مرورگر خارج میشود که مسدودکنندههای تبلیغات آن را نمیشناسند، و سرور تگگذاری شما آن را به Google Analytics 4 و پلتفرمهای تبلیغاتیای که در صفحه کانتینر راهاندازی کردهاید منتقل میکند: Google Ads، Meta، TikTok و دیگران.
دامنه ردیابی خودتان
کانتینر شما روی نشانیای زیر signalhost.io شروع به کار میکند. در یک طرح پولی، «راهاندازی دامنه خودتان» در صفحه کانتینر شما را گامبهگام راهنمایی میکند تا بهجای آن از زیردامنهای از سایت خودتان، مانند sgtm.yourstore.com، استفاده کنید؛ زیردامنهای که از فهرستهای فیلتر جان سالم به در میبرد و کوکیهای کلیک را شخص اول نگه میدارد. وقتی فعال شد، اپ ظرف چند دقیقه خودش فروشگاه شما را به آن منتقل میکند. لازم نیست چیزی را دستی جایگزین کنید.
افزودن دستی SignalHost
میتوانید بارگذار را بدون اپ اضافه کنید. در صفحه کانتینر، کد را در کارت «نصب روی سایت شما» پیدا کنید و «کپی» را بزنید. در پنل کنترل، Storefront › Script Manager را باز کنید و اسکریپتی با این کد اضافه کنید، در head همه صفحهها و، اگر فروشگاه شما بنر کوکی BigCommerce را نشان میدهد، در دسته analytics. سپس در صفحه کانتینر «این کار را انجام دادم» را بزنید.
این کار فقط بازدیدهای صفحه را به شما میدهد و نه بیشتر. اسکریپت رویدادها، کلید لایه داده، بررسی ویترین و انتقال خودکار به دامنه خودتان فقط با اپ میآیند؛ وقتی نشانی تگگذاری شما تغییر کند، اسکریپت را خودتان با کد جدیدی که SignalHost برایتان ایمیل میکند جایگزین میکنید. یکی از این دو را به کار ببرید: اگر اپ هم نصب باشد، بارگذار دو بار اجرا میشود.
مدیریت و قطع اتصال
صفحه اپ طرح شما و درخواستهای این ماه را نشان میدهد. هزینه طرح در signalhost.io دریافت میشود، نه توسط BigCommerce، و «ارتقای طرح» آن را همانجا باز میکند. در صفحه کانتینر، کارت نصب «نصبشده با اپ BigCommerce» را نشان میدهد و «مدیریت» به «تنظیمات»، «سایتهای متصل» میرسد.
«قطع اتصال» در پایین صفحه اپ یک بار دیگر زدن را میخواهد و سپس ظرف چند دقیقه هر دو اسکریپت را حذف میکند. «قطع اتصال» در «سایتهای متصل» هم همین کار را میکند. کانتینر و آمارش باقی میمانند و میتوانید فروشگاه را دوباره از صفحه اپ وصل کنید.
حذف اپ از بخش Apps › My Apps هم هر دو اسکریپت را حذف میکند: BigCommerce خودش آنها را پاک میکند، چون طوری ساخته شدهاند که همراه اپ بروند، و SignalHost اتصال فروشگاه را پایان میدهد.
وقتی چیزی کار نمیکند
- اسکریپتها در صفحه اصلی ویترین فروشگاه شما نیستند: آنها روی پوستههای Stencil اجرا میشوند. در ویترین headless باید کد را مستقیماً به آن اضافه کرد.
- ویترین فروشگاه شما هنوز بررسی نشد: معمولاً فروشگاه هنوز آنلاین نشده است. اسکریپتها سر جای خود هستند و بهمحض آنلاین شدن آن اجرا میشوند.
- بازدیدهای صفحه میرسند اما سبد خرید یا خریدی نمیرسد: لایه داده خاموش است. آن را در Settings › Data Solutions › Data layer روشن کنید. خریدارانی که در بنر BigCommerce کوکیهای تحلیلی را رد کردهاند اصلاً شمرده نمیشوند.
- کانتینر شما هنوز ویژگی Google Analytics ندارد: راهاندازی را در signalhost.io کامل کنید.
- SignalHost هنوز برای این فروشگاه راهاندازی نشده است: اپ را در Apps › My Apps حذف کنید و دوباره نصب کنید.
- صفحه مدت زیادی باز مانده است: SignalHost را دوباره از منوی Apps باز کنید.
- آخرین بهروزرسانی انجام نشد: بهطور خودکار دوباره تلاش میشود.
- هر مورد دیگر: با ذکر نشانی فروشگاهتان به hello@signalhost.io بنویسید.
علائم تجاری
SignalHost محصولی مستقل از Algorithmo GmbH است و هیچ وابستگیای به BigCommerce، Google، Meta یا TikTok ندارد و از سوی آنها تأیید نشده است. Google Analytics، Google Ads و Google Tag Manager علائم تجاری Google LLC هستند؛ Meta علامت تجاری Meta Platforms, Inc. است؛ TikTok علامت تجاری ByteDance Ltd. است؛ BigCommerce علامت تجاری BigCommerce Pty. Ltd. است.

