سازگاری رویداد تجارت الکترونیک و مرجع ترجمه (gtag.js)

این سند سازگاری و ترجمه رویداد تجارت الکترونیک بین Universal Analytics (UA) و Google Analytics 4 (GA4) را توضیح می‌دهد.

زمینه

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

هدف

ترجمه بین رویدادهای تجارت الکترونیک UA و GA4 به موارد زیر کمک می کند:

• سهولت اجرا : تجارت الکترونیک GA4 را با استفاده از پیاده سازی UA موجود خود با یک به روز رسانی پیکربندی جزئی بپذیرید.
• از بین بردن نیاز به برچسب دوگانه : شما می توانید رویدادهای تجارت الکترونیکی مشابه را به یک دارایی UA و GA4 ارسال کنید. این گزینه ای برای انتقال به GA4 و حفظ پیاده سازی تجارت الکترونیک UA شما، بدون نیاز به حفظ پیکربندی برچسب دوگانه را فراهم می کند.

مبادلات

سازگاری انعطاف‌پذیری را برای انتخاب مسیر مهاجرت GA4 فراهم می‌کند که مناسب‌ترین مسیر برای برآورده کردن الزامات کوتاه‌مدت و بلندمدت شما برای حفظ پیاده‌سازی UA شما باشد.

اکثر رویدادها/پارامترهای تجارت الکترونیک GA4 با UA و بالعکس سازگار هستند. برای تعداد کمی از مواردی که ناسازگاری وجود دارد، بسته به انتخاب مهاجرتی که انجام می‌دهید، ممکن است گزارش‌های تجارت الکترونیک UA یا GA4 شما به طور کامل پر از داده نباشد.

مهم است که هر گزینه مهاجرت را برای جزئیات بیشتر در مورد سازگاری و پیکربندی مورد نیاز بررسی کنید.

ترجمه چگونه کار می کند

• هنگامی که یک رویداد تجارت الکترونیک GA4 به یک ویژگی UA ارسال می شود، رویداد به رویداد تجارت الکترونیک معادل UA (gtag.js) ترجمه می شود.
  • پارامترهای رویداد UA با مقادیر پارامترهای GA4 قابل مقایسه پر شده است. اگر یک پارامتر UA را نتوان از یک رویداد GA4 پر کرد (یعنی هیچ پارامتر قابل مقایسه ای وجود ندارد)، در آن صورت وقتی رویداد به ویژگی UA ارسال می شود، این پارامتر حذف می شود.
• هنگامی که یک رویداد تجارت الکترونیک UA (gtag.js) به یک ویژگی GA4 ارسال می شود، رویداد به رویداد تجارت الکترونیک GA4 معادل ترجمه می شود.
  • پارامترهای رویداد GA4 با مقادیر پارامترهای UA قابل مقایسه پر شده است. اگر پارامتر GA4 را نتوان از یک رویداد UA پر کرد (یعنی هیچ پارامتر معادلی وجود ندارد) در آن صورت وقتی رویداد به ویژگی GA4 ارسال می شود، پارامتر حذف می شود. در برخی موارد، اگر یک پارامتر UA دارای پارامتر GA4 قابل مقایسه نباشد، پارامتر با رویداد GA4 به عنوان یک پارامتر سفارشی ارسال می‌شود.
• تمام ترجمه ها از GA4 به UA و بالعکس در سمت مشتری انجام می شود.
• ترجمه رویداد/پارامتر به طور پیش‌فرض فعال است، هیچ پیکربندی کاربر مورد نیاز نیست و نمی‌توان آن را غیرفعال کرد.

پارامترهای قابل مقایسه برای UA و GA4

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

توجه: یک سلول جدول خالی نشان می دهد که هیچ پارامتر قابل مقایسه ای وجود ندارد.

نام پارامتر Universal Analytics	نام پارامتر Google Analytics 4	یادداشت
affiliation	affiliation
checkout_step
checkout_option
content_type
coupon	coupon
currency	currency	هنگام ارسال یک رویداد UA به یک ویژگی GA4، این مقدار ارز برای پارامتر GA4 items[].currency استفاده می‌شود.
	location_id
	payment_type
shipping	shipping
shipping_tier
tax	tax
transaction_id	transaction_id
value	value
items[]	items[]
items[].name	items[].item_name
items[].id	items[].item_id
	items[].affiliation
