UA PRO -KÄYTTÖOPAS

Aloitusopas

Aloita ensimmäisestä säännöstä ja tutustu soveltamisalueisiin, satunnaistiloihin, resurssien varatoimintoon ja asetusten siirtämiseen.

Koskee versiota: 1.4.5 · Opas päivitetty: 16. marraskuuta 2026

Tämä opas koskee versiota 1.4.5. Tarkista valitsemassasi asennuslähteessä saatavilla oleva versio.

UA Prolla voit määrittää User-Agentin (UA) kaikille verkkosivustoille, tietyille verkkotunnuksille tai yhdelle välilehdelle. Valitse ensin, mitä sivuja sääntö koskee, ja sitten, miten UA luodaan. Kun sääntöjä on useita, laajennus valitsee pääsivulle yhden säännön etusijajärjestyksen mukaan; tavalliset sivun resurssit perivät ensin pääsivun UA:n.

01UA ja sivun resurssit

UA kuvaa selaimen sivustoille lähettämää identiteettiä ja sisältää yleensä selaimen, käyttöjärjestelmän ja laitteen tiedot. UA Pro voi muuttaa tavallisten verkkopyyntöjen User-Agent ja antaa tavallisilla sivuilla vastaavan arvon kohteelle navigator.userAgent.

Mobiili-UA:lla voit tarkastella, mitä sivusto palauttaa mobiili-UA:ille, mutta se ei muuta tietokonetta puhelimeksi eikä automaattisesti muuta näytön kokoa, selainmoottoria, IP-osoitetta tai selaimen täydellistä sormenjälkeä.

Oletetaan, että osoiterivillä näkyy https://shop.example.com/product:

Termi Merkitys tässä esimerkissä
Pääsivu Osoiteriviltä avattu tuotesivu
Pääsivun verkkotunnus shop.example.com ilman protokollaa tai polkua
Ylemmän tason verkkotunnus Suhteessa tunnukseen shop.example.com example.com on ylemmän tason verkkotunnus
Aliverkkotunnus img.shop.example.com on tunnuksen shop.example.com aliverkkotunnus
Sivun resurssit Sivun lataamat kuvat, komentosarjat, tyylit, API-pyynnöt, tavalliset verkosta ladatut iframe-kehykset ja vastaavat
Resurssin verkkotunnus Resurssipyynnön kohdeverkkotunnus, esimerkiksi cdn.example.net

Tässä oppaassa ”pääsivun verkkotunnus” tarkoittaa osoiterivin sivun isäntänimeä. Se ei ole ylätason verkkotunnus kuten .com eikä välttämättä rekisteröity verkkotunnus kuten example.com.

02Kolme toisistaan riippumatonta asetuskäsitettä

Asetus Kysymys, johon se vastaa Esimerkkejä
Soveltamisalue Mitkä sivut käyttävät tätä sääntöä? Yleinen, verkkotunnus example.com, nykyinen välilehti
UA-tila Mistä UA:n sisältö tulee? Sisäänrakennettu UA, mukautettu, lisää tekstiä, satunnainen UA
Satunnaistila Milloin uusi arvo arvotaan, kun satunnaistaminen on valittu? Jokaisella sivulatauksella, välilehtikohtaisesti

Esimerkiksi ”verkkotunnuksen alue + satunnainen UA + välilehtikohtaisesti” tarkoittaa, että jokainen kyseisen alueen sivuilla käyvä välilehti tallentaa säännölle oman satunnaisen tuloksensa. Se ei tarkoita, että kaikki verkkotunnuksessa käyvät välilehdet jakaisivat yhden pysyvän UA:n.

2.1 Soveltamisalue

Soveltamisalue Mihin vaikuttaa Kesto ja ohittaminen
Yleinen Tavalliset verkkosivut, joille ei ole etusijaltaan korkeampaa sääntöä Asetukset säilyvät; verkkotunnus- tai välilehtisääntö voi ohittaa ne
Verkkotunnus Sivut, joiden pääsivun verkkotunnus vastaa määritettyä tunnusta tai sen aliverkkotunnusta Asetukset säilyvät; tarkemmat verkkotunnus- tai välilehtisäännöt voivat ohittaa ne
Välilehti Välilehti, jolla sääntö luotiin Korkein etusija; koskee välilehteä myös sen siirtyessä muille sivustoille ja päättyy, kun välilehti suljetaan

