اسکریپت آنالتیکس یکتانت

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

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

اگر تیم فنی شما می‌تواند اطلاعات لازم را در یک قالب مشخص 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

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

تمامی مواردی که از طریق API ثبت محصول یکتانت می‌توانید ارسال کنید، در بالا آمده است. در قسمت زیر، هر کدام از پارامترهای purchaseInfo توضیح داده شده است: