Как Astrina вписывается в настройку сайта
Astrina — это тот инструмент, который устанавливают один раз, а потом регулярно проверяют. Он помогает сайту отправлять данные о посещениях и событиях в одну панель управления, чтобы вы могли видеть, справляются ли страницы, теги и кампании со своей задачей. Если вы ведёте не один сайт, это быстро становится важным. Для более широкого понимания структуры аккаунта и рабочего процесса см. каждый сайт, который вы ведёте.
Прежде чем трогать код, убедитесь, что выполнены 2 условия: есть доступ к глобальному шаблону сайта и есть доступ к аккаунту Astrina. Если сайт работает на CMS, в tag manager или на кастомной сборке, у кого-то должны быть права на редактирование header или footer. Нет доступа — нет установки. Это звучит очевидно, но именно так чаще всего и возникают задержки, когда вы разбираетесь, как установить Astrina на сайт.
Сначала доступ к панели управления стоит дать только нескольким людям. Отдайте его владельцу, разработчику или маркетологу, который отвечает за отчётность, а не каждому сотруднику. Небольшое изменение сейчас может сэкономить много лишней работы позже, особенно если кто-то вставит не тот фрагмент не в тот шаблон. Одной ошибки достаточно.
Шаг 1: Скопируйте трекинг-скрипт Astrina
Начните в панели Astrina и найдите раздел отслеживания для своего сайта. Найдите скрипт, который Astrina сгенерировала для вашего ресурса, и скопируйте его точно в таком виде, как он показан. Без правок. Без обрезки. Без «очистки». Это первая часть того, как добавить Astrina на сайт пошагово.
Если в скрипте есть site ID или account ID, сохраните каждый символ на месте. Разработчику может захотеться встроить код в уже существующий bundle или убрать переносы строк, но это плохая привычка, если только поддержка Astrina не сказала иначе. Если в фрагменте ошибка хотя бы в одном символе, сайт может продолжать загружаться, а отслеживание будет тихо ломаться. Это худший вариант сбоя.
Используйте кнопку копирования в браузере, если она есть. Если копируете вручную, проверьте открывающие и закрывающие теги, кавычки и все data attributes. Самая безопасная привычка проста: сначала вставьте в обычный текстовый редактор, а потом перенесите на сайт. Две копии, одна проверка.
Шаг 2: Установите трекинг-скрипт на сайт
Главная идея — установить трекинг-скрипт в глобальное место, чтобы он загружался на каждой странице. На большинстве сайтов это означает общий header, footer, базовый layout или контейнер tag manager, который срабатывает на всём сайте. Если он попадёт только на главную страницу, данные будут выглядеть чистыми, но неверными. Поэтому этот шаг так важен в процессе того, как установить Astrina на сайт.
Базовый процесс такой:
- Откройте шаблон сайта или tag manager.
- Найдите глобальную область, которая используется всеми страницами.
- Вставьте скрипт Astrina в разрешённое место.
- Сохраните изменения.
- Опубликуйте сайт или контейнер.
На разных платформах эта область называется по-разному. В WordPress это может быть theme header или plugin. В Shopify часто используются файлы темы. В Webflow может применяться проектный custom code. На кастомном сайте это может быть layout-файл в app shell. Название меняется, логика — нет. Один общий шаблон, одна установка.
Если вы используете tag manager, убедитесь, что тег срабатывает на всех страницах, а не только на одном маршруте. В single-page apps нужен особый подход, потому что первая загрузка и последующие переходы между маршрутами — это не одно и то же. В такой конфигурации скрипту может понадобиться специальный event hook. В продакшене такие вещи не стоит оставлять на догадку.
Для агентств и команд, которые ведут несколько доменов, полезно держать чек-лист рядом с установкой. Централизованный обзор вроде все сайты клиентов в одной панели может сократить дублирование работы, но только если для каждого сайта используется свой правильный фрагмент. Одна панель не исправит неверную вставку.
Шаг 3: Добавьте один тег перед закрывающим body
На многих сайтах самое аккуратное место для добавления одного тега перед закрывающим body — прямо над тегом </body>. Astrina часто хорошо работает там, потому что сначала загружается контент страницы и основной layout, а потом скрипт выполняется ближе к концу документа. Это помогает, когда другие скрипты уже конкурируют за внимание. Порядок имеет значение.
Практически это выглядит так. Откройте шаблон страницы, прокрутите вниз и найдите закрывающий тег body. Разместите фрагмент Astrina прямо перед ним, не внутри случайного блока контента и не в поле, привязанном только к одной странице. Обычно правильное место — общий footer или глобальный файл layout. Именно это чаще всего имеют в виду, когда спрашивают, как установить Astrina на сайт.
Это место рекомендуется, чтобы страница успела отрисоваться, а трекер загрузился после того, как основной HTML уже на месте. Если вы работаете в редакторе CMS, убедитесь, что выбранное поле применяется ко всему сайту, а не только к одному типу страниц. Фрагмент не в том поле может отлично выглядеть в предпросмотре и исчезнуть после публикации. Такое случается чаще, чем готовы признать.
Чтобы подтвердить размещение, откройте исходный код страницы в браузере и найдите фрагмент Astrina. Он должен быть ближе к концу документа, прямо перед </body>. Если вы видите его дважды, остановитесь и исправьте это. Дублирующиеся теги могут исказить счётчики и поведение событий. Два тега — не плюс.
Шаг 4: Опубликуйте, обновите страницу и проверьте установку
После добавления кода сохраните шаблон и опубликуйте изменения. Затем обновите страницу в обычном окне браузера, а не только в предпросмотре редактора. Если сайт кэшируется, сделайте жёсткое обновление один раз, чтобы не оценивать старую копию страницы.
Теперь проверьте панель Astrina на наличие визита, события или live signal, если продукт это показывает. Некоторые системы отображают данные за секунды; другим требуется больше времени. Если ничего не появляется, убедитесь, что фрагмент находится на живом сайте, а не только в черновой версии. Черновики умеют очень вежливо врать.
Простая диагностика выглядит так: откройте инструменты разработчика, найдите запрос к скрипту и посмотрите, загружается он или блокируется. Политика безопасности контента, ad blocker или плагин для оптимизации сайта могут остановить запрос. Если в консоли браузера есть ошибка, скопируйте сообщение, прежде чем менять что-либо ещё. Одно сообщение об ошибке стоит больше пяти догадок.
Если вы сравниваете тарифы или решаете, кто должен сохранить доступ после запуска, детали ценообразования Astrina могут пригодиться позже; сейчас же нужно сначала убедиться, что установка работает на live URL. Держите фокус на одном результате: сайт отправляет данные или нет. Промежуточного варианта нет.
Шаг 5: Проверьте ключевые страницы и подтвердите поток данных
Не останавливайтесь на главной странице. Откройте как минимум 3 важные внутренние страницы, например страницу товара, страницу контактов и запись блога или страницу категории. Если сайт использует несколько шаблонов, каждый шаблон должен загружать Astrina одинаково. Одна работающая страница — не доказательство. Три страницы дают больше уверенности и практически завершают процесс того, как добавить Astrina на сайт пошагово.
Проверьте сайт на десктопе и на мобильном устройстве. Некоторые команды тестируют только на ноутбуке и пропускают скрипт, который ломается в mobile-only layout или в кэшированном app shell. Если главная страница отслеживается, а страница товара — нет, проблема обычно связана с конкретным шаблоном. В этот момент нужно смотреть shared layout, а не content editor.
По возможности проверьте стабильность потока данных после обновлений, в новых сессиях и в разных браузерах. Хороший набор для теста прост: Chrome на десктопе, Safari или мобильный браузер на телефоне и одно приватное окно. Если все 3 варианта фиксируют визиты или события, установка работает в обычных условиях.
Для команд, которым также важны SEO и ранжирование страниц, полезно сравнить отслеживаемые страницы с важными страницами из контент-плана. Страницы astrina могут использоваться вместе с задачами по отслеживанию, когда нужна отчётность, связанная с производительностью сайта, а не только с визитами. Смысл в том, чтобы подтвердить: Astrina видит именно те страницы, которые вам важны.
Распространённые проблемы при добавлении Astrina на сайт
Дублирование скриптов быстро создаёт путаницу. Если фрагмент есть и в header, и в footer, или и в tag manager, и в жёстко прописанном шаблоне, вы можете увидеть удвоенные визиты или дубли событий. Удалите одну копию и проверьте ещё раз. Один скрипт, один путь на сайте.
Следующий частый подозреваемый — кэш. Кэш сайта, CDN-кэш или кэш браузера могут оставить старый код активным после публикации. Очистите все 3, если можете, и затем перезагрузите страницу. Если плагин кэша переписывает скрипты, проверьте, не задерживает ли он код Astrina и не объединяет ли его так, что это ломает работу.
Ошибки размещения в CMS тоже случаются. Кто-то вставляет скрипт в поле записи блога, виджет конструктора страниц или шаблон, который используется только на одной странице. Это работает, пока вы не откроете остальную часть сайта и не обнаружите, что данных нет совсем. Исправление скучное: переместите скрипт в общий layout или глобальную настройку. Скучно — здесь хорошо.
Блокировка скриптов — ещё одна частая проблема. Расширения браузера, инструменты согласия, правила firewall и политики безопасности контента могут помешать загрузке Astrina. Если вы видите заблокированный запрос, протестируйте в чистом профиле браузера и на другом устройстве. Одно расширение может сделать вид, что сломана вся установка. Люди любят ставить себе лишние блокировки.
Если после проверки фрагмента, шаблона, кэша и браузера установка всё равно не отображается, обратитесь в поддержку с точным URL страницы, местом размещения кода и скриншотом исходника. Так у поддержки Astrina будет конкретный материал для проверки, а не расплывчатое «не работает». Конкретика всегда лучше расплывчатости. Если нужно решить, использовать ли после установки alerts или daily summaries, см. стоит ли выбрать аналитические уведомления.
И ещё одна последняя проверка: убедитесь, что версия сайта в production совпадает с той, которую вы редактировали. Команды иногда тестируют на staging, а затем публикуют другой branch или theme и удивляются, почему данные пропали. Проверьте live URL, live template и live source. Три места, один ответ.
