مرجع حقل Analytics.js

يسرد هذا المستند جميع أسماء الحقول القابلة للضبط في مقتطف analytics.js.

  1. إنشاء الحقول فقط
  2. الإعدادات العامة
  3. المستخدم
  4. الجلسة
  5. مصادر الزيارات
  6. معلومات النظام
  7. النتيجة
  8. معلومات المحتوى
  9. التطبيقات
  10. الأحداث
  11. التجارة الإلكترونية المحسَّنة
  12. التفاعلات الاجتماعية
  13. التوقيت
  14. الاستثناءات
  15. السمات / المقاييس المخصَّصة

إنشاء الحقول فقط

لا يمكن ضبط الحقول التالية إلا باستخدام طريقة create. لمعرفة مزيد من التفاصيل، يُرجى الاطِّلاع على القسم إنشاء كائنات أداة التتبُّع في دليل الإعداد المتقدِّم.

رقم تعريف التتبّع/ رقم تعريف الموقع الإلكتروني

مطلوبة لجميع أنواع النتائج.

رقم تعريف التتبّع / رقم تعريف موقع الويب. يكون التنسيق على النحو التالي: UA-XXXX-Y. جميع البيانات المجمَّعة مرتبطة برقم التعريف هذا.

اسم الحقل نوع القيمة القيمة التلقائية
trackingId text بدون قفل
مثال على القيمة: 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 text t0
مثال على القيمة: myTracker
مثال على الاستخدام: 
ga('create', 'UA-XXXX-Y', {'name': 'myTracker'});

رقم تعريف العميل

اختياريّ. ولا يمكن ضبط ذلك إلا من خلال طريقة create.

يتمّ تحديد نسخة المتصفّح بشكلٍ مجهول. يتمّ تخزين هذه القيمة تلقائيًا كجزء من ملفّ تعريف ارتباط "إحصاءات Google" التابع للطرف الأوّل والذي تنتهي صلاحيته بعد عامَين.

اسم الحقل نوع القيمة القيمة التلقائية
clientId text Randomly Generated
مثال على القيمة: 35009a79-1a05-49d7-b876-2b884d0f825b
مثال على الاستخدام: 
ga('create', 'UA-XXXX-Y', {
  'clientId': '35009a79-1a05-49d7-b876-2b884d0f825b'
});

معدّل البيانات في الملف الصوتي

اختياريّ. ولا يمكن ضبط ذلك إلا من خلال طريقة create.

تُحدِّد النسبة المئوية للمستخدمين الذين يجب تتبُّعهم. يتم ضبط الإعداد التلقائي على 100 (لا يتم أخذ عينات من أي مستخدمين)، ولكن قد تحتاج المواقع الإلكترونية الكبيرة إلى استخدام معدّل عيّنة أقل للبقاء ضمن حدود معالجة "إحصاءات Google".

اسم الحقل نوع القيمة القيمة التلقائية
sampleRate الرقم 100
مثال على القيمة: 5
مثال على الاستخدام: 
ga('create', 'UA-XXXX-Y', {'sampleRate': 5});

معدّل البيانات في عيّنة لسرعة الموقع الإلكتروني

اختياريّ. ولا يمكن ضبط ذلك إلا من خلال طريقة create.

يحدّد هذا الإعداد عدد المرات التي سيتم فيها إرسال إشارات سرعة الموقع الإلكتروني. سيتم تلقائيًا قياس 1% من المستخدمين.

اسم الحقل نوع القيمة القيمة التلقائية
siteSpeedSampleRate الرقم 1
مثال على القيمة: 10
مثال على الاستخدام: 
ga('create', 'UA-XXXX-Y', {'siteSpeedSampleRate': 10});

إرسال المُحيل دائمًا

اختياريّ. ولا يمكن ضبط ذلك إلا من خلال طريقة create.

بشكلٍ تلقائي، يتم إرسال عنوان URL لمحيل HTTP، والذي يُستخدم لتحديد مصدر مصادر الزيارات، فقط عندما يختلف اسم المضيف لموقع الإحالة عن اسم المضيف للصفحة الحالية. قم بتمكين هذا الإعداد فقط إذا كنت تريد معالجة الصفحات الأخرى من مضيفك الحالي كإحالات.

اسم الحقل نوع القيمة القيمة التلقائية
alwaysSendReferrer boolean false
مثال على القيمة: true
مثال على الاستخدام: 
ga('create', 'UA-XXXX-Y', {'alwaysSendReferrer': true});

السماح بمَعلمات علامة الارتساء

اختياريّ. ولا يمكن ضبط ذلك إلا من خلال طريقة create.

بشكلٍ تلقائي، ستبحث analytics.js عن مَعلمات الحملات المخصّصة، مثل utm_source وutm_medium وما إلى ذلك، في كلّ من سلسلة طلب البحث وعلامة الارتساء لعنوان URL للصفحة الحالية. وسيؤدي ضبط هذا الحقل على "خطأ" إلى تجاهل أي مَعلمات حملة مخصّصة تظهر في علامة الارتساء.

اسم الحقل نوع القيمة القيمة التلقائية
allowAnchor boolean true
مثال على القيمة: false
مثال على الاستخدام: 
ga('create', 'UA-XXXX-Y', {'allowAnchor': false});

اسم ملف تعريف الارتباط

اختياريّ. ولا يمكن ضبط ذلك إلا من خلال طريقة create.

اسم ملف تعريف الارتباط المُستخدَم لتخزين بيانات الإحصاءات

اسم الحقل نوع القيمة القيمة التلقائية
cookieName text _ga
مثال على القيمة: gaCookie
مثال على الاستخدام: 
ga('create', 'UA-XXXX-Y', {'cookieName': 'gaCookie'});

نطاق ملفات تعريف الارتباط

اختياريّ. ولا يمكن ضبط ذلك إلا من خلال طريقة create.

