این صفحه نحوه استفاده از gtag.js را برای ارسال رویدادهای Google Analytics توضیح می دهد.
ارسال رویدادها
برای ارسال رویدادهای Google Analytics در صفحهای که تگ Google در آن اضافه شده است، از دستور event
gtag.js با نحو زیر استفاده کنید:
gtag('event', <action>, {
'event_category': <category>,
'event_label': <label>,
'value': <value>
});
نام | تایپ کنید | مقدار پیش فرض | شرح |
---|---|---|---|
<action> | string | مقداری که به عنوان کنش رویداد در گزارشهای رویداد Google Analytics ظاهر میشود. | |
<category> | string | "general" | دسته بندی رویداد. |
<label> | string | برچسب رویداد. | |
<value> | number | یک عدد صحیح غیر منفی که به عنوان مقدار رویداد ظاهر می شود. |
موارد زیر یک رویداد را با عملکرد 'aaa'
، یک دسته از 'bbb'
و یک برچسب 'ccc'
ارسال میکند:
gtag('event', 'aaa', {
'event_category' : 'bbb',
'event_label' : 'ccc'
});
اگر <category>
یا <label>
حذف شوند، روی مقادیر پیشفرض "(not set)"
تنظیم میشوند.
برای اطلاعات بیشتر در مورد نحوه تفسیر ساختار رویدادها توسط Google Analytics، به آناتومی پارامترهای رویداد Google Analytics مراجعه کنید.
رویدادهای پیشفرض Google Analytics
شما باید از رویدادهای پیشفرض Google Analytics استفاده کنید که دارای دستهها و برچسبهای از پیش تعیینشده هستند. استفاده از این رویدادها گزارش دهی و قابلیت همکاری با عملکردهای آینده را تسهیل می کند.
جدول زیر رویدادهای پیشفرض Google Analytics، دستههای پیشفرض آنها و انواع برچسبهای پیشفرض (در صورت وجود) را فهرست میکند. برای نامهای رویداد که در این جدول فهرست نشدهاند (مثلاً نامهای رویداد دلخواه که ایجاد میکنید)، دسته پیشفرض "engagement"
و برچسب پیشفرض "(not set)"
است.
نام رخداد | دسته بندی پیش فرض | نوع برچسب پیش فرض |
---|---|---|
add_payment_info | ecommerce | |
add_to_cart | ecommerce | |
add_to_wishlist | ecommerce | |
begin_checkout | ecommerce | |
checkout_progress | ecommerce | |
generate_lead | engagement | |
login | engagement | method |
purchase | ecommerce | |
refund | ecommerce | |
remove_from_cart | ecommerce | |
search | engagement | search_term |
select_content | engagement | content_type |
set_checkout_option | ecommerce | |
share | engagement | method |
sign_up | engagement | method |
view_item | engagement | |
view_item_list | engagement | |
view_promotion | engagement | |
view_search_results | engagement | search_term |
رویدادهای غیر تعاملی را ارسال کنید
برای ارسال یک رویداد non-interaction ، پارامتر non_interaction
را روی true
تنظیم کنید:
gtag('event', 'video_auto_play_start', {
'event_label': 'My promotional video',
'event_category': 'video_auto_play',
'non_interaction': true
});