داده ها را به مدیر برچسب سمت سرور ارسال کنید

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

این مقاله در مورد چگونگی انجام موارد زیر بحث می‌کند:

  • ارسال داده‌ها از یک وب‌سایت به کانتینر سمت سرور شما
  • ارسال داده‌های اضافی به یک کانتینر سرور
  • داده‌ها را در کانتینر سمت سرور خود دریافت کنید
  • ارسال داده از منابعی غیر از وب‌سایت‌ها

قبل از اینکه شروع کنی

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

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

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

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

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

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

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

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

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

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

  • پیکسل تصویر
  • واکشی API
  • ایکس اچ آر
  • سرویس ورکر که در یک iframe بارگذاری شده از دامنه کانتینر سرور شما اجرا می‌شود.

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

سیاست امنیت محتوا (CSP)

دستورالعمل محتوا هدف
img-src [آدرس سرور] درخواست‌های اندازه‌گیری
اتصال-src [آدرس سرور] درخواست‌های اندازه‌گیری
قاب-src [آدرس سرور] پیاده‌سازی سرویس ورکر

علاوه بر این، X-Frame-Options نباید مانع از بارگذاری iframeها از URL کانتینر سرور شود.

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

۲. داده‌ها را در کانتینر سمت سرور خود دریافت کنید

وقتی درخواست HTTP را به یک کانتینر سرور ارسال می‌کنید، کلاینت باید آن درخواست را مطالبه کند.

برای مشاهده لیست کلاینت‌های موجود:

  1. باز کردن گوگل تگ منیجر

  2. کانتینر سرور خود را باز کنید.

  3. در نوار ناوبری سمت چپ، روی Clients کلیک کنید. کلاینت GA4 به طور پیش‌فرض روی کانتینر سمت سرور شما از قبل نصب شده است.

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

تنظیمات اختیاری کلاینت

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

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

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

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

اختیاری: دریافت داده‌های اضافی در مدیریت برچسب سمت سرور

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

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

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

  1. در کانتینر سرور خود، در منوی سمت چپ روی متغیرها (Variables) کلیک کنید.
  2. یک متغیر جدید تعریف شده توسط کاربر ایجاد کنید.
  3. در پیکربندی متغیر ، نوع متغیر را Event Data انتخاب کنید.
  4. در قسمت Key Path ، نام پارامتر را وارد کنید.
  5. به متغیر خود یک نام بدهید و ذخیره کنید .

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

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

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

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

اپلیکیشن‌های موبایل

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

  1. در بخش موبایل خود (اندروید یا iOS)، روی برچسب‌ها > جدید کلیک کنید.
  2. در پیکربندی برچسب، نوع برچسب تصویر سفارشی را انتخاب کنید.
  3. مقدار Image URL را روی یک تصویر پیکسلی در کانتینر سرور، در مسیری که قبلاً در کلاینت Measurement Protocol مشخص کرده‌اید، تنظیم کنید. پارامترهای دلخواه Measurement Protocol را به انتهای pixel 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
  4. گزینه‌ی «فعال کردنِ از کار انداختنِ حافظه‌ی پنهان» را از حالت انتخاب خارج کنید.
  5. تگ را ذخیره کنید و کانتینر را منتشر کنید.
  6. در کانتینر سمت سرور خود، روی Clients > New کلیک کنید.
  7. در پیکربندی کلاینت ، نوع کلاینت پروتکل اندازه‌گیری را انتخاب کنید.
  8. مسیر فعال‌سازی (Activation Path) را روی مسیر نقطه پایانی جمع‌آوری (collection point) برنامه خود تنظیم کنید.
  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

برای دریافت بازدیدهای پروتکل اندازه‌گیری، نصب تگ منیجر سمت سرور خود را با یک کلاینت پروتکل اندازه‌گیری پیکربندی کنید:

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

مراحل بعدی

برای ارسال داده‌ها در یک زمینه‌ی کاملاً شخص اول، باید اسکریپت‌های گوگل، مانند کتابخانه‌ی گوگل آنالیتیکس، را از سرورهای خودتان ارائه دهید.

اسکریپت‌های گوگل را از طریق سرور من بارگذاری کنید