تُحدِّد النطاق المستخدَم لتخزين ملفّ تعريف ارتباط "إحصاءات Google". ويؤدي ضبط هذا الإعداد على "none" إلى ضبط ملف تعريف الارتباط بدون تحديد نطاق.

اسم الحقل نوع القيمة القيمة التلقائية
cookieDomain text document.location.hostname (normalized)
مثال على القيمة: example.com
مثال على الاستخدام: 
ga('create', 'UA-XXXX-Y', {'cookieDomain': 'example.com'});

علامات ملفات تعريف الارتباط

اختياريّ. ولا يمكن ضبط ذلك إلا من خلال طريقة create.

تُحدِّد علامات إضافية لإلحاقها بملف تعريف الارتباط. يجب فصل العلامات باستخدام الفاصلات المنقوطة.

اسم الحقل نوع القيمة القيمة التلقائية
cookieFlags text بدون قفل
مثال على القيمة: 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 boolean true
مثال على القيمة: true
مثال على الاستخدام: 
ga('create', 'UA-XXXX-Y', {'cookieUpdate': 'false'});

متجر GAC

اختياريّ. ولا يمكن ضبط ذلك إلا من خلال طريقة create.

تكتب analytics.js بشكل تلقائي ملف تعريف ارتباط لتخزين معلومات الحملة. ويمكن استخدام هذا الحقل لإيقاف كتابة ملف تعريف الارتباط هذا.

اسم الحقل نوع القيمة القيمة التلقائية
storeGac boolean true
مثال على القيمة: false
مثال على الاستخدام: 
ga('create', 'UA-XXXX-Y', {'storeGac': false});

نطاق ملفات تعريف الارتباط القديم

اختياريّ. ولا يمكن ضبط ذلك إلا من خلال طريقة create.

يُستخدم هذا الحقل لضبط كيفية بحث analytics.js عن ملفات تعريف الارتباط التي تم إنشاؤها بواسطة النصوص البرمجية السابقة لخدمة "إحصاءات Google"، مثل ga.js وurchin.js.

اسم الحقل نوع القيمة القيمة التلقائية
legacyCookieDomain text بدون قفل
مثال على القيمة: store.example.com
مثال على الاستخدام: 
ga('create', 'UA-XXXX-Y', {'legacyCookieDomain': 'store.example.com'});

استيراد السجلّ القديم

اختياريّ. ولا يمكن ضبط ذلك إلا من خلال طريقة create.

تحدِّد ما إذا كان يجب أن تحاول مقتطف analytics.js استيراد بيانات السجلّ من ملفات تعريف الارتباط ga.js.

اسم الحقل نوع القيمة القيمة التلقائية
legacyHistoryImport boolean true
مثال على القيمة: false
مثال على الاستخدام: 
ga('create', 'UA-XXXX-Y', 'auto', {'legacyHistoryImport': false});

السماح بمَعلمات علامة الربط

اختياريّ. ولا يمكن ضبط ذلك إلا من خلال طريقة create.

عند ضبط هذا الحقل على "صحيح"، سيتم تفعيل تحليل مقاييس الربط عبر النطاقات المستخدَمة لنقل حالة عبر النطاقات.

اسم الحقل نوع القيمة القيمة التلقائية
allowLinker boolean false
مثال على القيمة: true
مثال على الاستخدام: 
ga('create', 'UA-XXXX-Y', {allowLinker: true});

بنود عامة

السماح بميزات الإعلان

اختياريّ.

يمكنك ضبط هذا الحقل على "خطأ" لإيقاف إشارات الميزات الإعلانية في "إحصاءات Google" عندما تكون هذه الميزات مفعَّلة من خلال المكوّن الإضافي Displayfeatures أو من داخل "إحصاءات Google" (إعدادات الموقع > جمع البيانات).

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
allowAdFeatures بدون قفل boolean true لا ينطبق الكل
مثال على القيمة: false
مثال على الاستخدام: 
ga('set', 'allowAdFeatures', false)

عنوان IP للقناع

اختياريّ.

وعند توفّر عنوان IP هذا، سيتم إخفاء عنوان IP للمرسِل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
anonymizeIp aip boolean بدون قفل لا ينطبق الكل
مثال على القيمة: true
مثال على الاستخدام: 
ga('set', 'anonymizeIp', true);

مصدر البيانات

اختياريّ.

يشير إلى مصدر بيانات النتيجة. سيتم ضبط مصدر البيانات للنتائج المُرسَلة من analytics.js على "الويب"، في حين سيتم ضبط مصدر البيانات على النتائج المُرسَلة من إحدى حِزم SDK للأجهزة الجوّالة على "التطبيق".

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
dataSource ds text بدون قفل بدون قفل الكل
مثال على القيمة: crm
مثال على الاستخدام: 
ga('set', 'dataSource', 'crm');

وقت قائمة المحتوى التالي

اختياريّ.

يُستخدَم لجمع النتائج بلا إنترنت / الكامنة. وتمثل القيمة دلتا الوقت (بالمللي ثانية) بين وقت حدوث النتيجة التي يتم الإبلاغ عنها ووقت إرسال النتيجة. يجب أن تكون القيمة أكبر من 0 أو مساوية له. قد تؤدي القيم التي تزيد عن أربع ساعات إلى عدم معالجة النتائج.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
queueTime qt عدد صحيح بدون قفل بدون قفل الكل
مثال على القيمة: 560
مثال على الاستخدام: 
ga('set', 'queueTime', 560);

فرض طبقة المقابس الآمنة

اختياريّ.

وبشكلٍ تلقائي، سيتم إرسال الإشارات المُرسَلة من صفحات https باستخدام https، في حين سيتم إرسال الإشارات المُرسَلة من صفحات http باستخدام http. سيؤدي ضبط forceSSL على "صحيح" إلى فرض إرسال جميع الإشارات باستخدام https أيضًا على صفحات http.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
forceSSL بدون قفل boolean false لا ينطبق الكل
مثال على القيمة: true
مثال على الاستخدام: 
ga('set', 'forceSSL', true);

