رهگیری رویداد های محصولات

ردیابی ویژگی های رویداد پیچیده محصولات

شما در SDK می توانید اتربیوت های ایونت های پیچید تر را به عنوان انواع داده های Array و Object به زبلاین ارسال کنید.

توجه

قبل از مطالعه این بخش، مطمئن شوید که در مورد رویداد های محصولات در بخش مقدمه اطلاعات کافی را دارید.

با راهندازی SDK زبلاین می توانید از طریق مثال زیر اطلاعات مربوط به رویداد محصولات خود را ارسال کنید.

مثال

const addProductEventButton = document.getElementById("add_product_event_button");
button.onclick = () => {
  window.zebline.productEvent.track(<PRODUCT_ID>, <EVENT_NAME>, <EVENT_DATA>);
  // Your code
};

در تابع بالا PRODUCT_ID معادل آیدی یکتایی است که سمت شما برای محصول مورد نظر در نظر گرفته شده است و به عنوان پارامتر اول تابع ارسال می شود.

مقدار EVENT_NAME معادل نام رویداد مورد نظر است که به صورت string می باشد.

EVENT_DATA یک آبجکت شامل دیتای جزئیات رویداد محصول مورد نظر است.

window.zebline.productEvent.track("P01", "watch", {duration: "1h"});

در مثال بالا یک رویداد محصول به نام watch داریم که برای محصول P01 است و در اطلاعات جزئیاتش {duration: "1h"} وجود دارد.

ساختار ایونت:

ایونت ها در زبلاین در قالب یک فایل JSON دریافت و ذخیره میشوند.هر رویداد محصول دارای چهار بخش اصلی است:

{
    "productId": "value",
    "eventName": "value",
    "eventTime": "2019-12-09T11:29:00",
    "eventData": {
        "1st-data": "value",
        "2nd-data": "value",
        "3rd-data": "value"
    }
}

نکته مهم

مقدار eventTime توسط خود SDK ارسال میگردد و نیازی به فرستادن آن نیست.

توضیحات

• هر رویداد محصول باید نامی با حداکثر 50 کاراکتر داشته باشد.
• مقادیر برای eventData میتواند فقط شامل String, Number, Boolean, Date, JSON Array, JSON Object. JSON Object باشد.
• هر رویداد حداکثر میتواند 25 عدد پارامتر خصوصیت در خود داشته باشد.

نکات مهم در ارسال دیتای رویداد های محصول

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

مقادیری که عددی هستند را سعی کنید همیشه به صورت عددی و با تایپ number بفرستید.