Към съдържанието
Get Ranked On TopИлюстративен казусПлан Signal

Измислен бизнес. Цифрите са моделиран сценарий, а не резултат на клиент.

Ferrovane · Платформа за наблюдаемост и логове · Берлин

Как платформа за наблюдаемост направи видими за Google 6000 страници с документация, рендерирани с JavaScript

+341%индексирани страници с документация
за 8 месеца · Signal
6040 URL адреса с документацияМ0 · 1120М8 · 4940
CH1 · ИНДЕКСИРАНИ СТРАНИЦИ
РАЗВИВКА = 8 МЕСЕЦА
ТРИГЕР · ГОТОВ

Входен сигнал · предизвикателството

Шест хиляди страници документация, а Google не можеше да прочете почти нито една.

Документацията на Ferrovane беше SPA, рендерирано в браузъра, затова Google индексираше под една пета от нея, а разработчиците попадаха на ръководствата на конкурентите.

На хартия документацията беше най-добрият канал на Ferrovane за привличане на клиенти: 6040 ръководства, рецепти за колектори и API справочници, написани от самите инженери, създали продукта. Но сайтът беше single-page приложение, рендерирано в браузъра. Googlebot изтегляше празна обвивка, слагаше я на опашка за рендериране и често се отказваше, преди съдържанието да се зареди. Разработчиците, които търсеха точни съобщения за грешки и конфигурационни фрагменти, попадаха на уроци на конкуренти – много от тях обясняваха как се свързва Ferrovane.

18,5%от URL адресите с документация бяха индексирани в началото (1120 от 6040).
Какво изтегли Googlebot
<html>
  <body>
    <div id="root"></div>
    <script src="/app.9f3c.js">
    <!-- 1.9 MB -->
  </body>
</html>
Какво видя разработчикът
# Configure the OTel collector

exporters:
  ferrovane:
    endpoint: ingest.eu.ferrovane.example
    compression: zstd

Диагноза · дневник на повредите

Седем повреди между документацията и индекса.

Прочетохме 30 дни сървърни логове, сравнихме суровия и рендерирания HTML за всеки URL и обходихме сайта с изключен JavaScript. Повредите се разделиха в четири групи: рендериране, архитектура, crawl бюджет и международни версии.

  1. E-101КРИТИЧНОРендериране

    Документацията се доставяше като празен <div id="root"> плюс пакет от 1,9 МБ. Опашката за рендериране на Googlebot стигаше до повечето страници с дни закъснение, а при API справочниците, които зареждаха съдържанието си след хидратацията, времето изтичаше.

    > Думи в суровия HTML: 0 при 5880 от 6040 URL

  2. E-102КРИТИЧНОРендериране

    Навигацията беше изградена от onClick обработчици върху <span> елементи, така че роботът не намираше нито една <a href> връзка между разделите. Повечето ръководства бяха страници сираци.

    > Вътрешни връзки в суровия HTML: средно по 3 на страница

  3. E-207СЕРИОЗНОАрхитектура

    Шест версии (от v3.0 до v3.5) бяха публикувани под различни пътища без canonical. Google упорито избираше стари страници от v3.1 за представителен URL.

    > Клъстери с дублирано съдържание: 2310 URL в 6 версии

  4. E-214СЕРИОЗНОАрхитектура

    Маршрутизацията с хеш фрагменти (/docs#/collectors/otel) сливаше хиляди страници в един-единствен URL от гледна точка на търсачките.

    > Уникални URL, достъпни за обхождане: 412 от 6040

  5. W-318СЕРИОЗНОCrawl бюджет

    Фасетните параметри на API експлорера и сесийните токени създаваха практически безкрайно пространство от URL адреси. Googlebot харчеше там 71% от заявките си.

    > Обхождане на неканонични URL: 71%

  6. W-322НЕЗНАЧИТЕЛНОCrawl бюджет

    Преименуваните страници връщаха soft 404: код 200 с компонент „не е намерено“. Картите на сайта съдържаха 1400 URL, които пренасочваха.

    > Грешки при обхождане на седмица: 3840

  7. W-405СЕРИОЗНОHreflang

    Документацията на немски и японски се зареждаше в браузъра на същия URL като английската, така че нямаше езиков URL, който да се анотира, и немските страници така и не бяха индексирани.

    > Индексирани страници на DE/JA: 0

Калибриране · стратегията

Четири канала, всеки настроен поотделно.

Работата мина по нашия план Signal за техническо SEO. Всяка тактика премахваше един източник на шум и идваше с проверка, за да не може поправката тихомълком да се върне назад при следващото издание.

CH1

Рендериране на JavaScript

Преместихме документацията от SPA, което работи само в браузъра, към статично предварително рендериране при build, с инкрементално регенериране при всяко издание. Всяка страница вече носи пълния си текст, заглавията и примерите с код още в първия HTML отговор; JavaScript само добавя интерактивност.

Проверка за съответствие на суровия HTML в CI: build-ът се проваля, ако рендерираният и суровият текст се различават с над 2%.

CH2

Архитектура на документацията

Заменихме хеш маршрутите с истински пътища (/docs/collectors/otel), превърнахме span навигацията в нормални връзки и въведохме canonical „latest“, към който сочат версионните страници. Навигационни пътеки и най-много 3 клика до всяко ръководство.

Страници сираци: 4100 → 0. Медианна дълбочина на кликане: 7 → 3.

CH3

Crawl бюджет

Блокирахме фасетите на експлорера и сесийните параметри в robots.txt, махнахме токените от връзките, върнахме истински кодове 404/410 и разделихме картите на сайта по раздели с точни дати lastmod от хранилището на документацията.

Дял на обхождането върху канонични URL с документация: 29% → 94%.

CH4

Hreflang

Дадохме на всеки език собствена подпапка (/de/, /ja/) със сървърно рендериране, после добавихме взаимни hreflang и x-default както в HTML head, така и в картите на сайта – генерирани от манифеста на преводите, за да не се разминават.

Грешки в обратните hreflang тагове: 1960 → 0.

Времева база · 1 деление = 1 месец

8 месеца – от сондиране до захват.

  1. М01 · СОНДА

    Одит на обхождането и рендерирането

    Анализ на логовете за 30 дни посещения на Googlebot, сравнение на суров и рендериран HTML за всеки URL и изходна база от 1120 индексирани страници с документация.

  2. М02 · СОНДА

    Пилот с предварително рендериране

    Ръководствата за колектори (420 страници) бяха рендерирани предварително зад флаг. Индексираните страници в раздела се увеличиха от 61 на 388 за пет седмици.

  3. М03 · НАСТРОЙКА

    Рендериране навсякъде

    Статично рендериране за всички 6040 страници. Добавена е проверка за съответствие в CI. Span навигацията е изградена наново с истински връзки.

  4. М04 · НАСТРОЙКА

    Миграция на URL

    Хеш маршрутите са заменени с пътища, над 6000 пренасочвания 301 едно към едно, canonical на версиите сочат към „latest“.

  5. М05 · ФИЛТЪР

    Почистване на crawl бюджета

    Блокирани фасетни и токен параметри, поправени soft 404, карти на сайта по раздели с реален lastmod.

  6. М06 · ФИЛТЪР

    Езикови подпапки

    Документацията на немски и японски е преместена в /de/ и /ja/, със сървърно рендериране и взаимни hreflang.

  7. М07 · ЗАХВАТ

    Празноти в съдържанието

    Сравнителни страници и ръководства за 140 заявки на разработчици, по които се класираха уроци на конкуренти, а Ferrovane нямаше страница.

  8. М08 · ЗАХВАТ

    Мониторинг и предаване

    Проверките за рендериране, индексиране и hreflang са вградени в процеса по издаване, с известия към екипа на документацията.

Отчитане · резултати

Настройте всеки канал. Сигналът е бил там през цялото време.

  • Индексирани страници с документация
    1120 → 4940
  • Органични регистрации
    +88%
  • Грешки при обхождане
    -93%
  • Топ 10 по заявки на разработчици
    +620

Моделиран сценарий за измислен бизнес — не е резултат на клиент. Класирането и трафикът никога не са гарантирани; вижте нашите Общи условия.

Захванати канали: 0/4

CH1 · страници в индексаШум

Индексирани страници с документация

1120 → 4940

CH2 · органични регистрации, индекс = 100Шум

Органични регистрации

+88%

CH3 · грешки при обхождане / седмицаШум

Грешки при обхождане

-93%

CH4 · нови топ 10 по заявки на разработчициШум

Топ 10 по заявки на разработчици

+620

Завъртете копче (плъзнете го или го фокусирайте и използвайте стрелките), за да извадите всеки показател от шума.

Заявки на разработчици – преди и след

Позиция в Google, моделирана. „—“ означава извън първите 100.

ЗаявкаЕзикТърс./мес.М0М8
opentelemetry collector configEN6,6 хил.48#3
structured logging kubernetesEN2,9 хил.—#6
fluent bit json parserEN3,4 хил.22#4
trace sampling strategiesEN1,6 хил.—#8
promql vs logqlEN1,3 хил.67#5
log retention policy gdprEN88031#2
log management dsgvoDE1,1 хил.—#1
opentelemetry exporter einrichtenDE590—#3
ログ 監視 ツール 比較JA1,9 хил.—#7

Една страница с резултати – преди и след

„opentelemetry collector config“, моделирано.

М0 · #48

  1. 1. Урок на конкурент: настройка на OTel колектор
  2. 2. Уики на общността: справочник за конфигурацията на колектора
  3. 3. Блог: изпращане на логове с колектора

… Ferrovane е чак на страница 5

М8 · #3

  1. 1. Документацията на проекта OpenTelemetry
  2. 2. Урок на конкурент: настройка на OTel колектор
  3. 3. Ferrovane Docs › Collectors › Configure the OTel collector

Край на кривата

Вземете такъв план

Ако търсачките не виждат това, което виждат вашите потребители, Signal започва с одит на рендерирането и обхождането и превръща находките в поправки, които инженерите ви могат да пуснат.