پیوند دهنده

پلاگین پیوند دهنده فرآیند اجرای اندازه گیری متقابل دامنه را همانطور که در راهنمای سنجش بین دامنه برای analytics.js توضیح داده شده است، ساده می کند.

بررسی اجمالی

اندازه گیری متقابل دامنه با به اشتراک گذاشتن شناسه مشتری منحصر به فرد بین دامنه مبدا و دامنه مقصد کار می کند. این یک فرآیند دو مرحله ای است:

  1. دامنه مبدأ باید اطمینان حاصل کند که همه URL هایی که به دامنه مقصد اشاره می کنند، دارای شناسه مشتری دامنه مبدا هستند.
  2. دامنه مقصد باید بداند که وجود شناسه مشتری در URL را هنگامی که کاربر در آنجا حرکت می کند، بررسی کند.

پلاگین لینکر این کار را با افزودن یک پارامتر پیوند دهنده به URL هایی که به دامنه مقصد اشاره می کنند انجام می دهد. پارامتر پیوند دهنده شامل شناسه مشتری و همچنین مُهر زمان فعلی و ابرداده مرورگر است که در آن کدگذاری شده است. از مهر زمانی و ابرداده برای جلوگیری از مشکلات اشتراک‌گذاری URL استفاده می‌شود.

پارامتر linker چیزی شبیه به این خواهد بود:

_ga=1.199239214.1624002396.1440697407

در دامنه مقصد، فیلد allowLinker ارائه شده است، که وقتی true به analytics.js دستور می دهد تا پارامترهای پیوند دهنده را در URL بررسی کند. اگر پارامتر لینکر پیدا شود و معتبر باشد، شناسه مشتری را از پارامتر استخراج کرده و ذخیره می کند.

افزونه Linker امکان افزودن خودکار و دستی پارامتر لینکر به URL ها را در لینک ها و فرم های موجود در صفحه فراهم می کند. در بیشتر موارد، روش خودکار توصیه می شود.

افزودن خودکار پارامترهای پیوند دهنده

برای راه‌اندازی پیوند خودکار متقابل دامنه در دامنه مبدا برای URLهایی که به دامنه مقصد اشاره می‌کنند، باید به افزونه پیوند دهنده نیاز داشته باشید و روش autoLink آن را فراخوانی کنید.

متد autoLink را می توان از طریق صف فرمان فراخوانی کرد.

پس از اجرا، analytics.js به کلیک‌های روی پیوندهایی که به دامنه مقصد (یا دامنه‌ها) اشاره می‌کنند گوش می‌دهد و پارامتر پیوند دهنده را بلافاصله قبل از شروع ناوبری به آن پیوندها اضافه می‌کند. منتظر ماندن تا زمانی که کاربر روی پیوندی برای افزودن پارامتر پیوند دهنده کلیک کند، ضروری است زیرا پارامترهای پیوند دهنده پس از دو دقیقه منقضی می شوند.

اگر فرم هایی در سایت خود دارید که به دامنه مقصد اشاره می کنند، پارامتر اختیاری decorateForms باید مشخص و روی true تنظیم شود.

استفاده

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

مولفه های

نام تایپ کنید ضروری شرح
domains Array[RexExp|string] آره آرایه‌ای از رشته‌ها یا عبارات منظم برای مطابقت با hostname URL که نشان می‌دهد پیوند خودکار در کدام دامنه‌ها باید اعمال شود. اگر رشته ای ارسال شود، 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);

افزودن دستی پارامترهای پیوند دهنده

شما می توانید به صورت دستی پارامتر پیوند دهنده را از طریق روش decorate به عنصر <a> یا <form> خاص اضافه کنید. این روش تنها زمانی مورد نیاز است که از روش 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']);