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

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

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

نتیجه

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

این دو مرحله از مهاجرت است:

  • تراکنش‌های UA را به رویداد خرید GA4 منتقل کنید
    • تجارت الکترونیک استاندارد برای Universal Analytics از ارسال داده های تراکنش و اقلام پشتیبانی می کند. مهاجرت به یک رویداد purchase Google Analytics 4 عملکردی معادل را ارائه می دهد.
  • (اختیاری) رویدادهای اضافی تجارت الکترونیک GA4 را اندازه گیری کنید

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

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

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

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

  3. برای آشنایی با نحوه ترجمه رویداد خرید GA4 هنگام ارسال به یک دارایی UA ، مرجع سازگاری رویداد را مرور کنید.

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

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

طرفداران منفی
  • داده‌های تجارت الکترونیک را در گزارش‌های GA4 و Universal Analytics مشاهده کنید.
  • مهاجرت به رویداد purchase GA4 گزارش های کامل تجارت الکترونیک UA را ارائه می دهد.
  • کار اضافی برای مهاجرت از analytics.js به gtag.js. توصیه می‌شود تمام اندازه‌گیری‌های سفارشی را از analytics.js به gtag.js منتقل کنید (مانند رویدادها، بازدید از صفحه، زمان‌بندی و غیره).

پیاده سازی

1. اندازه گیری UA را از analytics.js به gtag.js منتقل کنید

برای ارسال رویدادهای تجارت الکترونیک GA4 باید از analytics.js به gtag.js مهاجرت کنید، از جمله هر اندازه گیری سفارشی.

به طور کلی، مراحل تکمیل مهاجرت شامل موارد زیر است:

  1. قطعه analytics.js را حذف کنید.
  2. تگ Google (gtag.js) را نصب کنید و با شناسه ردیابی دارایی UA خود پیکربندی کنید.
  3. کد اندازه گیری سفارشی خود را از analytics.js به gtag.js منتقل کنید. بخش های زیر نحوه انتقال یک تراکنش استاندارد تجارت الکترونیک را شرح می دهد. برای راهنمایی کلی در مورد مهاجرت سایر سناریوهای اندازه گیری، به مهاجرت اندازه گیری مراجعه کنید.

قبل: تگ analytics.js

<!-- Google Analytics -->
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');

ga('create', 'UA-XXXXX-Y', 'auto');    // Universal Analytics property.
ga('send', 'pageview');
</script>
<!-- End Google Analytics -->

بعد: تگ گوگل (gtag.js)

<!-- 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.
</script>

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

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

مثال زیر نحوه انتقال یک رویداد تراکنش تجارت الکترونیک استاندارد analytics.js را به یک رویداد purchase تجارت الکترونیک GA4 معادل که با Universal Analytics سازگار است، نشان می‌دهد.

قبل: تراکنش تجارت الکترونیک استاندارد UA (analytics.js)

مثال زیر یک پیاده سازی استاندارد تجارت الکترونیک analytics.js را برای یک تراکنش با 2 مورد نشان می دهد:

// Add the transaction.
ga('ecommerce:addTransaction', {
  id: '1234',     // Transaction ID.
  affiliation: 'Google Store',
  revenue: '29.97',
  shipping: '5.25',
  tax: '2.42'
});

// Add the items belonging to the transaction.
ga('ecommerce:addItem', {
  id: '1234',     // Transaction ID.
  name: 'Android Warhol T-Shirt',
  sku: 'P12345',  // Item ID.
  category: 'Apparel/T-Shirts',
  price: '12.99',
  quantity: '2'
});
ga('ecommerce:addItem', {
  id: '1234',     // Transaction ID.
  name: 'Flame challenge T-Shirt',
  sku: 'P67890',  // Item ID.
  category: 'Apparel/T-Shirts',
  price: '3.99',
  quantity: '1'
});
ga('ecommerce:send');

بعد از: خرید تجارت الکترونیک GA4 (gtag.js)

هنگام انتقال یک رویداد تراکنش analytics.js به یک رویداد purchase GA4، تفاوت های اصلی عبارتند از:

  • GA4 یک رویداد purchase دارد که شامل تمام جزئیات و موارد مربوط به تراکنش است. analytics.js چندین دستور تجارت الکترونیک ga() را برای گرفتن اطلاعات یکسان اجرا می کند.
  • GA4 دارای یک فیلد transaction_id واحد برای کل رویداد است. analytics.js نیاز دارد که شناسه تراکنش در هر مورد گنجانده شود.
  • GA4 دارای چندین فیلد دسته بندی آیتم است. analytics.js از یک فیلد دسته بندی واحد با جداکننده / برای توصیف سلسله مراتب استفاده می کند. با این حال، رویدادهای GA4 با فیلدهای دسته بندی چند مورد، به دلیل ترجمه پارامتر دسته، برای ویژگی UA شما کار خواهند کرد.
 gtag('event', 'purchase', {
   currency: 'USD',
   transaction_id: '1234',    // Transaction ID.
   value: 29.97,
   affiliation: 'Google Store',
   shipping: 5.25,
   tax: 2.42,
   items: [
    {
      item_id: 'P12345',     // Item ID.
      item_name: 'Android Warhol T-Shirt',
      item_category: 'Apparel',
      item_category2: 'T-Shirts',
      price: 12.99,
      quantity: 2
    },
    {
      item_id: 'P67890',    // Item ID.
      item_name: 'Flame challenge T-Shirt',
      item_category: 'Apparel',
      item_category2: 'T-Shirts',
      price: 3.99,
      quantity: 1
    }
  ]
});

3. یک ویژگی جدید 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>

4. (اختیاری) رویدادهای تجارت الکترونیک اضافی را اندازه گیری کنید

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

اگر از پیکربندی پیش‌فرض قطعه gtag.js استفاده می‌کنید، رویدادهای GA4 به هر دو ویژگی UA و GA4 شما ارسال می‌شود. رویدادهای GA4 ارسال شده به دارایی UA شما همانطور که در مرجع سازگاری رویداد تعریف شده است ترجمه می شود. اگر رفتار متفاوتی را ترجیح می‌دهید، می‌توانید از عملکرد داده‌های گروه و مسیر gtag.js برای کنترل رویدادهایی که به ویژگی UA و GA4 شما ارسال می‌شوند استفاده کنید. به عنوان مثال، می‌توانید رویداد purchase را به دارایی UA و GA4 خود ارسال کنید، اما فقط سایر رویدادهای تجارت الکترونیک GA4 را به دارایی GA4 خود ارسال کنید.