پیکربندی دامنه سفارشی

این مقاله برای توسعه‌دهندگانی است که می‌خواهند برچسب‌گذاری سمت سرور را در همان زمینه شخص اول وب سایت خود میزبانی کنند. ارائه همان منبع بهترین روشی است که به شما امکان می دهد از مزایای امنیت و دوام کوکی های مجموعه سرور استفاده کنید. دستورالعمل‌های زیر برای راه‌اندازی سرویس با مبدا یکسان بدون توجه به برچسب Google مستقر در سایت شما (gtag.js یا gtm.js) اعمال می‌شود.

هنگامی که برای اولین بار یک سرور برچسب گذاری را راه اندازی می کنید، روی دامنه ای که توسط ارائه دهنده ابر ارائه می شود میزبانی می شود. وقتی از نقطه پایانی پیش‌فرض استفاده می‌کنید، داده‌ها را به ظرف سرور تحویل می‌دهد، اما در یک زمینه شخص ثالث اجرا می‌شود. برای باز کردن مزایای یک زمینه شخص اول، مانند کوکی‌های بادوام‌تر، سرور برچسب‌گذاری و وب‌سایت شما باید در یک دامنه اجرا شوند.

جدول زیر نشان می دهد که چگونه می توانید یک سرور برچسب گذاری را در زمانی که وب سایت اصلی در www.example.com میزبانی می شود میزبانی کنید:

منشا یکسان (بهترین روش) زیر دامنه دامنه پیش فرض
URL مثال https://www.example.com/metrics https://metrics.example.com https://metrics.run.app
دسترسی به کوکی های مجموعه سرور دسترسی کامل به مزایای امنیت و دوام. دسترسی کامل به مزایای امنیت و دوام. هیچ کدام فقط می تواند کوکی های جاوا اسکریپت را تنظیم کند.
پیچیدگی راه اندازی یک CDN یا متعادل کننده بار را برای ارسال درخواست ها پیکربندی کنید. ممکن است نیاز به به روز رسانی ورودی های DNS داشته باشد. ورودی های DNS را به روز کنید. از قبل پیکربندی شده است.

گزینه پیاده سازی خود را برای شروع انتخاب کنید.

پیش نیازها

این راهنما فرض می کند که شما دارید:

  • یک کانتینر سرور را در Tag Manager تنظیم کنید
  • یک سرور برچسب گذاری راه اندازی کنید
  • یک CDN یا متعادل کننده بار که می تواند درخواست ها را ارسال کند.
  • اگر از App Engine استفاده می کنید: سرور برچسب گذاری باید نسخه 2.2.0 یا بالاتر را اجرا کند. برای اینکه سرور برچسب‌گذاری خود را ثابت کنید، به Cloud Run بروید.

دامنه سفارشی را پیکربندی کنید

می توانید کانتینر سرور خود را طوری تنظیم کنید که در مسیری از همان دامنه وب سایت شما اجرا شود. برای مثال، اگر وب‌سایت شما ترافیک وب را در www.example.com ارائه می‌کند، مسیری مانند www.example.com/metrics را برای محفظه سرور خود رزرو کنید.

نمودار برچسب گذاری سمت سرور در همان مبدا تنظیم شده است.

1. مسیر دامنه خود را برای استفاده برای سرور برچسب گذاری خود انتخاب کنید

این مسیر برای اجرای سرویس‌دهی شخص اول رزرو می‌شود. مطمئن شوید که مسیری را انتخاب کرده اید که قبلاً از آن استفاده نمی کنید.

نمونه هایی از مسیرهایی که ممکن است بخواهید از آنها استفاده کنید عبارتند از: /collect ، /metrics ، /data

به این رشته مسیر توجه کنید. شما از آن در تمام مراحل بعدی به جای /metrics استفاده خواهید کرد هر کجا که می بینید: /metrics

2. ترافیک را به سرور برچسب گذاری خود هدایت کنید

