تجارت الکترونیک GA4 (gtag.js): رویدادهای GA4 را ارسال کنید

این راهنما نحوه انتقال پیاده‌سازی تجارت الکترونیک gtag.js Universal Analytics را برای استفاده از رویدادهای تجارت الکترونیک Google Analytics 4 توضیح می‌دهد.

برای دریافت راهنماها و منابع مهاجرتی، از مرکز مهاجرت توسعه‌دهنده دیدن کنید.

نتیجه

نتیجه پیروی از این راهنما این است که رویدادهای تجارت الکترونیک Google Analytics 4 را برای یک ویژگی جدید GA4 پیاده‌سازی می‌کنید و از آن پیاده‌سازی جدید برای پر کردن گزارش‌های Universal Analytics موجود خود استفاده می‌کنید. اجرای Universal Analytics موجود شما برای دریافت داده های تجارت الکترونیک GA4 تغییر می کند.

احتیاط: اگرچه رویدادهای تجارت الکترونیک Google Analytics 4 به طور خودکار ترجمه می شوند تا با Universal Analytics سازگار باشند، اما همه رویدادهای Google Analytics 4 دارای رویدادی معادل در Universal Analytics نیستند. داده‌ها در گزارش‌های تجارت الکترونیک Universal Analytics برای این رویدادها وجود ندارد. مبادلات و ملاحظات زیر را ببینید.

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

1. از ابزار کمکی مهاجرت تجارت الکترونیک استفاده کنید تا تأیید کنید که موارد زیر پیاده‌سازی فعلی شما را توصیف می‌کنند:

   • شما از ویژگی Universal Analytics استفاده می کنید
   • سایت شما از کتابخانه gtag.js برای ارسال رویدادهای تجارت الکترونیک استفاده می کند

2. گزینه های مهاجرت برای پیاده سازی تجارت الکترونیک را مرور کنید تا در مورد مبادلات هر گزینه مطلع شوید. تأیید کنید که واقعاً می‌خواهید از این راهنما پیروی کنید تا از رویدادهای تجارت الکترونیک Google Analytics 4 برای اجرای gtag.js Universal Analytics موجود خود استفاده کنید.

3. مرجع سازگاری رویداد را مرور کنید تا بدانید که چگونه رویدادهای UA هنگام ارسال به یک ویژگی GA4 ترجمه می‌شوند.

مبادلات و ملاحظات

برای درک کامل پیامدهای استفاده از رویدادهای تجارت الکترونیک Google Analytics 4 با پیاده‌سازی تجارت الکترونیک gtag.js (Universal Analytics) اطلاعات زیر را بررسی و در نظر بگیرید.

طرفداران	منفی
به شما امکان می دهد داده های تجارت الکترونیک را در گزارش های GA4 و Universal Analytics خود مشاهده کنید. استفاده از رویدادها و پارامترهای GA4 گزارش های کامل تجارت الکترونیک GA4 را تضمین می کند.	از شما می خواهد که رویدادهای تجارت الکترونیک موجود خود را تغییر دهید. همه رویدادها و پارامترهای GA4 در Universal Analytics معادل ندارند. پارامترهای shipping_tier ، discount ، currency ، location_id ، promotion_name ، و promotion_id هیچ معادلی با Universal Analytics ندارند و در گزارش‌های Universal Analytics شما ظاهر نمی‌شوند.

پیاده سازی

1. پیاده سازی تجارت الکترونیک خود را به روز کنید

پیاده سازی تجارت الکترونیک موجود خود را به روز کنید تا از رویدادهای تجارت الکترونیک Universal Analytics به رویدادهای Google Analytics 4 مهاجرت کنید. پس از تکمیل این مرحله، دارایی Universal Analytics شما رویدادهای تجارت الکترونیک GA4 را دریافت خواهد کرد. برای درک پیامدهای این به روز رسانی ، معاوضه ها و ملاحظات را مرور کنید.

برای کمک به به روز رسانی، از منابع زیر استفاده کنید:

• راهنمای تجارت الکترونیک Google Analytics 4 برای یادگیری نحوه ارسال رویدادهای تجارت الکترونیک GA4.
• اطلاعات موجود در سازگاری بین رویدادهای UA و GA4 و پارامترهای قابل مقایسه برای جداول UA و GA4 . این اطلاعات به شما کمک می‌کند نام‌ها و پارامترهای رویدادهای تجارت الکترونیک Universal Analytics را به رویدادها و پارامترهای معادل Google Analytics 4 نگاشت کنید.
• ابزار کمکی مهاجرت تجارت الکترونیک برای تأیید اعتبار شما که رویدادهای تجارت الکترونیک خود را به درستی به روز کرده اید.

2. یک ویژگی جدید GA4 ایجاد و پیکربندی کنید

هنگامی که پیاده سازی تجارت الکترونیک خود را برای ارسال رویدادهای تجارت الکترونیک GA4 به روز کردید، یکی از گزینه های زیر را تکمیل کنید تا شروع به ارسال داده ها به ویژگی جدید Google Analytics 4 کنید .

گزینه 1: از GA4 Setup Assistant استفاده کنید و برچسب های سایت متصل را فعال کنید

دستیار راه‌اندازی GA4 به‌طور خودکار یک ویژگی GA4 جدید ایجاد می‌کند و تنظیمات زیر را از ویژگی Universal Analytics کپی می‌کند: نام دارایی ، URL وب‌سایت ، منطقه زمانی و تنظیمات ارز . همچنین می‌تواند ویژگی برچسب سایت متصل را فعال کند تا از پیاده‌سازی gtag.js Universal Analytics موجود شما برای بارگیری ویژگی جدید GA4 شما استفاده مجدد کند.

مراحل توضیح داده شده در GA4 Setup Assistant را برای ایجاد و پیکربندی ویژگی Google Analytics 4 جدید دنبال کنید. مطمئن شوید که برای استفاده از ویژگی برچسب سایت متصل، گزینه Enable data using your tags موجود را علامت بزنید .

گزینه 2: قطعه gtag.js خود را به روز کنید

1. یک ویژگی Google Analytics 4 جدید ایجاد کنید.
   • از دستیار راه اندازی GA4 برای افزودن ویژگی Google Analytics 4 استفاده کنید. با این حال، هنگامی که در هنگام تنظیم از شما خواسته شد، تیک گزینه Enable data using your tags موجود را بردارید . از طرف دیگر، یک ویژگی Google Analytics 4 بدون دستیار راه اندازی GA4 ایجاد کنید. مزیت استفاده از دستیار این است که برخی از تنظیمات اولیه را از ویژگی Universal Analytics شما کپی می کند.
2. شناسه برچسب ویژگی Google Analytics 4 را پیدا کنید .
3. با استفاده از دستور config با شناسه برچسب، ویژگی Google Analytics 4 را به قطعه gtag.js موجود خود اضافه کنید .

در زیر نمونه ای از قطعه gtag.js است که ویژگی Universal Analytics و Google Analytics 4 را پیکربندی کرده است:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-XXXXX-Y"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-XXXXX-Y');  // Universal Analytics property
  gtag('config', 'TAG_ID');  // Google Analytics 4 property
</script>