کد رهگیری: دامنه ها و دایرکتوری ها

ga.js یک کتابخانه قدیمی است. اگر پیاده‌سازی جدیدی را شروع می‌کنید، توصیه می‌کنیم از آخرین نسخه این کتابخانه، analytics.js استفاده کنید. برای پیاده سازی های موجود، نحوه مهاجرت از ga.js به analytics.js را بیاموزید.

این مرجع روش‌هایی را توضیح می‌دهد که شما برای سفارشی‌سازی نحوه عملکرد گزارش‌دهی Google Analytics در دامنه‌ها، در میزبان‌های مختلف یا در زیر شاخه‌های یک وب‌سایت استفاده می‌کنید.

روش‌های دامنه/دایرکتوری GATC

• _cookiePathCopy (newPath)
• _getLinkerUrl (targetUrl, useHash)
• _link (targetUrl, useHash)
• _linkByPost (formObject, useHash)
• _setAllowHash (bool) منسوخ شد
• _setAllowLinker (bool)
• _setCookiePath (newCookiePath)
• _setDomainName (newDomainName)
• _storeGac (bool)

جزئیات روش

_cookiePathCopy()

_cookiePathCopy(newPath)

مسیرهای همه کوکی‌های GATC را به مسیر جدید مشخص شده تغییر می‌دهد. از این ویژگی برای ردیابی رفتار کاربر از یک ساختار دایرکتوری به دیگری در همان دامنه استفاده کنید.

هنگامی که این تابع فراخوانی می شود، بلافاصله هر کوکی را در مسیر کوکی جدید کپی می کند. بنابراین، اگر متد _trackPageview() فراخوانی نشده باشد، مقادیر کوکی‌های موجود Analytics ارائه می‌شوند. به همین دلیل، توصیه می‌کنیم که این روش پس از _trackPageview() و همچنین سایر روش‌های پیکربندی که ممکن است بر مقادیر کوکی یا مقادیر کمپینی که می‌خواهید ارسال کنید، مانند _setCampaignCookieTimeout() یا _setReferrerOverride() تاثیر بگذارد.

Async Snippet (توصیه می شود)

_gaq.push(['_cookiePathCopy', '/newSubDirectory/']);

قطعه سنتی (ga.js).

var pageTracker = _gat._getTracker("UA-12345-1");
    pageTracker._trackPageview();
    pageTracker._cookiePathCopy("/newSubDirectory/");

مولفه های

String newPath مسیر جدید برای ذخیره کوکی‌های GATC در زیر.

---

_getLinkerUrl()

_getLinkerUrl(targetUrl, useHash)

این روش در ارتباط با متدهای _setDomainName() و _setAllowLinker() کار می کند تا ردیابی کاربران بین دامنه ای را به طور خاص برای iFrames و پیوندهایی که در یک پنجره جدید باز می شوند، فعال کند. این روش یک رشته از تمام داده‌های کوکی GATC را از پیوند آغازگر با الحاق آن به پارامتر URL برمی‌گرداند. سپس این می تواند به یک سایت دیگر یا iFrame منتقل شود.

Async Snippet (توصیه می شود)

  _gaq.push(function() {
    var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
    var linkerUrl = pageTracker._getLinkerUrl('http://www.my-example-iframecontent.com/');
  });

قطعه سنتی (ga.js).

pageTracker._getLinkerUrl("http://www.my-example-iframecontent.com/");

همچنین باید پیوند را در سایت هدف فعال کنید ( pageTracker._setAllowLinker(true); ) تا پیوند به درستی کار کند.

مولفه های

URL String targetUrl سایت مورد نظر برای ارسال مقادیر کوکی به آن.

Boolean useHash برای ارسال متغیرهای کد رهگیری با استفاده از # جداکننده تگ anchor به جای پیش فرض، روی true تنظیم شود؟ جداکننده رشته پرس و جو

برمی گرداند

String URL پیوند دهنده.

---

_ارتباط دادن()

_link(targetUrl, useHash)

این روش به همراه متدهای _setDomainName() و _setAllowLinker() کار می کند تا ردیابی کاربر بین دامنه ای را فعال کند. متد _link() کوکی‌های GATC را از طریق پارامترهای URL (HTTP GET) از این سایت به سایت دیگر ارسال می‌کند. همچنین document.location را تغییر می دهد و کاربر را به URL جدید هدایت می کند.