”Yleinen alue + välilehtikohtainen satunnaistus” on edelleen yleinen sääntö; satunnaistulosten erillinen tallennus ei tee siitä korkeimman etusijan välilehtisääntöä.

2.2 UA-tila

Tila Miten UA luodaan Sopii tarkoitukseen
Sisäänrakennettu UA Valitsee UA:n esiasetetuista selaimista tai laitteista Esiasetetun identiteetin nopeaan käyttöön
Mukautettu Käyttää syöttämääsi kokonaista UA-merkkijonoa Tietyn UA:n käyttöön tai oman UA-luettelon tallennukseen
Lisää tekstiä Lisää välilyönnin ja määritetyn tekstin selaimen oletus-UA:n perään Tunnistemerkin lisäämiseen oletus-UA:han
Satunnainen UA Arpoo UA:n valitusta ehdokasjoukosta Satunnaisten arvojen antamiseen sivulataus- tai välilehtikohtaisesti

Tekstin lisääminen perustuu selaimen oletus-UA:han, ei ohitettuun ylemmän tason verkkotunnuksen UA:han tai yleiseen UA:han. Jos esimerkiksi yleinen sääntö on mukautettu UA ja verkkotunnussääntö lisää MyTest, kyseinen tunnus käyttää arvoa ”selaimen oletus-UA + välilyönti + MyTest”. Sääntöjä ei yhdistetä.

Satunnainen ehdokasjoukko voi koostua sisäänrakennetuista UA-arvoista, mukautetusta luettelosta, lisättävien tekstien luettelosta tai niiden yhdistelmästä; voit myös valita tiettyjä luokkia. Lisättävän tekstin ehdokkaat yhdistetään ensin selaimen oletus-UA:han ja otetaan sitten mukaan arvontaan. Jos joukko on tyhjä tai siinä ei ole kelvollista sisältöä, säännöstä ei voi tulla kelvollista pääsivun sääntöä.

03Pääsivun sääntöjen etusijajärjestys

Välilehtisääntö → tarkin kelvollinen verkkotunnussääntö → ylempien verkkotunnusten säännöt taso kerrallaan → yleinen sääntö → selaimen oletus-UA.

Tässä järjestyksessä käytetään ensimmäistä käyttöön otettua sääntöä, joka voi tuottaa kelvollisen UA:n; myöhempiä sääntöjä ei yhdistetä siihen. Kiinteiden ja satunnaisten tilojen välillä ei ole lisäetusijaa.

Tarkistusjärjestys Esimerkki, kun pääsivu on news.shop.example.com
1 Nykyisen välilehden sääntö
2 Kelvollinen sääntö tunnukselle news.shop.example.com
3 Kelvollinen sääntö tunnukselle shop.example.com
4 Kelvollinen sääntö tunnukselle example.com
5 Kelvollinen yleinen sääntö
6 Mikään yllä olevista ei kelpaa; käytetään selaimen oletus-UA:ta

”Kelvollinen” edellyttää kahta asiaa: sääntö on käytössä ja se voi tuottaa sallitun, ei-tyhjän UA:n. Keskeytetyt säännöt, kielletyt UA-arvot ja tyhjät satunnaiset ehdokasjoukot ohitetaan.

3.1 Verkkotunnusten vastaavuus

Kun määrität example.com, seuraavat pääsivut vastaavat sitä:

Pääsivun verkkotunnus Vastaako?
example.com Kyllä
www.example.com Kyllä
shop.example.com Kyllä
a.shop.example.com Kyllä
otherexample.com Ei
example.com.other.net Ei
example.net Ei

Kirjoita verkkotunnuskenttään example.com; älä kirjoita https://, polkua, kyselyparametreja tai porttia. Asetukset ovat tällä hetkellä verkkotunnus-, eivät URL-polkukohtaisia.

Versiossa 1.4.5 ei ole valintaa, joka täsmäisi vain täsmälleen tähän isäntänimeen ja sulkisi kaikki aliverkkotunnukset pois. Jos haluat vaikuttaa vain haaraan shop.example.com, kirjoita shop.example.com, mutta myös sen aliverkkotunnukset sisältyvät.

