Denne guiden viser hvordan du installerer Skyra på en måte som respekterer brukerens cookie-valg.

Anbefalt oppsett

Det anbefales å sette opp cookie-banner med "Script-alltid-tilgjengelig"-metoden: Skyra-scriptet lastes alltid, men lagrer kun cookies ved samtykke. Dette gjør at inline-undersøkelser fungerer for alle, mens popup-undersøkelser kun vises til de som godkjenner cookies.

Forutsetning: Denne installasjonen krever at noen kan redigere HTML og JavaScript på nettsiden din.

Må Skyra bruke cookies?

Kort fortalt: Pop-up undersøkelser bruker cookies for å fungere normalt.

✅ Fungerer uten cookies:

Inline surveys (alle typer spørsmålskort)
Findability ("Fant du det du lette etter?")

❌ Krever cookies:

"Vanlige" popup-undersøkelser som følger brukeren rundt på nettsiden.

Begrensinger uten cookies

Popup vises ikke
Frekvens-regler fungerer ikke (samme undersøkelse vises til samme bruker)
Husker ikke svar eller spørsmål mellom sidevisninger

*Begrepene cookies og informasjonskapsler brukes litt om hverandre.

Hvilke cookies bruker Skyra?

Skyra bruker førsteparts funksjonelle cookies som settes på ditt eget domene.

Cookie-navn	Virkemåte og Formål	Formål	Varighet
`skyra.state`	Virkemåte: Informasjonskapslen lagrer en tilfeldig generert identifikator og status på undersøkelser (åpne/lukket/fullført). Type: Funksjonell	Hensikten er at brukere som enten har sendt inn svar eller valgt å ikke delta, ikke blir invitert igjen.	365 dager
`skyra.<survey-slug>`	Virkemåte: Lagrer midlertidige svar mens brukeren fyller ut undersøkelsen. Type: Funksjonell	Hensikten er å vise rett spørsmål i undersøkelsen, mens brukeren navigerer mellom forskjellige sider. Brukeren kan også starte undersøkelsen på én side og fullføre på en annen.	Session (slettes ved fullføring/lukking)
`skyra._test`	Dette er kun en momentan informasjonskapsel som verifiserer om Skyra's informasjonskapsler støttes. Type: Funksjonell	Tester om cookies støttes	Session (momentan) *Den slettes umiddelbart etter testen.

Hvordan registrere i cookie-banner?

Du må registrere hver cookie separat i din cookie-banner. Tabellen over gir nødvendig informasjon.

Eksempel: CookieYes

Logg inn på CookieYes dashboard
Gå til "Cookie List"
Klikk "Add New Cookie" for hver cookie
Fyll ut informasjonen fra tabellen over
Velg kategori: Functional

Slik setter du opp Skyra med cookie-banner

Det finnes to hovedmetoder for å integrere Skyra med cookie-banner:

"Script-alltid-tilgjengelig" - scriptet lastes alltid, men cookie-bruk styres av samtykke.
"Blokker skyra-script" - scriptet lastes kun ved samtykke.

Vi anbefaler "Script-alltid-tilgjengelig" fordi den lar inline-undersøkelser fungere for alle besøkende.

Anbefalt oppsett: "Script-alltid-tilgjengelig"

"Script-alltid-tilgjengelig" betyr at Skyra:

Venter med å sette cookies til brukeren har sagt "ja"
Respekterer hvis brukeren sier "nei" (kan vise inline-undersøkelser uten cookies.)
Endrer innstilling hvis brukeren endrer sitt samtykke senere

Denne metoden lar Skyra-scriptet alltid laste, men kontrollerer cookie-bruk basert på brukerens samtykke. Skyra får lov til å lagre cookies når du setter consent: true, og blokkeres når du setter consent: false.

consent: false = "Ikke lagre cookies"
consent: true = "Kan lagre cookies"

Hva skjer ved "consent: false"?

✅ Inline surveys vises normalt
✅ Findability vises
❌ Popup-undersøkelser vises IKKE (krever cookies)
❌ Ingen cookies settes

Steg 1: Grunnleggende installasjon

Hvis du enda ikke har installert Skyra scriptet på din nettside, må det gjøres.

Finn ditt script i Skyra: Gå til Settings → General → View installation script
Legg inn ditt Skyra script i <head> eller rett før </body>:

Les mer om dette steget her:

