LOKALLI
← Back to Platform

User Guide

LOKALLI Configuration Platform

1. Customer Configuration

The platform home page (/) lists all configured customers. Click + New Customer to create a new configuration.

Name The customer or partner name. Appears on reports and PDF exports.
Email Customer email. Pre-filled when sending reports via email.
Zones & Frames Select zones (to include all frames in that zone) and/or specific frames (devices). Only data from the assigned zones and frames will appear in the customer's report.
GA Paths Select or add Google Analytics page path patterns (e.g. /spots/venue-name) associated with this customer. The report will only show GA metrics for pages matching these paths.

2. Generating Reports

Click View Report on any customer card to open their dedicated report. The report is filtered to only show data for the customer's assigned zones and GA paths.

Date Range Adjust the From and To dates, then click Apply.
GA Metrics Page views, card impressions, and clicks filtered to the customer's configured GA paths. A daily trend chart is shown when data is available.
Top Pages Most viewed pages within the customer's GA path patterns.
Frames Data Sensor data from the customer's assigned zones: views, engaged views, presence time, and device breakdown.

3. PDF Export

Two PDF export options are available from the report page:

Export PDF Client-side export using html2pdf.js. Captures the current view including charts as a multi-page A4 PDF.
Download PDF Server-side PDF generated with xhtml2pdf. Uses a clean print-optimized template. Requires the xhtml2pdf Python package.

4. Email Delivery

Click Email on the report page to send the PDF report to one or more recipients. The customer's email is pre-filled. SMTP must be configured in .env: 

SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your-email@gmail.com
SMTP_PASS=your-app-password
SMTP_FROM=reports@yourdomain.com

5. Data Sources

All data is fetched live each time a report is loaded: