توضِّح هذه الصفحة كيفية استخدام gtag.js لإرسال أحداث "إحصاءات Google".
إرسال الأحداث
لإرسال أحداث "إحصاءات Google" إلى صفحة ويب تمت إضافة علامة Google إليها، استخدِم الأمر event
gtag.js مع البنية التالية:
gtag('event', <action>, {
'event_category': <category>,
'event_label': <label>,
'value': <value>
});
الاسم | النوع | القيمة التلقائية | الوصف |
---|---|---|---|
<action> |
string |
القيمة التي ستظهر كإجراء الحدث في تقارير الأحداث في "إحصاءات Google". | |
<category> |
string |
"general" |
فئة الحدث. |
<label> |
string |
تسمية الحدث. | |
<value> |
number |
عدد صحيح غير سالب سيظهر كقيمة الحدث. |
بعد ذلك، يتم إرسال حدث مع الإجراء 'aaa'
وفئة 'bbb'
وتصنيف 'ccc'
:
gtag('event', 'aaa', {
'event_category' : 'bbb',
'event_label' : 'ccc'
});
إذا تم حذف <category>
أو <label>
، سيتم ضبطهما على القيم التلقائية
"(not set)"
.
اطّلِع على تحليل مَعلمات أحداث "إحصاءات Google" لمزيد من المعلومات عن كيفية تفسير "إحصاءات Google" لبنية الأحداث.
أحداث "إحصاءات Google" التلقائية
عليك استخدام أحداث "إحصاءات Google" التلقائية، التي تحتوي على فئات وتصنيفات معدّة مسبقًا. يسهِّل استخدام هذه الأحداث إعداد التقارير المتسقة وإمكانية التشغيل التفاعلي مع الوظائف المستقبلية.
يسرد الجدول التالي أحداث "إحصاءات Google" التلقائية وفئاتها
التلقائية وأنواع التصنيفات التلقائية (إن توفّرت). بالنسبة إلى أسماء الأحداث غير المدرَجة في هذا الجدول (مثل أسماء الأحداث العشوائية التي تنشئها)، تكون الفئة التلقائية "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
على
true
:
gtag('event', 'video_auto_play_start', {
'event_label': 'My promotional video',
'event_category': 'video_auto_play',
'non_interaction': true
});