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

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

این مقاله در مورد چگونگی انجام:

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

قبل از شروع

این راهنما فرض می کند که شما قبلاً دارید:

1. داده ها را از یک وب سایت به ظرف سمت سرور خود ارسال کنید

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

برچسب گوگل: GA 4

برای تنظیم یک برچسب Google برای پردازش سمت سرور، باید URL ظرف سرور خود را اضافه کنید.

یک متغیر پیکربندی برای URL کانتینر سرور ایجاد کنید

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

  2. محفظه وب را که می خواهید پیکربندی کنید انتخاب کنید.

  3. منوی متغیرها را باز کنید.

  4. یک متغیر جدید تعریف شده توسط کاربر از نوع برچسب Google ایجاد کنید: تنظیمات پیکربندی .

  5. پارامترهای زیر را اضافه کنید:

    • نام : server_container_url
    • مقدار : روی نشانی وب محفظه سرور ظرف سرور Tag Manager خود تنظیم کنید.

  6. نام متغیر خود را به عنوان مثال "Server URL" بگذارید و آن را ذخیره کنید .

URL کانتینر سرور را به یک تگ Google اختصاص دهید

  1. را باز کنید منوی برچسب ها
  2. یک برچسب Google جدید اضافه کنید یا یک برچسب موجود را ویرایش کنید.
  3. در تنظیمات پیکربندی ، متغیر محفظه سروری را که ایجاد کردید انتخاب کنید.
  4. برای اطمینان از اینکه تگ Google قبل از سایر راه‌اندازها فعال می‌شود، روی Triggering کلیک کنید و از راه‌اندازی Initialization - All pages استفاده کنید. درباره محرک‌های صفحه بیشتر بیاموزید.
  5. برچسب را ذخیره کنید و ظرف را منتشر کنید .

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

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

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

پارامترهای پیکربندی همه رویدادها رویدادها را انتخاب کنید page_view رویدادها

با نحوه استفاده مجدد از تنظیمات پیکربندی در Google Tag Manager آشنا شوید.

برای ارسال پارامترهای اضافی در همه رویدادها، از تنظیمات رویداد در Google Tag Manager استفاده مجدد کنید .

برای ارسال پارامترهای اضافی با رویداد Google Analytics 4 :

  1. در یک محفظه وب، یک برچسب رویداد Google Analytics 4 اضافه کنید یا یک برچسب موجود را ویرایش کنید.
  2. روی پارامترهای رویداد > افزودن ردیف کلیک کنید.
  3. پارامتری را برای ارسال با رویداد اضافه کنید. برای پارامترهای رویداد از پیش تعریف شده به مرجع رویدادهای توصیه شده مراجعه کنید.
    • در Field Name نام پارامتر خود را اضافه کنید، به عنوان مثال، language .
    • در Value مقدار پارامتر خود را اضافه کنید.
  1. یک ماشه را پیکربندی کنید تا در Initialization - All Pages فعال شود.
  2. برچسب را ذخیره کنید و ظرف را منتشر کنید .

برای ارسال یک پارامتر در یک رویداد page_view :

  1. در یک محفظه وب، یک برچسب Google موجود را ویرایش کنید.

  2. با افزودن پارامتر جدید، page_view پیش‌فرض را در تنظیمات پیکربندی غیرفعال کنید:

    • نام : send_page_view
    • مقدار : false

  3. یک Google Analytics جدید ایجاد کنید: برچسب رویداد GA4 .

    • تگ پیکربندی را که در مرحله 1 تغییر دادید انتخاب کنید.
    • نام رویداد را روی page_view تنظیم کنید.

  4. پارامتری را برای ارسال با رویداد اضافه کنید. برای پارامترهای رویداد از پیش تعریف شده به مرجع رویدادهای توصیه شده مراجعه کنید. - در Field Name نام پارامتر خود را اضافه کنید، به عنوان مثال language .

    • در Value مقدار پارامتر خود را اضافه کنید.
  1. یک ماشه را پیکربندی کنید تا در Initialization - All Pages فعال شود.
  2. برچسب را ذخیره کنید و ظرف را منتشر کنید .

2. داده ها را در ظرف سمت سرور خود دریافت کنید

وقتی درخواست HTTP را به یک ظرف سرور ارسال می کنید، یک کلاینت باید آن درخواست را ادعا کند.

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

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

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

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

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

تنظیمات مشتری اختیاری

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

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

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

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

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

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

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

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

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

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

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

پروتکل اندازه گیری Google Analytics را می توان برای فعال کردن پشتیبانی از برچسب گذاری سمت سرور از منابعی مانند برنامه های تلفن همراه و برنامه های کاربردی سرور به سرور استفاده کرد.

برنامه های موبایل

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

  1. در ظرف تلفن همراه خود (Android یا iOS)، روی برچسب‌ها > جدید کلیک کنید.
  2. در پیکربندی برچسب، نوع تگ تصویر سفارشی را انتخاب کنید.
  3. مقدار 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
  4. Enable Cache Busting را لغو انتخاب کنید.
  5. برچسب را ذخیره کنید و ظرف را منتشر کنید.
  6. در ظرف سمت سرور خود، روی Clients > New کلیک کنید.
  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

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

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

مراحل بعدی

برای ارسال داده‌ها در یک زمینه واقعی شخص اول، باید اسکریپت‌های Google، مانند کتابخانه Google Analytics، را از سرورهای خود ارائه دهید.

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