وسائل النقل

اختياريّ.

يحدِّد هذا الإعداد آلية النقل التي سيتم إرسال النتائج بها. تكون الخيارات هي "منارة" أو "xhr" أو "image". ستحاول analytics.js بشكل تلقائي اكتشاف أفضل طريقة استنادًا إلى حجم النتيجة وإمكانات المتصفح. إذا حدّدت "منارة" وكان متصفّح المستخدم لا يتيح استخدام طريقة "navigator.sendBeacon"، سيتراجع إلى "image" أو "xhr" بناءً على حجم النتيجة.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
transport بدون قفل text none (automatically determined) بدون قفل الكل
مثال على القيمة: beacon
مثال على الاستخدام: 
ga('send', 'event', 'click', 'download-me', {transport: 'beacon'});

استخدام الإشارة

اختياريّ.

تم إيقاف هذا الخيار نهائيًا الآن. استخدِم "transport" بدلاً من ذلك. وعند ضبط ذلك على "صحيح"، سيتم توجيه العميل لاستخدام navigator.sendBeacon لإرسال النتيجة. وهذا مفيد في الحالات التي تريد فيها تتبُّع حدث قبل انتقال المستخدِم مباشرةً إلى موقعك الإلكتروني، بدون تأخير الانتقال. وإذا كان المتصفح لا يدعم navigator.sendBeacon، فسيتم إرسال النتيجة بشكل طبيعي.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
useBeacon بدون قفل boolean false لا ينطبق الكل
مثال على القيمة: true
مثال على الاستخدام: 
ga('send', 'event', 'click', 'download-me', {useBeacon: true});

مَعلمة الرابط

اختياريّ.

مَعلمة الرابط للقياس على جميع النطاقات

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
linkerParam بدون قفل text بدون قفل بدون قفل الكل
مثال على القيمة: _ga=1.231587807.1974034684.1435105198
مثال على الاستخدام: 
// Alerts the linker parameter for the default tracker.
ga(function(tracker) {
  alert(tracker.get('linkerParam'));
});

النقر على معاودة الاتصال

اختياريّ.

دالة سيتم استدعاؤها بعد معالجة نتيجة. تم تصميم معاودة الاتصال هذه ليتم طلبها دائمًا، إما مباشرةً بعد إرسال النتيجة بنجاح أو عند تحديد أنّه يتعذّر إرسال نتيجة أو تعذّر إرسالها. لا يتم تمرير أي وسيطات إلى الدالة عند استدعاءها. قد ترغب في تجنب استخدام HitcallBack لتنفيذ التعليمات البرمجية التي تعتبر أمرًا بالغ الأهمية لتطبيقك نظرًا لأنه ربما لا يتم استدعاؤه في حالات نادرة (على سبيل المثال، في حالة عدم استجابة الخادم أو تعذُّر تحميل analytics.js). وفي هذه الحالة، يمكنك تعيين مهلة لضمان التنفيذ.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
hitCallback بدون قفل الوظيفة بدون قفل بدون قفل الكل
مثال على الاستخدام: 
// 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...
}

المستخدِم

رقم تعريف المستخدم

اختياريّ.

يجب ملء هذا الحقل في حال عدم تحديد معرِّف العميل (cid) في الطلب. والهدف من ذلك أن يكون معرّفًا معروفًا للمستخدِم يقدّمه مالك الموقع الإلكتروني/المكتبة. ويجب ألّا تكون بحدّ ذاتها معلومات تحدِّد الهوية الشخصية. يجب عدم الاحتفاظ بالقيمة مطلقًا في ملفّات تعريف ارتباط "إحصاءات Google" أو مساحة تخزين أخرى من "إحصاءات Google".

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
userId uid text بدون قفل بدون قفل الكل
مثال على القيمة: 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 text بدون قفل بدون قفل الكل
مثال على القيمة: start
مثال على الاستخدام: 
// Starts a new session.
ga('send', 'pageview', {'sessionControl': 'start'});

مصادر الزيارات

مُحيل المستند

اختياريّ.

تُستخدَم لتحديد مصدر الإحالة الذي جلب الزيارات إلى الموقع الإلكتروني. تُستخدم هذه القيمة أيضًا لاحتساب مصدر الزيارات. تنسيق هذه القيمة هو عنوان URL. وتتم تهيئة هذا الحقل باستخدام أمر إنشاء، ولا يتم ضبطه إلا عندما يختلف اسم المضيف الحالي عن اسم المضيف المُحيل، ما لم يتم ضبط الحقل "alwaysSendReferrer" على "صحيح".

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
referrer dr text document.referrer 2048 بايت الكل
مثال على القيمة: http://example.com
مثال على الاستخدام: 
ga('set', 'referrer', 'http://example.com');

اسم الحملة

اختياريّ.

تحدِّد هذه السمة اسم الحملة.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
campaignName cn text بدون قفل 100 بايت الكل
مثال على القيمة: (direct)
مثال على الاستخدام: 
ga('set', 'campaignName', '(direct)');

مصدر الحملة

اختياريّ.

تحدِّد مصدر الحملة.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
campaignSource cs text بدون قفل 100 بايت الكل
مثال على القيمة: (direct)
مثال على الاستخدام: 
ga('set', 'campaignSource', '(direct)');

وسيط الحملة

اختياريّ.

تُحدِّد وسيط الحملة.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
campaignMedium cm text بدون قفل 50 بايت الكل
مثال على القيمة: organic
مثال على الاستخدام: 
ga('set', 'campaignMedium', 'organic');

الكلمة الرئيسية للحملة

اختياريّ.

