Von Umami migrieren

Skript tauschen, Events zuordnen und die Historie importieren. Die meisten Websites sind in unter 30 Minuten fertig.

1. Skript-Tag tauschen

Legen Sie Ihre Website in Glyphex an und kopieren Sie den Skript-Tag unter Einstellungen, Tracking. Er ersetzt den Umami-Tag. Betreiben Sie beide einige Tage parallel, wenn Sie Zahlen vergleichen möchten, und entfernen Sie dann den Umami-Tag.

Umami

<script defer src="https://cloud.umami.is/script.js"
  data-website-id="YOUR_UMAMI_WEBSITE_ID"></script>

Glyphex

<script defer src="https://glyphex.io/t/YOUR_SITE_ID.js"></script>

Umami-Skriptoptionen entsprechen sich so:

2. Benutzerdefinierte Events zuordnen

Umamis umami.track(name, data) wird zu window.analytics.track(name, properties). Die Argumente haben dieselbe Bedeutung. Die vollständige API finden Sie unter Benutzerdefinierte Events.

Umami

umami.track('signup', { plan: 'pro' });

Glyphex

window.analytics.track('signup', { plan: 'pro' });

Umamis HTML-Attribute haben direkte Entsprechungen. data-glyphex-event legt den Event-Namen fest und data-glyphex-event-<name> eine Eigenschaft, genau wie bei Umami.

Umami

<button data-umami-event="signup" data-umami-event-plan="pro">
  Sign up
</button>

Glyphex

<button data-glyphex-event="signup" data-glyphex-event-plan="pro">
  Sign up
</button>

3. Historie importieren

Glyphex kann Seitenaufrufe und benutzerdefinierte Events aus Umami als CSV importieren. Sie erzeugen die CSV mit einer Abfrage auf Ihrer Umami-Datenbank und laden sie dann in den Website-Einstellungen hoch.

Schritt 1: Export aus Postgres

Führen Sie diese Abfrage auf Ihrer Umami-Datenbank aus. Ersetzen Sie YOUR_UMAMI_WEBSITE_ID durch die ID aus Umami, Einstellungen, Websites.

SELECT
  e.created_at, e.url_path, e.url_query,
  e.referrer_domain, e.referrer_path, e.page_title,
  e.event_type, e.event_name, e.hostname,
  e.utm_source, e.utm_medium, e.utm_campaign, e.utm_term, e.utm_content,
  e.session_id, e.visit_id,
  s.browser, s.os, s.device, s.screen, s.country, s.region, s.city
FROM website_event e
JOIN session s ON s.session_id = e.session_id
WHERE e.website_id = 'YOUR_UMAMI_WEBSITE_ID'
  AND e.event_type IN (1, 2)
ORDER BY e.created_at

# Save the query above as umami-export.sql (no trailing semicolon), then run:
psql "$DATABASE_URL" \
  -c "COPY ($(cat umami-export.sql)) TO STDOUT WITH (FORMAT csv, HEADER true)" \
  > umami-export.csv

Schritt 2 (stattdessen MySQL): Export aus MySQL

Läuft Umami auf MySQL, verwenden Sie stattdessen diese Abfrage. Der Server braucht Schreibzugriff auf den OUTFILE-Ordner. Die erste Zeile ist die Kopfzeile.

SELECT 'created_at', 'url_path', 'url_query', 'referrer_domain', 'referrer_path',
  'page_title', 'event_type', 'event_name', 'hostname', 'utm_source', 'utm_medium',
  'utm_campaign', 'utm_term', 'utm_content', 'session_id', 'visit_id',
  'browser', 'os', 'device', 'screen', 'country', 'region', 'city'
UNION ALL
SELECT
  DATE_FORMAT(e.created_at, '%Y-%m-%d %H:%i:%s'), e.url_path, e.url_query,
  e.referrer_domain, e.referrer_path, e.page_title,
  e.event_type, e.event_name, e.hostname,
  e.utm_source, e.utm_medium, e.utm_campaign, e.utm_term, e.utm_content,
  e.session_id, e.visit_id,
  s.browser, s.os, s.device, s.screen, s.country, s.region, s.city
FROM website_event e
JOIN session s ON s.session_id = e.session_id
WHERE e.website_id = 'YOUR_UMAMI_WEBSITE_ID'
  AND e.event_type IN (1, 2)
INTO OUTFILE '/var/lib/mysql-files/umami-export.csv'
FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '"' ESCAPED BY '"'
LINES TERMINATED BY '\n'

Schritt 3: Datei hochladen

Öffnen Sie in der Glyphex-Website Einstellungen, Daten, suchen Sie Import aus Umami und wählen Sie die CSV. Nur Website-Eigentümer und Admins können importieren. Der Import läuft in Ihrem Browser in Batches, und Sie sehen Fortschritt und eine Ergebnisübersicht.

Was importiert wird

• Seitenaufrufe (event_type 1) und benutzerdefinierte Events (event_type 2). Andere Umami-Event-Typen werden übersprungen.
• Pfad, Seitentitel, Referrer, UTM-Felder, Land, Stadt, Gerät, Browser, Betriebssystem und Bildschirmbreite.
• Umami-Besuche bleiben gruppiert. Sitzungs-IDs werden mit Ihrer Glyphex-Website-ID gehasht, nichts verweist zurück auf Umami.
• Der Query-String jeder URL entfällt. UTM-Werte stammen aus den utm-Spalten.
• Eigenschaften benutzerdefinierter Events sind nicht im Export enthalten, importierte Events haben daher nur Namen und Pfad.
• Text, der mit =, +, - oder @ beginnt, erhält ein vorangestelltes Apostroph, damit Tabellenprogramme ihn beim Export nicht als Formel ausführen.

Grenzen

• Dateien bis 200 MB. Teilen Sie größere Exporte nach Zeitraum auf und laden Sie sie nacheinander hoch.
• Zeilen, die älter als der Datenzeitraum Ihres Tarifs sind, werden übersprungen und im Ergebnis gezählt.
• Jede Website kann per Import bis zu 12 Monate der monatlichen Events Ihres Tarifs aufnehmen. Weitere Zeilen werden übersprungen.
• Importierte Zeilen zählen nicht zu Ihrer monatlichen Event-Nutzung.
• Wird dieselbe Datei zweimal importiert, entstehen die Zeilen doppelt. Importieren Sie jeden Zeitraum nur einmal.

4. Zahlen prüfen

Vergleichen Sie eine aktuelle Woche in beiden Tools. Kleine Abweichungen sind normal: Die Tools zählen Besucher und Sitzungen unterschiedlich. Wenn alles passt, entfernen Sie das Umami-Skript.