توضیحات اولیه
اسکریپت تجزیه و تحلیل منحصر به فرد یک فایل جاوا اسکریپت کوچک (gzip: 7k) است که می توانید از آن برای ردیابی رویدادهای مختلف در صفحه استفاده کنید. به طور پیش فرض، این اسکریپت فقط اطلاعات مربوط به بازدیدهای صفحه را بازیابی می کند و نه اطلاعات دیگری. با استفاده از پنل Ektan می توانید تگ های مختلفی ایجاد کنید و اطلاعات مورد نظر را از طریق Ektan API ذخیره کرده و در کمپین های خود استفاده کنید.
پیش نیازها
این سند فرض می کند که شما دانش اولیه ای از موارد زیر دارید:
- جاوا اسکریپت
- انتخابگر پرس و جو
- انواع متغیر JS
- فرمت JSON
- html
- تگ های html
- متا
- عناصر html
اگر در مورد موارد فوق اطلاعی ندارید، لطفاً قبل از خواندن این سند در مورد آنها مطالعه کنید.
توجه
همه APIهای فهرست شده در زیر باید از سمت مشتری وب سایت فراخوانی شوند. از آنجایی که Ektant از کوکی‌ها برای شناسایی کاربران استفاده می‌کند، لازم است همه این APIها در سمت مشتری فراخوانی شوند.
مشتریان را بازگردانید و فروش خود را با تبلیغات منحصر به فرد هدف‌گیری مجدد محصول افزایش دهید!
شروع به تبلیغات کنید
API برای جزئیات محصول
شرح
از این API برای ارسال اطلاعات محصول به وب سایت خود استفاده کنید. اگر اطلاعات مورد نظر را از طریق این API برای اکتان ارسال کنید، می توانید از طریق داشبورد اکتان کمپین های محصول ایجاد کنید. این کمپین ها نیازی به ایجاد محتوا یا بنر ندارند و به طور خودکار اطلاعات محصول را در وب سایت شما از طریق این API بازیابی می کنند و به مشتریان هدف شما نمایش می دهند.
یک مثال
از طریق این API می توانید اطلاعات محصولات خود را برای یکتان ارسال کنید. نمونه ای از نحوه فراخوانی این API در قطعه کد زیر نشان داده شده است:
این قسمت از کد اطلاعات محصول “رب گوجه فرنگی” را برای اکتان ارسال می کند. این اطلاعات که در بالا قابل مشاهده است شامل عنوان، شناسه محصول، دسته بندی محصول، قیمت محصول (به تومان و بعد از تخفیف)، برند محصول، درصد تخفیف محصول، تصویر محصول و موجود بودن یا نبودن محصول می باشد.
API
تمام اطلاعاتی که می توان از طریق API محصول Ektan ارسال کرد در زیر فهرست شده است:
همه مواردی که می توانید از طریق API ثبت محصول Ektonet ارسال کنید در بالا لیست شده است. بخش زیر هر یک از پارامترهای productInfo را توضیح می دهد:
| یادداشت های مهم | شرح | این لازم است | ارزش-t | زمینه محصول |
| این مدرک هویتی باید ارائه شود؛ در غیر این صورت اطلاعاتی که ارسال می کنید مورد قبول یکتان نخواهد بود. | شناسه منحصر به فرد محصول هر محصول یک شناسه دارد. اگر نمی توانید شناسه محصول را پیدا کنید، از بخش راهنمای شناسه محصول استفاده کنید. | آره | یک رشته | sku |
| می توانید نحوه پیدا کردن عنوان محصول خود را با استفاده از راهنمای بازیابی عنوان محصول مشاهده کنید. | عنوان محصول شما، به عنوان مثال “لپ تاپ لنوو AC73” یا “پوشک بچه بزرگ” می تواند عنوان محصول قابل فروش شما باشد. | برای هدف گذاری مجدد کمپین ها | یک رشته | عنوان |
| URL تصویر محصول شما. توجه داشته باشید که باید این آدرس را به صورت کامل همراه با پروتکل و دامنه وبسایت ارسال کنید. | برای هدف گذاری مجدد کمپین ها | یک رشته | تصویر | |
| لیست دسته هایی که محصول به آن تعلق دارد. با ارسال این اطلاعات می‌توانید کمپین‌های هدف‌گیری مجدد خود را هدفمندتر کنید و فقط دسته‌های خاصی را هدف قرار دهید. همچنین در این صورت اطلاعات تحلیلی مفیدی در مورد دسته های کاربری و محبوب در اختیار شما قرار می گیرد. | لیستی از رشته ها | دسته بندی | ||
| توجه داشته باشید که این قیمت در حال حاضر به تومان ارسال می شود. | عدد صحیح | قیمت | ||
| این فیلد باید به صورت شناور ارسال شود و درصد تخفیف محصول را مشخص کند. | درصد تخفیف محصول شما اگر محصول شما تخفیف ندارد، می توانید این قسمت را خالی بگذارید یا آن را بازنشانی کنید. | من دریانوردی هستم | تخفیف | |
| مقادیر معتبر برای این فیلد
“IRT” |
ارزی که در قسمت قیمت مشخص کردید. در حال حاضر فقط تومان پشتیبانی می شود و باید آن را به عنوان “IRT” ارسال کنید. | یک رشته | واحد پول | |
| برند محصول شما | یک رشته | نام تجاری | ||
| اگر کاربران بتوانند محصولات شما را رتبه بندی کنند، می توانید میانگین امتیاز کاربر را از طریق این قسمت به عنوان یک متغیر شناور ارسال کنید. توجه داشته باشید که امتیاز کاربر باید بین یک تا پنج باشد. بنابراین اگر از سیستم رتبه‌بندی متفاوتی استفاده می‌کنید، قبل از ارسال، مقیاس را بین یک تا پنج تغییر دهید. | من دریانوردی هستم | صدای میانی | ||
| عدد صحیح | کل آرا | |||
| این قسمت نشان می دهد که آیا محصول در حال حاضر در فروشگاه حمل و نقل موجود است یا خیر. اگر محصول در دسترس نباشد، محصول در کمپین های هدف گذاری مجدد ظاهر نمی شود. | بولی | موجود است | ||
| با استفاده از راهنمای استخراج فیلد انقضا، می توانید اطلاعات پایان فروش یک محصول را مشخص کنید. | فروش محصولات شما ممکن است محدود شود. به عنوان مثال، فروش یک تور می تواند تا تاریخ خاصی انجام شود. شما می توانید تاریخ پایان محصول را از طریق این فیلد ارسال کنید تا محصول شما پس از آن تاریخ در کمپین های هدف گیری مجدد شما ظاهر نشود. | عدد صحیح | نشتی |
| زمینه محصول | نمونه |
| sku | “D-8356-fx56” |
| عنوان | “قوطی بزرگ رب گوجه فرنگی” |
| تصویر | مثال های صحیح:
نمونه های نامعتبر: yourWebsite.com/images/awesomeImage.jpg /images/wesomeImage.jpg awesomeImage.jpg |
| دسته بندی | [“وسایل الکترونیکی”, “کامپیوترهای شخصی”, “لپ‌تاپ”] |
| قیمت | 256320 |
| تخفیف | 27 |
| واحد پول | “IRT” |
| نام تجاری | گوچی |
| صدای میانی | 3.6 |
| کل آرا | 125 |
| موجود است | درست است، واقعی |
| نشتی | 1542918600000 |
استخراج اطلاعات از صفحه
تهیه اطلاعات از باطن
اگر تیم فنی شما می تواند اطلاعات مورد نیاز را با فرمت json خاص در اختیار شما قرار دهد، کافی است این اطلاعات را در یک شی در باطن ذخیره کرده و به صفحه مورد نظر وب سایت و از طریق yektanet(“product”, ” جزئیات”، productInfo) اطلاعاتی برای شما ارسال می شود که productInfo همان شیء ایجاد شده توسط سمت باطن است.
استخراج sku
شناسه محصول یک رشته منحصر به فرد است که برای هر محصول ثابت و خاص است. این فیلد اجباری است و اکتانت محصولات شما را از طریق آن شناسایی می کند. شما باید شناسه محصول خود را ارسال کنید، اما اگر مطمئن هستید که اصلا شناسه محصول ندارید و نمی توانید آن را ایجاد کنید، می توانید از قطعه کد زیر به عنوان Sku استفاده کنید. لازم به ذکر است که این روش فقط در حالت محدود کار می کند و ممکن است دارای خطا باشد، پس سعی کنید همیشه اسکوس محصولات خود را داشته باشید و در صفحات خود قرار دهید.
عنوان را بازیابی کنید
معمولاً می توانید عنوان محصول خود را به روش های زیر پیدا کنید:
- متا تگ فیس بوک / توییتر:
- document.querySelector(‘meta[property=”og:title”]’).محتوا
- document.querySelector(‘meta[property=”twitter:title”]’).محتوا
- تگ های سرصفحه
- document.querySelector(‘title’).text
- اولین h1 یا h2 صفحه
- document.querySelector(‘h1’).text
- document.querySelector(‘h2’).text
استخراج نشت
این فیلد باید به عنوان مهر زمانی ارسال شود. به عنوان مثال، اگر محصول شما در 23 اکتبر 2018 منقضی می شود، می توانید از new Date(2018, 10, 23).getTime() استفاده کنید و قسمت انقضا را روی: new Date(2018, 10, 23).getTime() تنظیم کنید. یا نشت را ارسال کنید: 1542918600000.
API برای خرید محصولات
شرح
از طریق این API می توانید اعلام کنید که یک کاربر محصولی را خریداری کرده است. در این صورت، کمپین هدف‌گیری مجدد برای آن کاربر متوقف می‌شود. همچنین می‌توانید از این API برای ارسال اطلاعات خرید به یکتان و استفاده از آن برای سایر کمپین‌های هدف‌گذاری مجدد و هدف‌گیری مجدد خود برای مشتریان ارزشمند خود استفاده کنید.
یک مثال
از طریق این API می توانید اطلاعات محصولات خود را برای یکتان ارسال کنید. نمونه ای از نحوه فراخوانی این API در قطعه کد زیر نشان داده شده است:
این قطعه کد اطلاعاتی را درباره خرید یک محصول توسط کاربر ارسال می کند. در این مثال کاربر دو محصول با شناسه مشخص خریداری کرده و برای این دو محصول 22600 تومان پرداخت کرده است.
API
تمام اطلاعاتی که می توان از طریق API خرید محصول Ektant ارسال کرد در زیر فهرست شده است:
همه مواردی که می توانید از طریق API ثبت محصول Ektonet ارسال کنید در بالا لیست شده است. بخش زیر هر یک از پارامترهای buyInfo را توضیح می دهد:
| یادداشت های مهم | شرح | این لازم است | نوع ارزش | زمینه محصول |
| این مدرک هویتی باید ارائه شود؛ در غیر این صورت اطلاعاتی که ارسال می کنید مورد قبول یکتان نخواهد بود. | شناسه منحصر به فرد محصول هر محصول یک شناسه دارد. اگر نمی توانید شناسه محصول را پیدا کنید، از بخش راهنمای شناسه محصول استفاده کنید. | آره | یک رشته | sku |
| تعداد محصولات خریداری شده توسط کاربر. این فیلد باید به صورت عدد صحیح ارسال شود. | عدد صحیح | تعداد | ||
| توجه داشته باشید که این قیمت در حال حاضر به تومان ارسال می شود. | قیمت کالای ارسالی که باید عدد صحیح باشد. توجه داشته باشید که در حال حاضر این قیمت باید به تومان ارسال شود و کل قیمتی که کاربر برای این محصول پرداخت کرده است ارسال شود. به عنوان مثال اگر کاربر 2 نمونه از کالایی را به ارزش 120 هزار تومان خریداری کرده باشد باید 240000 به عنوان ارزش این فیلد ارسال شود. | عدد صحیح | قیمت | |
| مقادیر معتبر برای این فیلد
“IRT” |
ارزی که در قسمت قیمت مشخص کردید. در حال حاضر فقط تومان پشتیبانی می شود و باید آن را به عنوان “IRT” ارسال کنید. | یک رشته | واحد پول |
| نمونه | زمینه محصول |
| “D-8356-fx56” | sku |
| 1 | تعداد |
| 256320 | قیمت |
| “IRT” | واحد پول |
نکته ها
مطمئن شوید که فیلد قیمت کل قیمتی است که کاربر برای خرید تعداد معینی از محصولات پرداخت کرده است.
اگر کاربر محصولات مختلفی را خریداری کرده است، باید اطلاعات مربوط به هر محصول را از طریق API فوق ارسال کنید.
نکات مهم
نکاتی که هنگام استفاده از API باید رعایت کنید و عدم رعایت آنها منجر به خطا یا ارسال اطلاعات نادرست می شود، در زیر فهرست شده است:
همیشه باید sku را در همه APIهای مربوط به محصول ارسال کنید. sku یک شناسه محصول منحصر به فرد است که محصول شما را مشخص می کند.
اگر اطلاعات تصویر و عنوان را ارسال نکنید، اطلاعات محصول شما همچنان در اکتونت ذخیره می شود، اما به دلیل کمبود اطلاعات در این دو زمینه، این محصولات در کمپین های هدف گیری مجدد شما ظاهر نمی شوند.
محدودیت ها
در حال حاضر شما باید اسکریپت کامل Ektonet (rg.complete.js) را در وب سایت خود داشته باشید تا بتوانید از قابلیت های تجزیه و تحلیل Ektonet استفاده کنید.
قیمت در حال حاضر فقط به تومان پشتیبانی می شود. بنابراین فیلد قیمت باید به تومان ارسال شود و فیلد ارز همیشه برابر با «IRT» باشد.
