Diegimo vadovas
Jūsų svetainėje turi būti aktyvūs du dalykai: pranešimas, kurį mato lankytojai, ir nedidelis viešas failas, deklaruojantis jūsų DI naudojimą (jusu-svetaine.lt/.well-known/ai-disclosure.json). Fragmento žyma įklijuojama vieną kartą, yra vienoda kiekviename puslapyje, o jūsų deklaracija nulemia, kurie pranešimai kur pasirodo. Pasirinkite savo platformą žemiau; daugumoje tai užtrunka apie dešimt minučių.
Juosta ir DI žymos, kurias jūsų lankytojai mato puslapyje.
ai-disclosure.json, viešas failas, perskaitomas iš jūsų pačių domeno.
tikriklis rodo 2 lygį · Atvaizduota.
Pasirinkite savo platformą
WordPress
Įdiekite papildinį
WordPress administravimo skydelyje: Plugins → Add New → Upload Plugin, pasirinkite žemiau atsisiųstą failą ir spustelėkite Activate.
Leiskite jam atlikti abu darbus
Papildinys rodo pranešimus ir automatiškai paskelbia jūsų deklaracijos failą. Pažymėkite DI turinį bet kuriame įraše ar paveikslėlyje jo „DI turinys“ jungikliu. Jokių kodo redagavimų.
-
Patikra
Baigta, kai tikriklis rodo 2 lygį · Atvaizduota.
Vykdyti tikriklį
Shopify
Pridėkite fragmentą
Online Store → Themes → ⋯ → Edit code → theme.liquid: įklijuokite šią vieną žymą prieš pat </body>. theme.liquid yra išdėstymas, per kurį atvaizduojamas kiekvienas puslapis, todėl vienas įklijavimas apima visą parduotuvę. Shopify negali talpinti failų jūsų domeno šaknyje, todėl žyma neša jūsų AIDisclose svetainės raktą (data-aidisclose) ir įkelia mūsų už jus talpinamą manifestą.
theme.liquid <script src="https://cdn.aidisclose.io/v1/aidisclose.js" data-aidisclose="YOUR_SITE_KEY" defer></script>Susiekite savo deklaraciją
Įklijuokite šią nuorodą tame pačiame faile viduje <head>. Jūsų valdymo skydelis rodo abi eilutes iš anksto užpildytas su jūsų svetainės raktu.
<head> <link rel="ai-disclosure" href="https://cdn.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY">Tai pagal specifikaciją leidžiamas metodas.
-
Patikra
Baigta, kai tikriklis rodo 1 lygį · Deklaruota su pastaba. Tai yra tikėtinas rezultatas šioje platformoje, ir jis atitinka reikalavimus.
Vykdyti tikriklį
Webflow
Pridėkite fragmentą
Site settings → Custom code → Footer code: įklijuokite žemiau esantį fragmento bloką ir paskelbkite (Publish). Svetainės lygio pasirinktinis kodas įkeliamas kiekviename puslapyje.
Footer code <script src="https://cdn.aidisclose.io/v1/aidisclose.js" data-aidisclose="YOUR_SITE_KEY" defer></script>Susiekite savo deklaraciją
Head code skiltyje pridėkite deklaracijos nuorodos eilutę (antras blokas žemiau). Norite failą pateikti iš savo domeno? Naudokite tarpinį serverį (proxy) skiltyje Advanced, jei jūsų DNS eina per Cloudflare.
Head code <link rel="ai-disclosure" href="https://cdn.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY">Tai pagal specifikaciją leidžiamas metodas.
-
Patikra
Baigta, kai tikriklis rodo 1 lygį · Deklaruota su pastaba. Tai yra tikėtinas rezultatas šioje platformoje, ir jis atitinka reikalavimus.
Vykdyti tikriklį
Squarespace
Pridėkite fragmentą
Settings → Advanced → Code Injection → Footer: įklijuokite žemiau esantį fragmento bloką. Kodo įterpimas taikomas kiekvienam puslapiui. Tam reikia Business plano.
Footer <script src="https://cdn.aidisclose.io/v1/aidisclose.js" data-aidisclose="YOUR_SITE_KEY" defer></script>Susiekite savo deklaraciją
Header injection skiltyje pridėkite deklaracijos nuorodos eilutę (antras blokas žemiau).
Header <link rel="ai-disclosure" href="https://cdn.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY">Tai pagal specifikaciją leidžiamas metodas.
-
Patikra
Baigta, kai tikriklis rodo 1 lygį · Deklaruota su pastaba. Tai yra tikėtinas rezultatas šioje platformoje, ir jis atitinka reikalavimus.
Vykdyti tikriklį
Google Tag Manager
Sukurkite žymą
New tag → Tag configuration → Custom HTML → įklijuokite fragmentą. Aktyvinimas: All Pages (Page View). Nenaudokite uždelsto ar slinkties aktyvinimo: atskleidimo taisyklės reikalauja pranešimo nuo pirmo poveikio. Paskelbkite darbo sritį.
Custom HTML <script src="https://cdn.aidisclose.io/v1/aidisclose.js" defer></script>Paskelbkite ir savo deklaraciją
Tag Manager tvarko tik pranešimus. Jūsų deklaracijos failą vis tiek reikia paskelbti: atlikite savo platformos žingsnį kituose skirtukuose arba Custom code skirtuke, jei valdote savo svetainę.
-
Patikra
Baigta, kai tikriklis rodo 2 lygį · Atvaizduota.
Vykdyti tikriklį
Savas kodas
Pridėkite fragmentą
Vieną kartą savo svetainės šablone ar išdėstyme, prieš </body>, kad jis būtų pateikiamas su kiekvienu puslapiu. Gamybinis sutvirtinimas (versijos fiksavimas, SRI) yra skiltyje Advanced.
HTML <script src="https://cdn.aidisclose.io/v1/aidisclose.js" defer></script>Pateikite deklaracijos failą
ai-disclosure.json turi būti pasiekiamas adresu /.well-known/ jūsų domene. Jei naudojate Vercel arba Netlify, įtraukite failą. Jei jūsų karkasas kiekvieną maršrutą perrašo į index.html, šiam failui reikia išimties: žr. Vieno puslapio programos skiltyje Išplėstiniai nustatymai. nginx ir Apache konfigūracijos taip pat pateikiamos skiltyje Išplėstiniai nustatymai.
Vercel / Netlify # Vercel / Netlify: commit the file public/.well-known/ai-disclosure.json # SPA that rewrites every route to index.html? # Exclude /.well-known/ from the rewrite (see Advanced).-
Patikra
Baigta, kai tikriklis rodo 2 lygį · Atvaizduota.
Vykdyti tikriklį
Patikra
Vykdykite tikriklį. Jis patvirtina tris dalykus: jūsų deklaracijos failas galioja, fragmentas veikia, o pranešimai iš tikrųjų pasirodo puslapyje. (Inžinieriams: patikros C1, C3 ir C4–C6.)
Jei jūsų svetainė blokuoja mūsų tikriklį (AIDiscloseBot)
Patikros ir įrodymų fiksavimai atliekami iš AIDiscloseBot/1.0. Jis skaito tik viešus puslapius: niekada neprisijungia, niekada nepateikia formų ir laikosi robots.txt. Jei jūsų robots.txt ar apsauga nuo robotų blokuoja nežinomus robotus, leiskite jį aiškiai:
User-agent: AIDiscloseBot
Allow: /
Ar leisti jį rizikinga? Ne. robots.txt leidimas nesuteikia jokios prieigos. Jis tik nurodo mandagiems robotams, kad jie gali skaityti jau viešus puslapius. Bet kas gali suklastoti User-Agent eilutę, tačiau klastotojas negauna nieko, ko jūsų vieši puslapiai jau neduotų.
Jei srautą filtruojate WAF arba robotų valdymo sistema, niekada neleiskite vien pagal User-Agent. Derinkite tai su šaltinio patikra. Mes skelbiame savo roboto tapatybę ir išeinančio srauto IP diapazonus, kai jie priskiriami, adresu aidisclose.io/bot.json.
Papildomai
Theming with CSS variables, custom copy, single-page-app setup, and the full option reference are in the snippet reference.
Užfiksuokite scenarijų prie tikslios versijos (SRI)
Vientisumo maiša scenarijaus žymoje priverčia naršyklę atsisakyti vykdyti pakeistą failą. Užfiksuokite versijos URL ir sugeneruokite maišą iš tikslaus diegiamo failo:
curl -sO https://cdn.aidisclose.io/v1/aidisclose.js
openssl dgst -sha384 -binary aidisclose.js | openssl base64 -A
Pateikite failą patys (nginx / Apache)
Jūsų valdomiems serveriams tiesiogiai pateikite atsisiųstą ai-disclosure.json:
location = /.well-known/ai-disclosure.json {
alias /var/www/site/ai-disclosure.json;
default_type application/json;
add_header Cache-Control "max-age=3600";
}
Alias "/.well-known/ai-disclosure.json" "/var/www/site/ai-disclosure.json"
<Files "ai-disclosure.json">
ForceType application/json
</Files>
Pateikite valdymo skydelyje talpinamą failą iš savo domeno
Jūsų serveris persiunčia užklausas tuo vienu adresu mums: jūs redaguojate failą valdymo skydelyje, o jis vis tiek pateikiamas iš jūsų domeno. Valdymo skydelis rodo šiuos iš anksto užpildytus su jūsų svetainės raktu.
location = /.well-known/ai-disclosure.json {
proxy_pass https://cdn.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY;
proxy_set_header Host cdn.aidisclose.io;
proxy_ssl_server_name on;
}
export default {
async fetch(request) {
const url = new URL(request.url);
if (url.pathname === "/.well-known/ai-disclosure.json") {
return fetch("https://cdn.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY");
}
return fetch(request);
}
};
Vieno puslapio programos ir statiniai serveriai
Karkasai, kurie kiekvieną maršrutą perrašo į index.html, ir kai kurie statiniai serveriai perima /.well-known/ai-disclosure.json ir grąžina jūsų programos HTML su 200 būsena. Atrodo, kad failas įtrauktas, tačiau tikrintuvas nuskaito HTML, o ne manifestą. Du sprendimai: pašalinkite /.well-known/ iš universaliojo perrašymo, kad statinis failas būtų pateikiamas su application/json tipu, arba prie script žymės pridėkite data-aidisclose="YOUR_SITE_KEY", kad būtų įkeltas AIDisclose talpinamas manifestas ir failo apskritai nereikėtų pateikti.
# netlify.toml: serve the real file before the SPA fallback
[[redirects]]
from = "/*"
to = "/index.html"
status = 200
force = false # a real file at the path wins over this fallback
# vercel.json: rewrite everything EXCEPT /.well-known to the app
{ "rewrites": [
{ "source": "/((?!\.well-known/).*)", "destination": "/index.html" }
] }