تُحدِّد الكلمة الرئيسية للحملة.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
campaignKeyword ck text بدون قفل 500 بايت الكل
مثال على القيمة: Blue Shoes
مثال على الاستخدام: 
ga('set', 'campaignKeyword', 'Blue Shoes');

محتوى الحملة

اختياريّ.

تُحدِّد محتوى الحملة.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
campaignContent cc text بدون قفل 500 بايت الكل
مثال على القيمة: content
مثال على الاستخدام: 
ga('set', 'campaignContent', 'content');

Campaign ID

اختياريّ.

تُحدِّد رقم تعريف الحملة.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
campaignId ci text بدون قفل 100 بايت الكل
مثال على القيمة: ID
مثال على الاستخدام: 
ga('set', 'campaignId', 'ID');

معلومات النظام

درجة دقة الشاشة

اختياريّ.

تُستخدَم لتحديد درجة دقّة الشاشة. تتم تهيئة هذا الحقل باستخدام الأمر create.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
screenResolution sr text بدون قفل 20 بايت الكل
مثال على القيمة: 800x600
مثال على الاستخدام: 
ga('set', 'screenResolution', '800x600');

حجم إطار العرض

اختياريّ.

تحدّد المنطقة القابلة للعرض في المتصفّح أو الجهاز. تتم تهيئة هذا الحقل باستخدام الأمر create.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
viewportSize vp text بدون قفل 20 بايت الكل
مثال على القيمة: 123x456
مثال على الاستخدام: 
ga('set', 'viewportSize', '123x456');

ترميز المستندات

اختياريّ.

تحدّد مجموعة الأحرف المستخدَمة لترميز الصفحة أو المستند. تتم تهيئة هذا الحقل باستخدام الأمر create.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
encoding de text UTF-8 20 بايت الكل
مثال على القيمة: UTF-8
مثال على الاستخدام: 
ga('set', 'encoding', 'UTF-16');

ألوان الشاشة

اختياريّ.

تحدِّد هذه السياسة عمق لون الشاشة. تتم تهيئة هذا الحقل باستخدام الأمر create.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
screenColors sd text بدون قفل 20 بايت الكل
مثال على القيمة: 24-bits
مثال على الاستخدام: 
ga('set', 'screenColors', '8-bit');

لغة المستخدم

اختياريّ.

لتحديد اللغة. تتم تهيئة هذا الحقل باستخدام الأمر create.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
language ul text بدون قفل 20 بايت الكل
مثال على القيمة: en-us
مثال على الاستخدام: 
ga('set', 'language', 'en-us');

تم تفعيل Java

اختياريّ.

تحدِّد هذه السياسة ما إذا تم تفعيل Java. تتم تهيئة هذا الحقل باستخدام الأمر create.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
javaEnabled je boolean بدون قفل لا ينطبق الكل
مثال على القيمة: true
مثال على الاستخدام: 
ga('set', 'javaEnabled', true);

إصدار الفلاش

اختياريّ.

تحدِّد هذه السياسة إصدار الفلاش. تتم تهيئة هذا الحقل باستخدام الأمر create.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
flashVersion fl text بدون قفل 20 بايت الكل
مثال على القيمة: 10 1 r103
مثال على الاستخدام: 
ga('set', 'flashVersion', '10 1 r103');

تصدّي

نوع النتيجة

مطلوبة لجميع أنواع النتائج.

نوع النتيجة. يجب أن تكون إحدى القيم التالية: "مشاهدة الصفحة على الويب" أو "مشاهدة الشاشة" أو "الحدث" أو "المعاملة" أو "العنصر" أو "الشبكات الاجتماعية" أو "الاستثناء" أو "التوقيت".

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
hitType t text بدون قفل بدون قفل الكل
مثال على القيمة: pageview
مثال على الاستخدام: 
ga('send', {
  'hitType': 'pageview',
  'page': '/home'
});

نتيجة بلا تفاعل

اختياريّ.

لتحديد أن النتيجة تعتبر غير تفاعلية.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
nonInteraction ni boolean بدون قفل لا ينطبق الكل
مثال على القيمة: true
مثال على الاستخدام: 
ga('set', 'nonInteraction', true);

معلومات المحتوى

عنوان URL لموقع المستند

اختياريّ.

تُحدِّد عنوان URL الكامل للصفحة (باستثناء علامة الارتساء) للصفحة. تتم تهيئة هذا الحقل باستخدام الأمر create.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
location dl text بدون قفل 2048 بايت الكل
مثال على القيمة: http://foo.com/home?a=b
مثال على الاستخدام: 
ga('set', 'location', 'http://foo.com/home?a=b');

اسم مضيف المستند

اختياريّ.

تُحدِّد اسم المضيف الذي تمت استضافة المحتوى منه.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
hostname dh text بدون قفل 100 بايت الكل
مثال على القيمة: foo.com
مثال على الاستخدام: 
ga('set', 'hostname', 'foo.com');

مسار المستند

اختياريّ.

جزء المسار من عنوان URL للصفحة. يجب أن يبدأ بـ "/". بالنسبة إلى نتائج "مشاهدة الصفحة"، يجب تحديد إما &dl أو كليهما &dh و &dp حتى تكون النتيجة صالحة. يُستخدَم لتحديد مسارات الصفحات الافتراضية.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
page dp text بدون قفل 2048 بايت الكل
مثال على القيمة: /foo
مثال على الاستخدام: 
ga('set', 'page', '/foo');

عنوان المستند

اختياريّ.

تمثّل هذه السمة عنوان الصفحة أو المستند. يتم ضبط عنوان URL تلقائيًا على document.title.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
title dt text بدون قفل 1500 بايت الكل
مثال على القيمة: Settings
مثال على الاستخدام: 
ga('set', 'title', 'Settings');

اسم الشاشة

مطلوب لنوع نتيجة مشاهدة الشاشة.

