Объект product содержит в себе переменные, которые описывают товар, представленный на сайте: URL с детальным описанием, цена, производитель, категория и т.д.

Объект product встречаются в структуре digitalData в составе других объектов и массивов, например: digitalData.product, digitalData.listing.items[].product, digitalData.cart.lineItems[].product, digitalData.recommendations[] и другие. Принцип заполнения объекта не меняется.

Навигация по странице


Введение


Объект product должен быть объявлен и заполнен в исходном коде страницы в следующих случаях:

  • На вашем сайте есть корзина, и в данный момент в корзине лежит 1 и более товаров. Объект product будет входить в массив lineItems объекта digitalData.cart;
  • Посетитель оформил заказ и находится на странице “Спасибо за покупку”. Объект product будет входить в массив lineItems объекта digitalData.transaction;
  • Если посетитель находится на странице детального описания товара. Объект product будет помещен в корень объекта digitalData;
  • Посетитель находится на странице с листингом товаров: категория или результаты поиска. Объект product будет входить в массив items объекта digitalData.listing
  • Посетитель находится на странице со списком рекомендованных товаров. Объект product будет входить в массив items массива digitalData.recommendation

Пример заполнения:

.product = {
  id: "1234567890",
  url: "http://website.com/product.html",
  imageUrl: "http://website.com/image.png",
  thumbnailUrl: "http://website.com/image_thump.png",
  name: "Ботинки Timberland",
  description: "Описание данного товара",
  manufacturer: "Timberland",
  category: ["Обувь","Ботинки"],
  categoryId: "123",
  currency: "RUB",
  unitPrice: 12990,
  unitSalePrice: 10990,
  skuCode: "TBL6065RW",
  stock: 21,
  voucher: "MYVOUCHER1",
  color: "желто-бежевый",
  size: "41",
  variations: [Product, Product, Product, ...]
}

Список переменных может быть расширен любыми другими свойствами товара, применимыми к вашему бизнесу.

product.id


Тип данных: строка.

product.id - обязательная переменная, которая содержит в себе идентификатор товара. У каждого товара может быть только один product.id. Существует 2 типа товаров: с вариациями и без вариаций. Если ваши товары имеют вариации, используйте переменную product.skuCode в сочетании с product.id. Это поможет отличить один товар разных размеров или комплектаций.

product.id должен соответствовать значению offer.group_id из вашего XML-фида в том случае, если вы используете XML-фиды с группировкой товаров. Группировки товаров часто встречаются на Fashion сайтах, когда product.id имеет одинаковое значение для всех размеров товара одного цвета. Для каждой цвето-модели product.id должен принимать уникальное значение.

Если у ваших товаров нет вариаций используйте связку product.id = offer.id(вашего XML-фида). В данном случае заполнять переменную product.skuCode необязательно.

product.skuCode


Тип данных: строка.

product.skuCode - обязательная переменная, которая содержит в себе идентификатор вариации товара. Если ваши товары имеют вариации, используйте переменную product.skuCode в сочетании с product.id. Это поможет отличить один товар разных размеров или комплектаций.

product.skuCode должен соответствовать значению offer.id из вашего XML-фида в том случае, если вы используете XML-фиды с группировкой товаров. Группировки товаров часто встречаются на Fashion сайтах, когда product.skuCode имеет уникальное значение для каждой вариации одного и того же товара. product.id при этом не меняется.

product.name


Тип данных: строка.

product.name - обязательная переменная, которая содержит в себе название товара.

product.currency


Тип данных: строка.

product.currency - обязательная переменная, которая содержит в себе валюту товара в формате ISO 4217 (USD, EUR, RUB).

product.unitPrice


Тип данных: число.

product.unitPrice - обязательная переменная, которая содержит в себе стоимость единицы товара, без учета скидок и акций.

product.unitSalePrice


Тип данных: число.

product.unitSalePrice - обязательная переменная, которая содержит в себе стоимость товара, включая все скидки и акции. Если на товар нет никаких скидок, переменная должна быть объявлена, значение должно совпадать с unitPrice.

product.category


Тип данных: массив строк.

product.category - обязательная переменная, которая содержит в себе иерархия категорий для данного продукта. Например, [“Мужская одежда”, “Обувь”, “Ботинки”]

product.categoryId


Тип данных: строка.

product.categoryId содержит в себе ID товарной категории данного товара.

product.categoryId должен совпадать с идентификатором категории, передаваемым в XML-фид для каждого товара.

product.variations


Тип данных: массив объектов product.

product.variations содержит в себе массив вариантов товара, имеющих один идентификатор, но разные SKU. При этом у товаров могут также отличаться другие атрибуты: цена, остатки, размер и т.д.

Заполнение данного массива требуется только на странице с детальным описанием товара (page.type=”product”) и только для интеграции с Retail Rocket в случае использования метода groupView.

product.url


Тип данных: строка.

product.url содержит в себе полный URL (с http/https) страницы с детальным описанием товара.

product.imageUrl


Тип данных: строка.

product.imageUrl содержит в себе полный URL (с http/https) картинки данного товара.

product.thumbnailUrl


Тип данных: строка.

product.thumbnailUrl содержит в себе полный URL (с http/https) миниатюры данного товара.

product.description


Тип данных: строка.

product.description содержит в себе короткое текстовое описание товара. Не передавайте в данную переменную длинный список технических характеристик а также html-теги.

Заполнение переменной product.description требуется только на странице с детальным описанием товара (page.type=”product”)

product.manufacturer


Тип данных: строка.

product.manufacturer содержит в себе название производителя/бренда товара

product.reviews


Тип данных: массив объектов.

product.reviews содержит в себе массив объектов, описывающих отзыв

Пример заполнения массива reviews объектами:

.product = {
  ...,
  reviews: [
    {
      body: "Отличные ботинки!",
      rating: 5.0
    },
    {
      body: "Довольно неплохие в холодную погоду",
      rating: 4.5
    }
  ],
  ...
}

где,

  • body - это строка. Содержит в себе текст отзыва
  • rating - это число. Может принимать любое значение. Зависит от вашей системы подсчета рейтингов.

product.color


Тип данных: строка.

product.color содержит в себе название цвета данного товара.

product.size


Тип данных: строка.

product.size содержит в себе название размера выбранного SKU. Как правило product.size изменяется вместе с product.skuCode.

product.voucher


Тип данных: строка.

product.voucher содержит в себе промокод, примененный пользователем, который изменил цену конкретного товара.

Если примененный код не связан с конкретным продуктом, а применяется ко всем товарам в корзине - добавьте переменную voucher в объекты digitalData.cart и digitalData.transaction.

product.stock


Тип данных: число.

product.stock содержит в себе количество единиц товара, доступных для заказа. product.stock применим к конкретному product.id, но не к product.skuCode.

Если вы не хотите передавать точное количество единиц товара, доступных для заказа, используйте следующие значения. 0 - товара нет в наличии. 1 - на складе осталось мало товаров. 2 - на складе достаточное количество товаров. Порог между мало и много вы можете определить сами.