يسرد هذا المستند جميع أسماء الحقول القابلة للتهيئة لشفرة analytics.js.
إنشاء حقول فقط
لا يمكن ضبط الحقول التالية إلا في طريقة create
. لمزيد من التفاصيل، يُرجى الاطلاع على القسم إنشاء كائنات المتتبع في دليل التهيئة المتقدمة.
رقم تعريف التتبع/رقم تعريف موقع الويب
مطلوبة لكل أنواع النتائج.
رقم تعريف التتبع / رقم تعريف موقع الويب. التنسيق هو UA-XXXX-Y. وترتبط جميع البيانات المجمّعة بهذا المعرّف.
اسم الحقل | نوع القيمة | القيمة التلقائية |
---|---|---|
trackingId |
ملف نصي | بدون قفل |
UA-XXXX-Y
مثال على الاستخدام:
ga('create', 'UA-XXXX-Y');
// Alerts the tracking ID for the default tracker. ga(function(tracker) { alert(tracker.get('trackingId')); });
اسم أداة التتبّع
اختياريّ.
لا يمكن ضبط ذلك إلا في طريقة create
.
اسم كائن المتتبع.
اسم الحقل | نوع القيمة | القيمة التلقائية |
---|---|---|
name |
ملف نصي |
t0
|
myTracker
مثال على الاستخدام:
ga('create', 'UA-XXXX-Y', {'name': 'myTracker'});
رقم تعريف العميل
اختياريّ.
لا يمكن ضبط ذلك إلا في طريقة create
.
يتم تحديد مثيل المتصفح بشكل مجهول. يتم تخزين هذه القيمة تلقائيًا كجزء من ملف تعريف ارتباط "إحصاءات Google" للطرف الأول مع انتهاء صلاحية لمدة عامين.
اسم الحقل | نوع القيمة | القيمة التلقائية |
---|---|---|
clientId |
ملف نصي |
Randomly Generated
|
35009a79-1a05-49d7-b876-2b884d0f825b
مثال على الاستخدام:
ga('create', 'UA-XXXX-Y', { 'clientId': '35009a79-1a05-49d7-b876-2b884d0f825b' });
معدّل البيانات في الملف الصوتي
اختياريّ.
لا يمكن ضبط ذلك إلا في طريقة create
.
لتحديد النسبة المئوية للمستخدمين الذين ينبغي تتبعهم. وافتراضيًا إلى 100 (لا يتم أخذ عينات من المستخدمين) ولكن قد تحتاج المواقع الكبيرة إلى استخدام معدل عينة أقل للبقاء في حدود معالجة Google Analytics.
اسم الحقل | نوع القيمة | القيمة التلقائية |
---|---|---|
sampleRate |
number |
100
|
5
مثال على الاستخدام:
ga('create', 'UA-XXXX-Y', {'sampleRate': 5});
معدّل البيانات في سرعة الموقع الإلكتروني
اختياريّ.
لا يمكن ضبط ذلك إلا في طريقة create
.
يحدد هذا الإعداد عدد مرات إرسال إشارات سرعة الموقع. وبشكل تلقائي، سيتم قياس 1% من المستخدمين تلقائيًا.
اسم الحقل | نوع القيمة | القيمة التلقائية |
---|---|---|
siteSpeedSampleRate |
number |
1
|
10
مثال على الاستخدام:
ga('create', 'UA-XXXX-Y', {'siteSpeedSampleRate': 10});
إرسال المُحيل دائمًا
اختياريّ.
لا يمكن ضبط ذلك إلا في طريقة create
.
يتم تلقائيًا إرسال عنوان URL المُحيل لبروتوكول HTTP المستخدَم لإسناد مصادر الزيارات، وذلك فقط عندما يختلف اسم مضيف الموقع المُحيل عن اسم مضيف الصفحة الحالية. يُرجى تفعيل هذا الإعداد فقط في حال كنت تريد معالجة صفحات أخرى من المضيف الحالي كإحالات.
اسم الحقل | نوع القيمة | القيمة التلقائية |
---|---|---|
alwaysSendReferrer |
منطقي |
false
|
true
مثال على الاستخدام:
ga('create', 'UA-XXXX-Y', {'alwaysSendReferrer': true});
السماح بمعلمات الروابط
اختياريّ.
لا يمكن ضبط ذلك إلا في طريقة create
.
ستبحث analytics.js بشكلٍ تلقائي عن معلمات الحملات المخصّصة مثل utm_source وutm_medium وما إلى ذلك، في كل من سلسلة طلب البحث وعنوان url لعنوان URL للصفحة الحالية. وسيؤدي تعيين هذا الحقل على "خطأ" إلى تجاهل أي معلمات حملات مخصصة تظهر في علامة الارتساء.
اسم الحقل | نوع القيمة | القيمة التلقائية |
---|---|---|
allowAnchor |
منطقي |
true
|
false
مثال على الاستخدام:
ga('create', 'UA-XXXX-Y', {'allowAnchor': false});
اسم ملف تعريف الارتباط
اختياريّ.
لا يمكن ضبط ذلك إلا في طريقة create
.
اسم ملف تعريف الارتباط المستخدَم لتخزين بيانات الإحصاءات
اسم الحقل | نوع القيمة | القيمة التلقائية |
---|---|---|
cookieName |
ملف نصي |
_ga
|
gaCookie
مثال على الاستخدام:
ga('create', 'UA-XXXX-Y', {'cookieName': 'gaCookie'});
نطاق ملفات تعريف الارتباط
اختياريّ.
لا يمكن ضبط ذلك إلا في طريقة create
.
تحدّد النطاق المستخدم لتخزين ملف تعريف ارتباط "إحصاءات Google". يؤدي تعيين هذا على "لا شيء" إلى تعيين ملف تعريف الارتباط بدون تحديد نطاق.
اسم الحقل | نوع القيمة | القيمة التلقائية |
---|---|---|
cookieDomain |
ملف نصي |
document.location.hostname (normalized)
|
example.com
مثال على الاستخدام:
ga('create', 'UA-XXXX-Y', {'cookieDomain': 'example.com'});
أعلام ملفات تعريف الارتباط
اختياريّ.
لا يمكن ضبط ذلك إلا في طريقة create
.
تحدد علامات إضافية لإلحاقها بملف تعريف الارتباط. يجب فصل العلامات بعلامات الفاصلة المنقوطة.
اسم الحقل | نوع القيمة | القيمة التلقائية |
---|---|---|
cookieFlags |
ملف نصي | بدون قفل |
SameSite=None; Secure
مثال على الاستخدام:
ga('create', 'UA-XXXX-Y', {'cookieFlags': 'SameSite=None; Secure'});
انتهاء صلاحية ملف تعريف الارتباط
اختياريّ.
لا يمكن ضبط ذلك إلا في طريقة create
.
لتحديد انتهاء صلاحية ملف تعريف الارتباط، بالثواني.
اسم الحقل | نوع القيمة | القيمة التلقائية |
---|---|---|
cookieExpires |
عدد صحيح |
63072000 (two years)
|
86400
مثال على الاستخدام:
ga('create', 'UA-XXXX-Y', {'cookieExpires': 86400});
تعديل ملفات تعريف الارتباط
اختياريّ.
لا يمكن ضبط ذلك إلا في طريقة create
.
عند تعيين ملف تعريف الارتباط على "صحيح" (القيمة الافتراضية)، ستحدِّث شفرة analytics.js ملفات تعريف الارتباط عند كل تحميل للصفحة. سيؤدي هذا إلى تحديث تاريخ انتهاء صلاحية ملف تعريف الارتباط المطلوب تعيينه مقارنةً بآخر زيارة للموقع. على سبيل المثال، إذا تم تعيين مدة صلاحية ملف تعريف الارتباط على أسبوع واحد، وزار أحد المستخدمين باستخدام المتصفح نفسه كل خمسة أيام، فسيتم تحديث انتهاء صلاحية ملفات تعريف الارتباط في كل زيارة، ولن تنتهي صلاحيته أبدًا.
اسم الحقل | نوع القيمة | القيمة التلقائية |
---|---|---|
cookieUpdate |
منطقي |
true
|
true
مثال على الاستخدام:
ga('create', 'UA-XXXX-Y', {'cookieUpdate': 'false'});
GAC للمتجر
اختياريّ.
لا يمكن ضبط ذلك إلا في طريقة create
.
بشكلٍ افتراضي، تكتب شفرة analytics.js ملف تعريف ارتباط لتخزين معلومات الحملة. يمكن استخدام هذا الحقل لتعطيل كتابة ملف تعريف الارتباط هذا.
اسم الحقل | نوع القيمة | القيمة التلقائية |
---|---|---|
storeGac |
منطقي |
true
|
false
مثال على الاستخدام:
ga('create', 'UA-XXXX-Y', {'storeGac': false});
نطاق ملفات تعريف الارتباط القديم
اختياريّ.
لا يمكن ضبط ذلك إلا في طريقة create
.
يُستخدم هذا الحقل لتهيئة كيفية بحث analytics.js عن ملفات تعريف الارتباط التي تم إنشاؤها بواسطة النصوص البرمجية السابقة في Google Analytics مثل ga.js وurchin.js.
اسم الحقل | نوع القيمة | القيمة التلقائية |
---|---|---|
legacyCookieDomain |
ملف نصي | بدون قفل |
store.example.com
مثال على الاستخدام:
ga('create', 'UA-XXXX-Y', {'legacyCookieDomain': 'store.example.com'});
استيراد السجلّ القديم
اختياريّ.
لا يمكن ضبط ذلك إلا في طريقة create
.
يحدِّد ما إذا كان يجب أن يحاول analytics.js استيراد بيانات السجلّ من ملفات تعريف ارتباط ga.js.
اسم الحقل | نوع القيمة | القيمة التلقائية |
---|---|---|
legacyHistoryImport |
منطقي |
true
|
false
مثال على الاستخدام:
ga('create', 'UA-XXXX-Y', 'auto', {'legacyHistoryImport': false});
السماح بمعلمات الرابط
اختياريّ.
لا يمكن ضبط ذلك إلا في طريقة create
.
يؤدي تعيين هذا الحقل على "صحيح" إلى تمكين تحليل مقاييس الروابط عبر النطاقات المستخدمة لنقل الحالة عبر النطاقات.
اسم الحقل | نوع القيمة | القيمة التلقائية |
---|---|---|
allowLinker |
منطقي |
false
|
true
مثال على الاستخدام:
ga('create', 'UA-XXXX-Y', {allowLinker: true});
أسئلة عامة
السماح بميزات الإعلان
اختياريّ.
عيّن هذا الحقل على "false" لتعطيل أجهزة المرشد للميزات الإعلانية في Google Analytics عند تمكين هذه الميزات عبر المكون الإضافي displayfeatures أو من داخل Google Analytics (إعدادات الموقع > جمع البيانات).
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
allowAdFeatures |
بدون قفل | منطقي |
true
|
غير متاح | all |
false
مثال على الاستخدام:
ga('set', 'allowAdFeatures', false)
قناع IP
اختياريّ.
عند توفره، سيتم إخفاء عنوان IP للمرسِل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
anonymizeIp |
aip
|
منطقي | بدون قفل | غير متاح | all |
true
مثال على الاستخدام:
ga('set', 'anonymizeIp', true);
مصدر البيانات
اختياريّ.
تشير إلى مصدر البيانات للنتيجة. سيتم ضبط مصدر البيانات الذي تم إرساله من مقتطف analytics.js على "الويب"، بينما سيتم تعيين مصدر البيانات في أحد حزم SDK للجوّال على "تطبيق".
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
dataSource |
ds
|
ملف نصي | بدون قفل | بدون قفل | all |
crm
مثال على الاستخدام:
ga('set', 'dataSource', 'crm');
وقت قائمة الانتظار
اختياريّ.
يُستخدم لجمع النتائج بلا إنترنت / الكامن. تمثل القيمة دلتا الوقت (بالمللي ثانية) بين وقت حدوث النتيجة التي تم إعداد تقرير لها ووقت إرسال النتيجة. يجب أن تكون القيمة أكبر من أو تساوي 0. وقد تؤدي القيم التي تزيد عن أربع ساعات إلى عدم معالجة النتائج.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
queueTime |
qt
|
عدد صحيح | بدون قفل | بدون قفل | all |
560
مثال على الاستخدام:
ga('set', 'queueTime', 560);
فرض طبقة المقابس الآمنة
اختياريّ.
وبشكل افتراضي، سيتم إرسال المرشدات من صفحات https باستخدام https في حين سيتم إرسال المرشدات المرسلة من صفحات http باستخدام http. سيؤدي تعيين forceSSL على true إلى إجبار صفحات http على إرسال جميع الإشارات باستخدام https.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
forceSSL |
بدون قفل | منطقي |
false
|
غير متاح | all |
true
مثال على الاستخدام:
ga('set', 'forceSSL', true);
النقل
اختياريّ.
تحدد هذه الآلية آلية النقل التي سيتم إرسال النتائج بها. وتكون الخيارات هي "beacon" أو "xhr" أو "image". سيحاول analytics.js بشكل افتراضي اكتشاف أفضل طريقة استنادًا إلى حجم النتائج وإمكانات المتصفح. إذا حددت 'beacon' ولا يدعم متصفح المستخدم طريقة `navigator.sendBeacon`، فسيعود إلى 'image' أو 'xhr' بناءً على حجم النتيجة.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
transport |
بدون قفل | ملف نصي |
none (automatically determined)
|
بدون قفل | all |
beacon
مثال على الاستخدام:
ga('send', 'event', 'click', 'download-me', {transport: 'beacon'});
استخدام جهاز المرشد
اختياريّ.
تم إيقاف هذا الخيار الآن. استخدم "الترجمة" بدلاً من ذلك. يؤدي تعيين هذا على "true"، إلى توجيه العميل لاستخدام navigator.sendBeacon لإرسال النتيجة. ويُعد هذا مفيدًا في الحالات التي تريد فيها تتبع حدث قبل انتقال المستخدم بعيدًا عن موقعك مباشرةً، بدون تأخير التنقل. إذا كان المتصفح لا يدعم navigator.sendBeacon، فسيتم إرسال النتيجة بشكل طبيعي.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
useBeacon |
بدون قفل | منطقي |
false
|
غير متاح | all |
true
مثال على الاستخدام:
ga('send', 'event', 'click', 'download-me', {useBeacon: true});
معلمة الرابط
اختياريّ.
معلمة الرابط للقياس عبر النطاقات.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
linkerParam |
بدون قفل | ملف نصي | بدون قفل | بدون قفل | all |
_ga=1.231587807.1974034684.1435105198
مثال على الاستخدام:
// Alerts the linker parameter for the default tracker. ga(function(tracker) { alert(tracker.get('linkerParam')); });
النقر على معاودة الاتصال
اختياريّ.
دالة سيتم استدعاؤها بعد معالجة نتيجة. تم تصميم معاودة الاتصال هذه للاتصال دائمًا، إما مباشرة بعد إرسال إحدى النتائج أو عندما يتبين أنه لا يمكن إرسال نتيجة أو قد تخفق في إرسالها. لا يتم تمرير أي وسيطات إلى الدالة عند استدعائها. قد تحتاج إلى تجنب استخدام hitscallBack لتنفيذ الشفرة المهمة لتطبيقك نظرًا لأنه من المحتمل ألا يتم استدعاؤها في حالات نادرة (على سبيل المثال، إذا لم يستجب الخادم أو أخفق تحميل analytics.js). في هذه الحالة، يمكنك تعيين مهلة لضمان التنفيذ.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
hitCallback |
بدون قفل | الدالة | بدون قفل | بدون قفل | all |
// Alerts the user when a hit is sent. ga('send', 'pageview', { 'hitCallback': function() { alert('hit sent'); } });
// Use a timeout to ensure the execution of critical application code. ga('send', 'pageview', {'hitCallback': criticalCode}); setTimeout(criticalCode, 2000); // Only run the critical code once. var alreadyCalled = false; function criticalCode() { if (alreadyCalled) return; alreadyCalled = true; // Run critical code here... }
المستخدِم
رقم تعريف المستخدم
اختياريّ.
هذا الحقل مطلوب في حال عدم تحديد Client ID (CID) في الطلب. والغرض من ذلك أن يكون معرّفًا معروفًا للمستخدم الذي يقدمه مالك الموقع/مستخدم المكتبة. يجب ألا يكون في حد ذاته معلومات تحديد هوية شخصية (معلومات تحديد الهوية الشخصية). ويجب عدم الاحتفاظ بهذه القيمة مطلقًا في ملفات تعريف ارتباط "إحصاءات Google" أو مساحة التخزين الأخرى المقدَّمة في "إحصاءات Google".
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
userId |
uid
|
ملف نصي | بدون قفل | بدون قفل | all |
as8eknlll
مثال على الاستخدام:
// Set the user ID when creating the tracker. ga('create', 'UA-XXXX-Y', {'userId': 'as8eknlll'}); // Alternatively, you may set the user ID via the `set` method. ga('set', 'userId', 'as8eknlll');
الجلسة
التحكُّم في الجلسة
اختياريّ.
يتم استخدامه للتحكم في مدة الجلسة. تفرض قيمة "start" جلسة جديدة للبدء بهذه النتيجة وتفرض "إنهاء" انتهاء الجلسة الحالية بهذه النتيجة. ويتم تجاهل جميع القيم الأخرى.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
sessionControl |
sc
|
ملف نصي | بدون قفل | بدون قفل | all |
start
مثال على الاستخدام:
// Starts a new session. ga('send', 'pageview', {'sessionControl': 'start'});
مصادر الزيارات
مُحيل المستند
اختياريّ.
لتحديد مصدر الإحالة الذي جلب الزيارات إلى موقع ويب. وتُستخدم هذه القيمة أيضًا لحساب مصدر الزيارات. ويكون تنسيق هذه القيمة هو عنوان URL. يتم إعداد هذا الحقل بواسطة أمر إنشاء ولن يتم تعيينه إلا عندما يختلف اسم المضيف الحالي عن اسم المضيف المُحيل، ما لم يتم ضبط الحقل "alwaysSendReferrer" على "صحيح".
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
referrer |
dr
|
ملف نصي |
document.referrer
|
2048 بايت | all |
http://example.com
مثال على الاستخدام:
ga('set', 'referrer', 'http://example.com');
اسم الحملة
اختياريّ.
تحدد اسم الحملة.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
campaignName |
cn
|
ملف نصي | بدون قفل | 100 بايت | all |
(direct)
مثال على الاستخدام:
ga('set', 'campaignName', '(direct)');
مصدر الحملة
اختياريّ.
لتحديد مصدر الحملة.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
campaignSource |
cs
|
ملف نصي | بدون قفل | 100 بايت | all |
(direct)
مثال على الاستخدام:
ga('set', 'campaignSource', '(direct)');
وسيط الحملة
اختياريّ.
لتحديد وسيط الحملة.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
campaignMedium |
cm
|
ملف نصي | بدون قفل | 50 بايت | all |
organic
مثال على الاستخدام:
ga('set', 'campaignMedium', 'organic');
الكلمة الرئيسية للحملة
اختياريّ.
لتحديد الكلمة الرئيسية للحملة.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
campaignKeyword |
ck
|
ملف نصي | بدون قفل | 500 بايت | all |
Blue Shoes
مثال على الاستخدام:
ga('set', 'campaignKeyword', 'Blue Shoes');
محتوى الحملة
اختياريّ.
لتحديد محتوى الحملة.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
campaignContent |
cc
|
ملف نصي | بدون قفل | 500 بايت | all |
content
مثال على الاستخدام:
ga('set', 'campaignContent', 'content');
رقم تعريف الحملة
اختياريّ.
تحدّد رقم تعريف الحملة.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
campaignId |
ci
|
ملف نصي | بدون قفل | 100 بايت | all |
ID
مثال على الاستخدام:
ga('set', 'campaignId', 'ID');
معلومات النظام
درجة دقة الشاشة
اختياريّ.
لتحديد درجة دقة الشاشة. يتم إعداد هذا الحقل باستخدام أمر إنشاء.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
screenResolution |
sr
|
ملف نصي | بدون قفل | 20 بايت | all |
800x600
مثال على الاستخدام:
ga('set', 'screenResolution', '800x600');
حجم إطار العرض
اختياريّ.
لتحديد المنطقة القابلة للعرض في المتصفح / الجهاز. يتم إعداد هذا الحقل باستخدام أمر إنشاء.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
viewportSize |
vp
|
ملف نصي | بدون قفل | 20 بايت | all |
123x456
مثال على الاستخدام:
ga('set', 'viewportSize', '123x456');
ترميز المستندات
اختياريّ.
لتحديد مجموعة الأحرف المستخدمة لتشفير الصفحة / المستند. يتم إعداد هذا الحقل باستخدام أمر إنشاء.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
encoding |
de
|
ملف نصي |
UTF-8
|
20 بايت | all |
UTF-8
مثال على الاستخدام:
ga('set', 'encoding', 'UTF-16');
ألوان الشاشة
اختياريّ.
تحدِّد هذه السياسة العمق اللوني للشاشة. يتم إعداد هذا الحقل باستخدام أمر إنشاء.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
screenColors |
sd
|
ملف نصي | بدون قفل | 20 بايت | all |
24-bits
مثال على الاستخدام:
ga('set', 'screenColors', '8-bit');
لغة المستخدم
اختياريّ.
لتحديد اللغة. يتم إعداد هذا الحقل باستخدام أمر إنشاء.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
language |
ul
|
ملف نصي | بدون قفل | 20 بايت | all |
en-us
مثال على الاستخدام:
ga('set', 'language', 'en-us');
تم تفعيل جافا
اختياريّ.
لتحديد ما إذا تم تمكين جافا أم لا. يتم إعداد هذا الحقل باستخدام أمر إنشاء.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
javaEnabled |
je
|
منطقي | بدون قفل | غير متاح | all |
true
مثال على الاستخدام:
ga('set', 'javaEnabled', true);
إصدار Flash
اختياريّ.
لتحديد إصدار الفلاش. يتم إعداد هذا الحقل باستخدام أمر إنشاء.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
flashVersion |
fl
|
ملف نصي | بدون قفل | 20 بايت | all |
10 1 r103
مثال على الاستخدام:
ga('set', 'flashVersion', '10 1 r103');
Hit
نوع النتيجة
مطلوبة لكل أنواع النتائج.
نوع النتيجة. يجب أن يكون واحدًا من "مشاهدة الصفحة" أو "مشاهدة الشاشة" أو "الحدث" أو "المعاملة" أو "العنصر" أو "اجتماعية" أو "الاستثناء" أو "التوقيت".
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
hitType |
t
|
ملف نصي | بدون قفل | بدون قفل | all |
pageview
مثال على الاستخدام:
ga('send', { 'hitType': 'pageview', 'page': '/home' });
نتيجة عدم التفاعل
اختياريّ.
تحدد أن النتيجة تعتبر غير تفاعلية.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
nonInteraction |
ni
|
منطقي | بدون قفل | غير متاح | all |
true
مثال على الاستخدام:
ga('set', 'nonInteraction', true);
معلومات المحتوى
عنوان URL لموقع المستند
اختياريّ.
تحدد عنوان URL الكامل (باستثناء علامة الارتساء) للصفحة. يتم إعداد هذا الحقل باستخدام أمر إنشاء.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
location |
dl
|
ملف نصي | بدون قفل | 2048 بايت | all |
http://foo.com/home?a=b
مثال على الاستخدام:
ga('set', 'location', 'http://foo.com/home?a=b');
اسم مضيف المستند
اختياريّ.
لتحديد اسم المضيف الذي تمت استضافة المحتوى منه.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
hostname |
dh
|
ملف نصي | بدون قفل | 100 بايت | all |
foo.com
مثال على الاستخدام:
ga('set', 'hostname', 'foo.com');
مسار المستند
اختياريّ.
جزء المسار من عنوان URL للصفحة. يجب أن يبدأ بـ '/'. بالنسبة إلى نتائج 'مشاهدة الصفحة'، يجب تحديد &dl أو كلٍّ من &dh و&dp حتى تكون النتيجة صالحة. يتم استخدامه لتحديد مسارات الصفحات الافتراضية.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
page |
dp
|
ملف نصي | بدون قفل | 2048 بايت | all |
/foo
مثال على الاستخدام:
ga('set', 'page', '/foo');
عنوان المستند
اختياريّ.
تمثل هذه الخاصية عنوان الصفحة / المستند. الإعداد الافتراضي هو document.title.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
title |
dt
|
ملف نصي | بدون قفل | 1500 بايت | all |
Settings
مثال على الاستخدام:
ga('set', 'title', 'Settings');
اسم الشاشة
مطلوبة لنوع نتيجة مشاهدة الشاشة.
هذه المعلمة اختيارية في مواقع الويب، ومطلوبة في مواقع الجوال لنتائج مشاهدة الشاشة، حيث يتم استخدامها من أجل "اسم الشاشة" لنتيجة مشاهدة الشاشة. وفي مواقع الويب، سيتم تعيين ذلك تلقائيًا على عنوان URL الفريد للصفحة إما عن طريق استخدام المعلمة &dl كما هي أو تجميعها من &dh و &dp.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
screenName |
cd
|
ملف نصي | بدون قفل | 2048 بايت | مشاهدة صفحة |
High Scores
مثال على الاستخدام:
ga('set', 'screenName', 'High Scores');
مجموعة المحتوى
اختياريّ.
يمكن أن يكون لديك ما يصل إلى 5 مجموعات محتوى، لكل منها فهرس مرتبط بين 1 و5، بما في ذلك القيم الواقعة بينهما. يمكن أن يضم كل تجميع محتوى ما يصل إلى 100 مجموعة محتوى. قيمة مجموعة المحتوى هي نص هرمي مفصول بعلامة "/". وستتم إزالة كل الشرطة المائلة البادئة واللاحقة، كما سيتم تقليل أي شرطات مكررة إلى شرطة مائلة واحدة. على سبيل المثال، سيتم تحويل "/a//b/" إلى "a/b".
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
contentGroup |
cg<groupIndex>
|
ملف نصي | بدون قفل | 100 بايت | all |
news/sports
مثال على الاستخدام:
ga('set', 'contentGroup5', '/news/sports');
رقم تعريف الرابط
اختياريّ.
رقم تعريف عنصر DOM الذي تم النقر عليه، ويتم استخدامه لتمييز عدة روابط لعنوان URL نفسه في تقارير In-Page Analytics عند تفعيل تحسين إحالة الرابط للموقع.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
linkid |
linkid
|
ملف نصي | بدون قفل | بدون قفل | all |
nav_bar
مثال على الاستخدام:
ga('set', '&linkid', 'html-element-id');
حملة تطبيقات
اسم التطبيق
اختياريّ.
لتحديد اسم التطبيق. هذا الحقل مطلوب لأي نتيجة تحتوي على بيانات ذات صلة بالتطبيق (أي إصدار التطبيق أو رقم تعريف التطبيق أو رقم تعريف أداة تثبيت التطبيق). بالنسبة إلى النتائج المرسلة إلى مواقع الويب، يكون هذا الحقل اختياريًا.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
appName |
an
|
ملف نصي | بدون قفل | 100 بايت | all |
My App
مثال على الاستخدام:
ga('set', 'appName', 'My App');
معرّف التطبيق
اختياريّ.
معرّف التطبيق.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
appId |
aid
|
ملف نصي | بدون قفل | 150 بايت | all |
com.company.app
مثال على الاستخدام:
ga('set', 'appId', 'com.company.app');
إصدار التطبيق
اختياريّ.
لتحديد إصدار التطبيق.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
appVersion |
av
|
ملف نصي | بدون قفل | 100 بايت | all |
1.2
مثال على الاستخدام:
ga('set', 'appVersion', '1.2');
رقم تعريف أداة تثبيت التطبيق
اختياريّ.
معرّف أداة تثبيت التطبيق.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
appInstallerId |
aiid
|
ملف نصي | بدون قفل | 150 بايت | all |
com.platform.vending
مثال على الاستخدام:
ga('set', 'appInstallerId', 'com.platform.vending');
الأحداث
فئة الحدث
مطلوبة لنوع نتيجة الحدث.
لتحديد فئة الحدث. يجب ألا يكون فارغًا.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
eventCategory |
ec
|
ملف نصي | بدون قفل | 150 بايت | حدث |
Category
مثال على الاستخدام:
ga('send', 'event', { 'eventCategory': 'Category', 'eventAction': 'Action' });
إجراء الحدث
مطلوبة لنوع نتيجة الحدث.
لتحديد إجراء الحدث. يجب ألا يكون فارغًا.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
eventAction |
ea
|
ملف نصي | بدون قفل | 500 بايت | حدث |
Action
مثال على الاستخدام:
ga('send', 'event', { 'eventCategory': 'Category', 'eventAction': 'Action' });
تصنيف الحدث
اختياريّ.
لتحديد تصنيف الحدث.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
eventLabel |
el
|
ملف نصي | بدون قفل | 500 بايت | حدث |
Label
مثال على الاستخدام:
ga('send', 'event', { 'eventCategory': 'Category', 'eventAction': 'Action', 'eventLabel': 'Label' });
قيمة الحدث
اختياريّ.
لتحديد قيمة الحدث. يجب أن تكون القيم غير سالبة.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
eventValue |
ev
|
عدد صحيح | بدون قفل | بدون قفل | حدث |
55
مثال على الاستخدام:
ga('send', 'event', { 'eventCategory': 'Category', 'eventAction': 'Action', 'eventValue': 55 });
التجارة الإلكترونية المحسَّنة
حزمة SKU للمنتج
اختياريّ.
رمز التخزين التعريفي للمنتج. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product) id |
pr<productIndex>id
|
ملف نصي | بدون قفل | 500 بايت | all |
P12345
مثال على الاستخدام:
ga('ec:addProduct', {'id': 'P12345'});
اسم المنتج
اختياريّ.
اسم المنتج يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product) name |
pr<productIndex>nm
|
ملف نصي | بدون قفل | 500 بايت | all |
Android T-Shirt
مثال على الاستخدام:
ga('ec:addProduct', {'name': 'Android T-Shirt'});
العلامة التجارية للمنتج
اختياريّ.
العلامة التجارية المرتبطة بالمنتج. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product) brand |
pr<productIndex>br
|
ملف نصي | بدون قفل | 500 بايت | all |
Google
مثال على الاستخدام:
ga('ec:addProduct', {'brand': 'Google'});
فئة المنتج
اختياريّ.
الفئة التي ينتمي إليها المنتج. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. يمكن أن تكون معلمة فئة المنتج هرمية. استخدم / كمحدد لتحديد ما يصل إلى 5 مستويات من التدرج الهرمي. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product) category |
pr<productIndex>ca
|
ملف نصي | بدون قفل | 500 بايت | all |
Apparel
مثال على الاستخدام:
ga('ec:addProduct', {'category': 'Apparel'});
صيغة المنتج
اختياريّ.
صيغة المنتج. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product) variant |
pr<productIndex>va
|
ملف نصي | بدون قفل | 500 بايت | all |
Black
مثال على الاستخدام:
ga('ec:addProduct', {'variant': 'Black'});
سعر المنتج
اختياريّ.
سعر الوحدة للمنتج. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product) price |
pr<productIndex>pr
|
currency | بدون قفل | بدون قفل | all |
29.20
مثال على الاستخدام:
ga('ec:addProduct', {'price': '29.20'});
كمية المنتج
اختياريّ.
كمية المنتج يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product) quantity |
pr<productIndex>qt
|
عدد صحيح | بدون قفل | بدون قفل | all |
2
مثال على الاستخدام:
ga('ec:addProduct', {'quantity': 2});
رمز قسيمة المنتج
اختياريّ.
رمز القسيمة المرتبط بمنتج. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product) coupon |
pr<productIndex>cc
|
ملف نصي | بدون قفل | 500 بايت | all |
SUMMER_SALE13
مثال على الاستخدام:
ga('ec:addProduct', {'coupon': 'SUMMER_SALE13'});
موضع المنتج
اختياريّ.
موضع المنتج في قائمة أو مجموعة يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product) position |
pr<productIndex>ps
|
عدد صحيح | بدون قفل | بدون قفل | all |
2
مثال على الاستخدام:
ga('ec:addProduct', {'position': 2});
البُعد المخصّص للمنتج
اختياريّ.
مكوّن مخصّص على مستوى المنتج حيث يكون فهرس البُعد عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك القيم الواقعة بينهما. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product) dimension |
pr<productIndex>cd<dimensionIndex>
|
ملف نصي | بدون قفل | 150 بايت | all |
Member
مثال على الاستخدام:
ga('ec:addProduct', {'dimension1': 'Member'});
المقياس المخصّص للمنتج
اختياريّ.
مقياس مخصّص على مستوى المنتج حيث يكون فهرس المقياس عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product) metric |
pr<productIndex>cm<metricIndex>
|
عدد صحيح | بدون قفل | بدون قفل | all |
28
مثال على الاستخدام:
ga('ec:addProduct', {'metric1': 28});
إجراءات المنتج
اختياريّ.
دور المنتجات المضمّنة في النتيجة. إذا لم يتم تحديد إجراء منتج، سيتم تجاهل جميع تعريفات المنتج المضمنة في النتيجة. يجب أن يكون واحدًا مما يلي: التفاصيل، أو النقر، أو الإضافة، أو الإزالة، أو الدفع، أو checkout_option، أو الشراء، أو رد الأموال. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product action) |
pa
|
ملف نصي | بدون قفل | بدون قفل | all |
detail
مثال على الاستخدام:
ga('ec:setAction', 'detail');
معرِّف المعاملة
اختياريّ.
معرِّف المعاملة. وهذه معلمة إضافية يمكن إرسالها عند تعيين "إجراء المنتج" على "شراء" أو "رد أموال". بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product action) id |
ti
|
ملف نصي | بدون قفل | بدون قفل | all |
T1234
مثال على الاستخدام:
ga('ec:setAction', 'purchase', {'id': 'T1234'});
الارتباط
اختياريّ.
المتجر أو الارتباط الذي حدثت منه هذه المعاملة. وهذه معلمة إضافية يمكن إرسالها عند تعيين "إجراء المنتج" على "شراء" أو "رد أموال". بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product action) affiliation |
ta
|
ملف نصي | بدون قفل | بدون قفل | all |
Google Store
مثال على الاستخدام:
ga('ec:setAction', 'purchase', {'affiliation': 'Google Store'});
الأرباح
اختياريّ.
إجمالي قيمة المعاملة، بما في ذلك الضريبة والشحن. وفي حال عدم الإرسال، سيتم احتساب هذه القيمة تلقائيًا باستخدام حقلي كمية المنتج والسعر لكل المنتجات في النتيجة نفسها. وهذه معلمة إضافية يمكن إرسالها عند تعيين "إجراء المنتج" على "شراء" أو "رد أموال". بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product action) revenue |
tr
|
currency | بدون قفل | بدون قفل | all |
123.21
مثال على الاستخدام:
ga('ec:setAction', 'purchase', {'revenue': '123.21'});
الضريبة
اختياريّ.
إجمالي الضريبة المرتبطة بالمعاملة. وهذه معلمة إضافية يمكن إرسالها عند تعيين "إجراء المنتج" على "شراء" أو "رد أموال". بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product action) tax |
tt
|
currency | بدون قفل | بدون قفل | all |
10.78
مثال على الاستخدام:
ga('ec:setAction', 'purchase', {'tax': '10.78'});
الشحن
اختياريّ.
تكلفة الشحن المرتبطة بالمعاملة. وهذه معلمة إضافية يمكن إرسالها عند تعيين "إجراء المنتج" على "شراء" أو "رد أموال". بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product action) shipping |
ts
|
currency | بدون قفل | بدون قفل | all |
3.55
مثال على الاستخدام:
ga('ec:setAction', 'purchase', {'shipping': '3.55'});
رمز القسيمة
اختياريّ.
تم تحصيل قيمة قسيمة المعاملة. وهذه معلمة إضافية يمكن إرسالها عند تعيين "إجراء المنتج" على "شراء" أو "رد أموال". بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product action) coupon |
tcc
|
ملف نصي | بدون قفل | بدون قفل | all |
SUMMER08
مثال على الاستخدام:
ga('ec:setAction', 'purchase', {'coupon': 'SUMMER08'});
قائمة إجراءات المنتجات
اختياريّ.
القائمة أو المجموعة التي تم اتخاذ إجراء المنتج منها. وهذه معلمة إضافية يمكن إرسالها عند تعيين "إجراء المنتج" على "التفاصيل" أو "النقر". بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product action) list |
pal
|
ملف نصي | بدون قفل | بدون قفل | all |
Search Results
مثال على الاستخدام:
ga('ec:setAction', 'click', {'list': 'Search Results'});
خطوة الدفع
اختياريّ.
رقم الخطوة في مسار الدفع. وهذه معلمة إضافية يمكن إرسالها عند تعيين "إجراء المنتج" على "الدفع". بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product action) step |
cos
|
عدد صحيح | بدون قفل | بدون قفل | all |
2
مثال على الاستخدام:
ga('ec:setAction', 'checkout', {'step': 2});
خيار خطوة سداد الرسوم
اختياريّ.
معلومات إضافية حول خطوة الدفع. وهذه معلمة إضافية يمكن إرسالها عند تعيين "إجراء المنتج" على "الدفع". بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(product action) option |
col
|
ملف نصي | بدون قفل | بدون قفل | all |
Visa
مثال على الاستخدام:
ga('ec:setAction', 'checkout', {'option': 'Visa'});
اسم قائمة مرات ظهور المنتج
اختياريّ.
القائمة أو المجموعة التي ينتمي إليها المنتج. يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(impression) list |
il<listIndex>nm
|
ملف نصي | بدون قفل | بدون قفل | all |
Search Results
مثال على الاستخدام:
ga('ec:addImpression', {'list': 'Search Results'});
حزمة SKU لمرات ظهور المنتج
اختياريّ.
رقم تعريف المنتج أو رمز التخزين التعريفي. يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(impression) id |
il<listIndex>pi<productIndex>id
|
ملف نصي | بدون قفل | بدون قفل | all |
P67890
مثال على الاستخدام:
ga('ec:addImpression', {'id': 'P67890'});
اسم ظهور المنتج
اختياريّ.
اسم المنتج يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(impression) name |
il<listIndex>pi<productIndex>nm
|
ملف نصي | بدون قفل | بدون قفل | all |
Android T-Shirt
مثال على الاستخدام:
ga('ec:addImpression', {'name': 'Android T-Shirt'});
العلامة التجارية لمرّات ظهور المنتج
اختياريّ.
العلامة التجارية المرتبطة بالمنتج. يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(impression) brand |
il<listIndex>pi<productIndex>br
|
ملف نصي | بدون قفل | بدون قفل | all |
Google
مثال على الاستخدام:
ga('ec:addImpression', {'brand': 'Google'});
فئة ظهور المنتج
اختياريّ.
الفئة التي ينتمي إليها المنتج. يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(impression) category |
il<listIndex>pi<productIndex>ca
|
ملف نصي | بدون قفل | بدون قفل | all |
Apparel
مثال على الاستخدام:
ga('ec:addImpression', {'category': 'Apparel'});
صيغة مرة ظهور المنتج
اختياريّ.
صيغة المنتج. يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(impression) variant |
il<listIndex>pi<productIndex>va
|
ملف نصي | بدون قفل | بدون قفل | all |
Black
مثال على الاستخدام:
ga('ec:addImpression', {'variant': 'Black'});
موضع ظهور المنتج
اختياريّ.
موضع المنتج في قائمة أو مجموعة يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(impression) position |
il<listIndex>pi<productIndex>ps
|
عدد صحيح | بدون قفل | بدون قفل | all |
2
مثال على الاستخدام:
ga('ec:addImpression', {'position': 2});
سعر ظهور المنتج
اختياريّ.
سعر المنتج. يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(impression) price |
il<listIndex>pi<productIndex>pr
|
currency | بدون قفل | بدون قفل | all |
29.20
مثال على الاستخدام:
ga('ec:addImpression', {'price': '29.20'});
المكوّن المخصّص لمرات ظهور المنتج
اختياريّ.
مكوّن مخصّص على مستوى المنتج حيث يكون فهرس البُعد عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك القيم الواقعة بينهما. يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(impression) dimension |
il<listIndex>pi<productIndex>cd<dimensionIndex>
|
ملف نصي | بدون قفل | بدون قفل | all |
Member
مثال على الاستخدام:
ga('ec:addImpression', {'dimension1': 'Member'});
المقياس المخصّص لمرات ظهور المنتج
اختياريّ.
مقياس مخصّص على مستوى المنتج حيث يكون فهرس المقياس عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(impression) metric |
il<listIndex>pi<productIndex>cm<metricIndex>
|
عدد صحيح | بدون قفل | بدون قفل | all |
28
مثال على الاستخدام:
ga('ec:addImpression', {'metric1': '28'});
معرّف العرض الترويجي
اختياريّ.
معرّف العرض الترويجي يجب أن يكون فهرس العرض الترويجي عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(promo) id |
promo<promoIndex>id
|
ملف نصي | بدون قفل | بدون قفل | all |
SHIP
مثال على الاستخدام:
ga('ec:addPromo', {'id': 'SHIP'});
اسم العرض الترويجي
اختياريّ.
اسم الترويج. يجب أن يكون فهرس العرض الترويجي عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(promo) name |
promo<promoIndex>nm
|
ملف نصي | بدون قفل | بدون قفل | all |
Free Shipping
مثال على الاستخدام:
ga('ec:addPromo', {'name': 'Free Shipping'});
تصميم الإعلان الترويجي
اختياريّ.
تصميم الإعلان المرتبط بالعرض الترويجي. يجب أن يكون فهرس العرض الترويجي عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(promo) creative |
promo<promoIndex>cr
|
ملف نصي | بدون قفل | بدون قفل | all |
Shipping Banner
مثال على الاستخدام:
ga('ec:addPromo', {'creative': 'Shipping Banner'});
موضع العرض الترويجي
اختياريّ.
موضع تصميم الإعلان. يجب أن يكون فهرس العرض الترويجي عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان. بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(promo) position |
promo<promoIndex>ps
|
ملف نصي | بدون قفل | بدون قفل | all |
banner_slot_1
مثال على الاستخدام:
ga('ec:addPromo', {'position': 'banner_slot_1'});
الإجراء الترويجي
اختياريّ.
تحدد دور العروض الترويجية المضمنة في النتيجة. إذا لم يتم تحديد إجراء ترويج، فسيتم افتراض إجراء الترويج الافتراضي "عرض". لقياس نقر المستخدم على عرض ترويجي، يجب ضبط قيمة هذا العرض الترويجي على "promo_click". بالنسبة إلى analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
(promo) action |
promoa
|
ملف نصي | بدون قفل | بدون قفل | all |
click
مثال على الاستخدام:
ga('ec:setAction', 'promo_click'});
رمز العملة
اختياريّ.
عند توفّرها، تشير إلى العملة المحلية لجميع قيم عملة المعاملات. يجب أن تكون القيمة رمز عملة ISO 4217 صالحًا.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
currencyCode |
cu
|
ملف نصي | بدون قفل | 10 بايت | all |
EUR
مثال على الاستخدام:
ga('set', 'currencyCode', 'EUR');
التفاعلات الاجتماعية
الشبكات الاجتماعية
مطلوبة لنوع النتيجة الاجتماعية.
لتحديد الشبكة الاجتماعية، على سبيل المثال Facebook أو Google Plus.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
socialNetwork |
sn
|
ملف نصي | بدون قفل | 50 بايت | اجتماعي |
facebook
مثال على الاستخدام:
ga('send', 'social', { 'socialNetwork': 'facebook', 'socialAction': 'like', 'socialTarget': 'http://foo.com' })
الإجراء الاجتماعي
مطلوبة لنوع النتيجة الاجتماعية.
لتحديد إجراء التفاعل الاجتماعي. على سبيل المثال، في Google Plus عندما ينقر مستخدم على زر +1، يكون الإجراء الاجتماعي هو "plus".
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
socialAction |
sa
|
ملف نصي | بدون قفل | 50 بايت | اجتماعي |
like
مثال على الاستخدام:
ga('send', 'social', { 'socialNetwork': 'facebook', 'socialAction': 'like', 'socialTarget': 'http://foo.com' })
هدف الإجراء الاجتماعي
مطلوبة لنوع النتيجة الاجتماعية.
لتحديد الهدف من التفاعل الاجتماعي. عادةً ما تكون هذه القيمة عنوان URL، ولكن يمكن أن تكون أي نص.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
socialTarget |
st
|
ملف نصي | بدون قفل | 2048 بايت | اجتماعي |
http://foo.com
مثال على الاستخدام:
ga('send', 'social', { 'socialNetwork': 'facebook', 'socialAction': 'like', 'socialTarget': 'http://foo.com' })
التوقيت
فئة توقيت المستخدم
مطلوبة لنوع نتيجة النتيجة.
تحدّد فئة توقيت المستخدم.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
timingCategory |
utc
|
ملف نصي | بدون قفل | 150 بايت | التوقيت |
category
مثال على الاستخدام:
ga('send', 'timing', { 'timingCategory': 'category', 'timingVar': 'lookup', 'timingValue': 123 });
اسم متغير توقيت المستخدم
مطلوبة لنوع نتيجة النتيجة.
تحدّد هذه السمة متغير توقيت المستخدم.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
timingVar |
utv
|
ملف نصي | بدون قفل | 500 بايت | التوقيت |
lookup
مثال على الاستخدام:
ga('send', 'timing', { 'timingCategory': 'category', 'timingVar': 'lookup', 'timingValue': 123 });
وقت توقيت المستخدم
مطلوبة لنوع نتيجة النتيجة.
لتحديد قيمة توقيت المستخدم. القيمة بالمللي ثانية.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
timingValue |
utt
|
عدد صحيح | بدون قفل | بدون قفل | التوقيت |
123
مثال على الاستخدام:
ga('send', 'timing', { 'timingCategory': 'category', 'timingVar': 'lookup', 'timingValue': 123 });
تصنيف توقيت المستخدم
اختياريّ.
لتحديد تصنيف توقيت المستخدم.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
timingLabel |
utl
|
ملف نصي | بدون قفل | 500 بايت | التوقيت |
label
مثال على الاستخدام:
ga('send', 'timing', { 'timingCategory': 'category', 'timingVar': 'lookup', 'timingValue': 123, 'timingLabel': 'label' });
الاستثناءات
وصف الاستثناء
اختياريّ.
لتحديد وصف الاستثناء.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
exDescription |
exd
|
ملف نصي | بدون قفل | 150 بايت | الاستثناء |
DatabaseError
مثال على الاستخدام:
ga('send', 'exception', { 'exDescription': 'DatabaseError' });
هل الاستثناء فادح؟
اختياريّ.
لتحديد ما إذا كان الاستثناء فادحًا.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
exFatal |
exf
|
منطقي |
1
|
غير متاح | الاستثناء |
true
مثال على الاستخدام:
ga('send', 'exception', { 'exFatal': true });
الأبعاد / المقاييس المخصصة
البُعد المخصص
اختياريّ.
لكل مكوّن مخصص فهرس مرتبط. هناك 20 سمة مخصّصة بحدٍ أقصى (200 سمة لحسابات "إحصاءات 360"). يجب أن يكون فهرس البُعد عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
dimension |
cd<dimensionIndex>
|
ملف نصي | بدون قفل | 150 بايت | all |
Sports
مثال على الاستخدام:
ga('set', 'dimension14', 'Sports');
المقياس المخصّص
اختياريّ.
لكل مقياس مخصص فهرس مرتبط به. يتوفّر 20 مقياسًا مخصّصًا بحدٍ أقصى (200 مقياس لحسابات "إحصاءات 360"). يجب أن يكون فهرس المقياس عددًا صحيحًا موجبًا بين 1 و200، بما في ذلك الرقمان.
اسم الحقل | معلّمة البروتوكول | نوع القيمة | القيمة التلقائية | أقصى طول | أنواع النتائج المتوافقة |
---|---|---|---|---|---|
metric |
cm<metricIndex>
|
number | بدون قفل | بدون قفل | all |
47
مثال على الاستخدام:
ga('set', 'metric7', 47);