هذه المَعلمة اختيارية في المواقع الإلكترونية ومطلوبة في المواقع الإلكترونية للأجهزة الجوّالة لنتائج مشاهدة الصفحة في التطبيق، حيث تُستخدَم في "اسم الشاشة" كنتيجة مشاهدة الصفحة في التطبيق. في المواقع الإلكترونية، سيتم ضبط هذا الإعداد تلقائيًا على عنوان URL الفريد للصفحة إما باستخدام المَعلمة &dl كما هي أو تجميعها من &dh و &dp.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
screenName cd text بدون قفل 2048 بايت مشاهدة صفحة
مثال على القيمة: High Scores
مثال على الاستخدام: 
ga('set', 'screenName', 'High Scores');

مجموعة المحتوى

اختياريّ.

يمكنك استخدام ما يصل إلى 5 مجموعات محتوى، لكل مجموعة منها فهرس مرتبط يتراوح بين 1 و5، بشكل شامل. يمكن أن تتضمن كل مجموعة محتوى ما يصل إلى 100 مجموعة محتوى. قيمة مجموعة المحتوى هي نص هرمي مفصول بعلامة '/. ستتم إزالة جميع الشرطات المائلة البادئة واللاحقة وسيتم تقليل أي شرطات مائلة متكررة إلى شرطة مائلة واحدة. على سبيل المثال، سيتم تحويل '/a//b/' إلى 'a/b'.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
contentGroup cg<groupIndex> text بدون قفل 100 بايت الكل
مثال على القيمة: news/sports
مثال على الاستخدام: 
ga('set', 'contentGroup5', '/news/sports');

رقم تعريف الرابط

اختياريّ.

رقم تعريف عنصر DOM الذي تم النقر عليه، ويُستخدم للتفريق بين روابط متعددة لعنوان URL نفسه في تقارير "الإحصاءات في الصفحة" عندما تكون ميزة "تحديد مصدر الرابط" مفعَّلة للموقع.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
linkid linkid text بدون قفل بدون قفل الكل
مثال على القيمة: nav_bar
مثال على الاستخدام: 
ga('set', '&linkid', 'html-element-id');

حملة التطبيقات

اسم التطبيق

اختياريّ.

تُحدِّد اسم التطبيق. هذا الحقل مطلوب لأي نتيجة تحتوي على بيانات ذات صلة بالتطبيق (مثل إصدار التطبيق أو رقم تعريف التطبيق أو رقم تعريف أداة تثبيت التطبيق). بالنسبة إلى النتائج المُرسَلة إلى المواقع الإلكترونية، يكون هذا الحقل اختياريًا.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
appName an text بدون قفل 100 بايت الكل
مثال على القيمة: My App
مثال على الاستخدام: 
ga('set', 'appName', 'My App');

رقم تعريف التطبيق

اختياريّ.

معرّف التطبيق.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
appId aid text بدون قفل 150 بايت الكل
مثال على القيمة: com.company.app
مثال على الاستخدام: 
ga('set', 'appId', 'com.company.app');

إصدار التطبيق

اختياريّ.

تُحدِّد إصدار التطبيق.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
appVersion av text بدون قفل 100 بايت الكل
مثال على القيمة: 1.2
مثال على الاستخدام: 
ga('set', 'appVersion', '1.2');

رقم تعريف أداة تثبيت التطبيق

اختياريّ.

معرّف أداة تثبيت التطبيق.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
appInstallerId aiid text بدون قفل 150 بايت الكل
مثال على القيمة: com.platform.vending
مثال على الاستخدام: 
ga('set', 'appInstallerId', 'com.platform.vending');

فعاليات

فئة الحدث

مطلوب لنوع نتيجة الحدث.

تُستخدَم لتحديد فئة الحدث. يجب ألا يكون الحقل فارغًا.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
eventCategory ec text بدون قفل 150 بايت حدث
مثال على القيمة: Category
مثال على الاستخدام: 
ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action'
});

إجراء الحدث

مطلوب لنوع نتيجة الحدث.

لتحديد إجراء الحدث. يجب ألا يكون الحقل فارغًا.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
eventAction ea text بدون قفل 500 بايت حدث
مثال على القيمة: Action
مثال على الاستخدام: 
ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action'
});

تصنيف الحدث

اختياريّ.

تُستخدَم لتحديد تصنيف الحدث.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
eventLabel el text بدون قفل 500 بايت حدث
مثال على القيمة: Label
مثال على الاستخدام: 
ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action',
  'eventLabel': 'Label'
});

قيمة الحدث

اختياريّ.

تُحدِّد قيمة الحدث. يجب أن تكون القيم غير سالبة.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
eventValue ev عدد صحيح بدون قفل بدون قفل حدث
مثال على القيمة: 55
مثال على الاستخدام: 
ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action',
  'eventValue': 55
});

التجارة الإلكترونية المحسَّنة

رمز التخزين التعريفي للمنتج

اختياريّ.

تمثّل هذه السمة رمز التخزين التعريفي للمنتج. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product) id pr<productIndex>id text بدون قفل 500 بايت الكل
مثال على القيمة: P12345
مثال على الاستخدام: 
ga('ec:addProduct', {'id': 'P12345'});

اسم المنتج

اختياريّ.

اسم المنتج يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product) name pr<productIndex>nm text بدون قفل 500 بايت الكل
مثال على القيمة: Android T-Shirt
مثال على الاستخدام: 
ga('ec:addProduct', {'name': 'Android T-Shirt'});

العلامة التجارية للمنتج

اختياريّ.

العلامة التجارية المرتبطة بالمنتج. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product) brand pr<productIndex>br text بدون قفل 500 بايت الكل
مثال على القيمة: Google
مثال على الاستخدام: 
ga('ec:addProduct', {'brand': 'Google'});

فئة المنتج

اختياريّ.

