رمز التتبّع: النطاقات والأدلة

ويوضّح هذا المرجع الطرق التي تستخدمها لتخصيص طريقة عمل تقارير "إحصاءات Google" على مستوى النطاقات أو على مستوى المضيفين المختلفين أو ضمن الأدلة الفرعية لموقع إلكتروني.

طرق الدليل/النطاق في GATC

تفاصيل الطريقة

_cookiePathCopy()

_cookiePathCopy(newPath)

يغيّر مسارات جميع ملفات تعريف ارتباط "إحصاءات Google" GA إلى المسار المحدّد حديثًا. استخدِم هذه الميزة لتتبُّع سلوك المستخدم من بنية دليل إلى أخرى على النطاق نفسه.

وعند استدعاء هذه الدالة، يتم نسخ أي ملفات تعريف ارتباط على الفور إلى مسار ملف تعريف الارتباط الجديد. وبالتالي، إذا لم يتم استدعاء الطريقة _trackPageview()، سيتم توفير قيم أي ملفات تعريف ارتباط "إحصاءات Google" حالية. ولهذا ، ننصح باستدعاء هذه الطريقة بعد _trackPageview() بالإضافة إلى طرق الإعداد الأخرى التي قد تؤثر في قيم ملفات تعريف الارتباط أو قيم الحملات التي تريد تمريرها، مثل _setCampaignCookieTimeout() أو _setReferrerOverride().

مقتطف غير متزامن (مقترَح)
_gaq.push(['_cookiePathCopy', '/newSubDirectory/']);

المَعلَمات

String   newPath مسار جديد لتخزين ملفات تعريف الارتباط في GATC ضمنها.

_getLinkerUrl()

_getLinkerUrl(targetUrl, useHash)

تعمل هذه الطريقة مع طريقتَي _setDomainName() و_setAllowLinker() لتفعيل ميزة تتبُّع المستخدم من خلال النطاقات، وذلك خصيصًا لإطارات iframe والروابط التي يتم فتحها في نافذة جديدة. تعرض هذه الطريقة سلسلة من جميع بيانات ملف تعريف ارتباط GATC من رابط البدء عن طريق إرفاقها بمعلّمة عنوان URL. ويمكن بعد ذلك تمرير ذلك إلى موقع أو إطار iFrame آخر.

مقتطف غير متزامن (مقترَح)
  _gaq.push(function() {
    var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
    var linkerUrl = pageTracker._getLinkerUrl('http://www.my-example-iframecontent.com/');
  });

المَعلَمات

String   targetUrl عنوان URL للموقع الإلكتروني المستهدف لإرسال قيم ملفات تعريف الارتباط إليه.

Boolean   useHash يمكنك ضبط السياسة على "صحيح" لتمرير متغيّرات رمز التتبّع باستخدام فاصل علامة الارتساء # بدلاً من العلامة التلقائية. فاصل سلسلة طلب البحث.

returns

String عنوان URL للرابط

_link(targetUrl, useHash)

تعمل هذه الطريقة مع طريقتَي _setDomainName() و_setAllowLinker() لتفعيل ميزة تتبّع المستخدمين في جميع النطاقات. تمرِّر الطريقة _link() ملفات تعريف ارتباط "إحصاءات Google" (GATC) من هذا الموقع الإلكتروني إلى موقع إلكتروني آخر عبر معلَمات عناوين URL (HTTP GET). وتؤدي أيضًا هذه السياسة إلى تغيير document.location وإعادة توجيه المستخدم إلى عنوان URL الجديد.

مقتطف غير متزامن (مقترَح)
<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

المَعلَمات

String   targetUrl عنوان URL للموقع الإلكتروني المستهدف لإرسال قيم ملفات تعريف الارتباط إليه.

Boolean   useHash يمكنك ضبط السياسة على "صحيح" لتمرير متغيّرات رمز التتبّع باستخدام فاصل علامة الارتساء # بدلاً من العلامة التلقائية. فاصل سلسلة طلب البحث.


_linkByPost()

_linkByPost(formObject, useHash)

تعمل هذه الطريقة مع طريقتَي _setDomainName() و_setAllowLinker() لتفعيل ميزة تتبّع المستخدمين عبر النطاقات. تمرِّر الطريقة _linkByPost() ملفات تعريف ارتباط "إحصاءات Google" من نموذج الإحالة إلى موقع إلكتروني آخر في سلسلة ملحقة بقيمة الإجراء الخاصة بالنموذج (HTTP POST). ويتم عادةً استخدام هذه الطريقة عند تتبّع سلوك المستخدم من أحد المواقع الإلكترونية إلى سلة تسوّق خارجية، ولكن يمكن استخدامها أيضًا لإرسال بيانات ملفات تعريف الارتباط إلى نطاقات أخرى في النوافذ المنبثقة أو في إطارات iframe.