اگر وب‌سایت شما قبلاً با یک CDN یا متعادل‌کننده بار راه‌اندازی شده است که از مسیریابی ترافیک بر اساس مسیرها پشتیبانی می‌کند، به مرحله 4 بروید.

  1. یک منبع یا باطن اضافه کنید که به وب سایت شما اشاره می کند.
  2. هدر Host را نادیده بگیرید تا نام میزبان وب سایت باشد، مانند example.com
  3. اجازه دهید همه کوکی‌ها و رشته‌های پرس و جو بازارسال شوند. اگر پلتفرم این گزینه را نداشته باشد، احتمالاً به طور پیش فرض این کار را انجام می دهد.
  4. منبع یا باطن دیگری را اضافه کنید که به سرور برچسب گذاری شما اشاره می کند. این می تواند دامنه ارائه شده توسط ارائه دهنده ابر باشد، مانند metrics.run.app
  5. هدر Host را نادیده بگیرید تا با دامنه مشخص شده در بالا برابر شود. اجازه دهید همه کوکی‌ها و رشته‌های پرس و جو بازارسال شوند.
  6. یک قانون مسیر، مانند /metrics/* را برای هدایت ترافیک به سرور برچسب‌گذاری اضافه کنید.
  7. مسیر برچسب گذاری رزرو شده سمت سرور را به گونه ای پیکربندی کنید که اولویت بیشتری نسبت به قانون پیش فرض داشته باشد.
  8. DNS خود را به‌روزرسانی کنید تا به CDN یا load balancer اشاره کند، اگر قبلاً انجام نشده است. انتشار به‌روزرسانی‌های DNS ممکن است کمی طول بکشد.
  9. از نقطه پایانی /healthy در دامنه ای که به تازگی راه اندازی کرده اید، مانند https://example.com/metrics/healthy بازدید کنید. شما باید یک ok را ببینید.

3. URL سرور را در Google Tag Manager به روز کنید

شما باید پیکربندی کانتینر سرور خود را به روز کنید تا بتواند پیشوند مسیر را شناسایی کرده و درخواست ها را به درستی پردازش کند.

برای به روز رسانی به نقطه پایانی جدید:

  1. گوگل تگ منیجر را باز کنید
  2. محفظه سروری را که در همان مبدأ وب سایت تنظیم شده است، باز کنید.
  3. در زیر تب Admin > Container Settings ، همه URL های قبلی را حذف کنید. این امر ضروری است زیرا همه URL های کانتینر سرور باید مسیر یکسانی را به اشتراک بگذارند.
  4. روی Add URL کلیک کنید و URL خود را از جمله پیشوند مسیر وارد کنید.
  5. ذخیره کنید و به فضای کاری خود برگردید.
  6. برای شروع یک جلسه اشکال زدایی جدید و ارسال درخواست در یک برگه جداگانه، روی دکمه پیش نمایش کلیک کنید.
  7. روی درخواست ارسال شده کلیک کنید. اطمینان حاصل کنید که مشتری شما درخواست دریافتی را ادعا کرده است.

عیب یابی مشکلات رایج

  1. پیش نمایش درخواست های دریافتی را نشان نمی دهد
    1. به کاوشگر گزارش پروژه ابری خود بروید. بررسی کنید که استقرار برچسب‌گذاری سمت سرور ترافیک دریافت می‌کند. اگر اینطور نیست، دستورالعمل های مرحله 1 را دنبال کنید.
    2. تأیید کنید که CDN یا load balancer در حال ارسال کوکی‌ها است.
    3. بررسی کنید که یک سرور پیش‌نمایش واحد دارید و سرورهای برچسب‌گذاری دارای مجموعه PREVIEW_SERVER_URL هستند.
    4. با رفتن به PREVIEW_SERVER_URL + /healthy تأیید کنید که سرور پیش‌نمایش در حال اجرا است. شما باید یک ok را ببینید.
  2. مشتریان درخواستی را درخواست نمی کنند - URL را در تنظیمات کانتینر به روز کنید تا از مسیر رزرو شده استفاده کنید. اگر URL حاوی مسیر نباشد یا متفاوت باشد، کلاینت ها به درستی کار نمی کنند.