Migrer depuis Umami

Remplacez le script, faites correspondre vos événements et importez votre historique. La plupart des sites terminent en moins de 30 minutes.

1. Remplacer la balise de script

Ajoutez votre site dans Glyphex, puis copiez la balise de script depuis Paramètres, Suivi. Elle remplace la balise Umami. Gardez les deux quelques jours si vous voulez comparer les chiffres, puis supprimez la balise Umami.

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>

Les options du script Umami correspondent ainsi :

2. Faire correspondre vos événements personnalisés

umami.track(name, data) d'Umami devient window.analytics.track(name, properties). Les arguments ont le même sens. Consultez Événements personnalisés pour l'API complète.

Umami

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

Glyphex

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

Les attributs HTML d'Umami ont des équivalents directs. data-glyphex-event définit le nom de l'événement et data-glyphex-event-<nom> définit une propriété, comme chez 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. Importer votre historique

Glyphex peut importer les pages vues et les événements personnalisés d'Umami depuis un CSV. Vous produisez le CSV avec une requête sur votre base Umami, puis vous l'importez dans les paramètres de votre site.

Étape 1 : exporter depuis Postgres

Exécutez cette requête sur votre base Umami. Remplacez YOUR_UMAMI_WEBSITE_ID par l'identifiant d'Umami, Paramètres, Sites web.

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

Étape 2 (MySQL à la place) : exporter depuis MySQL

Si Umami tourne sur MySQL, utilisez plutôt cette requête. Le serveur doit pouvoir écrire dans le dossier OUTFILE. La première ligne est l'en-tête.

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'

Étape 3 : importer le fichier

Ouvrez Paramètres, Données dans le site Glyphex, trouvez Importer depuis Umami et choisissez le CSV. Seuls les propriétaires et les administrateurs du site peuvent importer. L'import s'exécute dans votre navigateur par lots, avec la progression et un résumé du résultat.

Ce qui est importé

• Les pages vues (event_type 1) et les événements personnalisés (event_type 2). Les autres types d'événements Umami sont ignorés.
• Chemin, titre de page, référent, champs UTM, pays, ville, appareil, navigateur, système et largeur d'écran.
• Les visites Umami restent regroupées. Les identifiants de session sont hachés avec l'identifiant de votre site Glyphex, rien ne renvoie vers Umami.
• La chaîne de requête de chaque URL est supprimée. Les valeurs UTM viennent des colonnes utm.
• Les propriétés des événements personnalisés ne sont pas dans l'export, donc les événements importés n'ont qu'un nom et un chemin.
• Le texte qui commence par =, +, - ou @ reçoit une apostrophe initiale, pour qu'un tableur ne l'exécute pas comme une formule lors d'un export.

Limites

• Fichiers jusqu'à 200 Mo. Découpez les exports plus gros par période et importez-les l'un après l'autre.
• Les lignes plus anciennes que l'historique de votre offre sont ignorées et comptées dans le résultat.
• Chaque site peut contenir par import jusqu'à 12 mois des événements mensuels de votre offre. Les lignes au-delà sont ignorées.
• Les lignes importées ne comptent pas dans votre usage mensuel d'événements.
• Importer deux fois le même fichier ajoute les lignes deux fois. Importez chaque période une seule fois.

4. Vérifier les chiffres

Comparez une semaine récente dans les deux outils. De petites différences sont normales : les outils comptent les visiteurs et les sessions différemment. Quand tout est bon, supprimez le script Umami.