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

توجه

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

پس از نصب کامل و صحیح SDK، در کل وب سایت شما و در Global Scope یک مشخصه به نام zebline در دسترس قرار میگیرد که میتوانید از طریق window.zebline آن را فراخوانی کنید.

ارسال اطلاعات محصول

برای ارسال اطلاعات محصولات خود می بایست در زمانی که محصول به وب سایت شما اضافه می شود تابع مورد نظر برای ارسال اطلاعات آن را برای زبلاین ارسال کنید:

مثال

const addProductButton = document.getElementById("add_product_button");
button.onclick = () => {
  window.zebline.product.track(<PRODUCT_ID>,<USERID>,<PROPERTIES>);
  // Your code
};

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

USERID معادل آیدی کاربر مورد نظر است, اگر محصول مورد نظر برای کاربر خاصی است، مثلا ویدیوی آپلود شده توسط یک کاربر. در غیر اینصورت میتوان به آن مقدار null تخصیص داد.

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

window.zebline.product.track("P01","TX55",{name: "Product 01"});

در مثال بالا محصولی داریم با productId = P01 و این محصول برای کاربری است با userId = TX55 و خصوصیات این محصول هم {name: 'Product 01'} است.

window.zebline.product.track("P02",null ,{name: "Product 02"});

در مثال بالا محصولی داریم که productId = P02 و این محصول یک محصول کلی است که متعلق به هیچ کاربر خاصی نمی باشد در نتیجه مقدار userId = null است و سپس به عنوان پارامتر آخر هم {name: "Product 02"} است.

توضیحات

• هر productId و userId می توانند حداکثر 100 کاراکتر داشته باشند.
• بعد از تخصیص یک userId، و productId دیگر نمی توان آن را تغییر داد.

نکات مهم در ارسال دیتای کاربر

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

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