الفئة التي ينتمي إليها المنتج. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. يمكن أن تكون مَعلمة فئة المنتج هرمية. يمكنك استخدام / كمحدِّد لتحديد ما يصل إلى 5 مستويات من التسلسل الهرمي. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product) category pr<productIndex>ca text بدون قفل 500 بايت الكل
مثال على القيمة: Apparel
مثال على الاستخدام: 
ga('ec:addProduct', {'category': 'Apparel'});

خيار المنتج

اختياريّ.

خيار المنتج. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product) variant pr<productIndex>va text بدون قفل 500 بايت الكل
مثال على القيمة: Black
مثال على الاستخدام: 
ga('ec:addProduct', {'variant': 'Black'});

سعر المنتج

اختياريّ.

تمثّل هذه السمة سعر الوحدة للمنتج. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product) price pr<productIndex>pr currency بدون قفل بدون قفل الكل
مثال على القيمة: 29.20
مثال على الاستخدام: 
ga('ec:addProduct', {'price': '29.20'});

كمية المنتج

اختياريّ.

كمية المنتج يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product) quantity pr<productIndex>qt عدد صحيح بدون قفل بدون قفل الكل
مثال على القيمة: 2
مثال على الاستخدام: 
ga('ec:addProduct', {'quantity': 2});

رمز قسيمة المنتج

اختياريّ.

رمز القسيمة المرتبط بمنتج. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product) coupon pr<productIndex>cc text بدون قفل 500 بايت الكل
مثال على القيمة: SUMMER_SALE13
مثال على الاستخدام: 
ga('ec:addProduct', {'coupon': 'SUMMER_SALE13'});

موضع المنتج

اختياريّ.

موضع المنتج في قائمة أو مجموعة. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product) position pr<productIndex>ps عدد صحيح بدون قفل بدون قفل الكل
مثال على القيمة: 2
مثال على الاستخدام: 
ga('ec:addProduct', {'position': 2});

السمة المخصّصة للمنتج

اختياريّ.

سمة مخصّصة على مستوى المنتج يكون فيها فهرس السمات عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product) dimension pr<productIndex>cd<dimensionIndex> text بدون قفل 150 بايت الكل
مثال على القيمة: Member
مثال على الاستخدام: 
ga('ec:addProduct', {'dimension1': 'Member'});

المقياس المخصّص للمنتج

اختياريّ.

مقياس مخصّص على مستوى المنتج يكون فيه مؤشر المقياس عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product) metric pr<productIndex>cm<metricIndex> عدد صحيح بدون قفل بدون قفل الكل
مثال على القيمة: 28
مثال على الاستخدام: 
ga('ec:addProduct', {'metric1': 28});

إجراء المنتج

اختياريّ.

دور المنتجات المضمّنة في النتيجة في حال عدم تحديد إجراء للمنتج، سيتم تجاهل جميع تعريفات المنتجات المضمّنة في النتيجة. يجب أن تكون إحدى السمات التالية: التفاصيل، أو النقر، أو الإضافة، أو الإزالة، أو الدفع، أو الدفع مقابل الاستخدام، أو الشراء، أو ردّ الأموال. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product action) pa text بدون قفل بدون قفل الكل
مثال على القيمة: detail
مثال على الاستخدام: 
ga('ec:setAction', 'detail');

معرِّف المعاملة

اختياريّ.

معرِّف المعاملة. هذه مَعلمة إضافية يمكن إرسالها عند ضبط Product Action على "شراء" أو "ردّ أموال". بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product action) id ti text بدون قفل بدون قفل الكل
مثال على القيمة: T1234
مثال على الاستخدام: 
ga('ec:setAction', 'purchase', {'id': 'T1234'});

الشركة التابعة

اختياريّ.

المتجر أو الارتباط الذي حدثت منه هذه المعاملة. هذه مَعلمة إضافية يمكن إرسالها عند ضبط Product Action على "شراء" أو "ردّ أموال". بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product action) affiliation ta text بدون قفل بدون قفل الكل
مثال على القيمة: Google Store
مثال على الاستخدام: 
ga('ec:setAction', 'purchase', {'affiliation': 'Google Store'});

الأرباح

اختياريّ.

إجمالي قيمة المعاملة، شاملاً الضريبة والشحن. وفي حال عدم إرسال هذه القيمة، سيتم احتساب هذه القيمة تلقائيًا باستخدام حقلَي كمية المنتجات وأسعارها لكلّ المنتجات في النتيجة نفسها. هذه مَعلمة إضافية يمكن إرسالها عند ضبط Product Action على "شراء" أو "ردّ أموال". بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product action) revenue tr currency بدون قفل بدون قفل الكل
مثال على القيمة: 123.21
مثال على الاستخدام: 
ga('ec:setAction', 'purchase', {'revenue': '123.21'});

الضريبة

اختياريّ.

إجمالي الضريبة المرتبطة بالمعاملة. هذه مَعلمة إضافية يمكن إرسالها عند ضبط Product Action على "شراء" أو "ردّ أموال". بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product action) tax tt currency بدون قفل بدون قفل الكل
مثال على القيمة: 10.78
مثال على الاستخدام: 
ga('ec:setAction', 'purchase', {'tax': '10.78'});

الشحن

اختياريّ.

تكلفة الشحن المرتبطة بالمعاملة. هذه مَعلمة إضافية يمكن إرسالها عند ضبط Product Action على "شراء" أو "ردّ أموال". بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product action) shipping ts currency بدون قفل بدون قفل الكل
مثال على القيمة: 3.55
مثال على الاستخدام: 
ga('ec:setAction', 'purchase', {'shipping': '3.55'});

رمز القسيمة

اختياريّ.

قسيمة المعاملة التي تم تحصيل قيمتها مع المعاملة. هذه مَعلمة إضافية يمكن إرسالها عند ضبط Product Action على "شراء" أو "ردّ أموال". بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product action) coupon tcc text بدون قفل بدون قفل الكل
مثال على القيمة: SUMMER08
مثال على الاستخدام: 
ga('ec:setAction', 'purchase', {'coupon': 'SUMMER08'});