items[].brand	items[].item_brand
items[].category	items[].item_category items[].item_category2 items[].item_category3 items[].item_category4 items[].item_category5	دسته بندی مورد. حداکثر 5 سطح سلسله مراتب را می توان مشخص کرد. برای جزئیات نحوه انجام ترجمه دسته بین رویدادهای UA و GA4، ترجمه پارامتر دسته را ببینید.
	items[].currency
items[].coupon	items[].coupon
	items[].discount
items[].list_name	items[].item_list_name
items[].list_position	items[].index
	items[].location_id
items[].price	items[].price
items[].quantity	items[].quantity
items[].variant	items[].item_variant
promotions[]		برای GA4، items[] با پارامترهای خاص تبلیغاتی مانند items[].promotion_id استفاده می‌شود.
promotions[].id	items[].promotion_id	این پارامترها هنگام ارسال رویداد UA به GA4 یا بالعکس ترجمه نمی شوند.
promotions[].name	items[].promotion_name	این پارامترها هنگام ارسال رویداد UA به GA4 یا بالعکس ترجمه نمی شوند.
promotions[].creative_name
promotions[].creative_slot	items[].creative_slot	این پارامترها هنگام ارسال رویداد UA به GA4 یا بالعکس ترجمه نمی شوند.

ترجمه پارامتر دسته

ترجمه پارامتر دسته به عنوان یک مورد خاص هنگام ارسال رویدادهای GA4 به UA یا بالعکس انجام می شود.

برای Universal Analytics، هنگام تنظیم پارامتر items[].category ، از / به عنوان یک جداکننده برای تعیین حداکثر پنج سطح سلسله مراتب استفاده می کنید. در Google Analytics 4، شما از پارامترهای دسته شمارش شده برای تعیین حداکثر پنج سطح سلسله مراتب استفاده می کنید: items[].item_category ، items[].item_category2 ، items[].item_category3 ، items[].item_category4 ، و items[].item_category5 .

رفتار برای ترجمه دسته به شرح زیر است:

• برای رویدادهای GA4 که به UA ترجمه شده‌اند، دسته‌های شمارش شده در یک پارامتر category واحد ترکیب می‌شوند و هر دسته با / محدود می‌شوند.
• برای رویدادهای UA ترجمه شده به GA4، مقدار پارامتر دسته تقسیم می‌شود تا دسته‌های برشماری GA4 مربوطه را پر کند.
• اگر می‌خواهید رویدادهای GA4 را به UA ارسال کنید، توصیه می‌شود از کاراکتر / در مقادیر دسته‌بندی استفاده نکنید، زیرا هنگام ترجمه به UA به عنوان جداکننده دسته تفسیر می‌شود.
• صرف نظر از تعداد تعریف شده، فقط از 5 سطح دسته اول استفاده خواهد شد.

نمونه ترجمه دسته

مثال‌های زیر یک پارامتر دسته UA را نشان می‌دهند که به GA4 ترجمه شده است. همین اصل در هنگام ترجمه یک رویداد GA4 به UA اعمال می شود.

یک رویداد UA با یک دسته که 5 سطح سلسله مراتب را تعریف می کند:

gtag("event", "add_to_cart", {
  items: [{
    ...
    category: "Apparel/Adult/Shirts/Crew/Short sleeve",
    ...
  }]
});

رویداد UA به یک رویداد GA4 با دسته‌های برشمرده ترجمه شده است:

gtag("event", "add_to_cart", {
  items: [{
    ...
    item_category: "Apparel",
    item_category2: "Adult",
    item_category3: "Shirts",
    item_category4: "Crew",
    item_category5: "Short sleeve",
    ...
  }]
});

سازگاری بین رویدادهای UA و GA4

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

برای هر ردیف در جدول، هر ستون اطلاعات زیر را ارائه می دهد:

