# Guide: Skyra og Cookie-samtykke

Canonical: https://www.skyra.no/no/help/guide-skyra-og-cookie-samtykke

Language: no

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

> [!TIP]
> **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.

> [!WARNING]
> Forutsetning: Denne installasjonen krever at noen kan redigere HTML og JavaScript på nettsiden din.

<a id="h_cafa542d70"></a>

## **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.

<a id="h_ccb39079c3"></a>

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

<a id="h_59fc46975e"></a>

## Hvordan registrere i cookie-banner?

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

<a id="h_81c29e6792"></a>

### Eksempel: CookieYes

1. Logg inn på CookieYes dashboard
2. Gå til "Cookie List"
3. Klikk "Add New Cookie" for hver cookie
4. Fyll ut informasjonen fra tabellen over
5. Velg kategori: **Functional**

<a id="h_4d955dc7d7"></a>

## Slik setter du opp Skyra med cookie-banner

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

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

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

<a id="h_14ca9e42ef"></a>

### **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

<a id="h_5d9434ba18"></a>

### **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> `:

> [!TIP]
> Les mer om dette steget her:
> 
> [Installasjon av skyra på din nettside](<https://www.skyra.no/no/help/guide-installasjon-av-skyra-pa-din-nettside>)

<a id="h_0c5dab5a78"></a>

#### Eksempel på installasjonsscript.

```html
<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>
```

<a id="h_8692571172"></a>

### 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

<a id="h_a62ddc3e2e"></a>

### Eksempler:

<a id="h_bca5d0f53c"></a>

#### **For CookieYes**

```html
<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>
```

<a id="h_e2861d48ae"></a>

#### For Cookiebot

```html
<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>
```

<a id="h_dd765d5b10"></a>

#### For OneTrust

```html
<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.

<a id="h_f587595404"></a>

## **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  


<a id="h_aafea6f539"></a>

## Testing og verifisering

<a id="h_67b576ebdc"></a>

### Sjekkliste for testing

1. **Test uten consent:**
   - Inline surveys vises
   - Findability vises
   - Popup vises IKKE
   - Ingen cookies i DevTools → Application → Cookies
2. **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)
3. **Test dynamisk endring:**
   - Start uten consent (inline vises)
   - Aksepter cookies i banner
   - Popup-surveys aktiveres uten refresh
   - Sjekk console for bekreftelse

<a id="h_77d363d373"></a>

### 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 |

## I disse samlingene

- [Installasjon](<https://www.skyra.no/no/help/installasjon.md>) — Installer scriptet