رابط

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

نظرة عامة

تعمل ميزة القياس على جميع النطاقات من خلال مشاركة رقم تعريف عميل فريد بين النطاق المصدر ونطاق الوجهة. هذه عملية مكونة من خطوتين:

  1. يحتاج النطاق المصدر إلى التأكد من احتواء جميع عناوين URL التي تشير إلى النطاق الوجهة على معرِّف العميل للنطاق المصدر.
  2. يجب أن يعرف النطاق الوجهة رقم تعريف العميل للتحقق من وجود معرّف عميل في عنوان URL بعد انتقال المستخدم إلى هناك.

يحقق المكوّن الإضافي للربط ذلك عن طريق إضافة معلمة linker إلى عناوين URL التي تشير إلى نطاق الوجهة. تحتوي مَعلمة linker على معرِّف العميل بالإضافة إلى الطابع الزمني الحالي والبيانات الوصفية للمتصفّح التي تم ترميزها فيها. يتم استخدام الطابع الزمني والبيانات الوصفية لتجنُّب المشاكل المتعلقة بمشاركة عنوان URL.

ستبدو معلمة الرابط على النحو التالي:

_ga=1.199239214.1624002396.1440697407

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

يسمح المكوّن الإضافي للرابط بالإضافة التلقائية واليدوية لمَعلمة الرابط إلى عناوين URL في الروابط والنماذج على الصفحة. في معظم الحالات، يُنصح باستخدام الطريقة التلقائية.

إضافة مَعلمات الربط تلقائيًا

لإعداد الربط التلقائي عبر النطاقات على النطاق المصدر لعناوين URL التي تشير إلى نطاق الوجهة، يجب require المكوّن الإضافي للرابط واستدعاء طريقة autoLink الخاصة به.

يمكن استدعاء الإجراء autoLink من قائمة انتظار الأوامر.

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

يجب تحديد المَعلمة decorateForms الاختيارية وضبطها على true إذا كان موقعك الإلكتروني يتضمّن نماذج تشير إلى نطاق الوجهة.

الاستخدام

ga('[trackerName.]linker:autoLink', domains, [useAnchor], [decorateForms]);

المَعلمات

الاسم Type مطلوبة الوصف
domains Array[RexExp|string] نعم مصفوفة من السلاسل أو التعبيرات العادية يجب مطابقتها مع hostname لعنوان URL للإشارة إلى النطاقات التي يجب تطبيق الربط التلقائي عليها. في حال تمرير سلسلة، سيجري analytics.js مطابقة سلسلة فرعية، ما يعني أنّ example.com سيطابق الروابط التي تشير إلى blog.example.com.
useAnchor boolean لا عند اختيار "true"، ستتم إضافة معلّمة الرابط إلى جزء الارتساء من عنوان URL بدلاً من جزء طلب البحث.
decorateForms boolean لا عند ضبط القيمة على "true"، سيضيف المكوّن الإضافي linker مَعلمة linker إلى عمليات إرسال النماذج التي تشير إلى الوجهات التي تتطابق مع مَعلمة domain.

مثال

// Loads the Linker plugin
ga('require', 'linker');

// Instructs the Linker plugin to automatically add linker parameters
// to all links and forms pointing to the domain "destination.com".
ga('linker:autoLink', ['destination.com'], false, true);

إضافة مَعلمات الربط يدويًا

يمكنك إضافة مَعلمة الرابط يدويًا إلى عنصر <a> أو <form> محدّد باستخدام الطريقة decorate. تكون هذه الطريقة مطلوبة فقط عند عدم استخدام طريقة autoLink الموضّحة أعلاه.

decorate

يمكن استدعاء الإجراء decorate من قائمة انتظار الأوامر.

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

الاستخدام

ga('[trackerName.]linker:decorate', element, [useAnchor]);

المَعلمات

الاسم Type مطلوبة الوصف
element HTMLElement نعم العنصر <a> أو <form> لإلحاق معلّمة الرابط بها
useAnchor boolean لا عند اختيار "true"، ستتم إضافة معلّمة الرابط إلى جزء الارتساء من عنوان URL بدلاً من جزء طلب البحث.

مثال

// Loads the Linker plugin
ga('require', 'linker');

// Gets a reference to a link pointing to an external domain.
var destinationLink = document.getElementById('destination-link');

// Adds click handler that decorates `destinationLink`.
destinationLink.addEventListener('click', function() {
  ga('linker:decorate', destinationLink);
});

linkerParam

بالإضافة إلى طريقة decorate، يمكنك يدويًا الحصول على مَعلمة الرابط التي ستستخدمها أداة التتبُّع من خلال الحقل linkerParam.

ga(function(tracker) {
  var linkerParam = tracker.get('linkerParam');
});

إعداد موقع إلكتروني لقبول مَعلمات الربط

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

يمكنك توجيه الصفحة المقصودة للبحث عن مَعلمات الرابط من خلال ضبط الحقل allowLinker على true عند إنشاء أداة التتبُّع:

ga('create', 'UA-XXXXXX-X', 'auto', {
  allowLinker: true
});

القياس الثنائي الاتجاه على جميع النطاقات

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

وفي الحالات التي لا يكون معروفًا فيها تحديد النطاق الذي سيزوره المستخدمون أولاً، عليك تنفيذ ميزة القياس الثنائي الاتجاه على جميع النطاقات، حيث يتم إعداد كل نطاق ليعمل كمصدر أو وجهة.

لتنفيذ القياس الثنائي الاتجاه على جميع النطاقات، عليك تفعيل الربط التلقائي على كلا النطاقَين وإعدادهما لقبول مَعلمات الرابط.

في source.com:

ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['destination.com']);

في destination.com:

ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com']);

استخدام مقتطف واحد في جميع النطاقات

لتبسيط ذلك أكثر، يمكنك إدراج جميع النطاقات المحتملة التي تريد قياسها باستخدام طريقة autoLink، ما يسمح لك باستخدام مقتطف الرمز نفسه على كل نطاق:

ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com', 'destination.com']);