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

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

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

نتیجه

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

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

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

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

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

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

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

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

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

طرفداران

منفی

ساده‌ترین گزینه برای پیاده‌سازی، زیرا تگ‌های رویداد تجارت الکترونیک موجود خود را تغییر نمی‌دهید. به شما امکان می دهد داده های تجارت الکترونیک را در گزارش های GA4 و Universal Analytics خود مشاهده کنید. هیچ تغییری در نحوه جمع‌آوری یا گزارش داده‌های تجارت الکترونیک در دارایی Universal Analytics شما وجود ندارد.

رویدادهای select_content ، checkout_progress ، set_checkout_option و view_refund در GA4 شناسایی نمی‌شوند و در گزارش‌های تجارت الکترونیک GA4 ظاهر نمی‌شوند. رویدادهای بالا و پارامترهای مرتبط با آنها به عنوان رویدادهای سفارشی و پارامترهای سفارشی در GA4 در نظر گرفته می‌شوند. با این حال، داده ها برای پارامتر items به Google Analytics ارسال نمی شود (به عنوان یک پارامتر سفارشی پشتیبانی نمی شود). مرحله افزودن اطلاعات حمل و نقل در گزارش جزئیات سبد خرید GA4/Fallout Funnel خالی خواهد بود. مرحله List Clicks در گزارش قیف فهرست کالا/محصول/مورد GA4 خالی خواهد بود. جداکننده / برای دسته در GA4 شناسایی نمی شود. GA4 cat1/cat2/cat3 را به‌جای سه دسته، یعنی cat1 ، cat2 و cat3 به عنوان یک دسته گزارش می‌کند.

پیاده سازی

یکی از گزینه‌های زیر را برای استفاده از پیاده‌سازی gtag.js Universal Analytics برای ارسال رویدادهای تجارت الکترونیک به ویژگی 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>