راهنمای افزونه یکتانت؛ ثبت اسکریپت و فعالسازی رویدادهای محصول و خرید
صفحهٔ افزونه یکتانت برای قراردادن اسکریپت یکتانت در فروشگاه و تعیین ارسال رویدادهای مشاهدهٔ محصول و خرید است. ریتارگتینگ یا بازاریابی مجدد کمک میکند سرویس تبلیغاتی، بازدید قبلی از کالا را در تبلیغات بعدی در نظر بگیرد. ساخت حساب، تنظیم کمپین و بررسی گزارش تبلیغات در خود یکتانت انجام میشود.
ذخیرهٔ اسکریپت در سپهر، تأیید صحت کد یا راهاندازی کمپین در یکتانت نیست. این صفحه آمار کلیک، هزینه یا نتیجهٔ کمپین را نشان نمیدهد.
ورود به تنظیمات یکتانت و آمادهکردن حساب فروشگاه
در افزونه یکتانت، بخش «ریتارگتینگ یعنی چه؟» کاربرد سرویس را توضیح میدهد و «اطلاعات بیشتر...» صفحهٔ توضیحات یکتانت را باز میکند. از «لینک عضویت در یکتانت» برای ورود یا ساخت حساب در برگهٔ جدید استفاده کنید. بازکردن این لینک، حساب را خودکار به فروشگاه متصل نمیکند.
اسکریپت را از حساب مربوط به همین فروشگاه بگیرید. کد فروشگاهی دیگر، لینک سایت یکتانت یا اطلاعات ورود به حساب را به جای اسکریپت وارد نکنید. برای دریافت و ثبت این تنظیمات، مدیر باید مجوز مدیریت محتوا داشته باشد؛ اگر صفحه باز میشود ولی دریافت یا ثبت با خطای دسترسی مواجه است، مجوز حساب را در مدیریت مدیران بررسی کنید.
ثبت، جایگزینی و حذف اسکریپت یکتانت
- در حساب یکتانت، اسکریپت ارائهشده برای فروشگاه را کامل کپی کنید.
- در صفحهٔ یکتانت، کد را در کادر «اسکریپت را اینجا کپی کنید» قرار دهید. کادر برای خواندن کد، چپبهراست است.
- «ذخیره» را بزنید و منتظر پیام «با موفقیت ذخیره شد» بمانید.
- صفحه را دوباره باز کنید تا مقدار ذخیرهشده را ببینید؛ سپس بارگذاری کد و دریافت رویداد را در فروشگاه و حساب یکتانت بررسی کنید.
ذخیره، متن قبلی کادر را جایگزین میکند. برای اصلاح کد، نسخهٔ کامل جدید را قرار دهید؛ افزودن یک نسخهٔ دیگر به انتهای نسخهٔ قبلی میتواند باعث اجرای چندباره شود. پیش از جایگزینی، نسخهٔ معتبر قبلی را نزد خود نگه دارید؛ تاریخچه و دکمهٔ بازگردانی در این صفحه وجود ندارد.
برای برداشتن اسکریپت از تنظیمات، تمام متن کادر را پاک و «ذخیره» کنید. ذخیرهٔ کادر خالی مجاز است. این کار وضعیت دو کلید رویداد را جداگانه خاموش نمیکند؛ در صورت توقف استفاده، وضعیت آنها را نیز بررسی کنید. برداشتن کد از سپهر، کمپین یا اطلاعات قبلی را از حساب یکتانت حذف نمیکند.
تغییر متن تا پیش از زدن «ذخیره» ثبت نمیشود. این صفحه هشدار اختصاصی برای خروج با متن ذخیرهنشده ندارد. هنگام دریافت یا ذخیرهٔ تنظیمات، دکمه حالت انتظار دارد؛ پیش از خروج، نتیجه را ببینید.
تفاوت «API محصول» و «API خرید محصول» یکتانت
بخش «API محصول را فعال کنید» پس از ذخیرهٔ اسکریپت در تنظیمات یکتانت ظاهر میشود. ابتدا کد کامل همان فروشگاه را ثبت کنید و سپس گزینههای مربوط به رویدادهای محصول و خرید را تنظیم کنید. این دو گزینه کاربرد متفاوت دارند و میتوانید هرکدام را متناسب با نیاز تبلیغاتی خود روشن کنید.
- API محصول: با روشنبودن این گزینه و آمادهبودن اسکریپت، هنگام نمایش صفحهٔ محصول، اطلاعاتی مانند نام، شناسه یا بارکد، دسته، برند، تصویر، قیمت و وضعیت موجودبودن محصول برای یکتانت فرستاده میشود. این گزینه مربوط به مشاهدهٔ کالا است؛ کپیکردن همهٔ محصولات به حساب تبلیغاتی را تضمین نمیکند.
- API خرید محصول: با روشنبودن این گزینه و آمادهبودن اسکریپت، هنگام بارگذاری فاکتور دارای اقلام، اطلاعات اقلام شامل شناسه یا بارکد، تعداد و مبلغ برای رویداد خرید فرستاده میشود. دریافت رویداد به بازشدن صفحهٔ فاکتور و بارگذاری اطلاعات آن وابسته است.
هر کلید «روشن / خاموش» مستقل است و تغییر آن همان لحظه برای ذخیره ارسال میشود؛ برای این دو کلید، زدن دوبارهٔ دکمهٔ «ذخیره» کادر اسکریپت لازم نیست. منتظر پایان درخواست و پیام موفقیت بمانید و پس از بازکردن مجدد صفحه، وضعیت را کنترل کنید.
اطلاعات خرید یکتانت برای گزارش و استفادهٔ تبلیغاتی ارسال میشود. مرجع تشخیص پرداخت قطعی، وضعیت واقعی سفارش و پرداخت در سفارشات است؛ برای تطبیق گزارش تبلیغاتی با فروش، همان سفارش و زمان ثبت آن را بررسی کنید.
بررسی نتیجهٔ یکتانت در صفحهٔ محصول و فاکتور فروشگاه
اسکریپت ذخیرهشده در بخش مشترک صفحات فروشگاه قرار میگیرد؛ به افزودن بلوک تبلیغاتی در صفحهساز نیاز ندارد. کلیدهای رویداد، ارسال اطلاعات از صفحهٔ محصول و فاکتور را کنترل میکنند. این تنظیمات کارت کالا، موجودی، قیمت فروش یا چیدمان صفحه را تغییر نمیدهند.
برای ارسال رویداد باید هم اطلاعات صفحه دریافت شده باشد و هم اسکریپت یکتانت در مرورگر آماده باشد. متن ذخیرهشدهٔ نادرست، بارگذارینشدن اسکریپت یا محدودیت مرورگر میتواند مانع ارسال شود؛ پیام ذخیرهٔ پنل این مرحله را آزمایش نمیکند.
- یک صفحهٔ محصول فعال و قابل مشاهده را در فروشگاه باز کنید و نتیجهٔ رویداد مشاهده را در یکتانت بررسی کنید.
- اگر «API خرید محصول» را روشن کردهاید، نتیجهٔ دریافت رویداد یک فاکتور نمونه را با همان سفارش تطبیق دهید.
- برای اختلاف اطلاعات، نام کالا، نوع کالا، مدل و واحد پول را یکسان در نظر بگیرید؛ مقایسهٔ دو مدل متفاوت نتیجهٔ قابل اتکا نمیدهد.
پس از تغییر تنظیمات، فروشگاه را با بارگذاری تازه بررسی کنید و نتیجهٔ رویداد را در یکتانت ببینید. زمان ثبت یا پردازش نهایی گزارشهای یکتانت از این صفحه قابل تعیین نیست.
رفع مشکل ذخیره و ارسال رویداد یکتانت
- بخش «API محصول را فعال کنید» دیده نمیشود: بررسی کنید اسکریپت را فقط تایپ نکرده باشید؛ آن را ذخیره و صفحه را دوباره باز کنید. کادر خالی این بخش را فعال نمیکند.
- اسکریپت ذخیره شده ولی رویدادی ثبت نمیشود: صحت نسخهٔ کد برای همین فروشگاه، روشنبودن کلید مربوط، دریافت اطلاعات محصول یا فاکتور و آمادهشدن اسکریپت در فروشگاه را جداگانه بررسی کنید. فعالبودن کمپین را در یکتانت کنترل کنید.
- گزینه روشن شده ولی پس از مراجعهٔ دوباره خاموش است: متن خطای ذخیره و مجوز مدیر را بررسی کنید. نمایش موقت کلید یا بستهشدن درخواست، جای تأیید نتیجه را نمیگیرد.
- آمار خرید با سفارشهای پرداختشده یکسان نیست: وابستگی رویداد به بازدید فاکتور و تفاوت آن با تأیید پرداخت را در نظر بگیرید؛ سفارش، وضعیت پرداخت و زمان بازدید فاکتور را مقایسه کنید.
- پس از حذف اسکریپت هنوز گزارش قبلی وجود دارد: حذف کد، سوابق یکتانت را پاک نمیکند. وضعیت فعلی ارسال را با یک بازدید تازه بررسی کنید.
برای پیگیری، نام فروشگاه، صفحهٔ محصول یا شماره سفارش نمونه، نوع کالا، وضعیت دو کلید، زمان آزمایش و متن دقیق خطا را ثبت کنید. اطلاعات ورود، کلیدها و دادهٔ واقعی مشتری را در متن عمومی درخواست قرار ندهید.



نظرات