نمای کلی
ردیابی تبدیل، تبدیلهای آغاز شده توسط گوگل را از طریق یکی از ادغامهای مرکز اقدام ما پیگیری میکند. این به سالم و فعال ماندن ادغام شما کمک میکند، زیرا میتواند بر رتبهبندی در صفحات خاص تأثیر بگذارد. هر بار که گوگل یک action_link ایجاد میکند، URL خاص اصلاح میشود تا شامل یک پارامتر جستجوی منحصر به فرد باشد: rwg_token . میتوانید توکن را ذخیره کنید و هنگامی که کاربر رزرو را تکمیل میکند، مقادیر مناسب را برگردانید.
برای تکمیل ادغام، مراحل زیر را دنبال کنید:
-
rwg_tokenرا تجزیه و ذخیره کنید. - اطلاعات فروشنده را تجزیه و ذخیره کنید.
- مقادیر
rwg_tokenوmerchant_changedرا برمیگرداند. - ردیابی تبدیل را آزمایش و تأیید کنید.
تجزیه و ذخیره rwg_token
برای تکمیل ادغام، باید rwg_token را تا 30 روز از اولین ارجاع گوگل جمعآوری و ذخیره کنید. مقدار rwg_token یک رشته کدگذاری شده است که شامل ابردادههایی در مورد لینک و اطلاعات فروشندهای است که آن action_link ایجاد کرده است.
تجزیه توکن
وقتی کاربری به صفحه رزرو شما هدایت میشود، یک rwg_token جدید به URL ارائه شده اضافه میشود. در صفحه رزرو، باید مقدار توکن را تجزیه و تحلیل کنید.
مثال زیر نحوه تجزیه و تحلیل rwg_token برای ردیابی در سطح دستگاه از طریق مرورگر را نشان میدهد.
const rwgToken = new URLSearchParams(location.search).get('rwg_token') || undefined;
توکن را ذخیره کنید
وقتی rwg_token را ذخیره میکنید، میتوانید ردیابی تبدیل را در دو سطح مختلف پیادهسازی کنید:
- سطح دستگاه
- سطح کاربر
شما میتوانید توکن را در هر سطحی ذخیره کنید، اما باید آن را تا 30 روز پس از معرفی اولیه ذخیره کنید .
مثال زیر ردیابی تبدیل در سطح دستگاه را نشان میدهد. میتوانید مقادیر توکن را در یک مرورگر با کوکی شخص اول ذخیره کنید. این مثال فرض میکند که شما مقدار توکن را در یک متغیر تجزیه کردهاید. حتماً rootdomain.com با دامنه خود بهروزرسانی کنید.
if (rwgToken !== undefined) {
document.cookie =
"_rwgToken=" + rwgToken + "; max-age=2592000; domain=rootdomain.com; path=/";
}
هر بار که گوگل یک action_link که شما از طریق فیدها ارائه کردهاید، ایجاد میکند، URL اصلاح میشود تا یک پارامتر پرسوجوی منحصر به فرد را شامل شود: rwg_token . شما باید این توکن را ذخیره کنید و آن را به عنوان بخشی از رویداد تبدیل، برگردانید.
ذخیره در سطح دستگاه
سطح دستگاه شامل استفاده از کوکیهای مرورگر، حافظه محلی، حافظه محلی برنامه یا هر روش دیگری است که میتواند توکن را برای مدت ۳۰ روز در پنجره تخصیص حفظ کند. توکن به صورت محلی در دستگاه کاربر ذخیره میشود. بنابراین، اگر کاربر:
- دستگاه مورد استفاده خود را تغییر میدهد.
- حافظه محلی یا کوکیها را پاک میکند.
- از یک مرورگر خصوصی یا ناشناس استفاده میکند.
وقتی از ردیابی تبدیل در سطح دستگاه استفاده میکنید، باید رویداد تبدیل را در هر دستگاه پشتیبانیشدهای که شامل موبایل نیز میشود، مجدداً پیادهسازی کنید.
ذخیره در سطح کاربر
سطح کاربر، توکن را از طریق یک سیستم تحلیلی سمت سرور یا سایر سیستمهای سمت سرور، در پایگاه داده برنامه شما حفظ میکند. توکن در سمت سرور ذخیره میشود. بنابراین، رویداد تبدیل پس از ورود مجدد کاربر، همچنان به درستی نسبتدهی میشود.
وقتی از ردیابی تبدیل در سطح کاربر بر اساس معماری سیستم خود استفاده میکنید، میتوانید رویداد تبدیل را یک بار در سمت سرور خود پیادهسازی کنید و آن را در تمام دستگاههای پشتیبانیشده دوباره استفاده کنید.
توکن را بهروزرسانی کنید
وقتی گوگل کاربری را به همان فروشنده ارجاع میدهد، توکن موجود که از قبل ذخیره شده است، با توکن جدید از آخرین ارجاع جایگزین میشود. پس از جایگزینی توکن، مهلت ۳۰ روزه تخصیص توکن به فروشگاه بازنشانی میشود و هرگونه تبدیل جدید برای این فروشنده، به آخرین توکن نسبت داده میشود.
برای جزئیات بیشتر به الزامات مربوط به نسبت تبدیل مراجعه کنید.
تجزیه و ذخیره اطلاعات فروشنده
وقتی کاربری به صفحه رزرو شما هدایت میشود، باید منطقی را پیادهسازی کنید که بتواند جزئیات فروشنده را پیدا و ثبت کند. معمولاً شرکا، متادیتای فروشنده یا merchant_id را به لینکهای اکشن خود اضافه میکنند و از آن برای شناسایی و ذخیره اطلاعات فروشنده استفاده میکنند.
توصیه میکنیم که merchant_id یا شناسه انتخاب شده را به همراه rwg_token ذخیره کنید. وقتی کاربری رزرو را تأیید میکند، میتوانید قبل از ارسال درخواست تبدیل کامل، به فروشنده مراجعه کنید. مشابه ذخیرهسازی توکن، باید جزئیات فروشنده را به همراه توکن به مدت 30 روز پس از ارجاع اولیه ذخیره کنید.
مثال زیر rwg_token ذخیره شده قبلی را تغییر میدهد. فرض بر این است که شما اطلاعات فروشنده را از فراداده موجود در URL ارائه شده تجزیه و تحلیل کردهاید و آن را یا به عنوان merchant_id ذخیره کردهاید یا آن را با merchant_id موجود مطابقت دادهاید.
// Store the rwgToken and merchantId in your cookie and set the cookie
// expiration date to 30 days.
if (typeof rwgToken !== 'undefined') {
document.cookie =
"_rwgToken=" + rwgToken + "; _merchantId=" + merchantId + "; max-age=2592000;domain=rootdomain.com; path=/";
}
مقادیر rwg_token و merchant_changed را برمیگرداند.
وقتی کاربری رزروی را که از ارجاع 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`;
// Retrieve the value of the rwgToken stored in the browser's cookie
const match = document.cookie.match(new RegExp('(?:^| )_rwgToken=([^;]+)'));
const storedRwgToken = match ? match[1] : undefined;
// Send Conversion event with decoded token, verify any special characters
// are sent properly.
if (storedRwgToken !== undefined) {
fetch(endpoint, {
method: "POST",
body: JSON.stringify({
conversion_partner_id: partnerId,
rwg_token: decodeURIComponent(storedRwgToken),
merchant_changed: merchantChanged
})
});
}
مقدار تغییر فروشنده را برگردانید
مقدار merchant_changed برای تعیین اینکه آیا فروشنده از فروشندهی ریدایرکت اولیه تغییر کرده است یا خیر، استفاده میشود. تغییر فروشنده در صورتی رایج است که صفحه فرود شما در پلتفرمی باشد که شامل فروشندگان دیگری نیز میشود. در این حالت، اگر کاربری توسط گوگل به پلتفرم شما ارجاع داده شود و تصمیم بگیرد برای تکمیل رزرو به فروشندهی دیگری مراجعه کند، باید بدانید که یک تبدیل با یک فروشندهی جداگانه اتفاق افتاده است. میتوانید از یک متغیر بولی برای شناسایی تغییر فروشنده استفاده کنید، اما نه جزئیات فروشنده.
وقتی تصمیم میگیرید که کدام مقدار را به merchant_changed اختصاص دهید، باید اطلاعات تاجر اصلی ذخیره شده در Parse را در نظر بگیرید و آن را ذخیره کنید . بررسی کنید که آیا تاجر تغییر کرده است یا خیر، و مقدار مورد نیاز خود را به آن اختصاص دهید.
- الزام : زمانی که کاربر وبسایت فروشنده اصلی را ترک میکند و از طریق پلتفرم شما با فروشنده دیگری خرید خود را انجام میدهد.
- مقدار تغییر فروشنده :
1
- مقدار تغییر فروشنده :
- الزام : زمانی که کاربر تراکنشی را از طریق فروشنده اصلی انجام میدهد.
- مقدار باقیمانده فروشنده :
2
- مقدار باقیمانده فروشنده :
ردیابی تبدیل را آزمایش و تأیید کنید
موارد آزمایشی زیر از توکنهای آزمایشی ارائه شده در بخش توکنهای آزمایشی استفاده میکنند و هدف آنها راهنمایی شما در تمام سناریوهای مختلفی است که میتوانند منجر به یک رویداد تبدیل شوند. این امر تضمین میکند که توکن به طور مناسب ذخیره میشود، مقدار merchant_changed به درستی تنظیم میشود و رویداد تبدیل در زمان مناسب ارسال میشود.
از لینک اقدام یا آدرسهای اینترنتی صفحه رزرو که در فیدهای شما ارائه شده است استفاده کنید و هر مورد آزمایشی را با افزودن توکنهای آزمایشی به انتهای URL اجرا کنید. حتماً از یک پنجره مرورگر خصوصی یا ناشناس استفاده کنید -- این کار هرگونه توکن موجود مرتبط با کاربر فعلی را پاک میکند و به شما یک صفحه تمیز برای کار میدهد.
| مورد آزمایشی | شرح آزمایش | جریان کاربر | نتیجه مورد انتظار |
|---|---|---|---|
| ۱ | کاربری رزروی را انجام میدهد که از طریق گوگل انجام نشده است. | کاربر بدون اینکه توسط گوگل ارجاع داده شود یا از قبل ارجاعی دریافت کرده باشد، مستقیماً به صفحه رزرو هدایت میشود. این نباید منجر به هیچ رویداد تبدیلی شود. | هیچ رویداد تبدیلی رخ نداده است زیرا کاربر قبلاً از صفحه رزرو بازدید نکرده یا توسط گوگل معرفی نشده است. |
| ۲ | کاربری رزروی را که از طریق گوگل انجام داده است، تکمیل میکند. | کاربر فروشنده شما را از طریق گوگل پیدا میکند، به صفحه رزرو شما هدایت میشود و رزرو خود را تکمیل میکند. | یک رویداد تبدیل با توکن A ارسال میشود و فروشنده مقدار ۲ را تغییر میدهد زیرا کاربر توسط گوگل به صفحه رزرو هدایت شده است. |
| ۳ | یک کاربر (از گوگل) فرآیند رزرو را آغاز میکند، اما قبل از تکمیل رزرو، جلسه را ترک میکند. توجه: این جلسه را برای آزمون ۴ و ۵ باز نگه دارید. | کاربر به صفحه رزرو شما ارجاع داده میشود اما جلسه به پایان میرسد و رزرو انجام نمیشود. | هیچ تبدیلی انجام نشده است زیرا کاربر رزرو را تکمیل نکرده است، اما توکن B باید به مدت 30 روز ذخیره شود. |
| ۴ | کاربر بدون اینکه از گوگل وارد شده باشد، به صفحه رزرو برمیگردد و رزرو خود را تکمیل میکند. توجه: آدرس اینترنتی (URL) جریان رزرو نباید شامل rwg_token باشد. | کاربر پس از آزمایش شماره ۴ به صفحه رزرو بازمیگردد. توکن B باید به مدت ۳۰ روز ذخیره شود و هرگونه تبدیل در طول این ۳۰ روز باید یک رویداد تبدیل را بازگرداند. | یک رویداد تبدیل با توکن B ارسال میشود و فروشنده مقدار ۲ را تغییر میدهد زیرا کاربر پس از ارجاع قبلی از گوگل، به صفحه رزرو بازمیگردد. |
| ۵ | کاربری پس از آزمایش شماره ۴، رزرو جدیدی را از طریق گوگل انجام میدهد. | اگر کاربری پس از ارجاع قبلی گوگل، با استفاده از ارجاع گوگل به صفحه رزرو شما بازگردد، مهلت ذخیرهسازی ۳۰ روزه او بازنشانی میشود و توکن جدید C جایگزین توکن قدیمی B میشود. سپس تمام تبدیلهای آینده به توکن C نسبت داده میشوند. | یک رویداد تبدیل با توکن C ارسال میشود و فروشنده مقدار ۲ را تغییر میدهد زیرا کاربر رزرو را تکمیل کرده و توکن جدید جایگزین توکن ذخیره شده قبلی شده است. |
اگر پلتفرمی دارید که به کاربران امکان میدهد با فروشندهی دیگری خرید خود را انجام دهند، موارد زیر را امتحان کنید.
| مورد آزمایشی | شرح آزمایش | جریان کاربر | نتیجه مورد انتظار |
|---|---|---|---|
| ۶ | یک کاربر توسط گوگل به صفحه رزرو شما ارجاع داده میشود و رزرو خود را با فروشنده دیگری تکمیل میکند. | کاربری توسط گوگل به صفحه رزرو شما ارجاع داده میشود، توکن A استفاده میشود، اما قبل از تکمیل رزرو، به صفحه دیگری هدایت میشود و رزرو را با فروشندهای که با فروشنده اصلی متفاوت است، تکمیل میکند. | یک رویداد تبدیل ارسال میشود زیرا کاربر رزروی را که با معرفی گوگل و با توکن A انجام شده بود، تکمیل کرده است و فروشنده مقدار ۱ را تغییر داده است زیرا کاربر رزرو را در فروشگاهی متفاوت از فروشگاه معرفی شده انجام داده است. |
در حین آزمایش، درخواست HTTP POST را به نقطه پایانی تبدیل ارسال کنید. دو نقطه پایانی وجود دارد:
- محیط تولید: https://www.google.com/maps/conversion/collect
- محیط سندباکس: https://www.google.com/maps/conversion/debug/collect
توکنهای آزمایشی
برای آزمایش ردیابی تبدیل، یکی از توکنهای آزمایشی زیر را به انتهای لینکهای اقدام یا آدرسهای اینترنتی صفحه رزرو که در فیدهای خود ارائه میدهید، اضافه کنید.
توکن الف:
rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D
توکن ب:
rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D
توکن ج:
rwg_token=AJKvS9VwInjZ_hGZPvBz0COVWJ5oFDzocFt9hGi7TMurlo2l71uiXP48PspPUMmRnqCUDE1mF_A5H_dMV78cBTF8jIfSQK6lEA%3D%3D
وقتی رویدادهای تبدیل موفق را ارسال میکنید، میتوانید آنها را به صورت تجمیعشده در مرکز اقدام (Action Center) در زیر داشبورد ردیابی تبدیل مشاهده کنید.
الزامات مربوط به انتساب تبدیل
استاندارد مورد نیاز گوگل برای انتساب تبدیل، یک بازه زمانی ۳۰ روزه برای هرگونه تعامل با لینک اقدام مکانی، در هر فروشگاهی است.
این پنجره انتساب به این معنی است که گوگل میتواند انتظار داشته باشد که یک رویداد تبدیل در هر یک از سناریوهای زیر ارسال شود:
- کاربر لینک مربوط به ثبت سفارش را دنبال میکند و سفارشی را برای همان فروشنده در همان جلسه ثبت میکند. مقدار تغییر فروشنده = ۲.
- کاربر یک لینک مربوط به اقدام به ثبت سفارش را دنبال میکند و سپس در بازه زمانی ۳۰ روزه از کانال دیگری برمیگردد تا سفارشی برای همان فروشنده ثبت کند. مقدار تغییر فروشنده = ۲.
- کاربر یک لینک مربوط به اقدام به ثبت سفارش را دنبال میکند و سپس سفارشی را در فروشگاه دیگری ثبت میکند، چه در همان جلسه یا در جلسهای متفاوت در یک بازه زمانی ۳۰ روزه. مقدار تغییر فروشنده = ۱.
علاوه بر این، گوگل انتظار دارد رویدادهای تبدیل را از هر دستگاهی که کاربر میتواند از طریق یک لینک اقدام به آن دسترسی داشته باشد، ارسال کند. این دستگاهها عبارتند از:
- برنامههای وب دسکتاپ یا موبایل.
- برنامههای تلفن همراه، چه از طریق یک لینک عمیق برنامه یا یک هدف برنامه ثبت شده برای دامنه شما.
اگر توکن در سطح کاربر ذخیره شده باشد، انتظار میرود که شما امکان تخصیص بین دستگاهی را فراهم کنید. برای اطلاعات بیشتر، به بخش «ذخیره در سطح کاربر» مراجعه کنید. در این حالت، کاربری که از طریق دسکتاپ یک لینک عملیاتی را دنبال میکند و سپس تراکنش را در موبایل با همان حساب کاربری تکمیل میکند، باید یک رویداد تبدیل را فعال کند.
اگر توکن منحصراً در سطح دستگاه ذخیره شده باشد، مانند کوکیهای مرورگر، انتظار نمیرود که شما انتساب بین دستگاهی را ارائه دهید. در این حالت، اگر کاربر یک لینک عملیاتی را در آن دستگاه دنبال کند، هر دستگاه میتواند یک توکن جداگانه داشته باشد و هر دستگاه میتواند قوانین انتساب را به طور جداگانه دنبال کند.