ارسال داده به «مدیر برچسب سمت سرور»

این سند روش‌های مختلف ارسال رویدادها به ظرف سمت سرور را توضیح می‌دهد. اگر به اطلاعات زمینه‌ای بیشتری نیاز دارید، به نحوه عملکرد برچسب‌گذاری سمت سرور نگاهی بیندازید.

این سند درباره نحوه انجام موارد زیر بحث می‌کند:

• ارسال داده از وب‌سایت به محتوی سمت سرور
• ارسال داده‌های اضافی به محفظه سرور
• دریافت داده‌ها در محتوی سمت سرور
• ارسال داده از منابعی غیراز وب‌سایت‌ها

قبل‌از شروع

این راهنما فرض می‌کند که شما ازقبل این موارد را دارید:

• راه‌اندازی کردن ظرف سرور در «مدیر برچسب»
• راه‌اندازی سرور برچسب‌گذاری

۱. ارسال داده از وب‌سایت به محتوی سمت سرور

می‌توانید داده‌ها را ازطریق پیاده‌سازی سمت سرور ازطریق «مدیر برچسب» یا gtag.js هدایت کنید. گزینه پیاده‌سازی خود را انتخاب کنید.

اختیاری: ارسال پارامترهای اضافی با هر رویداد

می‌توانید دو نوع پارامتر اضافی دیگر ارسال کنید: پارامترهای سطح پیکربندی و پارامترهای سطح رویداد. پارامترهای پیکربندی بر نحوه عملکرد برچسب Google یا برچسب مقصد Google Analytics شما تأثیر می‌گذارند و فقط در سطح برچسب Google یا برچسب مقصد Google Analytics قابل تنظیم هستند.

پارامترهای رویداد اطلاعات تکمیلی درباره رویداد را مشخص می‌کنند و می‌توانند برای همه رویدادها، رویدادهای انتخابی، یا page_view رویداد تنظیم شوند.

توصیه‌های راه‌اندازی

توصیه می‌کنیم از برچسب Google Analytics در صفحه وب برای ارسال داده‌ها به کانتینر سرور استفاده کنید. این برچسب می‌تواند از روش‌های انتقال مختلفی برای اطمینان از بهترین نرخ تحویل رویدادها استفاده کند. این روش‌ها شامل موارد زیر است، ولی به آن‌ها محدود نیست

• پیکسل تصویر
• Fetch API
• XHR
• کارمند خدماتی که در iframe بارگیری‌شده از دامنه حامل سرور شما اجرا می‌شود.

برای اطمینان از اینکه همه روش‌ها پشتیبانی می‌شوند، موارد زیر را بررسی کنید:

خط‌مشی امنیتی محتوا (CSP)

علاوه‌براین، X-Frame-Options نباید بار شدن iframe از نشانی وب محفظه سرور را محدود کند.

برای اطلاع از خط‌مشی‌های خاص هر محصول، به https://developers.google.com/tag-platform/security/guides/csp مراجعه کنید.

۲. دریافت داده‌ها در محتوی سمت سرور

وقتی درخواست اچ‌تی‌تی‌پی به محفظه سرور ارسال می‌کنید، کارخواه باید آن درخواست را مطالبه کند.

برای مشاهده فهرست کارگزاران دردسترس:

1. باز کردن Google Tag Manager

2. محفظه سرور را باز کنید.

3. در نوار پیمایش در سمت راست، روی مشتریان کلیک کنید. کارخواه Google Analytics به‌طور پیش‌فرض در فضای نگهداری سمت سرور شما ازپیش نصب شده است.

4. روی نام مشتری کلیک کنید تا جزئیات را مشاهده یا ویرایش کنید.

تنظیمات اختیاری کارخواه

در اکثر موارد، مشتری نیازی به تغییرات ندارد. بااین‌حال، مورد استفاده شما ممکن است متفاوت باشد و بخواهید یکی از تنظیمات زیر را ویرایش کنید:

• اولویت: ترتیب اجرای کارخواه‌ها را تعیین می‌کند. شماره‌های بالاتر ابتدا اجرا می‌شوند و اولین کارخواهی که با درخواست ورودی مطابقت داشته باشد کارخواه فعال برای آن درخواست خواهد شد.

• معیارهای فعال‌سازی: معیارهای فعال‌سازی مشخص می‌کنند که مشتری چه زمانی به درخواست‌ها پاسخ خواهد داد:

  • مسیرهای پیش‌فرض gtag.js برای شناسه‌های خاص: از این تنظیم برای فعال کردن ارائه جاوا اسکریپت gtag.js ازطریق نشانی وب سرایند سرور استفاده کنید. وقتی فعال باشد، این کارخواه در پاسخ به درخواست‌های مسیرهای درخواست پیش‌فرض gtag.js، مثلاً /gtag/js?id=TAG_ID، فعال خواهد شد. برای افزودن یک یا چند شناسه مقصد، روی افزودن شناسه اندازه‌گیری کلیک کنید.

