رابط

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

نظرة عامة

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

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

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

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

_ga=1.199239214.1624002396.1440697407

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

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

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

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

يمكن استدعاء الطريقة autoLink من خلال قائمة الأوامر.

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

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

الاستخدام

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

المَعلمات

الاسم النوع مطلوب الوصف
domains Array[RexExp|string] نعم مصفوفة من السلاسل أو التعبيرات العادية لمطابقتها مع hostname عنوان URL's للإشارة إلى النطاقات التي يجب أن تنطبق عليها ميزة الربط التلقائي. وفي حال تمرير سلسلة، ستُجري analytics.js مطابقة سلسلة فرعية، ما يعني أنّ example.com سيطابق الروابط التي تشير إلى blog.example.com.
useAnchor boolean لا عند القيمة "صحيح"، ستتم إضافة معلّمة الرابط إلى جزء الرابط من عنوان URL بدلاً من جزء طلب البحث.
decorateForms boolean لا عند ضبط هذا الإعداد، سيضيف المكوّن الإضافي لمعلّمة المعلّمة معلّمة رابط إلى نماذج الإرسال التي تشير إلى وجهات تتطابق مع المعلّمة 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]);

المَعلمات

الاسم النوع مطلوب الوصف
element HTMLElement نعم العنصر <a> أو <form> لإلحاق معلَمة الرابط به.
useAnchor boolean لا عند القيمة "صحيح"، ستتم إضافة معلّمة الرابط إلى جزء الرابط من عنوان 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']);