این مقاله روش‌های مختلف ارسال رویدادها به کانتینر سمت سرور را شرح می‌دهد. اگر به اطلاعات پس زمینه بیشتری نیاز دارید، نگاهی به نحوه عملکرد برچسب گذاری سمت سرور بیندازید.
این مقاله در مورد چگونگی انجام:
- داده ها را از یک وب سایت به ظرف سمت سرور خود ارسال کنید
- داده های اضافی را به ظرف سرور ارسال کنید
- داده ها را در ظرف سمت سرور خود دریافت کنید
- داده ها را از منابعی غیر از وب سایت ها ارسال کنید
قبل از اینکه شروع کنی
این راهنما فرض می کند که شما قبلاً دارید:
1. داده ها را از یک وب سایت به ظرف سمت سرور خود ارسال کنید
می توانید داده ها را از طریق اجرای سمت سرور از طریق Tag Manager یا برچسب Google (gtag.js) مسیریابی کنید. گزینه پیاده سازی خود را انتخاب کنید.
اختیاری: پارامترهای اضافی را با هر رویداد ارسال کنید
می‌توانید دو نوع پارامتر اضافی را ارسال کنید: پارامترهای سطح پیکربندی و پارامترهای سطح رویداد. پارامترهای پیکربندی بر نحوه رفتار تگ Google شما تأثیر می‌گذارند و فقط می‌توانند در سطح برچسب Google تنظیم شوند.
پارامترهای رویداد اطلاعات اضافی درباره یک رویداد را مشخص می‌کنند و می‌توانند برای همه رویدادها، رویدادهای انتخابی یا رویدادهای page_view تنظیم شوند.
2. داده ها را در ظرف سمت سرور خود دریافت کنید
وقتی درخواست HTTP را به یک ظرف سرور ارسال می کنید، یک کلاینت باید آن درخواست را ادعا کند.
برای مشاهده لیست مشتریان موجود:
ظرف سرور خود را باز کنید.
در نوار پیمایش در سمت چپ، روی Clients کلیک کنید. کلاینت GA4 به طور پیش فرض روی کانتینر سمت سرور شما از قبل نصب شده است. اگر نیاز به کار با Universal Analytics دارید، یک سرویس گیرنده Google Analytics: Universal Analytics راه اندازی کنید.
برای مشاهده یا ویرایش جزئیات، روی نام مشتری کلیک کنید.
تنظیمات مشتری اختیاری
در بیشتر موارد، مشتری نیاز به هیچ تغییری نخواهد داشت. با این حال، مورد استفاده شما ممکن است متفاوت باشد و ممکن است بخواهید یکی از تنظیمات زیر را ویرایش کنید:
اولویت: ترتیب اجرای کلاینت ها را مشخص می کند. اعداد بالاتر ابتدا اجرا می شوند و اولین مشتری که با درخواست ورودی مطابقت دارد، مشتری فعال آن درخواست می شود.
معیارهای فعال سازی: معیارهای فعال سازی مشخص می کنند که مشتری چه زمانی به درخواست ها پاسخ می دهد:
برای مشتریان UA: مسیرهای پیش‌فرض Universal Analytics : زمانی که مسیرهای درخواست شامل
/collect،/r/collectو سایر مسیرهای مشابه مورد استفاده فایل‌های جاوا اسکریپت هستند که داده‌ها را به Google Analytics ارسال می‌کنند، مشتری فعال می‌شود. این تنظیم به طور پیش فرض فعال است.مسیرهای پیش‌فرض gtag.js برای شناسه‌های خاص: از این تنظیم برای فعال کردن سرویس gtag.js جاوا اسکریپت از طریق URL ظرف سرور خود استفاده کنید. وقتی فعال باشد، این سرویس گیرنده در پاسخ به درخواست‌های مسیرهای درخواست پیش‌فرض gtag.js، به عنوان مثال
/gtag/js?id=TAG_IDفعال می‌شود. برای افزودن یک یا چند شناسه مقصد، روی Add Measurement ID کلیک کنید.
اختیاری: داده های اضافی را در مدیریت برچسب سمت سرور دریافت کنید
اگر پارامترهای اضافی را ارسال می کنید، باید سرویس گیرنده Google Analytics 4 را در ظرف سرور خود راه اندازی کنید تا پارامترهای اضافی را تجزیه کرده و داده رویداد را از آنها ایجاد کنید.
برای استفاده از پارامترهای اضافی در تگ سرور:
- در ظرف سرور خود، روی متغیرها در ناوبری سمت چپ کلیک کنید.
- یک متغیر جدید تعریف شده توسط کاربر ایجاد کنید.
- در پیکربندی متغیر ، نوع متغیر Event Data را انتخاب کنید.
- در Key Path ، نام پارامتر را وارد کنید.
- به متغیر خود یک نام بدهید و ذخیره کنید .
اکنون می توانید از پارامتر رویداد در هر تگ دیگری در ظرف سرور خود استفاده کنید.
3. اختیاری: ارسال داده از منابعی غیر از وب سایت ها
پروتکل اندازه گیری Google Analytics را می توان برای فعال کردن پشتیبانی از برچسب گذاری سمت سرور از منابعی مانند برنامه های تلفن همراه و برنامه های کاربردی سرور به سرور استفاده کرد.
برنامه های موبایل
برای اینکه برنامه اندروید یا iOS خود را به ارسال داده به محفظه سرور خود بفرستید، یک تگ تصویر سفارشی ایجاد کرده و آن را برای استفاده از پروتکل اندازه گیری پیکربندی می کنید:
- در ظرف تلفن همراه خود (Android یا iOS)، روی برچسب‌ها > جدید کلیک کنید.
- در پیکربندی برچسب، نوع تگ تصویر سفارشی را انتخاب کنید.
- مقدار Image URL را روی یک تصویر پیکسلی در محفظه سرور در مسیر مشتری پروتکل اندازه‌گیری که قبلاً مشخص کرده‌اید، تنظیم کنید. هر پارامتر پروتکل اندازه گیری دلخواه را به انتهای URL پیکسل خود اضافه کنید:
https://custom.example.com/app ?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home - Enable Cache Busting را لغو انتخاب کنید.
- برچسب را ذخیره کنید و ظرف را منتشر کنید.
- در ظرف سمت سرور خود، روی Clients > New کلیک کنید.
- در پیکربندی مشتری ، نوع مشتری پروتکل اندازه گیری را انتخاب کنید.
- مسیر فعال سازی را در مسیر نقطه پایانی مجموعه برنامه خود تنظیم کنید.
- پیکربندی کلاینت را ذخیره کنید و ظرف سمت سرور را منتشر کنید.
برنامه های سرور به سرور
برای ارسال داده های پروتکل اندازه گیری به ظرف سرور خود، نام میزبان www.google-analytics.com را با نام دامنه کانتینر سرور خود جایگزین کنید. مثلا:
POST /batch HTTP/1.1
Host: collection.example.com
v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
برای دریافت بازدیدهای پروتکل اندازه‌گیری، نصب تگ منیجر سمت سرور خود را با مشتری پروتکل اندازه‌گیری پیکربندی کنید:
- در ظرف سمت سرور خود، روی Clients > New کلیک کنید.
- در پیکربندی مشتری ، نوع مشتری پروتکل اندازه گیری را انتخاب کنید.
- مسیر فعال سازی را روی مسیر نقطه پایانی سرور خود تنظیم کنید.
- پیکربندی مشتری را ذخیره کنید و ظرف را منتشر کنید.
مراحل بعدی
برای ارسال داده‌ها در یک زمینه واقعی شخص اول، باید اسکریپت‌های Google، مانند کتابخانه Google Analytics، را از سرورهای خود ارائه دهید.