Gå til hovedinnhold

Guide: Installasjon av Skyra på din nettside

Slik installerer du Skyra på nettsiden din: steg-for-steg guide, hva som kreves for din undersøkelsestype og forutsetninger for vellykket installasjon.

Denne guiden viser deg hvordan du installerer Skyra-scriptet på nettsiden din. Det er et engangsoppsett - når scriptet er på plass kan du styre alt annet direkte fra Skyra: start, stopp og bestem hvor undersøkelser skal vises, uten å gjøre flere endringer på nettsiden.

Dette må gjøres:

  1. Hent ditt Skyra-script

  2. Installer scriptet på nettsiden

  3. Verifiser at det fungerer

Hva trengs for din type undersøkelse?

Type undersøkelse

Krever script

Krever HTML-tag

Krever cookies

Popup-undersøkelse

Ja

Nei

Ja

Inline-undersøkelse

Ja

Ja

Nei

Findability

Ja

Ja

Nei

Link Survey*

Nei

Nei

Nei

*Skal du kun bruke Link Survey, kan du hoppe over resten av denne artikkelen. Den deles direkte via egen lenke og krever ingen installasjon på nettsiden.

Innhold i denne artikkelen

  • Hva er Skyra-scriptet?

  • Hent ditt Skyra-script

  • Hvor skal scriptet installeres?

  • Verifiser at installasjonen fungerer

  • Cookie-banner

  • Viktige forutsetninger

  • Feilsøking

  • Teknisk dokumentasjon for utviklere og AI

Hva er Skyra-scriptet?

Skyra-scriptet (også kalt "Smart Script" eller "installasjons-script") er et JavaScrip 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:

  1. Gå til Settings i menyen til venstre

  2. Klikk på "View installation script"

  3. Velg "Click to copy"

💡 Viktig: Bruk alltid "Copy"-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

Hvis nettsiden er en Single Page Applications (SPA)
Da kreves et ekstra steg ved installasjonen - se eget punkt i avsnittet "Viktige forutsetninger."

Fordeler med direkte installasjon

  • Unngår ad-blockers – Ad-blockers blokkerer Google Tag Manager og andre tag managers. Når GTM blokkeres, lastes heller ikke Skyra-scriptet. Dette vil ramme en andel av dine besøkende.

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

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

⚠️ Alternativ: 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-blockere.

Verifiser at installasjonen fungerer

Steg 1: Sjekk at scriptet lastes

  1. Åpne nettsiden din i en nettleser

  2. Høyreklikk hvor som helst på siden og velg "Inspiser" (eller trykk F12)

  3. Gå til "Network"-fanen øverst

  4. Last siden på nytt (F5)

  5. Skriv "skyra" i filterfeltet

  6. 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

  1. Opprett en testundersøkelse i Skyra

  2. Sett den til Published

  3. Gå til Settings → Show-url og sett til å matche en testside (f.eks. nettside.no/test)

  4. Besøk testsiden

  5. Undersøkelsen skal nå vises

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

  • Show to how many visitors? Sett til 100% visning

  • Delay til 0 sekunder

  • Åpne nettsiden i Incognito (unngår cookie- og retrigger-sperre)

Da vises hver gang nettsiden lastes, uten forsinkelse.

Cookie-banner

Med korrekt installasjon skal Skyra aldri sette cookies før brukeren har gitt samtykke. Dette oppsettet gjøres én gang og gjelder for alle undersøkelser. Popup-undersøkelser krever cookie-samtykke for å fungere, mens Inline-undersøkelser og Link-undersøkelser fungerer uten cookies.

Husk: Det er ditt ansvar som kunde å konfigurere cookie-banneret på nettsiden slik at brukerens samtykke faktisk respekteres og formidles korrekt til Skyra.

📖 Les detaljert guide: Skyra og Cookie-samtykke

Viktige forutsetninger

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-undersøkelse på din nettside

Feilsøking

Vises ikke undersøkelsen etter installasjon, start med debug-verktøyet: åpne Console (F12) og skriv window.skyra.debugInfo(); for å se nøyaktig hvorfor undersøkelsen ikke vises (publiseringsstatus, URL-regler, capture %, cookie-samtykke m.m.).

📖 Les full feilsøkingsguide: Feilsøkingsguiden: Undersøkelsen vises ikke

Teknisk dokumentasjon for utviklere og AI

Vi har gjort all teknisk dokumentasjon tilgjengelig som en KI-vennlig tekstfil (llms.txt) – full oversikt over konfigurasjon, JavaScript-API, events, SPA-oppsett for React/Next.js/Vue/Angular, styling og feilkoder, alt i ett format en KI-assistent kan lese presist.

Lim hele innholdet fra lenken under inn i Claude, Copilot eller din favoritt-KI, og still konkrete spørsmål – for eksempel "hvordan setter jeg opp Skyra i en Next.js App Router-app?" eller "hvorfor får jeg feilmeldingen 'Could not find DOM element with selector'?".

👉 Skyra Survey Widget Integration for AI: https://survey.skyra.no/llms.txt

Trenger du hjelp?

Kontakt oss på e-post [email protected]

Relaterte artikler
Svarte dette på spørsmålet?