نمای کلی
ردیابی تبدیل، ردیابی تبدیل‌های آغاز شده توسط Google را از طریق یکی از ادغام‌های مرکز اقدام ما حفظ می‌کند. این کمک می کند تا ادغام شما سالم و در حال اجرا باشد، زیرا می تواند بر رتبه بندی در صفحات خاص تأثیر بگذارد. هر بار که Google یک action_link ایجاد می‌کند، URL خاص به گونه‌ای اصلاح می‌شود که یک پارامتر جستجوی منحصربه‌فرد را شامل شود: rwg_token . شما می توانید رمز را ذخیره کنید و زمانی که کاربر سفارشی را تکمیل کرد، مقادیر مناسب را برگردانید.
برای تکمیل ادغام، مراحل زیر را دنبال کنید:
-
rwg_tokenرا تجزیه و ذخیره کنید. - اطلاعات تاجر را تجزیه و ذخیره کنید.
- مقادیر
rwg_tokenوmerchant_changedرا برگردانید. - ردیابی تبدیل را آزمایش و تأیید کنید.
rwg_token را تجزیه و ذخیره کنید
برای تکمیل ادغام، باید rwg_token را تا 30 روز از ارجاع اولیه Google جمع آوری و ذخیره کنید. مقدار 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=/";
}
هر بار که Google یک action_link که شما از طریق فیدها ارائه کرده‌اید ایجاد می‌کند، URL به گونه‌ای تغییر می‌کند که یک پارامتر جستجوی منحصربه‌فرد را شامل شود: rwg_token . شما باید این نشانه را ذخیره کنید و آن را به عنوان بخشی از رویداد تبدیل پس دهید.
ذخیره در سطح دستگاه
سطح دستگاه شامل استفاده از کوکی‌های مرورگر، فضای ذخیره‌سازی محلی، فضای ذخیره‌سازی محلی برنامه یا هر روش دیگری است که می‌تواند رمز را برای 30 روز پنجره انتساب حفظ کند. توکن به صورت محلی در دستگاه کاربر ذخیره می شود. بنابراین، اگر کاربر:
- دستگاهی که استفاده می کنند را تغییر می دهد.
- حافظه محلی یا کوکی ها را پاک می کند.
- از یک مرورگر خصوصی یا ناشناس استفاده می کند.
وقتی از ردیابی تبدیل در سطح دستگاه استفاده می‌کنید، باید رویداد تبدیل را در همه دستگاه‌های پشتیبانی‌شده که شامل تلفن همراه نیز می‌شود، دوباره اجرا کنید.
ذخیره در سطح کاربر
سطح کاربر رمز را در پایگاه داده برنامه شما از طریق یک سیستم تجزیه و تحلیل سمت سرور یا سایر سیستم های سمت سرور حفظ می کند. توکن در سمت سرور ذخیره می شود. بنابراین، رویداد تبدیل پس از ورود مجدد کاربر همچنان به درستی مشخص می شود.
هنگامی که از ردیابی تبدیل در سطح کاربر بر اساس معماری سیستم خود استفاده می کنید، می توانید رویداد تبدیل را یک بار در سمت سرور خود پیاده سازی کنید و در همه دستگاه های پشتیبانی شده مجدداً از آن استفاده کنید.
توکن را رفرش کنید
وقتی Google کاربر را به همان تاجر ارجاع می دهد، رمز موجود که قبلاً ذخیره شده است، با توکن جدید از آخرین ارجاع جایگزین می شود. پس از جایگزینی توکن، پنجره 30 روز انتساب ذخیره‌سازی رمز بازنشانی می‌شود و هر تبدیل جدید برای این تاجر، به آخرین نشانه نسبت داده می‌شود.
برای جزئیات بیشتر به الزامات مربوط به اسناد تبدیل مراجعه کنید.
اطلاعات بازرگان را تجزیه و ذخیره کنید
هنگامی که کاربر به صفحه سفارش شما هدایت می شود، باید منطقی را پیاده سازی کنید که می تواند جزئیات تاجر را پیدا و ضبط کند. به طور معمول، شرکا متادیتای تجاری یا 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 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`;
// 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 را برگردانید
مقدار merchant_changed برای تعیین اینکه آیا تاجر از تاجر تغییر مسیر اولیه تغییر کرده است یا خیر استفاده می شود. اگر صفحه فرود شما در پلتفرمی باشد که سایر بازرگانان را نیز در بر می گیرد، تغییر تاجر رایج است. در این حالت، اگر کاربری توسط Google به پلتفرم شما ارجاع داده شود و تصمیم بگیرد برای تکمیل سفارش به یک تاجر دیگر مراجعه کند، باید بدانید که یک تبدیل با یک تاجر جداگانه اتفاق افتاده است. شما می توانید از یک Boolean برای شناسایی تغییر تاجر استفاده کنید، اما نه جزئیات تاجر.
وقتی تصمیم می‌گیرید که کدام مقدار را به merchant_changed اختصاص دهید، باید تاجر اصلی را که در Parse ذخیره شده است، بگیرید و اطلاعات Merchant را ذخیره کنید . بررسی کنید که آیا تاجر تغییر کرده است یا خیر، و مقدار را بر اساس نیاز خود تعیین کنید.
- مورد نیاز : زمانی که یک کاربر وب سایت تاجر اصلی را ترک می کند و خرید خود را از طریق پلتفرم شما با یک تاجر دیگر تکمیل می کند.
- ارزش تغییر تاجر :
1
- ارزش تغییر تاجر :
- مورد نیاز : زمانی که کاربر یک تراکنش را از طریق تاجر اصلی تکمیل می کند.
- ارزش تغییر تاجر :
2
- ارزش تغییر تاجر :
ردیابی تبدیل را آزمایش و تأیید کنید
موارد آزمایشی زیر از نشانه‌های آزمایشی ارائه شده در بخش تست توکن‌ها استفاده می‌کنند و در نظر گرفته شده‌اند که شما را در تمام سناریوهای مختلفی که می‌توانند منجر به یک رویداد تبدیل شوند راهنمایی کنند. این اطمینان حاصل می کند که توکن به طور مناسب ذخیره می شود، مقدار merchant_changed به درستی تنظیم شده است، و رویداد تبدیل در صورت لزوم ارسال می شود.
از پیوند اقدام یا سفارش URL های صفحه ارائه شده در فیدهای خود استفاده کنید و هر مورد آزمایشی را با ضمیمه کردن Test Tokens به انتهای URL اجرا کنید. مطمئن شوید که از یک پنجره مرورگر خصوصی یا ناشناس استفاده می‌کنید -- با این کار همه نشانه‌های موجود مرتبط با کاربر فعلی پاک می‌شوند و به شما یک صفحه تمیز برای کار می‌دهد.
| مورد تست | شرح تست | جریان کاربر | نتیجه مورد انتظار |
|---|---|---|---|
| 1 | کاربر سفارشی را تکمیل می‌کند که منشا آن Google نیست. | کاربر بدون ارجاع توسط گوگل یا بدون ارجاع موجود مستقیماً به صفحه سفارش هدایت می شود. این نباید به هیچ رویداد تبدیلی منجر شود. | هیچ رویداد تبدیلی وجود ندارد زیرا کاربر قبلاً از صفحه سفارش بازدید نکرده یا توسط Google ارجاع نشده است. |
| 2 | یک کاربر سفارشی را که در Google ایجاد شده است تکمیل می کند. | یک کاربر تاجر شما را از طریق Google پیدا می کند، به صفحه سفارش شما ارجاع داده می شود و سفارش را تکمیل می کند. | یک رویداد تبدیل با رمز A ارسال می‌شود و تاجر مقدار 2 را تغییر می‌دهد زیرا کاربر توسط Google به صفحه سفارش ارجاع داده شده است. |
| 3 | یک کاربر (منشا از Google) جریان سفارش را آغاز می کند، اما قبل از تکمیل سفارش، جلسه را رها می کند. توجه: این جلسه را برای آزمون 4 و 5 باز نگه دارید. | کاربر به صفحه سفارش شما ارجاع داده می شود اما جلسه به پایان می رسد و سفارش را تکمیل نمی کند. | هیچ تبدیلی وجود ندارد زیرا کاربر سفارشی را تکمیل نکرده است اما Token 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
تست توکن ها
برای آزمایش ردیابی تبدیل، یکی از نشانه های آزمایشی زیر را به انتهای پیوندهای Action یا URL های صفحه سفارشی که در فیدهای خود ارائه می دهید اضافه کنید.
نشانه 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 انتظار دارد رویدادهای تبدیل را از هر دستگاهی ارسال کند، کاربر می تواند از طریق پیوند اقدام مکان به آن دسترسی داشته باشد. این دستگاه ها عبارتند از:
- برنامه های وب دسکتاپ یا موبایل.
- برنامه‌های تلفن همراه، یا از طریق پیوند عمیق برنامه یا یک برنامه ثبت‌شده برای دامنه شما.
اگر توکن در سطح کاربر ذخیره شده باشد، انتظار می رود که شما اسناد بین دستگاهی را ارائه دهید. برای اطلاعات بیشتر، فروشگاه در سطح کاربر را ببینید. در این حالت، کاربری که یک پیوند عمل را از دسکتاپ دنبال می‌کند و سپس تراکنش را در تلفن همراه با همان حساب کاربری انجام می‌دهد، باید یک رویداد تبدیل را راه‌اندازی کند.
اگر نشانه منحصراً در سطح دستگاه ذخیره می‌شود، مانند کوکی‌های مرورگر، انتظار نمی‌رود که شما نسبت بین دستگاهی را ارائه دهید. در این حالت، در صورتی که کاربر یک پیوند اقدام را در آن دستگاه دنبال کند، هر دستگاه می‌تواند یک نشانه جداگانه باقی بماند، و هر دستگاه می‌تواند به طور جداگانه قوانین انتساب را دنبال کند.