Etter at Skyra-scriptet er installert på nettsiden, kan du enkelt administrere undersøkelser direkte fra Skyra – for eksempel starte, stoppe og styre hvor de skal vises. Dette er et engangsoppsett.

Dette må gjøres:

Hent ditt Skyra-script
Installer scriptet på nettsiden
Verifiser at det fungerer

Bruk AI til å få tekniske svar raskere (llms.txt)
Vi har gjort all teknisk dokumentasjon tilgjengelig i et eget KI-vennlig format. Lim denne filen inn i Copilot, Claude – eller din favoritt-KI – og spør i vei:
👉 https://survey.skyra.no/llms.txt

Hva er Skyra-scriptet?

Skyra-scriptet (også kalt "Smart Script") er en JavaScript-fil som må være installert på nettsiden for at undersøkelser skal kunne vises.

Viktig å vite:

Ett script per organisasjon – brukes for alle undersøkelser
Installeres kun én gang
Undersøkelser styres deretter fra Skyra-plattformen
Inline-undersøkelser krever også en HTML-tag på siden der de skal vises

Hent ditt Skyra-script

Hver organisasjon i Skyra har et unikt script. Slik finner du det:

Gå til Settings i menyen til venstre
Klikk på "View installation script"
Velg "Click to copy"

💡 Viktig: Bruk alltid "Copy code"-knappen for å unngå formateringsfeil.

Eksempel på Skyra-script:

Hvor skal scriptet installeres?

✅ Anbefalt: Direkte i nettsidens kildekode

Den beste måten å installere Skyra på er å legge scriptet direkte i nettsidens HTML-kode. Dette betyr at scriptet legges inn i selve nettsidens kildefiler, ikke via et eksternt verktøy som Google Tag Manager.

Anbefalt plassering:

Beste valg: I <head>-seksjonen
Alternativ: Rett før </body>-taggen

Fordeler med direkte installasjon:

1. Unngår ad blockers

Ad blockers blokkerer Google Tag Manager og andre tag managers. Når GTM blokkeres, lastes heller ikke Skyra-scriptet. Dette påvirker 7-40% av besøkende avhengig av målgruppen.

2. Raskere lasting

Scriptet lastes umiddelbart når siden lastes, uten forsinkelse fra tag managers som må lastes først.

3. Mer pålitelig
Færre avhengigheter betyr færre feilkilder. Hvis GTM får problemer, påvirkes ikke Skyra.

⚠️ Ikke anbefalt: Via Google Tag Manager (GTM)

Problemet med GTM:

Ad blockers blokkerer ikke bare annonser – de blokkerer også Google Tag Manager. Når GTM blokkeres, lastes heller ikke Skyra-scriptet og undersøkelser vises ikke til de med Ad blockers.

Hvis du må bruke GTM:

Vær klar over begrensningene. Vi anbefaler å flytte til direkte installasjon så snart som mulig.

Verifiser at installasjonen fungerer

Steg 1: Sjekk at scriptet lastes

Åpne nettsiden din i en nettleser
Høyreklikk hvor som helst på siden og velg "Inspiser" (eller trykk F12)
Gå til "Network"-fanen øverst
Last siden på nytt (F5)
Skriv "skyra" i søkefeltet
Du skal nå se en fil som heter skyra-survey.js

✅ Hvis du ser filen: Scriptet lastes korrekt
❌ Hvis du ikke ser filen: Scriptet er ikke installert riktig – se feilsøking under

Steg 2: Test med en undersøkelse

Opprett en testundersøkelse i Skyra
Sett den til Published
Gå til Settings → Show-url og sett til å matche en testside (nettside.no/../test)
Besøk testsiden
Undersøkelsen skal nå vises

Tips: Bruk disse innstillingene for å teste med undersøkelse

Capture % til 100%
Delay til 0 sekunder.
Åpne nettsiden i Incognito (unngår cookie og retrigger-karantene)

Cookie-banner

Med korrekt installasjon skal Skyra aldri sette cookies før brukeren har gitt samtykke. Cookie-oppsettet gjøres én gang når Skyra installeres første gang på nettsiden. Det gjelder for alle undersøkelser.

Må Skyra bruke Cookies?

Pop-up undersøkelser bruker informasjonskapsler (cookies) for å fungere normalt
Inline-undersøkelser kan fungere uten.

Med anbefalt oppsett av cookie-banner:

✅ Skyra respekterer brukerens valg
✅ Inline-undersøkelser fungerer for alle (også de som avviser cookies)
✅ Popup-surveys vises til de som godtar cookies

Anbefalt oppsett: "Script-alltid-tilgjengelig"

Den anbefalte metoden kalles "script-alltid-tilgjengelig" og betyr at:

Skyra-scriptet lastes alltid (uavhengig av cookie-valg)
Skyra lagrer kun cookies når brukeren har samtykket
Hvis brukeren endrer sitt samtykke senere, oppdateres dette dynamisk