Async Snippet (توصیه می شود)

<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

قطعه سنتی (ga.js).

<a href="http://www.newsite.com" onclick="pageTracker._link('http://www.newsite.com');return false;">Go to our sister site</a>

همچنین باید پیوند را در سایت هدف فعال کنید ( pageTracker._setAllowLinker(true); ) تا پیوند به درستی کار کند.

مولفه های

URL String targetUrl سایت مورد نظر برای ارسال مقادیر کوکی به آن.

Boolean useHash برای ارسال متغیرهای کد رهگیری با استفاده از # جداکننده تگ anchor به جای پیش فرض، روی true تنظیم شود؟ جداکننده رشته پرس و جو

---

_linkByPost()

_linkByPost(formObject, useHash)

این روش به همراه متدهای _setDomainName() و _setAllowLinker() کار می کند تا ردیابی کاربر بین دامنه ای را فعال کند. متد _linkByPost() کوکی‌های GATC را از فرم ارجاع‌دهنده به سایت دیگری در رشته‌ای که به مقدار عمل فرم (HTTP POST) اضافه شده است، ارسال می‌کند. این روش معمولاً هنگام ردیابی رفتار کاربر از یک سایت به یک سایت سبد خرید شخص ثالث استفاده می شود، اما همچنین می تواند برای ارسال داده های کوکی به دامنه های دیگر در پنجره های بازشو یا iFrames استفاده شود.

Async Snippet (توصیه می شود)

    <form action="http://www.shoppingcartsite.com/myService/formProcessor.php"
    name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>
  

قطعه سنتی (ga.js).

<form action="http://www.shoppingcartsite.com/myService/formProcessor.php"
        name="f" method="post" onsubmit="pageTracker._linkByPost(this)">
        . . .
        </form>

به علاوه، _setAllowLinker() باید در صفحه وب مقصد روی true تنظیم شود تا پیوند کار کند.

مولفه های

شی HTMLFormElement formObject Form که درخواست POST را محصور می کند.

Boolean useHash برای ارسال متغیرهای کد رهگیری با استفاده از # جداکننده تگ anchor به جای پیش فرض، روی true تنظیم شود؟ جداکننده رشته پرس و جو

---

_setAllowHash()

_setAllowHash(bool)

این روش منسوخ شده است و دیگر برای ردیابی بین دامنه‌ای مورد نیاز نیست.

پرچم هش دامنه مجاز را تنظیم می کند. به طور پیش فرض، این مقدار روی true تنظیم شده است. عملکرد هش دامنه در Google Analytics یک مقدار هش از دامنه شما ایجاد می کند و از این عدد برای بررسی یکپارچگی کوکی برای بازدیدکنندگان استفاده می کند. اگر چندین زیر دامنه دارید، مانند example1.example.com و example2.example.com ، و می خواهید رفتار کاربر را در هر دوی این زیر دامنه ها ردیابی کنید، هش دامنه را خاموش کنید تا بررسی یکپارچگی کوکی انجام شود. کوکی کاربر که از دامنه ای به دامنه دیگر می آید را رد نکنید. علاوه بر این، برای بهینه سازی عملکرد ردیابی هر صفحه، می توانید این ویژگی را خاموش کنید.

مولفه های

Boolean true یا false بولی مقدار پیش فرض true است. اگر این پارامتر روی true تنظیم شود، هش دامنه فعال می شود. در غیر این صورت، هش دامنه غیرفعال است.

---

_setAllowLinker()

_setAllowLinker(bool)

پرچم عملکرد پیوند دهنده را به عنوان بخشی از فعال کردن ردیابی کاربر بین دامنه ای تنظیم می کند. به طور پیش فرض، این روش روی false تنظیم شده و پیوند غیرفعال است. همچنین به روش های _link() ، _linkByPost() و _setDomainName() مراجعه کنید تا ردیابی بین دامنه را فعال کنید. از روش _setAllowLinker در سایت مورد نظر استفاده کنید، به طوری که سایت هدف به جای منطق جلسه استاندارد، از داده های کوکی در پارامتر URL استفاده کند.

Async Snippet (توصیه می شود)

_gaq.push(['_setAllowLinker', true]); 

قطعه سنتی (ga.js).

pageTracker._setAllowLinker(true);