Installasjon av skyra på din nettside

Eksempel på installasjonsscript.

<script>
  window.SKYRA_CONFIG = {
    org: 'din-organisasjon',  // Finn din org-slug i Skyra
    consent: false            // Start uten cookies
  };
</script>
<script src="https://survey.skyra.no/skyra-survey.js"></script>

Steg 2: Koble til cookie-banner

Cookie banneret må fortelle Skyra når brukeren godkjenner eller avviser cookies. Dette gjøres ved å lytte til hendelser fra din cookie-banner og kalle window.skyra.setConsent(true/false).

Viktig å vite:

Eksemplene under viser kode for de vanligste cookie banner-løsningene
Hvis du bruker en annen løsning, må du tilpasse koden til deres API
Sjekk dokumentasjonen til din cookie banner for riktig event-navn og funksjonskall
Legg koden rett etter Skyra-scriptet fra Steg 1

Hvor finner jeg informasjon om min cookie-banner?
Se dokumentasjonen til din cookie banner-leverandør for:

Event-navn (f.eks. cookieyes_consent_update)
Hvordan lese consent-status
Kategori-navn for funksjonelle cookies

Eksempler:

For CookieYes

<script>
  // Funksjon som sjekker om brukeren har godkjent cookies
  function getCookieYesConsent() {
    var cookie = document.cookie
      .split('; ')
      .find(function(row) { return row.startsWith('cookieyes-consent='); });
    
    if (!cookie) return false;
    
    var value = decodeURIComponent(cookie.split('=')[1]);
    return value.includes('functional:yes');
  }
  
  // Skyra kaller denne automatisk når den er klar
  window.skyraStart = function() {
    window.skyra.setConsent(getCookieYesConsent());
  };
  
  // Oppdater når brukeren endrer samtykke
  document.addEventListener('cookieyes_consent_update', function(event) {
    if (window.skyra) {
      var hasConsent = event.detail.accepted?.includes('functional');
      window.skyra.setConsent(hasConsent);
    }
  });
</script>

For Cookiebot

<script>
  window.skyraStart = function() {
    window.skyra.setConsent(Cookiebot.consent?.preferences ?? false);
  };
  
  window.addEventListener('CookiebotOnAccept', function() {
    window.skyra?.setConsent(Cookiebot.consent.preferences);
  });
  
  window.addEventListener('CookiebotOnDecline', function() {
    window.skyra?.setConsent(false);
  });
</script>

For OneTrust

<script>
  window.skyraStart = function() {
    var hasConsent = typeof OnetrustActiveGroups !== 'undefined' && 
                     OnetrustActiveGroups.includes('C0003');
    window.skyra.setConsent(hasConsent);
  };
  
  function OptanonWrapper() {
    if (window.skyra) {
      window.skyra.setConsent(OnetrustActiveGroups.includes('C0003'));
    }
  }
</script>

Merk: C0003 er OneTrust sin standard kategori-ID for funksjonelle cookies. Sjekk din egen OneTrust-konfigurasjon for riktig ID.

Alternativt oppsett: "Blokkering av Skyra-script"

Du kan også blokkere Skyra-scriptet helt til samtykke gis, men dette hindrer inline-undersøkelser i å vises og anbefales ikke.

Ja det er teknisk mulig, men vi anbefaler det ikke fordi:

Inline surveys vil ikke vises før samtykke gis
Det er mer komplisert å implementere
Den anbefalte metoden gir bedre brukeropplevelse

Testing og verifisering

Sjekkliste for testing

Test uten consent:
- Inline surveys vises
- Findability vises
- Popup vises IKKE
- Ingen cookies i DevTools → Application → Cookies
Test med consent:
- Kall window.skyra.setConsent(true)
- Popup-surveys vises
- Cookies skyra.state finnes i DevTools
- Surveys huskes (lukk og refresh, skal ikke vises igjen)
Test dynamisk endring:
- Start uten consent (inline vises)
- Aksepter cookies i banner
- Popup-surveys aktiveres uten refresh
- Sjekk console for bekreftelse

Vanlige feil

Problem	Årsak	Løsning
Inline survey vises ikke	`consent` ikke satt til `false`	Sett `consent: false` i config
Popup vises før consent	`consent` ikke satt	Sett `consent: false` i initial config
Consent oppdateres ikke	Event listener mangler	Legg til event listener for cookie-banner