اختیاری: دریافت داده‌های بیشتر در «مدیر برچسب» سمت سرور

اگر پارامترهای اضافی ارسال می‌کنید، باید کارخواه Google Analytics را در محفظه سرور خود راه‌اندازی کنید تا پارامترهای اضافی را تجزیه کند و از آن‌ها داده‌های رویداد ایجاد کند.

برخی‌از برچسب‌های سرور بدون راه‌اندازی، پارامترهای اضافی را در درخواست‌های خروجی خود اضافه می‌کنند. برای کنار گذاشتن آن پارامترها، تبدیلی ایجاد کنید تا مقدار را بردارید.

برای استفاده از پارامترهای اضافی در برچسب‌های دیگر:

1. در ظرف سرور، در پیمایش سمت راست روی متغیرها کلیک کنید.
2. متغیر تعریف‌شده توسط کاربر جدید ایجاد کنید.
3. در پیکربندی متغیر، نوع متغیر داده‌های رویداد را انتخاب کنید.
4. در مسیر کلید، نام پارامتر را وارد کنید.
5. نامی برای متغیرتان انتخاب کنید و ذخیره کنید.

اکنون می‌توانید از پارامتر رویداد در هر برچسب دیگری در ظرف سرورتان استفاده کنید.

۳. اختیاری: ارسال داده‌ها از منابعی غیراز وب‌سایت‌ها

از پروتکل اندازه‌گیری Google Analytics می‌توان برای فعال کردن پشتیبانی برچسب‌گذاری سمت سرور از منابعی مانند برنامه‌های تلفن همراه و برنامه‌های سرور به سرور استفاده کرد. این گزینه به شما امکان می‌دهد رویدادها را در قالب Measurement Protocol به محفظه‌تان ارسال کنید. این ظرف بااستفاده از همان سازوکار همه رویدادهای SGTM، آن رویدادها را به Google Analytics ارسال می‌کند.

این گزینه از همه ویژگی‌های نقطه پایانی «پروتکل اندازه‌گیری» پشتیبانی نمی‌کند، مثلاً استخراج اطلاعات جغرافیایی و دستگاه از رویدادهای برچسب‌گذاری.

برنامه‌های دستگاه همراه

برای اینکه برنامه Android یا iOS خود را برای ارسال داده به سرور ظرف تنظیم کنید، برچسب تصویر سفارشی ایجاد می‌کنید و آن را برای استفاده از «پروتکل اندازه‌گیری» پیکربندی می‌کنید:

1. در ظرف تلفن همراه (Android یا iOS)، روی برچسب‌ها > جدید کلیک کنید.
2. در پیکربندی برچسب نوع برچسب تصویر سفارشی را انتخاب کنید.
3. مقدار نشانی وب تصویر را روی تصویر پیکسل در محتوی سرور در مسیر در کارخواه «پروتکل اندازه‌گیری» که قبلاً مشخص کرده‌اید تنظیم کنید. هر پارامتر Measurement Protocol دلخواه را به انتهای نشانی وب پیکسل خود اضافه کنید:
   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
4. انتخاب فعال کردن باطل کردن حافظه نهان را لغو کنید.
5. برچسب را ذخیره کنید و محتوی را منتشر کنید.
6. در محتوی سرور، روی مشتریان > جدید کلیک کنید.
7. در پیکربندی مشتری، نوع مشتری پروتکل اندازه‌گیری را انتخاب کنید.
8. مسیر فعال‌سازی را روی مسیر نقطه پایانی مجموعه برنامه‌تان تنظیم کنید.
9. پیکربندی کارخواه را ذخیره کنید و حامل سمت سرور را منتشر کنید.

برنامه‌های سرور به سرور

برای ارسال داده‌های پروتکل اندازه‌گیری به محتوی سرور، 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

برای دریافت بازدیدهای Measurement Protocol، نصب «مدیر برچسب سرور» را با کارخواه Measurement Protocol پیکربندی کنید:

1. در محتوی سرور، روی مشتریان > جدید کلیک کنید.
2. در پیکربندی مشتری، نوع مشتری پروتکل اندازه‌گیری را انتخاب کنید.
3. مسیر فعال‌سازی را روی مسیر نقطه پایان سرورتان تنظیم کنید.
4. پیکربندی کارخواه را ذخیره کنید و محتوی را منتشر کنید.

مراحل بعدی

برای ارسال داده‌ها در بافت طرف اول واقعی، باید برنامه‌های Google، مثل کتابخانه Google Analytics، را از سرورهای خودتان ارائه کنید.

بار کردن اسکریپت‌های Google ازطریق کارساز منarrow_forward