Rubens Knowledge Base

The Rubens Admin platform provides a centralized analytics dashboard designed to help brands and retailers understand user behavior and product performance. By exporting and analyzing configuration data, you can derive actionable insights that drive product development and optimize the digital customer journey.

Direct KPI Monitoring: Access Rubens Admin to immediately view an overview of your key performance indicators, including overall views, conversions, AR views, saved configurations, saved user drafts, and 3D exports. This real-time dashboard provides a snapshot of your project's health and user engagement levels at a single glance.

Accessing the Analytics Section: Click the Analytics link located directly under the KPI overview to enter the full analytics module. Within this section, you can define specific time periods to filter your data, allowing for precise reporting and seasonal performance comparisons. You can access this area to download your raw data directly for further processing in external tools or internal databases.

Saved User Drafts: Export the configuration variants that were actively saved by a user as a draft during their session in the Rubens UI. This data highlights work-in-progress designs and helps identify products that require high levels of consideration before a final decision.

Saved Configurations: Export a comprehensive list of configuration variants saved during a user session, which includes active user drafts, AR views, configuration checkouts, and specific product requests. This is the most robust data set for understanding successful user journeys and final product preferences.

Views: Export the total number of views per individual configurator ID for your selected time period. This metric is essential for measuring the reach of your 3D content and identifying which specific configurators are attracting the most traffic on your website.

3D Export: Export all requested 3D files within your selected time period, with the ability to distinguish whether the export was triggered within Rubens Admin or from an embedded configurator on your site. This helps track the demand for production-ready data or professional-grade 3D assets.

Renderings: Export a log of all high-quality renderings that were requested specifically within Rubens Admin during your defined time frame. This allows you to monitor internal asset generation and the usage of the Rubens visualization engine for marketing or sales materials.

The Rubens Data Parser: The purpose of the parser is to provide all information from the "Saved configurations" file in a way that data visualization or analytics tools can easily work with it. The Java file meets exactly this goal and provides you with four different CSV files.

Setup and Execution: To use the parser, download the latest version from the** Roomle Analytics Converter GitHub**. You can download the analytics-converter.jar (found in the "bin" folder) or the full source code. Ensure that Java is installed on your computer before proceeding.

Terminal Commands: To execute the program, open your terminal and navigate to the folder where the jar file is saved using cd [path]. Run the parser using the following command: java -jar analytics-converter.jar {source} {destination}. The first parameter is the source path of your "Saved configurations" CSV; the second is the destination where the processed files should be saved. If no destination is entered, the source path will be used by default.

Relational Data Logic: The generated files utilize a specific database structure to ensure that no information is lost during the conversion process. This structure includes Configuration.csv (the primary database file), Item.csv, Parameter.csv, and Attribute.csv. While not every column may be relevant to your specific reporting needs, this comprehensive layout allows you to adapt the tables to your individual business requirements.

The Configuration Parts List: Every saved configuration contains a parts list that breaks down the product into its orderable units (the Bill of Materials). By cross-referencing the ConfigurationID with the ItemID, you can see the exact quantity and specification of every part within a configuration – such as hinges, panels, or modular connectors. This data is vital for brands that use Rubens to drive production planning, as it allows you to analyze actual material consumption rather than just high-level views.

Data Normalization and Granularity: Each parameter, such as "height," is linked directly to its specific component and then one step further to the corresponding configuration and origin part. This hierarchical structure allows you to decide exactly how granular you want your analytics to be, from high-level configuration trends down to the popularity of specific modular dimensions.

Visualizing Performance with BI Tools: Connect your parsed CSV files to professional business intelligence platforms such as Google Data Studio, Power BI, or Excel. This structured approach ensures that your dynamic dashboards reflect the true technical depth of your product interactions without manual data cleaning.

Google Data Studio Integration: We recommend using Google Data Studio for visualization as it is free, highly customizable, and easy to connect with CSV data. You can start by creating a new report or using our provided** Test Report Template**. To use the template, click the three dots on the right side and select "make a copy" to play around with the given file.

Managing Data Sources: In the toolbar, navigate to "Resources" and select "Manage added data sources" to add a new set of data. Choose the** File Upload ** connector to upload your CSV files to the Data Studio environment. You will see a page where you can manage data pools, which contain the files used for the report logic.

Updating Data Pools: Upload your own files via drag-and-drop to the matching data pools to replace the sample data. The significant advantage of this method is that the logic of the report is saved in the data pools themselves, meaning your customized report will automatically display your own data once the "add" button is clicked.