Skip to main content

Center Data Export (ZIP)

If a center terminates the contract and wants to take its Cockpit data with it, authorized users can generate a read-only ZIP export. During this process, no data is deleted or changed in the cockpit.

Where in the Dashboard​

Content → Shopping Center → Edit Center → Tab “Management” → Export Center Data (ZIP).

When exporting, a progress dialog will open (showing percentage and current step, e.g., database, Umami, bot statistics, images). Do not close the window during the export – the ZIP download will start automatically when everything is ready.

Find in the documentation: Topic Finder (Center & Organization) or search at the top (Ctrl+K / ⌘+K) for “Data export”.

Authorization​

Export is possible for:

  • Super Admin
  • Center Administrator / Marketing Manager (Organization), if the center belongs to their own organization
  • Users with the center assignment “Export Data” (canExportData under Settings → Users → Center Assignment)

Content of the ZIP Archive​

Folder/FileContent
README.txtQuick guide
manifest.jsonTimestamp, counter, status of media downloads
data/*.jsonMaster data, shops, branches, chains, news, events, offers, jobs, services, offices, page content, center plan metadata, categories, …
data/umami-analytics.jsonWebsite Analytics (Umami): aggregated metrics and trends for 30, 90, and 365 days – only if analytics is active for the center and Umami is accessible (see below)
data/bot-analytics.jsonAI Assistant / Bot: usage by channel (website, kiosk, companion), top searches, intents, mentions, journey funnel – periods of 30/90/365 days
data/chatbotInteractions.jsonRaw data of all bot interactions (anonymized: no chat response texts)
data/centerUsageEvents.jsonRaw data usage events (kiosk/companion/website, e.g., journey steps)
csv/*.csvExcel-compatible extracts (shops, news, offers, …)
csv/bot/Bot & AI evaluation for Excel (see below)
media/Images only: SVG, JPG/JPEG, PNG (no 3D models, videos, PDFs)

Not included (data protection/security): Passwords (e.g., analytics page password), user accounts of other centers.

Media: The media/ folder will only download SVG, JPG/JPEG, and PNG files. 3D models (GLB, GLTF, …), videos, PDFs, and other formats are excluded; their URLs remain in the JSON files under data/ and are listed in manifest.json under excludedMediaUrls.

Size limits (images): Maximum single file size 25 MB, total media archive max. around 400 MB.

Umami Statistics in the Export​

If the center uses Website Analytics (Umami) (analyticsEnabled, Umami website ID under Center → Analytics), the export will attempt to retrieve the same aggregated metrics as in the dashboard when creating the ZIP file (page views, visitors, visits, trends by day/month).

SituationResult in umami-analytics.json
Analytics off or another providerincluded: false with a brief explanation
Umami active, server has UMAMI_PASSWORDincluded: true, periods under periods
Umami active, API not configuredincluded: false, note on Umami Dashboard

The ZIP download does not fail if Umami is not accessible – only the statistics data will be missing. Status is also noted in manifest.json under umamiAnalytics.

Bot and AI Assistant Statistics​

For customer analysis (Excel): Folder csv/bot/ — German labeled CSV files with UTF-8-BOM. Quick guide: csv/bot/00-LESEHILFE.txt.

File in csv/bot/Content
01-overview-periods.csvUsage website / kiosk / companion for 30, 90, and 365 days
02-top-searches.csvMost frequent search queries per period
03-top-intents.csvRecognized user intents (German designation)
04–09Mentions of shops, gastronomy, services, offers, events, categories
10-companion-journey.csvCompanion journey steps
11-interactions-detail.csvIndividual interactions (date, channel, search, intent, names instead of just IDs)
12-usage-events.csvUsage events (kiosk/companion/website) prepared in a readable format

Technical raw data (archive): still under data/:

FileContent
bot-analytics.jsonAggregated metrics as in the dashboard (30/90/365 days)
chatbotInteractions.jsonRaw data of all bot interactions
centerUsageEvents.jsonRaw data usage events

No personal raw chats are exported – only what the system reliably stores for analytics (queryNormalized, mention IDs, intents).

Technical (for developers)​

  • UI: asynchronous with status dialog – POST …/export/start, GET …/export/status?jobId=, GET …/export/download?jobId=
  • Direct download (without progress): GET /api/centers/[centerId]/export
  • Implementation: apps/dashboard/src/lib/center-export/
  • Only SELECT queries, no migration, no deletion
  1. Execute export and archive ZIP
  2. Contractually document that the export has been received
  3. Optionally deactivate or delete the center – separate step under “Dangerous Actions”

See also: Users & Organization (right to “Export Data”).

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/dashboard/center-datenexport