آموزش اسکریپت محصول یکتانت (همراه با نمونه)

برای ایجاد و اجرای کمپین‌‌های تبلیغات ریتارگتینگ محصول و محتوامحور محصول، علاوه بر اسکریپت عمومی یکتانت، باید اسکریپت محصول را هم به سایت اضافه کنید.

در این راهنما، با نحوه استفاده و ساخت این اسکریپت همراه با چند مثال آشنا می‌شوید.

توجه: ساخت این اسکریپت نیازمند دانش فنی و تخصصی است. در صورتی که به تیم متخصصی دسترسی ندارید، می‌توانید از طریق بخش «راهنما و پشتیبانی»، درخواست خود را ثبت کنید تا کارشناسان ما، اسکریپت اختصاصی شما را آماده کنند.

توضیحات اولیه

اسکریپت  یکتانت، یک فایل جاوااسکریپتی کوچک است (gzip: 7k) که با استفاده از آن می‌توانید رویدادهای مختلف صفحه را ردیابی کنید. این اسکریپت به‌طور پیش‌فرض تنها اطلاعات مربوط به بازدید صفحه را استخراج می‌کند و هیچ اطلاعات دیگری را استخراج نمی‌کند.

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

پیش‌نیازها

در این مستند، فرض شده است که شما از موارد زیر اطلاعات مقدماتی دارید:

• JavaScript
  • query selector
  • JS variable types
  • JSON format
• html
  • html tags
  • meta
  • html item props

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

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

API جزئیات محصول

از این API برای ارسال اطلاعات محصولات وب‌سایت خود استفاده کنید. در صورتی که از طریق این API اطلاعات موردنظر را به یکتانت ارسال کنید، می‌توانید از طریق پنل یکتانت کمپین‌های محصول بسازید.

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

یک مثال

از طریق این API، شما می‌توانید اطلاعات محصولات خود را به یکتانت ارسال کنید. نمونه‌ای از نحوهٔ صدازدن این API در قطعه کد زیر نمایش داده شده است:

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

API

تمامی اطلاعاتی که از طریق API ثبت محصول یکتانت قابل ارسال است، در زیر آمده است:

در قسمت زیر، هر کدام از پارامترهای productInfo توضیح داده شده است:

در جدول زیر، یک نمونه را مشاهده می‌کنید:

استخراج اطلاعات از صفحه

• آماده‌سازی اطلاعات از بک‌اند

اگر تیم فنی شما می‌تواند اطلاعات لازم را در یک قالب مشخص json در اختیار شما قرار دهد، کافی است که این اطلاعات از سمت بک‌اند در یک object ذخیره شوند و در صفحهٔ موردنظر در وب‌سایت تحویل داده شود و از طریق yektanet(“product”, “detail”, productInfo) اطلاعات به یکتانت ارسال شود که productInfo همان object ایجادشده از سمت بک‌اند است.

• استخراج sku

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

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

لازم به ذکر است که این روش تنها به حالت محدود همراه است و ممکن است خطاهایی داشته باشد؛ بنابراین همیشه سعی کنید sku محصولات خود را داشته باشید و در صفحات خود قرار دهید.

• استخراج عنوان

معمولاً عنوان محصول خود را می‌توانید از راه‌های زیر پیدا کنید:

• facebook/twitter meta tag:
  • document.querySelector(‘meta[property=”og:title”]’).content
  • document.querySelector(‘meta[property=”twitter:title”]’).content
• title tags
  • document.querySelector(‘title’).text

• first h1 or h2 of the page
  • document.querySelector(‘h1’).text
  • document.querySelector(‘h2’).text

• استخراج expiration

این فیلد باید به‌صورت یک timestamp ارسال شود؛ به‌عنوان مثال، اگر محصول شما در تاریخ ۲۳ اکتبر ۲۰۱۸ تمام می‌شود، می‌توانید از new Date(2018, 10, 23).getTime() استفاده کنید و فیلد را به صورت expiration: new Date(2018, 10, 23).getTime() یا expiration: 1542918600000 بفرستید.

API خرید محصول

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

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

یک مثال

نمونه‌ای از نحوه‌ی صدا زدن این API در قطعه کد زیر نمایش داده شده است.

این قطعه کد، اطلاعات مربوط به خرید یک محصول را از سوی یک کاربر ارسال می‌کند. در این مثال، کاربری دو محصول با شناسه‌ی مشخص را خرید کرده است و بابت این دو محصول، مبلغ ۲۲۶۰۰ تومان پرداخت کرده است.

API

تمامی اطلاعاتی که از طریق API خرید محصول یکتانت قابل ارسال است، در زیر آمده است:

در جدول زیر، هر کدام از پارامترهای purchaseInfo توضیح داده شده است:

یک نمونه را در جدول زیر مشاهده کنید:

به ۲ موضوع زیر دقت کنید:

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

نکات مهم

نکاتی که شما باید در استفاده از APIها رعایت کنید و عدم‌رعایت آن‌ها به باگ یا ارسال اطلاعات نادرست منجر می‌شود، در زیر آمده است:

همیشه در همهٔ APIهای مربوط به محصول، شما باید sku را ارسال کنید. sku شناسهٔ یکتای محصول است که از طریق آن، یکتانت محصول شما را شناسایی می‌کند.

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

محدودیت‌ها

در حال حاضر، حتماً باید اسکریپت کامل یکتانت (rg.complete.js) روی وب‌سایت شما باشد تا بتوانید از قابلیت‌های آنالتیکس یکتانت استفاده کنید.

از طرفی، قیمت تنها به واحد تومان پشتیبانی می‌شود؛ بنابراین باید فیلد price به تومان ارسال شود و فیلد currency همیشه برابر با “IRT” باشد.