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

این راهنما نحوه نگهداری مجزای gtag.js Universal Analytics و Google Analytics 4 را توضیح می دهد.

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

نتیجه

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

توجه داشته باشید که وقتی تجارت الکترونیک را برای UA و GA4 پیاده سازی می کنید، دارایی Google Analytics 4 شما از پیاده سازی تجارت الکترونیک GA4 شما استفاده می کند.

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

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

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

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

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

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

طرفداران منفی
  • به شما امکان می دهد داده های تجارت الکترونیک را در گزارش های GA4 و Universal Analytics خود مشاهده کنید.
  • هیچ تغییری در نحوه جمع‌آوری یا گزارش داده‌های تجارت الکترونیک در دارایی Universal Analytics شما وجود ندارد.
  • استفاده از رویدادها و پارامترهای GA4 گزارش های کامل تجارت الکترونیک GA4 را تضمین می کند.
  • شما را ملزم به پیاده سازی رویدادهای تجارت الکترونیک GA4 می کند.
  • وب سایت شما دو مجموعه رویداد ارسال می کند: یکی برای Universal Analytics و دیگری برای GA4. این ممکن است بر عملکرد تأثیر بگذارد.

پیاده سازی

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

مراحل زیر را برای ایجاد و پیکربندی ویژگی Google Analytics 4 جدید خود تکمیل کنید:

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

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

<!-- 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', { 'groups': 'GA4' });  // Google Analytics 4 property
</script>

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

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

مثال زیر رویدادهای purchase تجارت الکترونیک Universal Analytics و Google Analytics 4 را نشان می‌دهد که با استفاده از پارامتر send_to برای رویدادهای GA4 به دارایی‌های مربوطه ارسال می‌شوند:

// Universal Analytics.
// The original UA implementation remains unchanged.
gtag('event', 'purchase', {
  "transaction_id": "24.031608523954162",
  "affiliation": "Google online store",
  "currency": "USD",
  "shipping": 7.50,
  "tax": 1.80,
  "value": 33.30,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_name": "Search Results",
      "list_position": 1,
      "quantity": 2,
      "price": 12.00
    }
  ]
});


// The new Google Analytics 4 ecommerce implementation.
// Uses `send_to` to route data to the GA4 group defined in the tag config.
gtag('event', 'purchase', {
  "send_to": "GA4",
  "transaction_id": "24.031608523954162",
  "affiliation": "Google online store",
  "currency": "USD",
  "shipping": 7.50,
  "tax": 1.80,
  "value": 33.30,
  "items": [
    {
      "item_id": "P12345",
      "item_name": "Android Warhol T-Shirt",
      "item_brand": "Google",
      "item_category": "Apparel/T-Shirts",
      "item_variant": "Black",
      "quantity": 2,
      "price": 12.00
    }
  ],
});