سيتم إيقاف Universal Analytics (UA) في 1 تموز (يوليو) 2023، ما يعني أنه سيتوقف عن معالجة البيانات. ستتوقف مواقع "إحصاءات Google 360" عن العمل في 1 تشرين الأول (أكتوبر) 2023. نقل البيانات إلى "إحصاءات Google" 4.

مرجع حقل Analytics.js

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

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

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

لا يمكن ضبط الحقول التالية إلا في طريقة 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);