Справочник настроек: GA4 и дополнения для AI-чтения

$ опубликовано 2026-11-13 | | обновлено 2026-11-14
Контекст: Типы, значения, условия загрузки GA4, публичные notes/links, языковые переопределения и границы машинного экспорта.

Независимые настройки посещений и публичных пояснений сайта.


Вывод
слов 1.4k токенов 1.8k

Китайские строки в примерах locales.zh сохранены намеренно: они показывают настройку китайского контента без изменения других языков. Китайские и английские значения по умолчанию в таблицах — цитаты из темы, а не пропущенный перевод.

Для первой публикации прочитайте размещение: там получение ID и назначение публичных текстов. Файл конфигурации — в установке, другие модули — в общем справочнике.

Обе группы находятся на верхнем уровне src/site.config.ts рядом с site/theme: analytics — статистика посещений, aiReadableContent — публичное текстовое дополнение сайта. Они независимы: статистике не нужно AI-дополнение, публичному экспорту — ID аналитики.

analytics.googleAnalyticsId: идентификатор GA4

Путь Тип / стандарт Состояние, действие и ограничения Пример
analytics { googleAnalyticsId: string } / { googleAnalyticsId: ‘’ } Контейнер с частичным переопределением; дополнительного enabled нет { googleAnalyticsId: ‘G-XXXXXXXXXX’ }
analytics.googleAnalyticsId string / ‘’ Условно: действительный формат, production и отсутствие исключения локального адреса загружают GA4. Пустота/пробелы отключают, крайние пробелы удаляются. Regex ^G-[A-Z0-9]+$ требует верхнего регистра; неверный формат вызывает ошибку разбора компонента ‘G-XXXXXXXXXX’

Это Measurement ID веб-потока GA4, не числовой ID ресурса, GTM, старый UA или API-ключ. Пример только демонстрирует формат, замените настоящим. Фиксированной длины нет, сеть не проверяет существование потока: прохождение regex не значит получение данных.

analytics: {
  googleAnalyticsId: 'G-XXXXXXXXXX',
},

Для отключения объедините:

analytics: { googleAnalyticsId: '' },

Добавьте в существующий defineThemeConfig({...}) без второго analytics. Один ID обслуживает языковые страницы общего каркаса; отдельных ID по языкам/страницам нет.

Когда загружается?

Среда или адрес Текущее поведение
npm run dev Загрузчика нет, но поле сначала разбирается, неверный формат может вызвать ошибку
Production, пустой ID Загрузчика нет
Production, localhost или .localhost-поддомен Ранний выход без очереди статистики темы и запроса Google
Production, адрес 127.*, 0.0.0.0, ::1 или [::1] Тоже пропуск; сравнение после нижнего регистра
Production, LAN IP или удалённый preview-домен Само название preview не исключает; с ID будет попытка загрузки
Production, настоящий домен и правильный формат ID Один раз инициализирует очередь gtag и асинхронно вставляет клиент Google

Тема выполняет js-инициализацию и config, не отправляет вручную дополнительный page_view и не добавляет события поиска/проигрывателя. Повторный загрузчик защищён одноразовым маркером, но не распознаёт другую установленную вами аналитику; проверьте дубли ручных скриптов/GTM.

Существующие window.dataLayer/window.gtag сохраняются. Панели согласия, автоматического согласия, прокси, списка исключаемых доменов и настройки событий нет. Специальной PUBLIC_GA_*-переменной для ID нет: при необходимости среду обрабатывает ваш site.config явно, произвольное имя тема не прочитает.

Отсутствие ANALYTICS у старого пользовательского adapter трактуется как ненастроенная аналитика. Это внутренняя совместимость, не рекомендуемый дополнительный путь. Заполняйте только analytics.googleAnalyticsId.

aiReadableContent: общее публичное дополнение

Необязательный объект MachineReadableSupplement, стандартно отсутствует. Экспорт создаётся и без него, просто без дополнительных пояснений. {} не выключает экспорт.