Yhteensopivuusmuoto *.example.com kattaa nykyisessä versiossa myös itse tunnuksen example.com ja sen aliverkkotunnukset, ei pelkästään aliverkkotunnuksia. Jos sekä kelvollinen example.com- että *.example.com-sääntö on olemassa, ensimmäinen on etusijalla; kun se keskeytetään, jälkimmäinen voi tulla voimaan. Uusille käyttäjille riittää yleensä tavallinen verkkotunnusmuoto.

3.2 Keskeyttämisen ja poistamisen ero

Toiminto tai tila Merkitys
Keskeytä Säilyttää asetukset mutta sulkee säännön tilapäisesti pois täsmäytyksestä; voidaan jatkaa
Poista Poistaa säännön; luo se tarvittaessa uudelleen
Ohitettu Sääntö on edelleen käytössä, mutta nykyiselle sivulle sovelletaan etusijaltaan korkeampaa sääntöä
Virheellinen Nykyinen sisältö ei voi tuottaa kelvollista UA:ta; korjaa sisältö tai ehdokasjoukko

Säännön keskeyttämisen tai poistamisen jälkeen laajennus etsii muita kelvollisia sääntöjä. Siksi keskeyttäminen ei ole poissulkeva sääntö, joka pakottaisi sivun käyttämään selaimen oletus-UA:ta.

Oletetaan esimerkiksi, että ainoat käytössä olevat kelvolliset säännöt ovat yleinen UA-G, tunnuksen example.com UA-P ja tunnuksen shop.example.com UA-C:

Toiminto Tulos avattaessa shop.example.com
Kaikki kolme sääntöä käytössä UA-C
Keskeytä aliverkkotunnuksen sääntö UA-P
Keskeytä myös ylemmän tason verkkotunnuksen sääntö UA-G
Keskeytä myös yleinen sääntö Selaimen oletus-UA
Lisää kelvollinen välilehtisääntö UA-T Kyseinen välilehti käyttää UA-T:tä

UA-G, UA-P, UA-C ja UA-T ovat vain eri UA-sisältöjen nimiä.

04Kaksi satunnaistilaa

4.1 Jokaisella sivulatauksella

Arvo arvotaan kerran jokaisella pääsivun täydellisellä verkkolatauksella, ja tavalliset sivun resurssit käyttävät samaa tulosta. Päivitys tai täydellinen siirtyminen arpoo uudelleen; sivun pyynnöt, kuten kuvat, API:t ja iframe-kehykset, eivät kukin laukaise uutta pääsivun arvontaa.

Oletetaan, että ehdokasjoukossa ovat UA-A, UA-B ja UA-C:

Toiminto Mahdollinen tulos
Avaa sivu ensimmäisen kerran Pääasiakirja ja tavalliset resurssit käyttävät UA-A:ta
Sivu pyytää sen jälkeen kuvia ja API:ita Edelleen UA-A
Vain ankkuri tai SPA:n sisäinen reitti muuttuu Edelleen UA-A
Päivitä sivu Uusi arvonta; voi käyttää UA-C:tä
Siirry kokonaan toiselle sivulle, johon sama sääntö edelleen täsmää Uusi arvonta; voi käyttää UA-B:tä

”Uudelleen arpominen” ei tarkoita, että arvo olisi välttämättä eri. Vastaavasti selaimen takaisin- tai eteenpäinpainikkeella suoraan välimuistista palautettua asiakirjaa ilman pääasiakirjan uutta verkkolatausta ei voida yksinkertaisesti pitää uutena arvontana.

Uudelleenohjauksissa sovellettava sääntö määräytyy edelleen kohdesivun mukaan. Samassa siirtymisessä ja samalla säännöllä jokainen uudelleenohjausvaihe ei laukaise toistuvia arvontoja; jos kohdeverkkotunnus osuu toiseen sääntöön, käytetään sitä.

4.2 Välilehtikohtaisesti

Satunnaistulos tallennetaan yhdistelmälle ”sääntö + välilehti”. Niin kauan kuin asetukset eivät muutu eikä välilehteä suljeta, päivitykset ja täydelliset siirtymiset saman säännön alla käyttävät edelleen tätä tulosta.

Määritä esimerkiksi välilehtikohtainen satunnaistus tunnukselle example.com:

