ردیابی تبدیل

شکل 2: بررسی اجمالی ردیابی تبدیل

نمای کلی

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

برای تکمیل ادغام، مراحل زیر را دنبال کنید:

  1. rwg_token را تجزیه و ذخیره کنید.
  2. اطلاعات تاجر را تجزیه و ذخیره کنید.
  3. مقادیر rwg_token و merchant_changed را برگردانید.
  4. ردیابی تبدیل را آزمایش و تأیید کنید.

rwg_token را تجزیه و ذخیره کنید

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

رمز را تجزیه کنید

هنگامی که کاربر به صفحه رزرو شما هدایت می شود، یک rwg_token جدید به URL ارائه شده اضافه می شود. در صفحه رزرو خود، باید مقدار رمز را تجزیه کنید.

مثال زیر نشان می دهد که چگونه rwg_token برای ردیابی در سطح دستگاه از طریق مرورگر تجزیه می شود.

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;
  }
}

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

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

توکن را ذخیره کنید

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

  • در سطح دستگاه
  • در سطح کاربر

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

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

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

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

ذخیره در سطح دستگاه

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

  • دستگاهی که استفاده می کنند را تغییر می دهد.
  • حافظه محلی یا کوکی ها را پاک می کند.
  • از یک مرورگر خصوصی یا ناشناس استفاده می کند.

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

ذخیره در سطح کاربر

سطح کاربر رمز را در پایگاه داده برنامه شما از طریق یک سیستم تجزیه و تحلیل سمت سرور یا سایر سیستم های سمت سرور حفظ می کند. توکن در سمت سرور ذخیره می شود. بنابراین، رویداد تبدیل پس از ورود مجدد کاربر همچنان به درستی مشخص می شود.

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

توکن را رفرش کنید

وقتی Google کاربر را به همان تاجر ارجاع می دهد، رمز موجود که قبلاً ذخیره شده است، با توکن جدید از آخرین ارجاع جایگزین می شود. پس از جایگزینی توکن، پنجره 30 روز انتساب ذخیره‌سازی رمز بازنشانی می‌شود و هر تبدیل جدید برای این تاجر، به آخرین نشانه نسبت داده می‌شود.

برای جزئیات بیشتر به الزامات مربوط به اسناد تبدیل مراجعه کنید.

اطلاعات بازرگان را تجزیه و ذخیره کنید

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

توصیه می کنیم merchant_id یا شناسه انتخاب شده را همراه با rwg_token ذخیره کنید. وقتی کاربر رزرو را تأیید می‌کند، می‌توانید قبل از ارسال درخواست تبدیل کامل به تاجر مراجعه کنید. مشابه ذخیره‌سازی توکن، باید جزئیات تاجر را با توکن به مدت 30 روز پس از ارجاع اولیه ذخیره کنید.

مثال زیر rwg_token ذخیره شده قبلی را اصلاح می کند. فرض بر این است که شما اطلاعات تاجر را از فراداده در URL ارائه شده تجزیه کرده اید و آن را به عنوان merchant_id ذخیره کرده اید یا با merchant_id موجود مطابقت داده اید.

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

rwg_token و merchant_changed Values ​​را برگردانید

وقتی کاربر رزروی را که از ارجاع action_link شروع می‌شود تکمیل می‌کند، باید یک درخواست HTTP POST به نقطه پایانی تبدیل ارسال کنید. دو نقطه پایانی وجود دارد:

  • محیط تولید : https://www.google.com/maps/conversion/collect
  • محیط سندباکس : https://www.google.com/maps/conversion/debug/collect

هنگامی که یک رویداد تبدیل را ارسال می کنید، باید rwg_token ذخیره شده و مقدار merchant_changed 1 یا 2 را وارد کنید. برای جزئیات بیشتر در مورد merchant_changed ، به بازگشت ارزش تغییر فروشنده مراجعه کنید.

بدنه POST باید یک شی کدگذاری شده JSON در قالب زیر باشد:

{
  "conversion_partner_id": "<partnerId>",
  "rwg_token": "<rwg_token_val>",
  "merchant_changed": "1|2"
}
{
  "conversion_partner_id": "XXXXXXX",
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
  "merchant_changed": "2"
}

مثال زیر شامل ردیابی تبدیل در سطح دستگاه با یک کوکی در دستگاه کاربر است که با جاوا اسکریپت نوشته شده است:

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,
      merchant_changed: merchantChanged
    })
  });
}

مقدار تغییر Merchant را برگردانید

مقدار merchant_changed برای تعیین اینکه آیا تاجر از تاجر تغییر مسیر اولیه تغییر کرده است یا خیر استفاده می شود. اگر صفحه فرود شما در پلتفرمی باشد که سایر بازرگانان را نیز در بر می گیرد، تغییر تاجر رایج است. در این مورد، اگر کاربری توسط گوگل به پلتفرم شما ارجاع داده شود و تصمیم بگیرد برای تکمیل رزرو به یک تاجر دیگر مراجعه کند، باید بدانید که یک تبدیل با یک تاجر جداگانه اتفاق افتاده است. شما می توانید از یک Boolean برای شناسایی تغییر تاجر استفاده کنید، اما نه جزئیات تاجر.

وقتی تصمیم می‌گیرید که کدام مقدار را به merchant_changed اختصاص دهید، باید تاجر اصلی را که در Parse ذخیره شده است، بگیرید و اطلاعات Merchant را ذخیره کنید . بررسی کنید که آیا تاجر تغییر کرده است یا خیر، و مقدار را بر اساس نیاز خود تعیین کنید.

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

ردیابی تبدیل را آزمایش و تأیید کنید

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

