در میان جوامع SaaS در توییتر، لینکدین، ردیت، دیسکورد بگردید، آن را نام ببرید و یک موضوع مشترک را در بسیاری از آنها خواهید دید. این موضوع میتواند با نامهای زیادی باشد: BI، تجزیه و تحلیل، بینش و غیره. طبیعی است، ما تجارت می کنیم، داده جمع آوری می کنیم، موفق می شویم یا شکست می خوریم. ما میخواهیم همه آنها را بررسی کنیم، اطلاعاتی را که داریم درک کنیم و اقدام کنیم. این نیاز پروژه ها و ابزارهای زیادی را ایجاد کرده است که زندگی هر کسی را که می خواهد به داده ها نگاه کند کمی آسان تر می کند. اما، وقتی انسان ها داشته باشند، انسان ها بیشتر می خواهند. و در دنیای BI و تجزیه و تحلیل، "بیشتر" اغلب به شکل جاسازی، نام تجاری، استایل سفارشی و دسترسی و غیره می آید. که در نهایت به معنای کار بیشتر برای توسعه دهندگان و زمان بیشتری برای حسابرسی است. بنابراین، طبیعتاً نیاز به ابزارهای BI وجود داشته است که به شما امکان می دهد همه چیز را داشته باشید.
بیایید فهرستی از چالشهایی که ممکن است بهعنوان سازنده و نگهدارنده این داشبوردها با آنها مواجه شوید، تهیه کنیم:
- میخواهید داشبوردها را از داخل برنامه یا پلتفرم خود در دسترس کاربران نهایی یا بینندگان قرار دهید
- شما می خواهید بتوانید مجموعه های مختلف داشبورد را مدیریت کنید (یعنی "ادغام ها")
- شما می خواهید بتوانید حقوق کاربر خاصی را به مجموعه ای از داشبوردها و مجموعه داده ها اعطا کنید
- شما می خواهید مطمئن شوید که کاربران فقط به داده های مربوط به آنها دسترسی دارند
Cumul.io ابزاری را فراهم می کند که ما آن را صدا می زنیم یکپارچگی که به حل این چالش ها کمک می کند. در این مقاله به شما توضیح میدهم که ادغامها چیست و چگونه آن را راهاندازی کنید. نکته جالب این است که برای اکثر نقاط بالا، حداقل کد مورد نیاز است و در بیشتر موارد می توان آن را در داخل تنظیم کرد Cumul.io UI
برخی از پیشینه - ادغام
An ادغام در Cumul.io ساختاری است که مجموعه ای از داشبوردها را تعریف می کند که قرار است با هم استفاده شوند (مثلاً در یک برنامه). همچنین همان چیزی است که ما از آن استفاده می کنیم جاسازی کردن داشبوردها در یک برنامه کاربردی به عبارت دیگر، برای جاسازی داشبوردها در یک برنامه، به برنامه دسترسی به یکپارچهسازی آنها را میدهیم. میتوانید داشبوردها را به یک ادغام مرتبط کنید و مدیریت کنید که کاربران نهایی ادغام چه نوع حقوق دسترسی روی این داشبوردها و مجموعه دادههایی که استفاده میکنند دارند. داشبورد ممکن است بخشی از چند ادغام باشد، اما ممکن است در ادغام های مختلف دارای حقوق دسترسی متفاوتی باشد. وقتی صحبت از جاسازی به میان میآید، تعدادی SDK در دسترس هستند تا زندگی را بدون توجه به ظاهر پشته شما ساده کنند. 😊
هنگامی که یک حساب Cumul.io دارید و اگر "مالک" یک سازمان در Cumul.io هستید، میتوانید از طریق تب Integrations همه ادغامهای خود را مدیریت و نگهداری کنید. بیایید نگاهی به یک نمونه حساب Cumul.io بیندازیم. در زیر می توانید داشبوردهایی را که ممکن است یکی از کاربران Cumul.io ایجاد کرده باشد مشاهده کنید:
اگرچه اینها همه داشبوردهایی هستند که این کاربر ممکن است ایجاد کرده باشد، به احتمال زیاد همه داشبوردها برای یک کاربر نهایی یا یک برنامه کاربردی در نظر گرفته نشده اند. بنابراین، صاحب این حساب Cumul.io یک ادغام (یا بیشتر!) ایجاد و نگهداری می کند 💪 بیایید نگاهی به این موضوع بیندازیم که ممکن است برای آنها چگونه باشد:
بنابراین، به نظر می رسد که صاحب این حساب Cumul.io دو برنامه جداگانه را حفظ می کند.
حال بیایید ببینیم روند ایجاد یکپارچگی و جاسازی داشبورد آن در یک برنامه چگونه خواهد بود. خبر خوب این است که همانطور که قبلا ذکر شد، بسیاری از مراحلی که باید بردارید را می توان در رابط کاربری Cumul.io انجام داد.
سلب مسئولیت: برای اهداف این مقاله، من فقط بر بخش یکپارچه سازی تمرکز می کنم. بنابراین، من از هر کاری که مربوط به ایجاد و طراحی داشبورد باشد صرف نظر می کنم و با مجموعه ای از داشبوردهای خیالی از پیش ساخته شده شروع می کنیم.
کاری که ما انجام خواهیم داد:
ایجاد یکپارچگی
برای سادگی، اجازه دهید در حال حاضر فقط یک ادغام ایجاد کنیم. بیایید تصور کنیم که یک پلتفرم تحلیلی داریم که برای شرکت خود نگهداری می کنیم. سه داشبورد وجود دارد که می خواهیم در اختیار کاربران نهایی خود قرار دهیم: داشبورد بازاریابی، داشبورد فروش و داشبورد سرنخ ها.
بیایید بگوییم که از بین تمام داشبوردهایی که این حساب ایجاد کرده یا به آنها دسترسی دارد، برای این پروژه خاص فقط میخواهند از موارد زیر استفاده کنند:
ادغام جدید
برای ایجاد ادغام، به تب Integrations رفته و New Integration را انتخاب می کنیم. دیالوگی که ظاهر می شود قبلاً به شما ایده ای از اقدامات بعدی شما می دهد:
انتخاب داشبوردها
در مرحله بعد، می توانید انتخاب کنید که کدام یک از داشبوردهای شما در این ادغام گنجانده شود. شما همچنین میتوانید نامی برای یکپارچهسازی بگذارید، که در اینجا من تصمیم گرفتم که بهطور مناسب «ادغام بسیار مهم» باشد:
هنگامی که انتخاب خود را تأیید کردید، این گزینه را خواهید داشت که برای هر داشبورد یک اسلگ تعریف کنید (به شدت توصیه می شود). اینها بعداً می توانند هنگام جاسازی داشبوردها در برنامه شما استفاده شوند. بعداً خواهید دید که اسلاگ ها ارجاع به داشبوردها در کد جلویی شما را آسان می کنند و در صورت نیاز جایگزینی داشبورد را نیز آسان می کنند (زیرا نیازی نیست نگران شناسه های داشبورد در کد جلویی باشید).
حقوق دسترسی
سپس می توانید حقوق دسترسی ادغام را برای مجموعه داده هایی که داشبورد آن استفاده می کند تنظیم کنید. در اینجا ما این را روی "می توانم مشاهده کنم" تنظیم می کنیم. برای اطلاعات بیشتر در مورد حقوق دسترسی و آنچه که مستلزم آن است، ما را بررسی کنید مرتبط کردن مجموعه داده ها به ادغام ها:
فیلترها و پارامترها (و دسترسی چند مستاجر)
نکته جانبی: برای کمک به دسترسی چند مستاجر - که در این راهاندازی خیالی منطقی است - Cumul.io تنظیم پارامترها و فیلترها را در مجموعه دادههایی که داشبورد استفاده میکند ممکن میسازد. این بدان معناست که هر کاربری که وارد پلتفرم تجزیه و تحلیل شما میشود، فقط دادههایی را که شخصاً به آنها دسترسی دارند در داشبوردها میبیند. میتوانید تصور کنید که در این سناریو، دسترسی بر اساس بخشهایی است که کاربر نهایی در شرکت کار میکند. برای اطلاعات بیشتر در مورد نحوه راه اندازی چند اجاره با Cumul.io، مقاله ما را بررسی کنید. "Multi-Tenancy در داشبوردهای Cumul.io با Auth0". این را می توان در فرآیند طراحی داشبورد انجام داد (که ما از آن صرفنظر می کنیم)، که تجسم آنچه را که فیلترها انجام می دهند آسان تر می کند. اما در اینجا، ما این فیلترها را در فرآیند ایجاد یکپارچگی تنظیم خواهیم کرد.
در اینجا، فیلترهایی را که مجموعه داده ها ممکن است نیاز داشته باشند را تنظیم می کنیم. در این سناریو، همانطور که بر اساس بخش های کاربران فیلتر می کنیم، a را تعریف می کنیم department
پارامتر و فیلتر بر اساس آن:
و voilà! هنگامی که با تنظیم آن ها تمام شد، با موفقیت یک ادغام ایجاد کرده اید. گفتگوی بعدی به شما دستورالعمل هایی را ارائه می دهد که مراحل بعدی شما برای جاسازی یکپارچه سازی شما چیست:
اکنون می توانید این ادغام کاملاً جدید را در برگه ادغام خود مشاهده کنید. همچنین در اینجاست که به شناسه ادغام دسترسی سریع خواهید داشت که بعداً برای جاسازی داشبوردها استفاده خواهد شد.
خبر خوب! پس از ایجاد ادغام شما، همیشه می توانید آن را ویرایش کنید. میتوانید داشبوردها را حذف یا اضافه کنید، اسلاگهای داشبوردها یا حقوق دسترسی را نیز تغییر دهید. بنابراین لازم نیست نگران ایجاد ادغام های جدید با تغییر و تکامل برنامه خود باشید. و از آنجایی که ویرایش یک ادغام تماماً در UI است، لازم نیست نگران تنظیم مجدد یک توسعه دهنده باشید. کاربران غیر فنی می توانند این ادغام ها را در حال حرکت تطبیق دهند.
جاسازی داشبوردها
بیایید ببینیم به کجا می خواهیم برسیم. ما می خواهیم داشبوردها را در یک برنامه سفارشی ارائه کنیم. ساده، کاربر به یک برنامه وارد می شود، برنامه دارای داشبورد است، آنها داشبوردها را با داده هایی که مجاز به دیدن هستند می بینند. به عنوان مثال می تواند به شکل زیر باشد:
شخصی دید بسیار خاصی در مورد نحوه ارائه داشبوردها به کاربر نهایی داشت. آنها یک نوار کناری می خواستند که در آن بتوانند هر یک از داشبوردها را ورق بزنند. می توانست چیزی کاملاً متفاوت نیز باشد. آنچه ما روی آن تمرکز خواهیم کرد این است که چگونه می توانیم این داشبوردها را بدون در نظر گرفتن ظاهر برنامه میزبان در برنامه خود جاسازی کنیم.
Cumul.io با مجموعه ای از SDK های عمومی در دسترس است. در اینجا من به شما نشان خواهم داد که اگر بخواهید از آن استفاده کنید چه کاری انجام می دهید گره SDK. ما را بررسی کنید اسناد توسعه دهنده برای دیدن سایر SDK ها و دستورالعمل های نحوه استفاده از آنها.
مرحله 1: توکن های SSO را برای کاربران نهایی خود ایجاد کنید
قبل از اینکه بتوانید توکن های SSO را برای کاربران نهایی خود تولید کنید، باید مطمئن شوید که یک کلید و توکن API در Cumul.io ایجاد کرده اید. می توانید این کار را از نمایه Cumul.io خود انجام دهید. باید مالک سازمان با دسترسی به ادغام باشد که این کلید و توکن API را ایجاد کرده و از آن برای ارائه درخواست مجوز SSO استفاده می کند. پس از انجام این کار، اجازه دهید ابتدا یک مشتری Cumul.io ایجاد کنیم که در سمت سرور برنامه انجام می شود:
const Cumulio = require("cumulio"); const client = new Cumulio({ api_key: '<YOUR API KEY>', api_token: '<YOUR API TOKEN>',
});
اکنون می توانیم توکن SSO را برای کاربر نهایی ایجاد کنیم. برای اطلاعات بیشتر در مورد این تماس API و فیلدهای مورد نیاز، ما را بررسی کنید مستندات توسعه دهنده در تولید SSO نشانه.
let promise = client.create('authorization', { integration_id: '<THE INTEGRATION ID>', type: 'sso', expiry: '24 hours', inactivity_interval: '10 minutes', username: '< A unique identifier for your end user >', name: '< end-user name >', email: '< end-user email >', suborganization: '< end-user suborganization >', role: 'viewer', metadata: {}
});
در اینجا، توجه کنید که چگونه گزینه اختیاری را اضافه کرده ایم metadata
رشته. اینجاست که میتوانید پارامترها و مقادیری را که میخواهید مجموعه دادههای داشبورد را روی آنها فیلتر کنید، ارائه کنید. در مثالی که از آن عبور کردهایم، بر اساس بخش فیلتر شدهایم، بنابراین این را به ابرداده اضافه میکنیم. در حالت ایده آل می توانید این اطلاعات را از ارائه دهنده احراز هویتی که استفاده می کنید دریافت کنید. a را ببینید توضیح مفصل در مورد نحوه انجام این کار با Auth0.
این درخواست یک شی JSON را برمی گرداند که حاوی شناسه و نشانه مجوز است که بعداً به عنوان ترکیب کلید/ژتون برای جاسازی داشبوردها در سمت مشتری استفاده می شود.
چیز دیگری که می توانید به صورت اختیاری در اینجا اضافه کنید که بسیار جالب است، یک ویژگی CSS است. این به شما امکان می دهد ظاهر و احساس سفارشی را برای هر کاربر (یا گروه کاربری) تعریف کنید. برای همان برنامه، داشبورد بازاریابی برای آنجلینا در مقابل براد به این صورت است:
مرحله 2: جاسازی
آنجا کمی جلوتر پریدیم. ما توکنهای SSO را برای کاربران نهایی ایجاد کردیم، اما هنوز داشبوردها را در برنامه جاسازی نکردهایم. بیایید نگاهی به آن بیندازیم. ابتدا باید آن را نصب و وارد کنید جزء وب.
import '@cumul.io/cumulio-dashboard';
پس از وارد کردن کامپوننت، می توانید از آن به عنوان یک تگ HTML استفاده کنید. این جایی است که شما داشبوردهای خود را جاسازی خواهید کرد:
<cumulio-dashboard dashboardId="< a dashboard id >" dashboardSlug="< a dashboard slug >" authKey="< SSO key from step 1 >" authToken="< SSO token from step 1 >">
</cumulio-dashboard>
در اینجا شما چند گزینه خواهید داشت. میتوانید شناسه داشبورد را برای هر داشبوردی که میخواهید جاسازی کنید ارائه کنید، یا میتوانید داشبورد را که در تنظیمات ادغام تعریف کردهایم ارائه کنید (به همین دلیل است که من این کار را به شدت توصیه میکنم، انجام این کار بسیار خواناتر است). برای اطلاعات دقیق تر در مورد نحوه جاسازی داشبوردها، می توانید ما را نیز بررسی کنید مستندات توسعه دهنده.
یک راه خوب برای انجام این مرحله البته فقط تعریف اسکلت مولفه داشبورد در فایل HTML خود و پر کردن بقیه آن از سمت مشتری برنامه شما است. من کارهای زیر را انجام داده ام، اگرچه البته این تنها راه نیست:
من جزء داشبورد را با شناسه اضافه کرده ام dashboard
:
<cumulio-dashboard id="dashboard"></cumulio-dashboard>
سپس، من این مؤلفه را در کد مشتری به صورت زیر بازیابی کردم:
const dashboardElement = document.getElementById("dashboard");
سپس توکن SSO را از سمت سرور برنامهام درخواست میکنم که کلید و توکن مورد نیاز را برای افزودن به مؤلفه داشبورد برمیگرداند. بیایید فرض کنیم که یک تابع wrapper داریم getDashboardAuthorizationToken()
که این کار را برای ما انجام می دهد و پاسخ درخواست توکن SSO سمت سرور را برمی گرداند. بعد، ما به سادگی مولفه داشبورد را مطابق با آن پر می کنیم:
const authorizationToken = await getDashboardAuthorizationToken();
if (authorizationToken.id && authorizationToken.token) { dashboardElement.authToken = authorizationToken.token; dashboardElement.authKey = authorizationToken.id; dashboardElement.dashboardSlug = "marketing|sales|leads";
}
توجه داشته باشید که چگونه در مراحل قبلی انتخاب کردم که برای داشبوردهای خود اسلاگ تعریف کنم که بخشی از این ادغام هستند. این بدان معنی است که می توانم از جستجوی شناسه های داشبورد و افزودن آن اجتناب کنم dashboardId
به عنوان یکی از پارامترهای من از dashboardElement
. در عوض من فقط می توانم یکی از راب ها را تهیه کنم marketing
, sales
or leads
و من تمام کردم! البته شما باید نوعی فرآیند انتخاب را برای برنامه خود تنظیم کنید تا تصمیم بگیرید کجا و چه زمانی کدام داشبورد را جاسازی کنید.
همین مردمی! ما با موفقیت یک ادغام را در Cumul.io ایجاد کردیم و در چند خط کد، توانستیم داشبوردهای آن را در برنامه خود جاسازی کنیم 🎉 حالا سناریویی را تصور کنید که در آن باید چندین برنامه را به طور همزمان نگهداری کنید. همان شرکت یا شرکت های جداگانه سناریوی شما هر چه باشد، مطمئنم می توانید تصور کنید که اگر تعدادی داشبورد داشته باشید که در آن هر یک از آنها باید به مکان های مختلف بروند و هر کدام از آنها بسته به جایی که هستند و در و یا در حال رفتن باید حقوق دسترسی متفاوتی داشته باشند. .. چگونه می تواند به سرعت از کنترل خارج شود. یکپارچهسازیها به شما این امکان را میدهند که این کار را به روشی ساده و منظم، همه در یک مکان، و همانطور که میبینید، بیشتر از داخل Cumul.io UI مدیریت کنید.
کارهای بسیار بیشتری می توانید در اینجا انجام دهید که ما به تفصیل آنها را بررسی نکرده ایم. مانند اضافه کردن تم های سفارشی خاص کاربر و CSS. همچنین نحوه تنظیم پارامترها و فیلترها در داشبورد یا نحوه استفاده از آنها را در برنامه میزبان خود به گونه ای که یک راه اندازی چند مستاجر داشته باشید، بررسی نکردیم. در زیر می توانید پیوندهایی به آموزش های مفید و مستندات مربوط به این مراحل را در صورت علاقه پیدا کنید.
منبع: https://css-tricks.com/embedded-analytics-made-simple-with-cumul-io-integrations/
- '
- "
- &
- 11
- 7
- 9
- 98
- دسترسی
- حساب
- عمل
- معرفی
- علم تجزیه و تحلیل
- API
- نرم افزار
- کاربرد
- برنامه های کاربردی
- مقاله
- تصدیق
- مجوز
- بیت
- علامت گذاری
- سازنده
- کسب و کار
- صدا
- تغییر دادن
- رمز
- مشترک
- جوامع
- شرکت
- جزء
- ایجاد
- داشبورد
- داده ها
- طرح
- جزئیات
- توسعه دهنده
- توسعه دهندگان
- اختلاف
- پست الکترونیک
- به پایان می رسد
- چهره
- زمینه
- فیلترها برای تصفیه آب
- نام خانوادگی
- تمرکز
- فرم
- تابع
- خوب
- گروه
- اینجا کلیک نمایید
- چگونه
- چگونه
- HTTPS
- انسان
- اندیشه
- واردات
- اطلاعات
- اطلاعات
- بینش
- ادغام
- یکپارچگی
- IT
- جاوا اسکریپت
- کلید
- لینک
- فهرست
- بازار یابی (Marketing)
- نام
- مرتب
- اخبار
- گزینه
- گزینه
- کدام سازمان ها
- دیگر
- مالک
- سکو
- ساخته
- مشخصات
- پروژه
- پروژه ها
- ویژگی
- ق
- پاسخ
- REST
- بازده
- SAAS
- حراجی
- حس
- تنظیم
- محیط
- ساده
- So
- حل
- حمایت مالی
- جهان
- موضوع
- زمان
- رمز
- نشانه
- آموزش
- توییتر
- ui
- us
- کاربران
- چشم انداز
- دید
- WHO
- در داخل
- کلمات
- مهاجرت کاری
- با این نسخهها کار
- جهان