Toiminto Mahdollinen tulos
Välilehti 1 avaa example.com Tämä sääntö sitoo UA-A:n välilehteen 1
Välilehti 1 päivittää tai siirtyy osoitteeseen shop.example.com ilman tarkempaa sääntöä Jatkaa UA-A:lla
Välilehti 2 avaa example.com Välilehdelle 2 tallennetaan sidonta; se voi olla UA-B tai edelleen UA-A
Välilehti 1 siirtyy osoitteeseen other.net, jolla ei ole sääntöä, eikä yleistä sääntöä ole Käyttää selaimen oletus-UA:ta
Välilehti 1 palaa osoitteeseen example.com Palauttaa tämän säännön alkuperäisen UA-A:n
Sulje välilehti 1 ja avaa se uudelleen Alkuperäinen välilehtisidonta poistetaan ja voidaan määrittää uudelleen

Jos erillinen shop.example.com-sääntö on olemassa, säännöt ovat eri sääntöjä ja tallentavat satunnaissidonnat erikseen, vaikka molemmat valitsisivat saman ehdokasjoukon. Säännön parametrien tai ehdokaskirjaston muuttamisen tai selaimen uudelleenkäynnistyksen jälkeen satunnaistulokset voidaan määrittää uudelleen.

4.3 Soveltamisalueen ja tilan yhdistelmät

Taulukko kuvaa toimintaa, kun sääntö on saanut pääsivun etusijan. Kiinteisiin tiloihin kuuluvat Sisäänrakennettu UA, Mukautettu ja Lisää tekstiä.

Soveltamisalue Kiinteät tilat Satunnainen jokaisella sivulatauksella Satunnainen välilehtikohtaisesti
Yleinen Vastaavat sivut käyttävät tämän säännön UA:ta Arvotaan jokaisella pääsivun verkkolatauksella Jokainen välilehti tallentaa oman sidontansa tälle yleiselle säännölle
Verkkotunnus Vastaavan verkkotunnuksen ja sen aliverkkotunnusten sivut käyttävät tätä UA:ta Arvotaan jokaisella pääsivun verkkolatauksella vastaavalla alueella Jokainen välilehti tallentaa oman sidontansa tälle verkkotunnussäännölle
Välilehti Tämä välilehti käyttää tätä UA:ta myös muille sivustoille siirryttäessä Tämä välilehti arpoo jokaisella pääsivun verkkolatauksella Tämä välilehti säilyttää säännön kiinteän satunnaistuloksen päivitysten ja sivustojen välisten siirtymisten yli

Kaikissa yhdistelmissä tavalliset sivun resurssit perivät ensin pääsivun UA:n. Satunnaistila määrää arvon keston eikä muuta sääntöjen etusijaa.

05Sivun resurssit ja resurssiverkkotunnuksen varatoiminto

5.1 Resurssit perivät ensin, kun pääsivulla on sääntö

Oletetaan, että seuraavat säännöt ovat olemassa:

  • shop.example.com → UA-Shop.
  • cdn.example.net → UA-CDN.

Kun avaat shop.example.com ja sivu lataa cdn.example.net/photo.png, kuva käyttää arvoa UA-Shop. Vaikka resurssin kohdeverkkotunnuksella olisi oma sääntö, se ei ohita pääsivun sääntöä. Näin pääasiakirja ja tavalliset sivun resurssit käyttävät samaa UA:ta.

Jos avaat cdn.example.net suoraan uuden välilehden osoiteriviltä, siitä tulee pääsivun verkkotunnus ja se voi täsmätä omaan UA-CDN-sääntöönsä.

5.2 Milloin varatoiminnon kytkin vaikuttaa

Resurssin verkkotunnuksen varasääntö kohdassa ”Lisää” on oletusarvoisesti pois päältä. Se on itsenäinen yleinen kytkin ja koskee kaikkia UA-tiloja.

Se vaikuttaa vain, kun pääsivulla ei ole kelvollista välilehti-, verkkotunnus- tai yleistä UA:ta, ja antaa resurssien etsiä kelvollista verkkotunnussääntöä oman kohdeverkkotunnuksensa perusteella. Resurssiverkkotunnukset noudattavat samaa logiikkaa: tarkempi sääntö on etusijalla ja alemman säännön ollessa keskeytettynä peritään ylempi sääntö.

