Hoppa till huvudinnehåll

Implementering

Det finns två sätt att samla in sökkategorier: automatisk URL-detektering och manuell JavaScript-spårning.

Alternativ 1: Automatisk URL-detektering​

Om webbplatsens sökfunktion inkluderar kategorin som en URL-parameter kan Matomo extrahera den automatiskt.

Exempel-URL:

https://example.se/sok?q=jacka&kategori=dam

Konfiguration i Matomo:

  1. Gå till Administration > Mätbara objekt > Hantera
  2. Välj den aktuella webbplatsen
  3. Under Webbplatssökning, se till att sökning är aktiverad
  4. Välj "Jag vill ange egna parametrar" (om standardparametrarna inte passar)
  5. Ange sökkategoriparametern (t.ex. kategori eller cat eller category)
  6. Spara

Matomo läser sedan automatiskt ut kategorivärdet från URL:en vid varje sökning.

Alternativ 2: Manuell JavaScript-spårning (rekommenderas)​

Detta ger mest kontroll och fungerar även när kategorin inte finns i URL:en (t.ex. vid JavaScript-baserade sökfilter eller SPA-applikationer).

Implementera på sökresultatsidan:

// Ersätt hårdkodade värden med dynamiska variabler från er sökfunktion
_paq.push(['trackSiteSearch',
    "Sökord",           // Obligatoriskt: sökordet
    "Kategorinamn",     // Valfritt: sökkategorin (false om ingen)
    42                  // Valfritt: antal sökresultat (0 = inga resultat)
]);

// VIKTIGT: Anropa INTE trackPageView() på sökresultatsidan
// när trackSiteSearch används
// _paq.push(['trackPageView']);

Praktiskt exempel — e-handel:

// Hämta värden dynamiskt från ert söksystem
var keyword = document.querySelector('#search-input').value;
var category = document.querySelector('#category-filter').value || false;
var resultCount = document.querySelectorAll('.search-result').length;

_paq.push(['trackSiteSearch', keyword, category, resultCount]);

Viktigt att tänka på:

  • Anropa inte trackPageView() på samma sida som trackSiteSearch() — annars räknas sökningen dubbelt (en gång som sökning, en gång som sidvisning)
  • Sätt category till false om ingen kategori är vald
  • Sätt searchCount till 0 för att spåra sökningar utan resultat — detta är värdefull data
  • Kategorivärdet trunkeras till max 200 tecken

Kan jag använda båda metoderna samtidigt? Om trackSiteSearch() anropas manuellt har det företräde framför URL-baserad detektering. Välj en metod.

Rekommendation​

Minimikonfiguration​

  1. Aktivera Site Search (aktiverat som standard)
  2. Implementera trackSiteSearch() med sökord och antal resultat

Fullständig konfiguration (rekommenderas)​

  1. Aktivera Site Search
  2. Implementera trackSiteSearch() med sökord, kategori och antal resultat
  3. Verifiera att trackPageView() inte anropas på sökresultatsidan
  4. Kontrollera att data visas korrekt under Beteende > Webbplatssökning

Verifiering​

Efter implementering kan ni verifiera att data samlas in korrekt genom att:

  1. Göra en sökning på webbplatsen
  2. Gå till Beteende > Webbplatssökning > Sökkategorier i Matomo
  3. Kontrollera att kategorin dyker upp i rapporten (kan ta några minuter)
  4. Alternativt: använd Besökare > Besöksloggen för att se den senaste sökningen i realtid