مولفه های

Boolean true یا false بولی مقدار پیش فرض false است. اگر این پارامتر روی true تنظیم شود، پیوند دهنده فعال می شود. در غیر این صورت پیوند دامنه غیرفعال است.

---

_setCookiePath()

_setCookiePath(newCookiePath)

مسیر کوکی جدید را برای سایت شما تنظیم می کند. به طور پیش فرض، Google Analytics مسیر کوکی را روی سطح ریشه (/) قرار می دهد. در اکثر مواقع، این گزینه مناسب است و با کد رهگیری که در وب سایت، وبلاگ یا فهرست وب شرکت خود نصب می کنید، به درستی کار می کند. با این حال، در موارد معدودی که دسترسی کاربر فقط به یک زیر شاخه از یک دامنه محدود می شود، این روش می تواند مشکلات ردیابی را با تنظیم یک زیر شاخه به عنوان مسیر پیش فرض برای همه ردیابی ها حل کند.

به طور معمول، اگر داده‌های شما ردیابی نمی‌شوند و در یک سرویس وبلاگ مشترک شده‌اید و فقط به فهرست فرعی تعریف‌شده خود دسترسی دارید، یا اگر در یک شبکه شرکتی یا دانشگاهی هستید و فقط به فهرست اصلی خود دسترسی دارید، از این استفاده می‌کنید.

احتیاط : تغییر مسیر کوکی از یک مقدار به مقدار دیگر می‌تواند منجر به داده‌های تحلیلی نادرست شود. بنابراین توصیه می شود پس از استفاده از یک مقدار خاص از تغییر مسیر کوکی خودداری کنید.

Async Snippet (توصیه می شود)

_gaq.push(['_setCookiePath', '/myBlogDirectory']); 

قطعه سنتی (ga.js).

pageTracker._setCookiePath("/myBlogDirectory");

مولفه های

String newCookiePath مسیر کوکی جدید برای تنظیم.

---

_setDomainName()

_setDomainName(newDomainName)

نام دامنه را برای کوکی های GATC تنظیم می کند. سه حالت برای این روش وجود دارد: ("auto" | "none" | [domain]) . به‌طور پیش‌فرض، روش روی auto تنظیم شده است، که تلاش می‌کند نام دامنه را بر اساس ویژگی document.domain در DOM حل کند.

تعیین یک دامنه

برای مثال‌های مختلف به راهنمای ردیابی دامنه‌های متقابل مراجعه کنید که نشان می‌دهد چه زمانی و چگونه یک دامنه را با این روش مشخص کنید. مثال زیر نشان می دهد که چگونه نام دامنه را روی example.com تنظیم کنید:

Async Snippet (توصیه می شود)

_gaq.push(['_setDomainName', 'example.com']); 

قطعه سنتی (ga.js).

pageTracker._setDomainName("example.com");

توجه : استفاده از یک نقطه پیشرو هنگام تنظیم دامنه نیز کار خواهد کرد. آنچه مهم است این است که _setDomainName به طور یکسان در تمام دامنه هایی که در پیوند دامنه شرکت می کنند پیکربندی شده است. این تضمین می‌کند که کوکی‌ها برای همه سایت‌های شرکت‌کننده در دسترس هستند، بنابراین از خطاها و ناهماهنگی‌ها در داده‌های گزارش جلوگیری می‌شود.

جداسازی دامنه های سطح بالا

تنظیم این روش بر روی none تضمین می کند که کوکی ها در یک دامنه معین توسط هیچ زیردامنه قابل دسترسی نیستند.

Async Snippet (توصیه می شود)

_gaq.push(['_setDomainName', 'none']); 

قطعه سنتی (ga.js).

pageTracker._setDomainName("none");

مولفه های

String newDomainName نام دامنه پیش‌فرض جدید برای تنظیم.

---

_storeGac(bool)

تعیین می کند که آیا کوکی GAC باید ایجاد شود یا خیر. به طور پیش فرض، کوکی GAC توسط اسکریپت نوشته می شود و برای نوشتن کوکی نیازی به انجام کاری ندارید. با استفاده از دستور زیر می توانید تنظیمات این کوکی را غیرفعال کنید.

Async Snippet (توصیه می شود)

_gaq.push(['_storeGac', false]);

قطعه سنتی

pageTracker._storeGac(false);

---