Onko pääsivulla kelvollinen UA? Kytkin Vastaako resurssi itse kelvollista verkkotunnussääntöä? Tavallisten resurssien UA
Kyllä Pois tai päällä Kyllä tai ei Perii pääsivun UA:n
Ei Pois Kyllä tai ei Selaimen oletus-UA
Ei Päällä Kyllä Resurssiverkkotunnuksen säännön tuottama UA
Ei Päällä Ei Selaimen oletus-UA

Kun pääsivulla ei ole kelvollista sääntöä, sen pääasiakirja käyttää edelleen selaimen oletus-UA:ta; resurssien varatoiminto ei koskaan anna arvoa takaisin pääsivulle. Myös kelvollinen yleinen sääntö tarkoittaa, että pääsivulla on kelvollinen UA, joten se estää varatoimintoa ottamasta tavallisia resursseja haltuun.

5.3 Esimerkki varatoiminnosta

Avaa news.example.org ilman välilehtisääntöä, pääsivun verkkotunnussääntöä tai yleistä sääntöä. Lisäksi on cdn.example.net → UA-CDN:

Pyyntö Varatoiminto pois Varatoiminto päällä
news.example.org pääasiakirja Oletus-UA Oletus-UA
news.example.org/api API Oletus-UA Oletus-UA
cdn.example.net/app.js Oletus-UA UA-CDN
img.cdn.example.net/photo.png Oletus-UA UA-CDN, peritty resurssin ylemmän verkkotunnuksen säännöstä
other.net/font.woff, ei vastaavaa sääntöä Oletus-UA Oletus-UA

Jos yleinen UA-G lisätään, kaikkia edellä olevia tavallisia pyyntöjä ohjaa pääsivun UA-G eikä resurssin UA-CDN enää ota niitä haltuun.

5.4 Varatoiminto satunnaistiloissa

Resurssiverkkotunnuksen säännön tila Miten arvo saadaan, kun varatoiminto on sallittu
Kiinteät tilat Käyttää resurssisäännössä määritettyä UA:ta
Satunnainen jokaisella sivulatauksella Tulos tallennetaan yhdistelmälle ”tämä isäntäsivun lataus + resurssisääntö”; saman latauksen resurssit, jotka vastaavat samaa sääntöä, jakavat sen
Satunnainen välilehtikohtaisesti Tulos tallennetaan yhdistelmälle ”isäntävälilehti + resurssisääntö”; sama välilehti käyttää sitä edelleen päivitysten jälkeen

Jos esimerkiksi cdn.example.net käyttää satunnaistilaa ja sekä img.cdn.example.net että js.cdn.example.net perivät sen, ne jakavat kyseisen sidonnan. Jos img.cdn.example.net:lla on oma kelvollinen sääntö, se kuuluu eri sääntöön ja voi käyttää eri UA:ta.

Muut resurssiverkkotunnuksessa käyvät välilehdet eivät korvaa nykyiselle sivulle jo tallennettuja resurssien satunnaissidontoja. Varatoiminnon ottaminen käyttöön sallii saman sivun eri resurssisääntöjen käyttää eri UA-arvoja; jos haluat tavallisen sivun pysyvän kokonaisuutena yhtenäisenä, pidä se yleensä pois päältä (oletus).

06Ensimmäisen säännön luominen

  1. Avaa määritettävä verkkosivusto ja napsauta työkalurivin UA Pro -kuvaketta.
  2. Jos nykyiselle sivustolle säännön asettava painike on käytettävissä, napsauta sitä tai luo uusi sääntö kohdasta ”Lisää”.
  3. Valitse soveltamisalue: ”Välilehti” tilapäiseen testiin vain nykyisellä välilehdellä, ”Verkkotunnus” saman sivuston useille välilehdille tai ”Kaikki sivustot” kaikkien sivustojen oletukseksi.
  4. Jos valitsit verkkotunnuksen, tarkista verkkotunnuskenttä. Jos esimerkiksi olet osoitteessa www.example.com ja haluat sisällyttää tunnuksen shop.example.com, kirjoita example.com.
  5. Valitse tila. Valitse ”Sisäänrakennettu”-tilassa selain tai laite; anna ”Mukautettu”-tilassa koko UA; anna ”Lisää tekstiä” -tilassa vain lisättävä teksti; valitse ”Satunnainen”-tilassa ehdokasjoukko ja satunnaistila.
  6. Tarkista ”Tarkista ja ota käyttöön” -kohdassa alue ja sisältö, napsauta ”Käytä” tai ”Tallenna ja käytä” ja odota vahvistusta ”Sääntö tallennettu ja otettu käyttöön”.
  7. Päivitä verkkosivu ja tarkista aloitusnäytössä näkyvä aktiivinen sääntö. Olemassa olevat sivut on päivitettävä, jotta sekä pääasiakirja että komentosarjat ottavat uuden UA:n käyttöön.

