Video ist in Arbeit. Bis dahin führt Sie die Anleitung sicher ans Ziel.
Schritt-für-Schritt-Anleitung
Was ist Suche-Tracking?
Wenn Sie auf Ihrer Website ein Suchfeld haben, tippt dort jemand vielleicht «Preise», «Kontakt» oder «Schuhe Grösse 42» ein. Diese Begriffe sind Gold wert. Sie zeigen Ihnen schwarz auf weiss, was Ihre Besucher wirklich wollen.
Trustlytics sammelt alle Suchbegriffe in einer Liste. Sie sehen, was am häufigsten gesucht wurde, was ins Leere lief und welche Seiten danach geklickt wurden.
Wie Trustlytics eine Suche erkennt
Eine Suche kann auf drei Arten passieren. Sie müssen nur wissen, welche davon bei Ihnen zutrifft. In den meisten Fällen brauchen Sie gar nichts zu tun, weil Trustlytics es von selbst erkennt.
Die drei Wege:
- Klassische Suche. Der Suchbegriff steht in der URL (zum Beispiel
?q=schuhe). Trustlytics erkennt das automatisch. - JavaScript-Suche. Die Treffer werden nachgeladen, ohne dass sich die URL ändert. Hier setzen Sie einen kleinen Hinweis.
- Single-Page-App. Ihre App schreibt die Suche in die URL. Trustlytics erkennt das automatisch.
Variante 1: Klassische Suche mit URL-Parameter
Das ist der Normalfall. Sieht Ihre Suche so aus:
example.com/suche?q=schuhe
oder so:
example.com/?search=preise
dann erkennt Trustlytics die Suche automatisch. Sie müssen nichts tun.
Diese gängigen Parameter kennt Trustlytics ohne jede Einstellung:
qqueryssearchsearchwordkkeyword
Schickt Ihre Suche zusätzlich eine Kategorie mit (etwa «nur in Produkten suchen»), werden diese Parameter automatisch als Kategorie gelesen:
catscategorysearch_cat
Wenn Ihre Suche eigene Parameter verwendet
Manche Websites nutzen eigene Namen wie ?suche=, ?find= oder ?begriff=. Die kann Trustlytics nicht erraten. Sie tragen den Namen einmalig ein, dann läuft alles von selbst.
So geht das:
- Gehen Sie zu Einstellungen (Zahnrad) → Suchtracking.
- Im Bereich «Eigene Parameter» tragen Sie den Parameternamen ein (zum Beispiel suche).
- Klicken Sie auf «Hinzufügen».
Ab jetzt erkennt Trustlytics auch diesen Parameter automatisch.
Variante 2: JavaScript-Suche (die URL ändert sich nicht)
Lädt Ihre Suche die Treffer per JavaScript nach, ohne dass sich die URL ändert (typisch bei Live-Suchen, wo schon beim Tippen Vorschläge erscheinen), dann braucht Trustlytics einen kleinen Hinweis.
Sobald Treffer angezeigt werden, setzen Sie zwei Attribute am <body>-Tag Ihrer Seite. So sieht ein <body>-Tag normalerweise aus:
<body>
...
</body>
Sie ergänzen die beiden Attribute so:
<body data-trustlytics-search="schuhe"
data-trustlytics-search-results="42">
...
</body>
Diese Attribute setzen Sie üblicherweise nicht von Hand, sondern Ihr JavaScript-Code erledigt das. Lädt Ihr Suchfeld nach dem Tippen die Treffer, schreibt Ihr Code etwa Folgendes:
// Nach erfolgreicher Suche:
document.body.dataset.trustlyticsSearch = userSuchbegriff;
document.body.dataset.trustlyticsSearchResults = String(trefferAnzahl);
Trustlytics bemerkt die Änderung von selbst und zählt die Suche.
Die Attribute im Detail
Trustlytics erkennt diese Klicks automatisch. Sie müssen nichts extra konfigurieren:
| Attribut | Pflicht? | Beispiel | Beschreibung |
|---|---|---|---|
data-trustlytics-search |
ja | «schuhe» | Der gesuchte Begriff |
data-trustlytics-search-results |
nein | «42» | Anzahl Treffer (oder 0, wenn keine) |
data-trustlytics-search-category |
nein | «Produkte» | Eine Filter-Kategorie |
Die Trefferzahl (-results) dürfen Sie weglassen, wenn Sie sie nicht ermitteln können. Dann zeigt Trustlytics in der Auswertung einfach keine Zahl an. Wenn es geht, schicken Sie aber 0 mit, sobald eine Suche keinen Treffer geliefert hat. Das ist die wertvollste Information überhaupt (Bereich «Ohne Treffer» in der Auswertung).
Warum zwei Sekunden Verzögerung?
Zeigt Ihr Suchfeld die Treffer schon beim Tippen, würde Trustlytics sonst für jeden einzelnen Buchstaben eine eigene Suche zählen. Das wäre unbrauchbar.
Darum wartet Trustlytics zwei Sekunden, ob noch eine Änderung kommt. Gezählt wird nur die letzte Eingabe vor der Pause. Tippt jemand “schuh» und ergänzt zwei Sekunden später zu «schuhe», zählt Trustlytics allein «schuhe». Nicht «s», «sc», «sch», «schu», «schuh».
Variante 3: Single-Page-App mit URL-Wechsel
Setzen Sie React-Router, Vue-Router, Next.js oder ein ähnliches Framework ein und Ihre App schreibt die Suche in die URL (zum Beispiel /suche?q=schuhe, ohne dass die Seite komplett neu lädt), dann erkennt Trustlytics das automatisch.
q, search und so weiter) steht in der Standard-Liste oder Sie haben ihn in den Einstellungen ergänzt (siehe oben).So prüfen Sie, ob es funktioniert
- Richten Sie Ihre Suche ein, wie oben beschrieben.
- Öffnen Sie Ihre Website in einem neuen Browserfenster.
- Geben Sie etwas ins Suchfeld ein und drücken Sie Enter (oder warten Sie auf die Treffer).
- Warten Sie bis zum nächsten Morgen.
Der Begriff taucht in der Tabelle «Suchbegriffe» auf.
Regeln und Limits
| Was | Regel |
|---|---|
| Suchbegriff | maximal 200 Zeichen, beliebige Sprache |
| Anzahl Treffer | beliebige Zahl von 0 bis 999'999 |
| Kategorie | maximal 100 Zeichen, beliebige Sprache |
| Suchen pro Besuch | maximal 50 (Anti-Spam-Schutz) |
| Verzögerung bei Live-Suche | 2 Sekunden zwischen letzter Tastatur-Eingabe und Zählung |
Datenschutz
Bot-Suchen (Suchmaschinen-Crawler und Ähnliches) werden automatisch herausgefiltert.
Eine Bitte: Keine persönlichen Daten in der Suche. Nimmt Ihr Suchfeld auch E-Mail-Adressen oder Namen auf, tauchen die in der Auswertung auf. Filtern Sie das am besten heraus, bevor Sie es data-trustlytics-search übergeben.
Häufige Fragen
Was, wenn jemand die Suche abbricht, ohne Enter zu drücken?
Dann wird nichts gezählt. Trustlytics zählt erst, wenn wirklich eine Suche ausgeführt wurde (URL-Wechsel oder Setzen der Attribute am <body>).
Werden Bots gezählt?
Nein. Crawler von Google, Bing, ChatGPT und so weiter werden automatisch erkannt und tauchen in den Statistiken nicht auf.
Wie genau ist die Zählung?
Genau. Jede Suche wird gespeichert. Der aktuelle Tag wird live ausgewertet, die Werte vom Vortag erscheinen final am Morgen danach.
Funktioniert das auch mit React, Vue oder Next.js?
Ja. Das Setzen der Attribute am <body> funktioniert in jedem Framework. Bauen Sie es einfach in Ihre Such-Komponente ein, sobald die Treffer da sind.
Was, wenn ich verschiedene Suchen auf verschiedenen Seiten habe (etwa eine für Produkte, eine für den Blog)?
Nutzen Sie das Attribut data-trustlytics-search-category mit einem eigenen Wert pro Suche (zum Beispiel «Produkte» und «Blog»). In der Auswertung sehen Sie dann beide Kategorien getrennt.
Was passiert, wenn ich einen URL-Parameter später ändere?
Alte Suchen bleiben in der Auswertung erhalten. Neue Suchen mit dem neuen Parameter werden gezählt, sobald Sie ihn in den Einstellungen ergänzt haben.
Was, wenn jemand dieselbe Sache mehrmals sucht?
Jede Suche zählt einzeln. Sucht jemand dreimal «schuhe», sind das drei Suchen.