• ستون‌های رویداد UA و رویداد GA4 رویدادهای قابل مقایسه را بر اساس آنچه که برای اندازه‌گیری در نظر گرفته‌اند نشان می‌دهند.
• Parameters پارامترهایی را لیست می کند که هیچ معادلی بین رویدادهای UA و GA4 مربوطه ندارند. GA4 فقط پارامترهایی را لیست می کند که فقط با رویداد GA4 استفاده می شوند و UA فقط پارامترهایی را لیست می کند که فقط با رویداد UA استفاده می شوند.
• رفتار ترجمه (ارسال UA به GA4) رفتار ترجمه را هنگام ارسال یک رویداد UA به یک ویژگی GA4 توصیف می کند. یادداشت ها جزئیاتی در مورد داده های ارسال شده، تفاوت های رویداد GA4 و هر گونه تأثیر قابل توجه بر گزارش های GA4 ارائه می دهند.
• رفتار ترجمه (ارسال GA4 به UA) رفتار ترجمه را هنگام ارسال یک رویداد UA به یک ویژگی GA4 توصیف می کند. یادداشت ها جزئیاتی را در مورد داده های ارسال شده، تفاوت های رویداد UA و هر گونه تأثیر قابل توجه بر گزارش های UA ارائه می دهند.

رویداد UA	رویداد GA4	مولفه های	رفتار ترجمه (ارسال UA به GA4)	رفتار ترجمه (ارسال GA4 به UA)
view_item_list	view_item_list	فقط GA4: item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	سازگار . تمام پارامترهای UA به معادل های GA4 ترجمه و ارسال می شوند. گزارش‌های GA4 که به هر پارامتر فقط GA4 نیاز دارند، ناقص خواهند بود.	سازگار . پارامترهای GA4 با پارامتر UA معادل ترجمه و ارسال می شوند. پارامترهای فقط GA4 ارسال نمی شوند. پارامتر item_list_name در سطح رویداد نادیده گرفته می‌شود، فقط item_list_name در سطح مورد ارسال می‌شود. گزارش‌های UA پر از داده‌های رویداد GA4 کامل / بدون تغییر خواهند بود.
select_content (items)	select_item	فقط GA4: item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id فقط UA: content_type	سازگار نیست . یک رویداد سفارشی select_content و یک پارامتر سفارشی content_type ارسال می‌شود. داده هیچ items ارسال نمی شود.	سازگار نیست . یک رویداد UA با کلی به عنوان event_category و select_item به عنوان event_action ارسال می‌شود. داده هیچ items ارسال نمی شود.
select_content (promotions)	select_promotion	فقط GA4: creative_name creative_slot location_id promotion_id promotion_name items فقط UA: content_type promotions	سازگار نیست . یک رویداد سفارشی select_content با content_type و promotions به عنوان پارامترهای سفارشی ارسال می‌شود. پارامتر سفارشی promotions حاوی هیچ داده مفیدی نیست.	سازگار نیست . یک رویداد UA با کلی به عنوان event_category و select_promotion به عنوان event_action ارسال می‌شود. هیچ داده promotions ارسال نمی شود.
view_item	view_item	فقط GA4: currency value items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	سازگار . تمام پارامترهای UA به معادل های GA4 ترجمه و ارسال می شوند. گزارش‌های GA4 که به هر پارامتر فقط GA4 نیاز دارند، ناقص خواهند بود.	سازگار . پارامترهای GA4 با پارامتر UA معادل ترجمه و ارسال می شوند. استثنا item_list_name است که ارسال نمی شود. تنها از پارامترهای GA4 ، currency و value به ترتیب با ضربه به عنوان ارز و درآمد تراکنش ارسال می‌شوند. event_value نیز روی پارامتر value به عنوان یک عدد صحیح تنظیم شده است. توجه داشته باشید که ترجمه از GA4 به UA شامل event_value است، اما معمولاً برای بازدیدهای UA تنظیم نمی‌شود. گزارش‌های UA پر از داده‌های GA4 عمدتاً کامل / بدون تغییر خواهند بود. نام فهرست مورد وجود ندارد.
add_to_wishlist * * داده های items برای UA پشتیبانی نمی شود.	add_to_wishlist	فقط GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	سازگار . تمام پارامترهای UA به معادل های GA4 ترجمه و ارسال می شوند. گزارش‌های GA4 که به هر پارامتر فقط GA4 نیاز دارند، ناقص خواهند بود.	سازگار . یک رویداد تصادفی معادل با تجارت الکترونیک به عنوان event_category ، add_to_wishlist به عنوان event_action و پارامتر value به عنوان event_value ارسال می‌شود. گزارش‌های UA پر از داده‌های رویداد GA4 کامل / بدون تغییر خواهند بود. از آنجایی که این رویداد به طور کلی در گزارش های تجارت الکترونیک UA پشتیبانی نمی شود، تأثیر قابل توجهی نخواهد داشت.
add_to_cart	add_to_cart	فقط GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	سازگار . تمام پارامترهای UA به معادل های GA4 ترجمه و ارسال می شوند. گزارش‌های GA4 که به هر پارامتر فقط GA4 نیاز دارند، ناقص خواهند بود.	سازگار . پارامترهای GA4 با پارامتر UA معادل ترجمه و ارسال می شوند.* پارامترهای فقط GA4 ارسال نمی شوند. * item_list_name ارسال نشد، اما این رفتار با gtag.js (UA) سازگار است، که list_name ارسال نمی‌کند. گزارش‌های UA پر از داده‌های رویداد GA4 کامل / بدون تغییر خواهند بود.
remove_from_cart	remove_from_cart	فقط GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	سازگار . تمام پارامترهای UA به معادل های GA4 ترجمه و ارسال می شوند. گزارش‌های GA4 که به هر پارامتر فقط GA4 نیاز دارند، ناقص خواهند بود.	سازگار . پارامترهای GA4 با پارامتر UA معادل ترجمه و ارسال می شوند.* پارامترهای فقط GA4 ارسال نمی شوند. * item_list_name ارسال نشد، اما این رفتار با gtag.js (UA) سازگار است، که list_name ارسال نمی‌کند. گزارش‌های UA پر از داده‌های رویداد GA4 کامل / بدون تغییر خواهند بود.
N/A	view_cart	رویداد فقط برای GA4 توصیه می شود.	سازگار نیست* . *بعید است اجرای UA شما این رویداد را ارسال کند زیرا یک رویداد توصیه شده نیست. برای اطمینان از کامل بودن گزارش‌های GA4، می‌توانید این رویداد را برای UA با استفاده از قالب GA4 پیاده‌سازی کنید. اگر رویداد GA4 را برای UA پیاده سازی کنید، به عنوان یک رویداد بدون داده items نشان داده می شود که ممکن است چندان مفید نباشد. بر گزارش تجارت الکترونیک UA تأثیری نخواهد گذاشت.	سازگار نیست . ضربه رویداد با کلی به عنوان event_category ، view_cart به عنوان event_action و پارامتر value به عنوان event_value ارسال می شود. داده های items ارسال نمی شود. از آنجایی که این رویداد به طور کلی در گزارش های تجارت الکترونیک UA پشتیبانی نمی شود، تأثیر قابل توجهی نخواهد داشت.
begin_checkout	begin_checkout	فقط GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	سازگار . تمام پارامترهای UA به معادل های GA4 ترجمه و ارسال می شوند. گزارش‌های GA4 که به هر پارامتر فقط GA4 نیاز دارند، ناقص خواهند بود.	سازگار . پارامترهای GA4 با پارامتر UA معادل ترجمه و ارسال می شوند.* پارامترهای فقط GA4 ارسال نمی شوند. * item_list_name ارسال نشد، اما این رفتار با gtag.js (UA) سازگار است، که list_name ارسال نمی‌کند. begin_checkout عملاً معادل ارسال یک رویداد checkout_progress با checkout_step روی 1 است. گزارش‌های UA پر از داده‌های رویداد GA4 کامل / بدون تغییر خواهند بود.
add_payment_info	add_payment_info	فقط GA4: currency value coupon payment_type items UA: N/A: پارامترها پشتیبانی نمی شوند.	سازگار نیست* . *از آنجایی که UA از پارامترهای این رویداد پشتیبانی نمی کند، هیچ کدام ارسال نمی شود. کار خواهد کرد اما به احتمال زیاد خیلی مفید نخواهد بود. گزارش‌های GA4 که به پارامترهای رویداد نیاز دارند ناقص خواهند بود.	سازگار . یک رویداد تصادفی معادل با تجارت الکترونیک به عنوان event_category ، add_to_wishlist به عنوان event_action و پارامتر value (که به عدد صحیح فرستاده می‌شود) به عنوان event_value ارسال می‌شود. توجه داشته باشید که ترجمه از GA4 به UA شامل event_value است، اما معمولاً برای بازدیدهای UA تنظیم نمی‌شود. گزارش‌های UA پر از داده‌های رویداد GA4 کامل / بدون تغییر خواهند بود. از آنجایی که این رویداد به طور کلی در گزارش های تجارت الکترونیک UA پشتیبانی نمی شود، تأثیر قابل توجهی نخواهد داشت.
N/A	add_shipping_info	رویداد فقط برای GA4 توصیه می شود.	سازگار نیست* . *بعید است اجرای UA شما این رویداد را ارسال کند زیرا یک رویداد توصیه شده نیست. برای اطمینان از کامل بودن گزارش‌های GA4، می‌توانید این رویداد را برای UA با استفاده از قالب GA4 پیاده‌سازی کنید. اگر رویداد GA4 را برای UA پیاده سازی کنید، به عنوان یک رویداد بدون داده items نشان داده می شود که ممکن است چندان مفید نباشد. بر گزارش تجارت الکترونیک UA تأثیری نخواهد گذاشت.	سازگار نیست* . ضربه رویداد با کلی به عنوان event_category ، add_shipping_info به عنوان event_action و پارامتر value (به عدد صحیح فرستاده شده) به عنوان event_value ارسال می شود. پارامتر currency GA4 با ضربه به عنوان ارز ارسال می شود. از آنجایی که این رویداد به طور کلی در گزارش های تجارت الکترونیک UA پشتیبانی نمی شود، تأثیر قابل توجهی نخواهد داشت.
checkout_progress set_checkout_option	N/A	رویدادها فقط برای UA توصیه می شود.	رویداد به عنوان یک رویداد سفارشی تلقی خواهد شد. فقط پارامترهای سطح رویداد ارسال خواهد شد، هیچ داده items ارسال نخواهد شد. از آنجایی که این رویدادها به طور کلی در گزارش های تجارت الکترونیک GA4 پشتیبانی نمی شوند، تأثیر قابل توجهی نخواهند داشت.	N/A
view_promotion	view_promotion	فقط GA4: creative_name creative_slot location_id promotion_id promotion_name items فقط UA: promotions	سازگار نیست . یک رویداد سفارشی view_promotion همراه با promotions به عنوان پارامتر سفارشی ارسال می شود. پارامتر سفارشی promotions حاوی هیچ داده مفیدی نیست.	سازگار نیست . یک رویداد UA با تعامل به عنوان event_category و view_promotion به عنوان event_action ارسال می‌شود. هیچ داده promotions ارسال نمی شود. رویداد به عنوان یک رویداد بدون تعامل علامت گذاری شده است.
purchase	purchase	فقط GA4: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	سازگار . تمام پارامترهای UA به معادل های GA4 ترجمه و ارسال می شوند. currency در سطح رویداد استفاده می شود زیرا currency در سطح مورد پشتیبانی نمی شود. گزارش‌های GA4 که به هر پارامتر فقط GA4 نیاز دارند، ناقص خواهند بود.	سازگار . پارامترهای GA4 با پارامتر UA معادل ترجمه و ارسال می شوند.* پارامترهای فقط GA4 ارسال نمی شوند. * item_list_name ارسال نشد، اما این رفتار با gtag.js (UA) سازگار است، که list_name ارسال نمی‌کند. گزارش‌های UA پر از داده‌های رویداد GA4 کامل / بدون تغییر خواهند بود.
refund	refund	فقط GA4: affiliation items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	سازگار . تمام پارامترهای UA به معادل های GA4 ترجمه و ارسال می شوند. currency در سطح رویداد استفاده می شود زیرا currency در سطح مورد پشتیبانی نمی شود. گزارش‌های GA4 که به هر پارامتر فقط GA4 نیاز دارند، ناقص خواهند بود.	سازگار . پارامترهای GA4 با پارامتر UA معادل ترجمه و ارسال می شوند.* پارامترهای فقط GA4 ارسال نمی شوند. * item_list_name ارسال نشد، اما این رفتار با gtag.js (UA) سازگار است، که list_name ارسال نمی‌کند. گزارش‌های UA پر از داده‌های رویداد GA4 کامل / بدون تغییر خواهند بود.