Sääntöluettelossa voit muokata, keskeyttää, jatkaa tai poistaa sääntöjä. Toisen säännön ohittama sääntö pysyy käytössä mutta ei ole nyt etusijalla; keskeytetty sääntö ei osallistu täsmäytykseen. Jos kelvollisen UA:n puuttumisesta tulee varoitus, tarkista mukautettu sisältö tai satunnainen ehdokasjoukko.

Mukautetun UA:n tulee olla yksi rivi kelvollista pyyntöotsakkeen sisältöä ilman rivinvaihtoja tai ohjausmerkkejä. Uusi mukautettu sisältö tai lisättävä teksti voidaan tallentaa luokittain luetteloon myöhempää valintaa tai satunnaisehdokkaana käyttöä varten.

07Kelluvan UA-paneelin käyttöönotto

Avaa Lisää ja ota Kelluva UA-paneeli käyttöön. Ikkuna on oletusarvoisesti pois päältä ja voi näkyä käytettävissä olevilla HTTP/HTTPS-sivuilla.

Sivun UA: arvo, jonka sivun JavaScript lukee navigator.userAgentista.

Pyynnön UA: User-Agent, jonka selain havaitsi tässä pääasiakirjan pyynnössä.

Tämä näyttää selaimen osoiterivin nykyisen sivun UA:n. Se ei sisällä kuvien, komentosarjojen, API:iden tai muiden resurssien, kuten CDN-resurssien, pyyntöjen UA:ta.

Jos molemmat arvot ovat saatavilla ja täsmälleen samat, ne näytetään yhdellä rivillä. Muuten ne näytetään erikseen.

Jos ikkuna otettiin käyttöön sivun lataamisen jälkeen, päivitä sivu sen pääpyynnön tallentamiseksi. Kun pyyntö ei ole saatavilla, ikkuna näyttää tämän tilan määritetyn arvon käyttämisen sijaan.

Siirrä ikkunaa vetämällä kahvaa tai otsaketta. Säädä leveyttä vetämällä vasenta tai oikeaa reunaa ja korkeutta vetämällä ylä- tai alareunaa. Reunan kaksoisnapsautus palauttaa automaattisen koon vain kyseisessä suunnassa. Puoliympyräpainike säätää taustan peittävyyttä. Sulkemispainike poistaa ikkunan käytöstä kaikilla sivuilla.

Jos User-Agent on pitkä, sen teksti jatkuu kapeassa ikkunassa automaattisesti seuraavalle riville. Ikkuna kasvaa tarvittaessa korkeammaksi. Vieritä ikkunan sisällä, jos teksti on näyttöä korkeampi. Käsin asetettu leveys ja korkeus säilyvät palautukseen asti.

Ikkuna pyrkii säilyttämään saman koon uuden sivun arvojen lataamisen aikana. Se näyttää latausilmaisimen, ei koskaan edellisen sivun arvoja. Täydellinen siirtyminen luo sivun uudelleen, joten ikkuna voi kadota hetkeksi.

Säännön muuttaminen ei muuta jo ladattua sivua eikä sen alkuperäisen pyynnön mukana lähetettyä otsaketta. Päivitä sivu tarkistaaksesi uuden säännön. Välityspalvelin tai palvelin voi muuttaa pyyntöotsakkeita sen jälkeen, kun selain on havainnut ne. Ikkuna ei voi näkyä suojatuilla selainsivuilla eikä selainlaajennusten kaupoissa.

Valikossa Lisää on myös Uuden käyttäjän opas; avaa verkkosivusto napsauttamalla valikon alaosassa UA Pro.

