ردیابی تبدیل

پیاده سازی

خلاصه

سه بخش برای اجرای ردیابی تبدیل وجود دارد:

  1. جمع آوری rwg_token از صفحه فرود / نقطه ورود برنامه.
  2. تداوم rwg_token برای پنجره انتساب مناسب
  3. ارسال یک رویداد تبدیل در هنگام پرداخت

این اجرای ردیابی تبدیل نیازی به استفاده از Google Analytics یا جاوا اسکریپت شخص ثالث دیگر ندارد.

قبل از شروع کار بر روی اجرای ردیابی تبدیل خود، باید تصمیم بگیرید که آیا می خواهید تبدیل ها را در سطح دستگاه یا کاربر ردیابی کنید:

  • سطح دستگاه شامل استفاده از کوکی‌های مرورگر، فضای ذخیره‌سازی محلی، فضای ذخیره‌سازی محلی برنامه یا هر روش دیگری است که می‌تواند رمز را برای پنجره اسناد 30 روزه حفظ کند. از آنجایی که رمز به صورت محلی در دستگاه کاربر ذخیره می‌شود، اگر کاربر دستگاهی را که استفاده می‌کند تغییر دهد، فضای ذخیره‌سازی/کوکی‌های محلی خود را پاک کند یا از یک مرور خصوصی یا حالت ناشناس استفاده کند، رویداد تبدیل ممکن است به درستی نسبت داده نشود. هنگام استفاده از ردیابی تبدیل سطح دستگاه، باید آن را مجدداً در هر سطح پشتیبانی شده (از جمله تلفن همراه) اجرا کنید.
  • سطح کاربر شامل تداوم آن در پایگاه داده برنامه شما، از طریق یک سیستم تجزیه و تحلیل سمت سرور یا سایر سیستم های سمت سرور است. از آنجایی که رمز در سمت سرور ذخیره می‌شود، اگر کاربر دستگاهی را که استفاده می‌کند تغییر دهد، فضای ذخیره‌سازی/کوکی‌های محلی خود را پاک کند، یا از یک مرور خصوصی یا حالت ناشناس استفاده می‌کند، پس از ورود مجدد کاربر به سیستم، رویداد تبدیل همچنان نسبت داده می‌شود. هنگام استفاده از ردیابی تبدیل سطح کاربر، بسته به معماری سیستم خود، ممکن است بتوانید آن را یک بار در سمت سرور خود پیاده سازی کنید و از آن در تمام سطوح پشتیبانی شده استفاده مجدد کنید.

جمع آوری rwg_token

هر بار که Google یک action_link که شما از طریق فیدها ارائه کرده‌اید نشان می‌دهد، آن نشانی اینترنتی به گونه‌ای اصلاح می‌شود که یک پارامتر جستجوی منحصربه‌فرد را شامل شود: rwg_token . مقدار rwg_token یک رشته رمزگذاری شده است که حاوی برخی فراداده در مورد پیوندی است که کاربر روی آن کلیک کرده است. شما این نشانه را ذخیره می‌کنید و آن را به عنوان بخشی از رویداد تبدیل پس می‌دهید.

در هر صفحه فرود / نقطه ورود برنامه باید مقدار تنظیم شده برای پارامتر query rwg_token را تجزیه و ذخیره کنید. الزامات ذخیره سازی این پارامتر در مرحله تداوم rwg_token توضیح داده شده است.

مثالی برای تجزیه این نشانه برای ردیابی سطح دستگاه از طریق مرورگر در زیر آمده است. از طرف دیگر، می توانید هنگام پاسخ دادن به درخواست، این نشانه را در سمت سرور جمع آوری کنید:

<script>
  var query = location.search.substring(1);
  var params = query.split('&');
  var rwgToken = undefined;
  for (var i = 0; i < params.length; ++i) {
    var pair = params[i].split('=');
    if (pair[0] == 'rwg_token') {
      rwgToken = decodeURIComponent(pair[1]);
      break;
    }
  }
</script>

ادامه rwg_token

از شما خواسته می شود که پارامتر URL rwg_token را که به تمام پیوندهای اقدام ارائه شده توسط شما الحاق می شود، در مجموع 30 روز ادامه دهید. مقدار rwg_token باید بدون هیچ گونه ویرایشی ذخیره و برگردانده شود. اگر رمز موجود از بازدید قبلی وجود داشته باشد، توکن قدیمی باید جایگزین شود و پنجره 30 روزه برای ذخیره سازی باید بازنشانی شود.

هنگام تداوم توکن، می‌توانید توکن را در سطح دستگاه یا در سطح کاربر ذخیره کنید:

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

