داده‌های سفارشی کاربر ویرایش

نکته : از این کتابخانه تا آخر سال ۹۸ پشتیبانی می‌شود (فقط به صورت Bug Fix)؛ بنابراین برای استفاده کتابخانه چابک در فریم‌ورک React Native لطفا به مستندات کتابخانه (React Native (bridge ما مراجعه کنید.

در این صفحه می‌توانید برای کاربرانتان اطلاعات، ویژگی‌ها (attributes) و تگ اضافه کنید. ثبت اطلاعات هر کاربر به تعامل شما با او کمک می‌کند طوری که می‌توانید پیام‌های شخصی‌سازی شده برایشان ارسال کنید.

مدیریت اطلاعات کاربر (User Attributes)

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

ثبت اطلاعات کاربر

شما می‌توانید اطلاعاتی که از کاربر دارید (مانند نام، نام خانوادگی، جنسیت، سن و …) را به طور دلخواه با استفاده از متد زیر، در پروفایل او ثبت کنید:

this.chabok.setUserAttributes({
                firstName: 'مهدی',
                lastName: 'یعقوبی',
                age: 19,
                gender: 'مرد'
            });

پس از فراخوانی این متد و ثبت اطلاعات می‌توانید آن را در پنل > جزئیات دستگاه > کارت اطلاعات کاربر مانند زیر مشاهده کنید:

نکته : در صورتی که از ویژگی (phone (Attribute استفاده کنید، می‌توانید با smart API چابک اقدام به ارسال پیامک کنید. فقط دقت داشته باشید که شماره همراه کاربر با کد کشور او شروع شود؛ به عنوان مثال ***۹۸۹۱۲۰۴۹۸.

نکته : دقت داشته باشید type مقداری که به value در متد setUserAttributes داده‌اید، را نمی‌توانید تغییر دهید . به این معنی که اگر boolean ذخیره کرده‌اید، دیگر نمی‌توانید عدد یا string دهید یا برعکس. به مثال زیر توجه کنید.

به عنوان مثال اگر مقدار age را مانند زیر string قرار داده باشید:

this.chabok.setUserAttributes({
                age: 'نوزده'
            });

دیگر عدد قرار دادن آن مانند زیر کار نخواهد کرد:

this.chabok.setUserAttributes({
                age: 19
            });

دریافت اطلاعات کاربر

برای دریافت اطلاعت کاربر متد زیر را فراخوانی کنید:

this.chabok.getUserAttributes()

نکته: در نسخه‌های ۱.۴.۰ یا پایین‌تر از متد زیر استفاده کنید:

this.chabok.setUserInfo({
                firstName: 'مهدی',
                lastName: 'یعقوبی',
                age: 19,
                gender: 'مرد'
            });

افزایش داده‌های کمیتی کاربر

شما می‌توانید داده‌های کمیتی کاربر را مانند بازدید از محصول یا صفحه‌ای، خرید آیتم خاصی و .. را به تعداد دلخواهتان افزایش دهید. برای این کار متد زیر را فراخوانی کنید:

this.chabok.incrementUserAttribute('visit_comedy_shows');

همچنین این متد از آرایه‌ای از اطلاعات کاربر (attribute) هم پشتیبانی می‌کند. به نمونه زیر دقت کنید:

this.chabok.incrementUserAttribute(['comedy_movie', 'workout'])

کد بالا به هر کدام از attributeها یک عدد اضافه می‌کند.

برای اضافه کردن تعداد دلخواه به چند attribute می‌توانید از کد زیر استفاده کنید:

this.chabok.incrementUserAttribute({workout: 10, size: 40})

مدیریت تگ‌ها

یکی از قوانین سگمنت، تگ یا همان برچسب‌گذاری کاربران می‌باشد. به عنوان مثال می‌توانید کاربران خود را بر اساس جنسیت برچسب‌گذاری کرده و به آن‌ها پیام خاصی را ارسال کنید و یا به کاربرانی که از پرداخت درون برنامه‌ای شما استفاده می‌کنند یک Tag با عنوان Premium_User اختصاص دهید.

افزودن تگ

با استفاده از متد زیر، شما می‌توانید به کاربر فعلی یک Tag اختصاص دهید :

chabok.addTag("Premium_User")

اگر هم می‌خواهید به کاربرتان چند Tag یکجا اضافه کنید، می‌توانید از کد زیر استفاده کنید:

chabok.addTags("Premium_User", "Male", "Teenage")

همچنین می‌توانید با استفاده از این متد، از افزودن و یا خطا در عملیات با خبر شوید :

this.chabok.addTag(this.state.tagName)
                .then(({count}) => {
                    alert(this.state.tagName + ' tag was assign to ' + this.getUserId() + ' user with '+ count + ' devices');
                })
                .catch(_ => console.warn("An error happend adding tag ..."));

اگر عملیات افزودن تگ با موفقیت انجام شود، می‌توانید از طریق پنل چابک، تگ اضافه شده به کاربر را در بخش مشترکین همانند تصویر زیر مشاهده کنید :

حذف تگ

با استفاده از متد زیر، می‌توانید یک Tag خاص از کاربر فعلی را حذف کنید :

chabok.removeTag("Premium_User")

اگر هم می‌خواهید به کاربرتان چند Tag یکجا حذف کنید، می‌توانید از کد زیر استفاده کنید:

chabok.removeTags("Premium_User", "Male", "Teenage")

‌ نکته: برای حذف همه تگ‌های یک کاربر می‌توانید در متد بالا، جای نام تگ‌ها را خالی بگذارید.