قائمة الإجراءات المتعلقة بالمنتج

اختياريّ.

القائمة أو المجموعة التي حدث منها إجراء منتج. هذه مَعلمة إضافية يمكن إرسالها عند ضبط "Product Action" على "detail" أو "click". بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product action) list pal text بدون قفل بدون قفل الكل
مثال على القيمة: Search Results
مثال على الاستخدام: 
ga('ec:setAction', 'click', {'list': 'Search Results'});

خطوة الدفع

اختياريّ.

رقم الخطوة في مسار الدفع. هذه مَعلمة إضافية يمكن إرسالها عند ضبط Product Action على "الدفع". بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product action) step cos عدد صحيح بدون قفل بدون قفل الكل
مثال على القيمة: 2
مثال على الاستخدام: 
ga('ec:setAction', 'checkout', {'step': 2});

خيار خطوة الدفع

اختياريّ.

معلومات إضافية حول خطوة الدفع هذه مَعلمة إضافية يمكن إرسالها عند ضبط Product Action على "الدفع". بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(product action) option col text بدون قفل بدون قفل الكل
مثال على القيمة: Visa
مثال على الاستخدام: 
ga('ec:setAction', 'checkout', {'option': 'Visa'});

اسم قائمة مرات ظهور المنتج

اختياريّ.

القائمة أو المجموعة التي ينتمي إليها المنتج. يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(impression) list il<listIndex>nm text بدون قفل بدون قفل الكل
مثال على القيمة: Search Results
مثال على الاستخدام: 
ga('ec:addImpression', {'list': 'Search Results'});

رمز التخزين التعريفي لمرّات ظهور المنتج

اختياريّ.

معرِّف المنتج أو رمز التخزين التعريفي. يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(impression) id il<listIndex>pi<productIndex>id text بدون قفل بدون قفل الكل
مثال على القيمة: P67890
مثال على الاستخدام: 
ga('ec:addImpression', {'id': 'P67890'});

اسم ظهور المنتج

اختياريّ.

اسم المنتج يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(impression) name il<listIndex>pi<productIndex>nm text بدون قفل بدون قفل الكل
مثال على القيمة: Android T-Shirt
مثال على الاستخدام: 
ga('ec:addImpression', {'name': 'Android T-Shirt'});

العلامة التجارية لمرّات ظهور المنتج

اختياريّ.

العلامة التجارية المرتبطة بالمنتج. يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(impression) brand il<listIndex>pi<productIndex>br text بدون قفل بدون قفل الكل
مثال على القيمة: Google
مثال على الاستخدام: 
ga('ec:addImpression', {'brand': 'Google'});

فئة ظهور المنتج

اختياريّ.

الفئة التي ينتمي إليها المنتج. يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(impression) category il<listIndex>pi<productIndex>ca text بدون قفل بدون قفل الكل
مثال على القيمة: Apparel
مثال على الاستخدام: 
ga('ec:addImpression', {'category': 'Apparel'});

صيغة ظهور المنتج

اختياريّ.

خيار المنتج. يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(impression) variant il<listIndex>pi<productIndex>va text بدون قفل بدون قفل الكل
مثال على القيمة: Black
مثال على الاستخدام: 
ga('ec:addImpression', {'variant': 'Black'});

موضع ظهور المنتج

اختياريّ.

موضع المنتج في قائمة أو مجموعة. يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(impression) position il<listIndex>pi<productIndex>ps عدد صحيح بدون قفل بدون قفل الكل
مثال على القيمة: 2
مثال على الاستخدام: 
ga('ec:addImpression', {'position': 2});

سعر ظهور المنتج

اختياريّ.

سعر المنتج. يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(impression) price il<listIndex>pi<productIndex>pr currency بدون قفل بدون قفل الكل
مثال على القيمة: 29.20
مثال على الاستخدام: 
ga('ec:addImpression', {'price': '29.20'});

السمة المخصّصة لمرات ظهور المنتج

اختياريّ.

سمة مخصّصة على مستوى المنتج يكون فيها فهرس السمات عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(impression) dimension il<listIndex>pi<productIndex>cd<dimensionIndex> text بدون قفل بدون قفل الكل
مثال على القيمة: Member
مثال على الاستخدام: 
ga('ec:addImpression', {'dimension1': 'Member'});

المقياس المخصّص لمرات ظهور المنتج

اختياريّ.

مقياس مخصّص على مستوى المنتج يكون فيه مؤشر المقياس عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. يجب أن يكون فهرس قائمة مرات الظهور عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. يجب أن يكون فهرس المنتج عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(impression) metric il<listIndex>pi<productIndex>cm<metricIndex> عدد صحيح بدون قفل بدون قفل الكل
مثال على القيمة: 28
مثال على الاستخدام: 
ga('ec:addImpression', {'metric1': '28'});

معرّف العرض الترويجي

اختياريّ.

معرّف العرض الترويجي يجب أن يكون مؤشر العرض الترويجي عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(promo) id promo<promoIndex>id text بدون قفل بدون قفل الكل
مثال على القيمة: SHIP
مثال على الاستخدام: 
ga('ec:addPromo', {'id': 'SHIP'});

اسم العرض الترويجي

اختياريّ.

اسم الترويج. يجب أن يكون مؤشر العرض الترويجي عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(promo) name promo<promoIndex>nm text بدون قفل بدون قفل الكل
مثال على القيمة: Free Shipping
مثال على الاستخدام: 
ga('ec:addPromo', {'name': 'Free Shipping'});

تصميم الإعلان الترويجي

اختياريّ.