در زیر نمونه ای از ردیابی تبدیل سطح دستگاه، ذخیره این نشانه در مرورگر وب از طریق یک کوکی شخص اول آورده شده است. این مثال فرض می کند که شما مقدار توکن را به متغیری مانند مثال بالا تجزیه کرده اید. برای استفاده از این مثال، باید “rootdomain” را به دامنه خود به روز کنید.

<script>
  if (typeof rwg_token !== 'undefined') {
    document.cookie =
    "_rwg_token=" + rwg_token + ";max-age=2592000;domain=rootdomain.com;path=/";
  }
</script>

هنگام استفاده از ردیابی تبدیل سطح کاربر، rwg_token باید در سرور ذخیره شده و با کاربر مرتبط شود.

ارسال داده های تبدیل

وقتی کاربر تراکنشی را انجام می‌دهد که به پیوند اقدام Google Place نسبت داده می‌شود، باید یک درخواست HTTP POST به نقطه پایانی تبدیل ارسال کنید. دو نقطه پایانی وجود دارد، یکی برای محیط تولید و دیگری برای محیط سندباکس.

  • تولید: https://www.google.com/maps/conversion/collect
  • جعبه ایمنی: https://www.google.com/maps/conversion/debug/collect

بدنه پست باید یک شی کدگذاری شده json در قالب زیر باشد:

{
  'conversion_partner_id': partnerId,
  'rwg_token': <rwg_token_val>
}

در هر دو محیط سندباکس و تولید، هنگام ارسال رویداد تبدیل، باید یک rwg_token معتبر ارائه دهید. برای اهداف آزمایشی در محیط سندباکس می‌توانید از نشانه تست زیر استفاده کنید.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

یک مثال کامل از ردیابی تبدیل سطح دستگاه (با استفاده از یک کوکی در دستگاه کاربر) در جاوا اسکریپت از نحوه ایجاد این درخواست پست در زیر آمده است:

const partnerId = XXXXXXXXXX;
const endpoint = `https://www.google.com/maps/conversion/collect`;

const rwgTokenCookie = document.cookie
  .split('; ')
  .find(row => row.startsWith('_rwg_token='));

if (typeof rwgTokenCookie !== 'undefined') {
  const rwgTokenVal = rwgTokenCookie.split('=')[1];
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: rwgTokenVal
    })
  });
}

هنگام استفاده از ردیابی تبدیل سطح کاربر، باید توکن مرتبط با کاربر (بدون توجه به سطحی که روی آن قرار دارد) را از مکانیسم ذخیره سازی سمت سرور خود بازیابی کنید و توکن را با استفاده از همان نقاط پایانی تولید یا جعبه ایمنی ارسال کنید.

الزامات اسناد تبدیل

استاندارد مورد نیاز Google برای ارجاع تبدیل، یک پنجره اسناد 30 روزه برای هرگونه تعامل با پیوند مکان، در هر فروشگاهی است.

این پنجره انتساب به این معنی است که انتظار داریم یک رویداد تبدیل در هر یک از سناریوهای زیر ارسال شود:

  • کاربر پیوند اکشن مکان را دنبال می کند و در همان جلسه سفارش می دهد
  • کاربر یک پیوند اقدام مکان را دنبال می کند و سپس از کانال دیگری در پنجره 30 روزه برای ثبت سفارش باز می گردد.
  • کاربر یک پیوند اقدام مکان را دنبال می کند و سپس در فروشگاه دیگری سفارش می دهد، چه در همان جلسه یا یک جلسه دیگر در یک پنجره 30 روزه.

علاوه بر این، ما انتظار داریم که رویدادهای تبدیل از تمام سطوحی که کاربر می‌تواند از پیوند اقدام مکان به آن فرود بیاید، ارسال شود. از جمله:

  • برنامه های وب دسکتاپ یا موبایل
  • برنامه‌های تلفن همراه، یا از طریق پیوند عمیق برنامه یا یک برنامه ثبت‌شده برای دامنه شما

اگر نشانه در سطح کاربر ذخیره شده باشد ( به ادامه نشانه مراجعه کنید)، انتظار می رود که شما نسبت بین دستگاهی را ارائه دهید. یعنی کاربری که یک لینک اقدام را از دسکتاپ دنبال می‌کند و سپس تراکنش را در موبایل (با استفاده از همان حساب کاربری) انجام می‌دهد، باید یک رویداد تبدیل را راه‌اندازی کند.

اگر نشانه منحصراً در سطح دستگاه ذخیره می‌شود، مانند کوکی‌های مرورگر، انتظار نمی‌رود که شما نسبت بین دستگاهی را ارائه دهید. در این حالت، اگر کاربر یک پیوند عملی را در آن دستگاه دنبال کرده باشد، هر دستگاه یک نشانه جداگانه باقی می‌ماند و هر دستگاه به طور جداگانه قوانین انتساب را دنبال می‌کند.