Формат eCommerce-данных

В общем случае eCommerce-объект характеризуется следующими полями:

Поле Тип Описание
ecommerce object Обязательное поле. Контейнер полей-параметров eCommerce-объекта.
currencyCode string Трехбуквенный код валюты по ISO 4217. Если передается иная валюта, будут отправлены нулевые значения вместо валюты и суммы. Указывается в коде в качестве параметра поля ecommerce.
<actionType> string Идентификатор действия, произведённого с набором товаров. Указывается в коде в качестве параметра поля ecommerce. Возможные значения: click – клик по товару (ссылке на товар); detail – просмотр полного описания (карточки) товара; add – добавление товара в корзину; remove – удаление товара из корзины; checkout – переход к оформлению покупки; checkout_option – выбор пользователя на определенном этапе оформления покупки; purchase – покупка товара; refund – возврат одного или нескольких товаров.
actionField object <actionField> Дополнительные данные, описывающие действие, произведённое с товаром или набором товаров. Данные передаются в виде объекта <actionField>. Поле обрабатывается, только для данных о покупках (<actionType>=purchase). Указывается в коде в качестве параметра поля <actionType>.
products array <productFieldObject> Список описаний товаров, с которыми было произведено указанное действие. Данные обязательны для событий <actionType>. Описание каждого из товаров представляет собой объект вида <productFieldObject>. Указывается в коде в качестве параметра поля <actionType>.
impressions array <productFieldObject> Список описаний товаров, относящихся к действию impressions (показ товара или набора товаров). Указывается в коде в качестве параметра поля ecommerce. Данные передаются в виде объекта <productFieldObject>. Надо передавать в следующих случаях: просмотр каталога, загрузка главной страницы, просмотр разделов (и подразделов) сайта с товарами. ВНИМАНИЕ! Следует передавать только те товары, которые действительно были показаны на странице, а не в принципе подгрузились. Например, если в блоке «Новинки» показывается по 3 товара за раз, а дальше карусель, нужно передавать 3 товара в первый момент, а не, например, 8, которые были предзагружены.
<promoActionType> string Идентификатор промо-действия, произведённого с набором товаров. Возможные значения: promoView, promoClick.
promotions array <promoFieldObject> Массив данных, описывающих связанное с рекламной акцией действие <promoActionType>. Данные передаются в виде объекта <promoFieldObject>. Указывается в коде в качестве параметра поля <promoActionType>.

Вложенность параметров eCommerce-объекта в общем случае следующая:

window.dataLayer.push({
    “ecommerce”: {
        “currencyCode”: “<код валюты по ISO 4217>”,
        “<actionType>” : {
            “actionField” : <actionField>,
            “products” : [<productFieldObject>, <productFieldObject>, …]
        },
        “impressions” : [<productFieldObject>, <productFieldObject>, …],
        “<promoActionType>” : {
            “promotions” : [<promoFieldObject>, <promoFieldObject>, …]
        }
    }
});

Какие именно группы полей отправлять зависит от конкретной ситуации/события.

Так, например, при отображении страницы с каталогом товаров и рекламным объявлением следует передавать impressions c перечнем показанных товаров и promoView в качестве <promoActionType> с данными по рекламе:

window.dataLayer.push({
    “ecommerce”: {
        “currencyCode”: “<код валюты по ISO 4217>”,
        “impressions” : [<productFieldObject>, <productFieldObject>, …],
        “promoView” : {
            “promotions” : [<параметры конкретной рекламы в формате promoFieldObject>]
        }
    }
});

При клике по конкретному товару из списка результатов поиска – click в качестве <actionType> c данными по товару и, например, названием блока «Результаты поиска»:

window.dataLayer.push({
    “ecommerce”: {
        “currencyCode”: “<код валюты по ISO 4217>”,
        “click” : {
            “actionField” : {
                “list” = “Результаты поиска”
            },
            “products” : [<параметры конкретного товара в формате productFieldObject>]
        }
    }
});

Рекомендации по тому, какие группы полей для каких ситуаций и событий передавать, приводятся в разделе «Рекомендации по передаче eCommerce-данных».

Структура объекта <productFieldObject> с описанием товара:

Поле Тип Описание
id string Обязательное поле.Идентификатор товара. Пример: «SKU».
name string Название товара. Пример: «Футболка». Поле опциональное, но рекомендуется его передавать.
list string Название блока, куда входит/ отображается товар. Пример: «Результаты поиска», «Вы недавно смотрели», «Вам также могут понравиться».
brand string Бренд, торговая марка, ассоциированная с товаром. Пример: «Печки-лавочки».
category string Категория, к которой относится товар. Поддерживается иерархия категорий до 5 уровней вложенности. Разделителем уровней является символ «/». Пример: «Одежда/Мужская одежда/Футболки».
coupon string Промокод, ассоциированный с товаром. Пример: «PARTNER_SITE_15».
position number Положение товара в списке. Пример: «2».
price number Итоговая стоимость единицы товара с учетом всех скидок.
quantity integer Количество единиц товара.
variant string Разновидность товара. Пример: «Красный цвет».

Структура объекта <promoFieldObject> с данными о рекламной акции:

Поле Тип Описание
id string Обязательное поле.Идентификатор рекламной акции. Пример: «PROMO12».
name string Название рекламной акции. Пример: «Сезонная распродажа». Поле опциональное, но рекомендуется его передавать.
creative string Cвязанное с рекламной акцией объявление. Пример: «sale_banner1».
position string Позиция объявления. Пример: «slot_2».

Структура объекта с данными о действии <actionField>:

Поле Тип Описание
id string Обязательное поле. Идентификатор покупки. Пример: «TRX#54321».
coupon string Промокод, ассоциированный со всей покупкой целиком.
revenue number Полученный доход. Если не указан, вычисляется автоматически как сумма цен всех товаров, ассоциированных с покупкой.
affilation string Магазин или филиал, в котором произошла транзакция.
tax number Сумма всех налогов для данной покупки.
shipping number Стоимость доставки данной покупки.
list string Название блока, куда входят/отображаются товары из данной покупки. Примеры: «Новинки», «Результаты поиска».
step number Число, представляющее этап последовательности покупки. Передается для действий типа checkout и checkout_option.
option string Дополнительное поле, передаваемое для действий типа checkout и checkout_option. Предоставляет информацию о выборе пользователя на определенном этапе оформления покупки (например, о выбранном способе оплаты).

results matching ""

    No results matching ""