📖 Les detaljert guide: Skyra og Cookie-samtykke

Viktige forutsetninger og spesielle hensyn

For at Skyra skal fungere optimalt på din nettside, er det noen spesielle tilfeller du bør være oppmerksom på.

1. Content Security Policy (CSP) må godkjenne Skyra

Hva er CSP?
Content Security Policy er en sikkerhetsmekanisme som kontrollerer hvilke eksterne scripts som får lastes på nettsiden. Mange nettsider bruker CSP for å beskytte mot ondsinnet kode.

Problemet:

Hvis nettsiden din har CSP aktivert, vil Skyra-scriptet bli blokkert med mindre Skyra er eksplisitt godkjent.

Hvordan sjekke om CSP blokkerer:
Åpne Console (F12) og se etter feilmeldinger som begynner med:

"Content Security Policy"
"Refused to load the script"
"blocked by CSP"

Løsningen:
Dersom din nettside har en Content Security Policy (CSP) må Skyra registreres som godkjent før installasjonen fungerer.

Legg til disse domenene i CSP-headeren på nettsiden:

script-src https://survey.skyra.no;
connect-src https://ingest.skyra.no https://survey.skyra.no;
style-src 'unsafe-inline';

Forklaring:

script-src – Tillater Skyra-scriptet å lastes
connect-src – Tillater sending av svar til Skyra
style-src – Tillater styling av undersøkelser (shadow DOM)

Merk: style-src 'unsafe-inline' er nødvendig for at Skyra skal kunne style undersøkelser korrekt (shadow DOM)

2. Single Page Applications (SPA)

Single Page Applications fungerer annerledes enn vanlige nettsider. Når brukeren navigerer, lastes ikke siden på nytt – i stedet oppdateres innholdet dynamisk. Dette betyr at Skyra ikke automatisk forstår at brukeren har navigert til en ny side.

Løsningen: Nettstedet må fortelle Skyra når en ny side vises ved å kalle window.skyra.reload() etter hver ruteendring. Dette er en enkel justering som din utvikler kan implementere.

📖 Les detaljert guide: Installasjon av Skyra på Single Page Applications

3. Inline-undersøkelser krever HTML-tag

Hvis du planlegger å bruke Inline-undersøkelser (undersøkelser som er en del av sidens innhold), krever disse et ekstra steg. I tillegg til Skyra-scriptet må du legge til en HTML-tag med undersøkelsens unike ID der undersøkelsen skal vises.

📖 Les mer: Hvordan installere en Inline-survey på din nettside

Feilsøking

Bruk debug-kommandoen

Skyra har et innebygd debug-verktøy som viser nøyaktig hvorfor en undersøkelse ikke vises.

Slik bruker du det:

Steg 1: Åpne nettsidens Console

Windows/Linux: Trykk F12 eller høyreklikk → "Inspiser" → velg "Console"-fanen
Mac: Trykk Cmd + Option + J eller høyreklikk → "Inspiser element" → velg "Console"-fanen

Steg 2: Skriv inn denne kommandoen:

window.skyra._debugEnabled = true;
window.skyra.debugInfo();

Steg 3: Les resultatet

Hva viser debug-verktøyet?

✅ Tilgjengelige undersøkelser – Alle undersøkelser som er publisert på denne siden

❌ Hvorfor undersøkelsen ikke vises – Konkret årsak (f.eks. "URL matcher ikke", "Cookie-samtykke mangler", "Ikke trukket ut i loddtrekning")

🍪 Cookie-status – Om brukeren har gitt samtykke til cookies

🔗 URL-matching – Om Show-url/Hide-url reglene matcher nåværende side

🎲 Loddtrekning (Capture %) – Om brukeren ble trukket ut til å se undersøkelsen

⏱️ Retrigger-status – Om brukeren nylig har sett undersøkelsen

📋 Undersøkelsesstatus – Om undersøkelsen er publisert eller i draft-modus

Andre årsaker til at undersøkelsen ikke vises

Hvis undersøkelsen ikke vises etter at scriptet er installert og verifisert, kan det skyldes flere faktorer.

Innstillinger i Skyra:

❌ Undersøkelsen er ikke publisert – Må være satt til "Published"
❌ URL-regler matcher ikke – Sjekk Show-url/Hide-url i Settings
❌ Capture % for lav – Brukeren ble ikke trukket ut (prøv 100% for testing)
❌ Initial Delay aktiv – Undersøkelsen vises forsinket (prøv 0 sekunder for testing)
❌ Retrigger-regler – Brukeren har nylig sett undersøkelsen og den vises ikke igjen

Tekniske faktorer:

❌ Cookie-samtykke mangler – Popup-surveys krever at brukeren har godtatt cookies
❌ Inline survey: HTML-tag mangler – Inline-undersøkelser krever <skyra-survey>-taggen på siden