از پیوند اقدام یا نشانی‌های اینترنتی صفحه رزرو ارائه شده در فیدهای خود استفاده کنید و هر مورد آزمایشی را با ضمیمه کردن نشانه‌های تست به انتهای URL اجرا کنید. مطمئن شوید که از یک پنجره مرورگر خصوصی یا ناشناس استفاده می‌کنید -- با این کار همه نشانه‌های موجود مرتبط با کاربر فعلی پاک می‌شوند و به شما یک صفحه تمیز برای کار می‌دهد.

مورد تست شرح تست جریان کاربر نتیجه مورد انتظار
1 کاربر رزروی را تکمیل می‌کند که منشا آن Google نیست. کاربر بدون ارجاع توسط Google یا بدون ارجاع موجود مستقیماً به صفحه رزرو حرکت می کند. این نباید به هیچ رویداد تبدیلی منجر شود. هیچ رویداد تبدیلی وجود ندارد زیرا کاربر قبلاً از صفحه رزرو بازدید نکرده یا توسط Google ارجاع نشده است.
2 یک کاربر رزروی را که در Google ایجاد شده است تکمیل می کند. یک کاربر تاجر شما را از طریق Google پیدا می کند، به صفحه رزرو شما ارجاع داده می شود و رزرو را تکمیل می کند. یک رویداد تبدیل با رمز A ارسال می‌شود و تاجر مقدار 2 را تغییر می‌دهد زیرا کاربر توسط Google به صفحه رزرو ارجاع داده شده است.
3 یک کاربر (منشا گوگل) جریان رزرو را شروع می کند، اما قبل از تکمیل رزرو، جلسه را رها می کند.

توجه: این جلسه را برای آزمون 4 و 5 باز نگه دارید.
کاربر به صفحه رزرو شما ارجاع داده می شود اما جلسه به پایان می رسد و آنها رزرو را تکمیل نمی کنند. بدون تبدیل، زیرا کاربر رزرو را کامل نکرده است، اما رمز B باید به مدت 30 روز ذخیره شود.
4 یک کاربر به صفحه رزرو باز می گردد، بدون اینکه منشأ آن از Google باشد، و یک رزرو را تکمیل می کند.

توجه: URL جریان رزرو نباید دارای rwg_token باشد.
یک کاربر پس از تست شماره 4 به صفحه رزرو باز می گردد. رمز B باید به مدت 30 روز ذخیره شود و هر تبدیلی در این 30 روز باید یک رویداد تبدیل را بازگرداند. یک رویداد تبدیل با رمز B ارسال می‌شود و تاجر مقدار 2 را تغییر می‌دهد زیرا کاربر پس از ارجاع قبلی از Google به صفحه رزرو برمی‌گردد.
5 یک کاربر پس از تست شماره 4، رزرو جدیدی را که از Google گرفته شده است، تکمیل می کند. اگر کاربر پس از ارجاع قبلی Google با استفاده از یک ارجاع Google به صفحه رزرو شما برگردد، پنجره ذخیره سازی 30 روزه او بازنشانی می شود و یک توکن C جدید جایگزین توکن B قدیمی می شود. سپس تمام تبدیل‌های آینده به Token C نسبت داده می‌شود. یک رویداد تبدیل با توکن C ارسال می‌شود و تاجر مقدار 2 را تغییر می‌دهد، زیرا کاربر رزرو را تکمیل کرده و رمز جدید جایگزین رمز ذخیره‌شده قبلی شده است.

اگر پلتفرمی دارید که کاربران می‌توانند با یک تاجر دیگر تسویه حساب کنند، موارد زیر را آزمایش کنید.

مورد تست شرح تست جریان کاربر نتیجه مورد انتظار
6 کاربر توسط Google به صفحه رزرو شما ارجاع داده می شود و رزرو را با یک تاجر دیگر تکمیل می کند. کاربر توسط Google به صفحه رزرو شما ارجاع داده می‌شود، رمز A استفاده می‌شود، اما قبل از تکمیل رزرو، به صفحه دیگری رفته و رزرو را با تاجری که با ارجاع اصلی متفاوت است تکمیل می‌کند. یک رویداد تبدیل ارسال می‌شود زیرا کاربر رزروی را که با ارجاع از طرف Google آغاز شده بود با رمز A تکمیل کرد و تاجر مقدار 1 را تغییر داد زیرا کاربر رزرو را در تاجری متفاوت از ارجاع انجام داد.

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

  • محیط تولید: https://www.google.com/maps/conversion/collect
  • محیط Sandbox: https://www.google.com/maps/conversion/debug/collect

تست توکن ها

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

نشانه A:

rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D

نشانه B:

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

توکن C:

rwg_token=AJKvS9VwInjZ_hGZPvBz0COVWJ5oFDzocFt9hGi7TMurlo2l71uiXP48PspPUMmRnqCUDE1mF_A5H_dMV78cBTF8jIfSQK6lEA%3D%3D

وقتی رویدادهای تبدیل موفق را ارسال می‌کنید، می‌توانید آنها را در مرکز اقدام زیر داشبورد ردیابی تبدیل مشاهده کنید.

تبدیل-ردیابی-داشبورد

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

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

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

  • یک کاربر یک پیوند اقدام مکان را دنبال می کند و برای یک تاجر در همان جلسه سفارش می دهد. مقدار تغییر تاجر = 2.
  • کاربر یک پیوند اقدام مکان را دنبال می کند و سپس از کانال دیگری در عرض 30 روز پنجره انتساب برمی گردد تا برای همان تاجر سفارش دهد. مقدار تغییر تاجر = 2.
  • کاربر یک پیوند اقدام مکان را دنبال می کند و سپس در یک فروشگاه دیگر سفارش می دهد، چه در همان جلسه یا در یک جلسه دیگر در یک پنجره انتساب 30 روزه. مقدار تغییر تاجر = 1.

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

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

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

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