تصميم الإعلان المرتبط بالعرض الترويجي يجب أن يكون مؤشر العرض الترويجي عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(promo) creative promo<promoIndex>cr text بدون قفل بدون قفل الكل
مثال على القيمة: Shipping Banner
مثال على الاستخدام: 
ga('ec:addPromo', {'creative': 'Shipping Banner'});

موضع الإعلان الترويجي

اختياريّ.

موضع تصميم الإعلان. يجب أن يكون مؤشر العرض الترويجي عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل. بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(promo) position promo<promoIndex>ps text بدون قفل بدون قفل الكل
مثال على القيمة: banner_slot_1
مثال على الاستخدام: 
ga('ec:addPromo', {'position': 'banner_slot_1'});

إجراء الترويج

اختياريّ.

تُحدِّد دور الإعلانات الترويجية المضمّنة في النتيجة. في حال عدم تحديد إجراء ترويجي، يُفترض أنّ الإجراء الترويجي التلقائي هو "عرض". لقياس نقرة المستخدم على عرض ترويجي، اضبط هذا على "promo_click". بالنسبة إلى مقتطف analytics.js، يجب تثبيت المكوّن الإضافي للتجارة الإلكترونية المحسَّنة قبل استخدام هذا الحقل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
(promo) action promoa text بدون قفل بدون قفل الكل
مثال على القيمة: click
مثال على الاستخدام: 
ga('ec:setAction', 'promo_click'});

رمز العملة

اختياريّ.

عند توفّرها، يشير إلى العملة المحلية لجميع قيم عملة المعاملات. يجب أن تكون القيمة رمز عملة صالحًا وفقًا لمعيار ISO 4217.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
currencyCode cu text بدون قفل 10 بايت الكل
مثال على القيمة: EUR
مثال على الاستخدام: 
ga('set', 'currencyCode', 'EUR');

التفاعلات الاجتماعية

الشبكة الاجتماعية

مطلوبة لنوع النتيجة الاجتماعية.

لتحديد الشبكة الاجتماعية، على سبيل المثال Facebook أو Google Plus.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
socialNetwork sn text بدون قفل 50 بايت اجتماعي
مثال على القيمة: facebook
مثال على الاستخدام: 
ga('send', 'social', {
  'socialNetwork': 'facebook',
  'socialAction': 'like',
  'socialTarget': 'http://foo.com'
})

الإجراء الاجتماعي

مطلوبة لنوع النتيجة الاجتماعية.

لتحديد إجراء التفاعل الاجتماعي. على سبيل المثال في +Google عندما ينقر مستخدم على زر 1+، يكون الإجراء الاجتماعي هو "علامة زائد".

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
socialAction sa text بدون قفل 50 بايت اجتماعي
مثال على القيمة: like
مثال على الاستخدام: 
ga('send', 'social', {
  'socialNetwork': 'facebook',
  'socialAction': 'like',
  'socialTarget': 'http://foo.com'
})

استهداف الإجراءات الاجتماعية

مطلوبة لنوع النتيجة الاجتماعية.

تحدد الهدف من التفاعل الاجتماعي. وتكون هذه القيمة عادةً عنوان URL، ولكن يمكن أن تكون أي نص.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
socialTarget st text بدون قفل 2048 بايت اجتماعي
مثال على القيمة: http://foo.com
مثال على الاستخدام: 
ga('send', 'social', {
  'socialNetwork': 'facebook',
  'socialAction': 'like',
  'socialTarget': 'http://foo.com'
})

التوقيت

فئة توقيت المستخدم

مطلوبة لنوع نتيجة التوقيت.

تُحدِّد فئة توقيت المستخدِم.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
timingCategory utc text بدون قفل 150 بايت التوقيت
مثال على القيمة: category
مثال على الاستخدام: 
ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123
});

اسم متغيّر توقيت المستخدِم

مطلوبة لنوع نتيجة التوقيت.

تحدِّد هذه السمة متغيّر توقيت المستخدم.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
timingVar utv text بدون قفل 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 text بدون قفل 500 بايت التوقيت
مثال على القيمة: label
مثال على الاستخدام: 
ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123,
  'timingLabel': 'label'
});

الاستثناءات

وصف الاستثناء

اختياريّ.

تُستخدَم لتحديد وصف الاستثناء.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
exDescription exd text بدون قفل 150 بايت الاستثناء
مثال على القيمة: DatabaseError
مثال على الاستخدام: 
ga('send', 'exception', {
  'exDescription': 'DatabaseError'
});

هل الاستثناء خطير؟

اختياريّ.

لتحديد ما إذا كان الاستثناء خطيرًا.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
exFatal exf boolean 1 لا ينطبق الاستثناء
مثال على القيمة: true
مثال على الاستخدام: 
ga('send', 'exception', {
  'exFatal': true
});

المقاييس والسمات المخصّصة

السمة المخصّصة

اختياريّ.

لكل سمة مخصّصة فهرس مرتبط. هناك 20 سمة مخصّصة بحدٍ أقصى (200 سمة مخصّصة لحسابات "إحصاءات Google 360"). يجب أن يكون فهرس السمات عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
dimension cd<dimensionIndex> text بدون قفل 150 بايت الكل
مثال على القيمة: Sports
مثال على الاستخدام: 
ga('set', 'dimension14', 'Sports');

المقياس المخصّص

اختياريّ.

لكل مقياس مخصّص فهرس مرتبط. هناك 20 مقياسًا مخصّصًا بحدٍ أقصى (200 مقياس لحسابات "إحصاءات Google 360"). يجب أن يكون مؤشر المقياس عددًا صحيحًا موجبًا بين 1 و200، بشكل شامل.

اسم الحقل مَعلمة البروتوكول نوع القيمة القيمة التلقائية أقصى طول أنواع النتائج المتوافقة
metric cm<metricIndex> الرقم بدون قفل بدون قفل الكل
مثال على القيمة: 47
مثال على الاستخدام: 
ga('set', 'metric7', 47);