Руководство по JSON-LD для начинающих [код Json Ld]
Взгляды автора являются полностью его собственными (за исключением маловероятного случая гипноза) и могут не всегда отражать взгляды Моза.
Что такое JSON-LD?
JSON-LD означает Нотация объектов JavaScript для связанных данных a, состоящих из многомерных массивов (подумайте: список пар атрибут-значение).
Это формат реализации для структурирования данных, аналогичный Microdata и RDFa. Как правило, с точки зрения SEO, JSON-LD реализуется с использованием словаря Schema.org, совместной работы Google, Bing, Yahoo! и Яндекса в 2011 году для создания единого словаря структурированных данных для Интернета. (Однако Bing и другие поисковые системы официально не заявляли о своей поддержке JSON-LD-реализаций Schema.org.)
JSON-LD считается более простым в реализации из-за возможности просто вставлять разметку в HTML-документ, а не оборачивать разметку вокруг элементов HTML (как в случае с микроданными).
Что делает JSON-LD?
JSON-LD аннотирует элементы на странице, структурируя данные, которые затем могут использоваться поисковыми системами для устранения неоднозначности элементов и установления фактов, окружающих объекты, что затем связано с созданием более организованной и лучшей сети в целом.
Рис. 1. Концептуальная визуализация JSON-LD, принимающая неструктурированное содержимое в Интернете, комментируя и структурируя содержимое для создания организованного структурированного результата.
Где в HTML (для веб-страницы) находится JSON-LD?
Google рекомендует добавлять JSON-LD в раздел документа HTML; однако это нормально, если JSON-LD находится в разделе. Google также может захватывать динамически генерируемые теги в DOM.
Разбивка JSON-LD
Неизменяемые теги (подумайте: вам не нужно запоминать их, просто скопируйте/вставьте)
Pro Совет: Закрывайте каждый тег, который вы открываете, когда открываете его. Подумайте: соль идет с перцем, а открывающая скобка идет с закрывающей скобкой.Примечание: Если ваш JSON-LD не заключен в фигурные скобки, он не анализируется (т. е. не скручивается).
"@context": "
The">http://schema.org",
Второй элемент, сохраняющий постоянное место в разметке JSON-LD, — это @context со значением http://schema. .org. @context говорит: "Эй, браузер, это словарь, на который я ссылаюсь. Вы можете найти его на http://schema.org". Преимущество SEO заключается в том, что мы можем использовать любые типы элементов и свойства элементов, которые определяет Schema.org.
Кроме того, вы, вероятно, обратили внимание на милую запятую, похожую на ресницу, в конце утверждения. Запятые означают: «Есть еще. Не прекращайте синтаксический анализ данных».
Совет для профессионалов: Следите за запятыми (и всегда проверяйте их с помощью Инструмента тестирования структурированных данных Google). Запятые — традиционное больное место для многих программистов, и JSON-LD не дает здесь утешения. Пропущенные запятые означают недопустимую разметку. |
"@Type": "…",
Последним элементом команды копирования/вставки схемы JSON-LD является спецификация @type (после двоеточия она становится аннотацией всех данных). @type указывает тип размечаемого элемента. Полный список всех типов элементов можно найти по адресу: https://schema.org/docs/full.html .
В приведенном ниже примере @type говорит: «Эй, я использую тип элемента Person (его можно найти на http://schema.org/Person)». Действительно, если вы введете URL-адрес в браузер, должны появиться документация и технические характеристики типа элемента, включая любые свойства элемента (и часто некоторые примеры использования).
@type для вложения: Когда вы используете вложенный тип элемента, вам потребуется вложить другой @type (это особенно важно для понимания разметки продукта и хлебных крошек).
Пары атрибут-значение
Следующим шагом является аннотирование информации о типе элемента. Вы можете найти свойства элемента на странице типа элемента Schema.org.
С точки зрения синтаксиса JSON-LD для каждого свойства элемента есть два важных элемента:
- Свойство элемента – Это взято из словаря Schema.org и всегда должно быть в двойных прямых кавычках (здесь это может показаться педантичным, но на самом деле фигурные и одинарные кавычки разные и будут мешать проверке ) и должны принадлежать к свойствам, разрешенным в пределах типа элемента (как указано в Schema.org).
- Значение – Здесь вы вставляете свое значение свойства. Крайне важно, чтобы значение соответствовало свойству и было единственным (т.
е. каждое значение должно быть аннотировано отдельно. В случае нескольких значений свойства элемента используйте квадратные скобки). Строки (символы) и URL-адреса нуждаются в «двойных прямых кавычках». Числа, целые числа, числа с плавающей запятой или двойные числа (для склонных к программированию) сами по себе не нуждаются в кавычках, но также можно помещать их в кавычки (это просто означает, что они будут считаться 9).0009 строка тип данных).
Квадратные скобки
Квадратные скобки используются для ситуаций, когда для свойства элемента имеется несколько значений. Распространенным использованием является использование свойства элемента sameAs как использование [квадратных скобок] для перечисления нескольких платформ социальных сетей.
Квадратные скобки ниже говорят: «Для этого типа элемента существует несколько значений; У Джейсона Деруло два имени.
Примечание: После последнего элемента в квадратных скобках запятая не ставится. Это означает, что в квадратных скобках больше нет информации.
Вложенность
Вложенность определяется как организация информации слоями или когда объекты содержат другие объекты. Образ матрешки является распространенной аналогией, где большие куклы содержат внутри себя меньших кукол, как визуальный элемент реляционной организации данных.
Рис. 2. Источник изображения
Гнездо — жизненно важный аспект для точной разметки Schema.org JSON-LD, потому что у вас будут определенные свойства элемента, принадлежащие типам элементов, которые не принадлежат другим. Например, ниже мы видим свойство элемента " имя"
Сопоставьте правильное имя свойств элемента с соответствующим типом элемента:
Вложение в JSON-LD начинается со свойства элемента. В первом типе элемента (например, Фильм ) вы должны сначала использовать свойство элемента (например, актер, режиссер, изображение ). Это свойство элемента идентифицируется, и затем мы должны открыть фигурные скобки с новым типом элемента (как указано "@type":) и данными атрибута/значения.
Контрольный список вложения JSON-LD:
- Необходимо использовать свойство элемента (зависит от типа элемента)
- Значение находится в фигурных скобках
- Вы ДОЛЖНЫ определить тип элемента этого свойства
- Свойства атрибута/значения должны быть включены (обычно существуют требования к тому, что должно быть включено)
- Без запятой перед закрывающей фигурной скобкой
- Запятая после закрывающей фигурной скобки, если есть еще свойства элемента (если нет, то после нее будет фигурная скобка)
Совет для профессионалов: Делайте отступы для вложенных элементов для удобства чтения. |
Обычное использование: В разметке типа товара Product , Price вложен в тип элемента Offer , и рейтинги также вложены!
Подводные камни
Если ваша разметка не проходит проверку в инструменте тестирования структурированных данных Google и вы не уверены, что происходит, проверьте этот список. Ниже приведены некоторые основные подводные камни при создании разметки структурированных данных JSON-LD.
- Синтаксис
- « » не то же самое, что «» (фигурные против прямых; борьба настоящая)
- Следите за запятыми
- Особо обратите внимание на маленькую красную букву «x» инструмента проверки структурированных данных на левой направляющей. Часто «x» появляется после отсутствующей или лишней запятой .
- Словарь
- Обратите внимание на обязательные/разрешенные свойства на странице спецификации каждого типа элемента Schema.org
- Всегда проверяйте в инструменте тестирования структурированных данных Google
- Нарушение политики
- Вся аннотированная информация должна быть на странице; добавление информации, которой нет на странице, скорее всего, не будет отображаться в результатах поиска, что противоречит рекомендациям Google .
- Также запрещено правилами заниматься манипулятивными практиками (не ловушка, о которой я беспокоюсь за вас!)
- Проверить/пересмотреть политику Google в отношении структурированных данных
- Microsoft (извините, Билл, я все еще большой поклонник!)
- Копирование/вставка из Word/Excel может создать проблемы (добавлены кавычки, добавлено форматирование стилей)
- Microsoft переключает "" на ""
- Решение: используйте редактор HTML
Процесс добавления JSON-LD на сайт
Процесс создания разметки структурированных данных JSON-LD зависит от удобства работы со словарем Schema. org и синтаксисом JSON-LD. Ниже описан процесс создания разметки для новичков в JSON-LD и Schema.org при одновременном развитии более глубокого понимания словарного запаса.
- Мысленно ответьте:
- Что вы хотите отметить?
- Цель: Определить, что вы можете размечать контент с помощью словаря Schema.org. Некоторые вещи могут иметь смысл концептуально, но недоступны в словарном запасе.
- Почему вы хотите сделать разметку?
- Цель: Определите, есть ли экономическое обоснование, или, возможно, вы хотите поэкспериментировать. Вы не хотите размечать контент только ради того, чтобы разметить его; вы хотите разметить контент, который поможет поисковым системам понять наиболее важную информацию на вашей странице и максимально продемонстрировать, что вы лучший ресурс для пользователей.
- Найдите ресурсы о разметках, которые поддерживает Google, о том, как они их используют, и примеры.
- Что вы хотите отметить?
- Если вы используете разметку, которую явно использует Google (т.
е. ресурсы Google), откройте конкретную страницу документации и все соответствующие примеры.
- Не думайте, что вам нужно создавать разметку JSON-LD с нуля. Используйте примеры Google для обратного проектирования вашей разметки. (Это не умаляет вашего понимания JSON-LD и словаря Schema.org; однако не нужно изобретать велосипед! #эффективность ☺).
- Откройте страницу типа элемента Schema.org
- Особенно, когда вы начинаете работу со Schema.org, просматривая страницу технической документации Schema.org, чтобы получить представление о том, что влечет за собой тип элемента, сколько сайтов использует эту разметку и ее различные свойства, может облегчить лучшее понимание по мере того, как вы продолжаете свое путешествие по структурированным данным. Через некоторое время этот шаг может стать необходимым только при попытке новой разметки или поиске углового случая.
- Скопируйте/вставьте неизменяемые элементы (например, из