08Yleisten tavoitteiden määrittäminen

Tavoite Miten määritetään Huomautuksia
Kokeile mobiili-UA:ta vain nykyisellä välilehdellä Välilehti + sisäänrakennettu mobiili-UA Koskee välilehteä myös muille sivustoille siirryttäessä; päättyy suljettaessa
Käytä kiinteää UA:ta koko sivustolla Verkkotunnus example.com + sisäänrakennettu tai mukautettu UA Sisältää kaikki aliverkkotunnukset ja koskee myös muita välilehtiä
Käytä toista UA:ta kaupan osasivustolla Säilytä ylempi sääntö ja lisää shop.example.com-sääntö Ilman etusijaltaan korkeampaa sääntöä alempi sääntö on etusijalla; kun se keskeytetään, ylempi sääntö voi tulla voimaan
Käytä yhtä oletus-UA:ta kaikilla sivustoilla yhtä poikkeusta lukuun ottamatta Määritä UA-G yleisesti ja UA-D kohdeverkkotunnukselle Kun muuta korkeamman etusijan sääntöä ei sovelleta, kohdeverkkotunnus käyttää UA-D:tä ja muut sivut UA-G:tä
Arvo sivustolle UA jokaisella päivityksellä Verkkotunnus + satunnainen UA + jokaisella sivulatauksella Saman latauksen resurssit jakavat sen; sama tulos voi toistua
Pidä sivuston UA vakaana kussakin välilehdessä Verkkotunnus + satunnainen UA + välilehtikohtaisesti Jokainen sääntö tallentaa erillisen sidonnan kuhunkin välilehteen
Määritä UA:t vain ulkoisille resursseille kohdeverkkotunnuksen mukaan Luo resurssiverkkotunnuksen sääntö ja ota resurssien varatoiminto käyttöön Isäntäsivulla ei saa olla kelvollista välilehti-, verkkotunnus- tai yleistä UA:ta
Poista aliverkkotunnuksen sääntö tilapäisesti käytöstä Napsauta ”Keskeytä” Sivu käyttää jäljellä olevaa korkeimman etusijan kelvollista sääntöä, kuten välilehtisääntöä, toista vastaavaa verkkotunnussääntöä tai yleistä sääntöä. Jos mikään ei sovi, se käyttää selaimen oletus-UA:ta

09Varmuuskopiointi ja siirto

Kohdan ”Lisää” tuonti- ja vientitoiminnot voivat varmuuskopioida tai siirtää yleiset säännöt, verkkotunnussäännöt, mukautetun kirjaston, lisättävän tekstin kirjaston ja resurssiverkkotunnuksen varatoiminnon kytkimen.

Välilehtisäännöt ja jo arvotut satunnaissidonnat eivät kuulu tähän pysyvän kokoonpanon vientiin. Tuonti ei palauta alkuperäisiä välilehtiä tai niiden satunnaistilaa.

Voit tuoda paikallisen asetustiedoston tai ladata etäasetusten osoitteen ja vahvistaa tuonnin. Vie ensin varmuuskopio. Annettu yleisen säännön, verkkotunnussääntöjen, mukautetun kirjaston tai lisättävän tekstin kirjaston objekti korvaa vastaavan osan; puuttuvat tai null-osat jättävät nykyiset arvot ennalleen. Etenkään null-arvoinen yleinen sääntö ei poista olemassa olevaa yleistä sääntöä. Resurssiverkkotunnuksen varatoiminto otetaan käyttöön vain, jos sen kenttä on true; muilla arvoilla, myös kentän puuttuessa tai ollessa null, se on tuonnin jälkeen pois päältä.

Versiossa 1.4.5 vanha satunnaistila domain käsitellään tilana ”Jokaisella sivulatauksella”; vanhat satunnaissäännöt, joissa ei ole määritetty satunnaistusstrategiaa, käsitellään tilana ”Välilehdittäin”. Tarkista tarvittava satunnaistila käyttöliittymästä siirron jälkeen.

10Usein kysyttyä ja käyttörajoitukset

