این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

ردیابی تبدیل

خلاصه

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

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

rwg_token را جمع آوری و ذخیره کنید.
تاجر را جمع آوری و ذخیره کنید.
مقادیر rwg_token و merchant_change را برگردانید.
ردیابی تبدیل را آزمایش و تأیید کنید.

`rwg_token` را جمع آوری و ذخیره کنید.

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

مجموعه توکن

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

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 روز از زمان ارجاع اولیه ذخیره کنید .

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

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

هنگام تصمیم گیری در مورد محل ذخیره rwg_token موارد زیر را در نظر بگیرید.

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

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

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

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

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

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

هنگامی که یک کاربر توسط 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_change` را برگردانید.

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

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

هنگام ارسال یک رویداد تبدیل، باید rwg_token ذخیره شده و یک مقدار merchant_change 1 یا 2 را وارد کنید، جزئیات بیشتر در مورد merchant_change را ببینید Return the Merchant Change Value .

بدنه 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 برای تعیین اینکه آیا تاجر از تاجر تغییر مسیر اولیه تغییر کرده است یا خیر استفاده می شود. اگر صفحه فرود شما در پلتفرمی باشد که سایر بازرگانان را نیز در بر می گیرد، تغییر بازرگانان امری عادی است. در این مورد، اگر کاربری توسط Google به پلتفرم شما ارجاع داده شد و تصمیم گرفت به یک تاجر دیگر پیمایش کند و یک رزرو را تکمیل کند، می‌خواهیم بدانیم که یک تبدیل اتفاق افتاده است اما با یک تاجر جداگانه، نیازی نیست تاجر را بشناسیم. فقط زمانی که یک رویداد تبدیل اتفاق افتاد و تاجر متفاوت بود، ما از یک Boolean برای تشخیص اینکه آیا یک تاجر تغییر کرده است یا خیر استفاده می‌کنیم.

هنگام تصمیم‌گیری برای تعیین مقدار merchant_change ، باید تاجر اصلی را که در Collect and Store the Merchant ذخیره شده است، بگیرید و بررسی کنید که آیا تاجر تغییر کرده است یا خیر، سپس هنگام تخصیص مقدار به جدول زیر مراجعه کنید.

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

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

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

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

فقط با استفاده از پیوند اقدام، رزرو را تکمیل کنید
- رزرو مستقیم بدون ارجاع یا نشانه‌های ذخیره‌شده قبلی نباید منجر به درخواست ارسال به Google شود.
با استفاده از پیوندی با rwg_token پیوست، رزرو را تکمیل کنید.
- اطمینان حاصل کنید که درخواست موفقیت آمیز است و با مقدار rwg_token و merchant_change 2 ارسال شده است.
- مطمئن شوید که rwg_token را به مدت 30 روز ذخیره می کنید
با استفاده از rwg_token جدید، رزرو جدیدی را با همان تاجر انجام دهید.
- اطمینان حاصل کنید که درخواست موفقیت آمیز است و با مقدار جدید rwg_token و merchant_change 2 ارسال شده است.
- اطمینان حاصل کنید که پنجره ذخیره انتساب رمز به مدت 30 روز به روز شده است
مستقیماً به صفحه رزرو تاجری که آزمایش می‌کردید بروید و بدون rwg_token ضمیمه شده، رزرو جدیدی انجام دهید.
- اطمینان حاصل کنید که درخواست با rwg_token ذخیره شده قبلی ارسال شده است و مقدار merchant_change 2 است

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

با استفاده از پیوندی با rwg_token ضمیمه شده، به صفحه رزرو تاجر بروید، سپس به یک تاجر دیگر بروید و رزرو کنید.
- اطمینان حاصل کنید که درخواست با مقدار rwg_token و merchant_change 1 ارسال شده است

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

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

باید کد زیر را به پیوند اقدام یا URL خود اضافه کنید:

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

برای تست هایی که به نشانه های اضافی نیاز دارند از نشانه زیر استفاده کنید.

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

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

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

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

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

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

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

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

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

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

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