Полный путь Тип / стандарт Состояние, действие и ограничения Пример
aiReadableContent.notes string, необязателен / отсутствует, пустой вывод Условно: Markdown-пояснение сайта в публичных текстах; пустота/пробелы не выводятся. Не заменяет статью и не является приватным промптом AI ‘Здесь собраны личные учебные заметки, которые могут обновляться.’
aiReadableContent.links { label: string; href: string }[], необязателен / отсутствует, пустой список Условно: публичные дополнительные ссылки; массив заменяется целиком, [] очищает. Публичного лимита количества нет, цели не загружаются автоматически [{ label: ‘Страница проекта’, href: ‘https://example.com/project/’ }]
aiReadableContent.links[].label string, обязателен / нет Условно: непустое имя после trim; переносы превращаются в пробелы, обратные слеши/скобки экранируются. Заголовок цели не извлекается ‘Страница проекта’
aiReadableContent.links[].href string, обязателен / нет Условно: непустой, разрешается относительно корня публикации; только HTTP(S) без имени/пароля. Неверное вызывает ошибку, доступность цели не проверяется ‘https://example.com/project/’

Общей настройки длины notes/links нет, типы обязательны. Неверный тип, пустое имя, не-веб-протокол или учётные данные могут остановить сборку. Тема не выполняет команды дополнения и не вызывает модель для генерации текста.

Markdown и относительные ссылки

notes сохраняет Markdown, оформление и примеры кода. Разобранные цели ссылок, изображений и ссылочных определений становятся абсолютными и проверяются на HTTP(S) без credentials. Примеры внутри блоков кода не переписываются как настоящие цели. Это не полный валидатор произвольного HTML и не сервис скриншотов.

База — публичный корень сайта с Astro base, не статья или языковой каталог. Например, при корне https://example.com/project/:

href или цель Markdown Результат
zh/blog/ https://example.com/project/zh/blog/
/zh/blog/ https://example.com/zh/blog/
https://docs.example.com/guide/ Внешний адрес без изменений

Начальный / при вложенном размещении означает корень домена, не сохраняет /project/ автоматически. Это отличается от добавления BASE_URL компонентами музыки: не смешивайте правила. mailto:, tel:, file:, javascript: здесь не принимаются; правила экспорта контактных ссылок основного текста не означают их поддержку в дополнении.

Глобальный пример

aiReadableContent: {
  notes: 'Здесь собраны личные учебные заметки, которые могут обновляться. См. [список статей](ru/blog/).',
  links: [
    { label: 'Страница проекта', href: 'https://example.com/project/' },
  ],
},

Переопределение aiReadableContent для языка

Полный префикс — i18n.locales.<locale>.aiReadableContent, необязательный MachineReadableSupplement, стандартно не задан. Действие как у глобальных полей, но отсутствующие поля по отдельности наследуют глобальное:

Относительное поле Тип / стандарт Действие и ограничения Пример
notes string, необязателен / наследует глобальный notes Условно: дополнение языка; ‘’/пробелы явно очищают, не откатывают к другому языку ‘Китайский контент постоянно обновляется.’
links { label: string; href: string }[], необязателен / наследует глобальный links Условно: полная замена массива; [] очищает, не добавляет к глобальному []
links[].label string, обязателен / нет Нужен для своего элемента; проверки/экранирование как у глобального ‘Статьи на китайском’
links[].href string, обязателен / нет Нужен для своего элемента; база — корень публикации, не языковой каталог ‘zh/blog/’

Например, замените китайское пояснение и скройте дополнительные ссылки:

i18n: {
  locales: {
    zh: {
      aiReadableContent: {
        notes: '中文内容持续更新。',
        links: [],
      },
    },
  },
},

Только notes сохраняет глобальные links; {} наследует оба. undefined игнорируется, не очищает. Объект не использует meta.fallback и не копирует английское/резервное дополнение; см. откат языков.

Корневой llms.txt всегда использует глобальное дополнение, языковое — индексы, сборники и отдельные Markdown. Поэтому очистка всех языков не обходит неверное глобальное значение: корень всё равно его обработает.

В какие публичные файлы попадает дополнение?

Пути относительно корня публикации, при подпути добавьте префикс. Языковые индекс/сборник создаются только при реальном экспортируемом контенте: заполнение дополнения не создаёт статьи.

Результат Положение и содержимое
llms.txt Корневой вход; глобальный notes перед языковым каталогом, links отдельным блоком. Даже без экспортируемого контента может содержать глобальное дополнение
<locale>/llms.txt Языковой вход с переопределёнными пояснениями/ссылками и категориями Articles / Fragments / About реальных документов
<locale>/llms-full.txt Полный публичный сборник языка, дополнение перед набором документов
index.md статей и другой Markdown После текста — разделитель, маркер дополнения сайта и действительные пояснения, не смешанные с авторским текстом
<locale>/about/index.md Публичное представление/контакты About и доступная статическая AI-панель; дополнение в конце, не вся конфигурация инструментов
<locale>/fragments/index.md Объединённые публичные заметки страниц со стабильными ID-ссылками, дополнение в конце без дублирования сборника на каждую страницу

Фактический Markdown-путь определяется положением HTML: index.html соответствует index.md. Свой формат Astro может отличаться; не создавайте и не перезаписывайте результаты вручную. Экспортируемые страницы получают ссылки обнаружения Markdown и языкового индекса.

Экспортируются только отмеченные публично индексируемые статьи, About и Fragments с canonical того же origin. Главная, списки, формы Decoder и iframe комментариев по умолчанию не экспортируются как статьи. Ссылки/код/таблицы преобразуются из собранного контента, произвольные неотрендеренные конфиги не упаковываются. AI-окно About уже доступно публично, заполняйте как открытые сведения.

search: false исключает лишь Pagefind, не машинные результаты. Очистка notes/links не отключает текст. Нет aiReadableContent.enabled, исключения статьи, адреса AI, параметров модели или API key. Файлы предоставляют открытые материалы, не гарантируя обход, цитирование или рейтинг.

Генератор защищает одноимённые файлы вне своего исторического манифеста и сообщает конфликт. Не занимайте те же llms.txt/Markdown вручную в public/сборке. Исправьте источник, пересоберите и полностью разверните. Успех сборки не подтверждает онлайн-обновление или чтение моделью.

Связанные настройки и границы

  • Публичный адрес зависит от site.url, среды и Astro base; заголовок/описание корневого индекса — от контекста сайта. См. размещение. Изменение URL в пояснении не меняет canonical.
  • Включение языков влияет на стандартные страницы, но не удаляет старые файлы хостинга. Дополнение не создаёт переводы; см. языки.
  • GA4 управляет только статистикой, не поиском/RSS/экспортом. У дополнения нет своей кнопки интерфейса, переводимых labels или переключателя статистики.
  • ID GA4 и все поля дополнения потребляются. Дополнительных устаревших полей не нужно; отсутствие analytics в старом adapter — только совместимое отключение.

После изменений пересоберите и разместите. Статистика зависит от блокировок, сети и стороны аналитики; локальная проверка текста не заменяет онлайн-проверку статистики. Назад к общему справочнику.