Kysymys Selitys
Miksi sivu näyttää edelleen vanhan UA:n heti tallennuksen jälkeen? Olemassa olevia asiakirjoja ei ladata uudelleen; päivitä tallennuksen onnistuttua. Tarkista myös, ohittaako korkeamman etusijan sääntö sen
Miksi mukautettu UA on edelleen käytössä, kun keskeytin alemman säännön? Kelvollinen välilehtisääntö voi edelleen olla etusijalla. Muussa tapauksessa toinen vastaava verkkotunnussääntö tai yleinen sääntö voi tulla voimaan. Päivitä sivu säännön muuttamisen jälkeen ja tarkista aktiivinen sääntö
Miksi resurssiverkkotunnuksen sääntö ei toimi? Tarkista ensin, onko pääsivulla jo kelvollinen UA, sitten onko resurssien varatoiminto päällä ja lopuksi onko resurssiverkkotunnuksen sääntö kelvollinen
Miksi satunnaisarvo ei muutu päivityksen jälkeen? Välilehtikohtainen tila säilyttää sen tarkoituksella; myös jokaisen sivulatauksen tila voi arpoa saman arvon uudelleen
Miksi samaan aikaan avatuilla välilehdillä on sama UA? Satunnaisarvot voivat toistua; samanaikaiset ensimmäiset siirtymiset voivat myös jakaa yhden etukäteen arvotun vara-arvon
Miksi sivu näyttää edelleen työpöytäsivulta mobiili-UA:han vaihtamisen jälkeen? Sivustot voivat käyttää myös näytön kokoa, Client Hints -tietoja tai muita tietoja; pelkkä UA:n vaihtaminen ei takaa erilaista sivuasettelua

Samanaikaiset ensimmäiset siirtymiset säilyttävät selaimen alkuperäisen navigoinnin: kun useat uudet välilehdet avaavat URL-osoitteen suoraan samanaikaisesti ja ensimmäinen paketti lähetetään ennen erillisen säännön asentamista, ne voivat käyttää samaa etukäteen arvottua UA:ta; sen jälkeen kukin välilehti tallentaa oman sidontansa. Laajennus ei lisää navigoinnin välitystä eikä muuta lomakkeiden alkuperäisiä POST-pyyntöjä toiseksi navigointitavaksi.

Tavalliset HTTP/HTTPS-sivut ja niiden resurssit ovat toiminnon pääkohde. Jaettujen Service Workereiden pyyntöjä ei aina voida kohdistaa yhdelle välilehdelle; UA:n synkronointia Client Hints -tiedoille, Workerien navigatorille ja iframe-kehyksille, joiden asiakirjoja ei ladata verkosta, ei ole tässä versiossa toteutettu täysin. Sivuston alkuperäisen Server-Timing säilyttämistä ei myöskään ole vielä toteutettu tässä muutoksessa. Älä pidä UA:n muuttamista selaimen sormenjäljen täydellisenä väärentämisenä.

Versio 1.4.5 käyttää oikeuksia webRequest ja webNavigation pääsivun siirtymisten ja todellisuudessa lähetetyn UA:n seuraamiseen. Se ei käytä pyyntöjen estämisoikeuksia eikä virheenkorjaimen oikeuksia.

11Version tarkistus ja lähteet

Version 1.3.0 lopullinen tarkistusympäristö oli eristetty testiprofiili Windows Edge 157.0.4341.42:ssa ja paikalliset HTTP/HTTPS-sivustot. Täysi HTTPS-ajo läpäisi 128 tapausta ja 2527 väittämää; HTTP-rajojen regressiotesti läpäisi 5 tapausta ja 441 väittämää. Nämä tarkistavat yllä kuvatut sääntöyhdistelmät ja ilmoitetun samanaikaisuusrajan; ne eivät tarkoita, että kaikki selainversiot ja sivustot olisi katettu.

Version 1.4.5 ikkuna testattiin eristetyissä Chrome- ja Edge-profiileissa paikallisilla HTTPS-sivuilla. Testit kattoivat siirtymiset, samanlaisten sivun ja pyynnön UA-arvojen yhdistämisen yhdelle riville, koon muuttamisen ja viivästetyt luvut. Ne eivät kata kaikkia sivustoja.

Yksityiskohtaiset testitiedot säilytetään projektiaineistossa. Tarkista asennettava versio Chrome Web Storesta tai offline-lataussivulta; saatavilla olevat versiot voivat poiketa tästä oppaasta.