مقتطف غير متزامن (مقترَح)
    <form action="http://www.shoppingcartsite.com/myService/formProcessor.php"
    name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>

بالإضافة إلى ذلك، يجب ضبط _setAllowLinker() على true في صفحة الويب المقصودة حتى يعمل الربط.

المَعلَمات

HTMLFormElement   formObject كائن النموذج الذي يتضمّن طلب POST.

Boolean   useHash يمكنك ضبط السياسة على"صحيح"لتمرير متغيّرات رمز التتبّع باستخدام فاصل علامة الارتساء # بدلاً من العلامة التلقائية. فاصل سلسلة طلب البحث.


_setAllowHash()

_setAllowHash(bool)

تُحدّد علامة السماح بتجزئة النطاق. وتكون هذه القيمة مضبوطة تلقائيًا على true. توفّر وظيفة تجزئة النطاق في "إحصاءات Google" قيمة تجزئة من نطاقك، وتستخدم هذا الرقم للتحقّق من سلامة ملفات تعريف الارتباط للزوّار. إذا كانت لديك عدة نطاقات فرعية، مثل example1.example.com وexample2.example.com، وكنت تريد تتبُّع سلوك المستخدمين على مستوى هذين النطاقَين الفرعيَين، عليك إيقاف تجزئة النطاق حتى لا ترفض عملية التحقّق من صحة ملفات تعريف الارتباط رفض ملف تعريف ارتباط المستخدم من نطاق آخر. إضافةً إلى ذلك، يمكنك إيقاف هذه الميزة لتحسين أداء التتبُّع لكل صفحة.

المَعلَمات

Boolean   true أو false القيمة التلقائية هي true. وفي حال ضبط هذه المعلَمة على true، سيتم تفعيل تجزئة النطاق. وبخلاف ذلك، سيتم إيقاف تجزئة النطاق.

_setAllowLinker()

_setAllowLinker(bool)

تُحدِّد علامة وظيفة الرابط كجزء من تفعيل تتبُّع المستخدم عبر النطاقات. ويتم ضبط هذه الطريقة تلقائيًا على false ويتم إيقاف الربط. راجِع أيضًا _link() و_linkByPost() و_setDomainName() الطرق لتفعيل التتبُّع عبر النطاقات. استخدِم الطريقة _setAllowLinker على الموقع الإلكتروني المستهدف، بحيث يستخدم الموقع الإلكتروني المستهدف بيانات ملفات تعريف الارتباط في معلّمة عنوان URL، بدلاً من منطق الجلسة العادية.

مقتطف غير متزامن (مقترَح)
_gaq.push(['_setAllowLinker', true]); 

المَعلَمات

Boolean  true أو القيمة التلقائية false هي false. وفي حال ضبط هذه المَعلمة على true، يتم تفعيل ميزة"الرابط". وإلا، سيتم إيقاف ربط النطاق.

_setCookiePath()

_setCookiePath(newCookiePath)

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

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

مقتطف غير متزامن (مقترَح)
_gaq.push(['_setCookiePath', '/myBlogDirectory']); 

المَعلَمات

String   newCookiePath مسار ملفات تعريف الارتباط الجديد المطلوب إعداده.

_setDomainName()

_setDomainName(newDomainName)

ضبط اسم النطاق لملفات تعريف ارتباط "إحصاءات Google" (GATC). هناك ثلاثة أوضاع لهذه الطريقة: ("auto" | "none" | [domain]). يتم تلقائيًا ضبط الطريقة على auto، ما يحاول حل اسم النطاق استنادًا إلى السمة document.domain في DOM.

تحديد نطاق

اطّلِع على دليل التتبُّع عبر النطاقات للاطّلاع على مجموعة متنوعة من الأمثلة التي توضّح وقت تحديد نطاق بهذه الطريقة وكيفية تحديده. يوضّح المثال التالي كيفية ضبط اسم النطاق على example.com:

مقتطف غير متزامن (مقترَح)
_gaq.push(['_setDomainName', 'example.com']); 

عزل نطاقات المستوى الأعلى

يضمن ضبط هذه الطريقة على none عدم إمكانية وصول أي نطاقات فرعية إلى ملفات تعريف الارتباط في نطاق معيّن.

مقتطف غير متزامن (مقترَح)
_gaq.push(['_setDomainName', 'none']); 

المَعلَمات

String   newDomainName اسم نطاق تلقائي جديد لضبطه.

_storeGac(bool)

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

مقتطف غير متزامن (مقترَح)
_gaq.push(['_storeGac', false]);