Передача данных об электронной коммерции

Данные о товаре

Объект, описывающий отдельный товар.

Структура объекта, описывающего товар, обозначается как <productFieldObject>.

Данные о действии

Объект, содержащий данные о действии, произведенном с товаром или набором товаров.

Обрабатывается только если действие — покупка (<actionType> — purchase).

Структура объекта, описывающего действие, обозначается как <actionField>.

При передаче данных о действии Метрика создает цель. Она позволяет получать данные о доходе с рекламной кампании Директа. В Директе, в списке доступных целей, такая цель отображается как «eCommerce: Покупка (счетчик № <ID счетчика>)». При этом вы можете отслеживать достижение цели самостоятельно, передавая поле goal_id.

Поля объекта

Поле	Тип	Описание
id *	String	Идентификатор покупки. Обязательно для заполнения. Пример: TRX#54321
coupon	String	Промокод, ассоциированный со всей покупкой целиком
goal_id	Integer	Номер цели. Указывается в том случае, если данное действие и было целью. Цель должна задаваться условием типа JavaScript-событие. Номер цели доступен в веб-интерфейсе Яндекс Метрики, в разделе Настройка (вкладка Цели).
revenue	Number	Полученный доход. Если не указан, вычисляется автоматически как сумма цен всех товаров, ассоциированных с покупкой

Поля объекта

Поле	Тип	Описание
id *	String	Идентификатор покупки. Обязательно для заполнения. Пример: TRX#54321
coupon	String	Промокод, ассоциированный со всей покупкой целиком
goal_id	Integer	Номер цели. Указывается в том случае, если данное действие и было целью. Цель должна задаваться условием типа JavaScript-событие. Номер цели доступен в веб-интерфейсе Яндекс Метрики, в разделе Настройка (вкладка Цели).
revenue	Number	Полученный доход. Если не указан, вычисляется автоматически как сумма цен всех товаров, ассоциированных с покупкой

Данные о промокампаниях

Объект, описывающий промокампании.

Контейнер такой же, но вместо <productFieldObject> записывается <promoFieldObject>.

Просмотр списка товаров

Данные должны отправляться в момент открытия списка товаров.

dataLayer.push({
    "ecommerce": {
        "currencyCode": "RUB",
        "impressions": [
            {
                "id": "P15432",
                "name" : "Футболка",
                "price": 477.60,
                "brand": "Яндекс / Яndex",
                "category": "Одежда/Мужская одежда/Футболки",
                "variant" : "Красный цвет",
                "list": "Search",
                "position": 1
            },
            {
                "id": "P15435",
                "name" : "Футболка",
                "price": 500.60,
                "brand": "Яндекс / Яndex",
                "category": "Одежда/Мужская одежда/Футболки",
                "variant" : "Синий цвет",
                "list": "Search",
                "position": 2
            }
        ]
    }
});

Клик по товару из списка

Данные должны передаваться в момент, когда пользователь совершил клик по ссылке товара.

dataLayer.push({
    "ecommerce": {
        "currencyCode": "RUB",
        "click": {
            "products": [
                {
                    "id": "39084",
                    "name": "Термостакан Яндекс",
                    "price": 1089.69,
                    "brand": "Яндекс / Яndex",
                    "category": "Товары для дома/Посуда/Термосы и термокружки",
                    "variant": "Красный цвет",
                    "list": "Search",
                    "position": 1
                }
            ]
        }
    }
});

Просмотр товара

Данные должны отправляться в момент открытия страницы с карточкой товара.

dataLayer.push({
    "ecommerce": {
        "currencyCode": "RUB",
        "detail": {
            "products": [
                {
                    "id": "P15432",
                    "name" : "Футболка",
                    "price": 477.60,
                    "brand": "Яндекс / Яndex",
                    "category": "Одежда/Мужская одежда/Футболки",
                    "variant" : "Красный цвет",
                    "list": "Результаты поиска",
                    "position": 1
                }
            ]
        }
    }
});

Добавление товара в корзину

Данные должны отправляться в момент добавления заказа в корзину. Например, при нажатии кнопки «Добавить в корзину».

dataLayer.push({
    "ecommerce": {
        "currencyCode": "RUB",    
        "add": {
            "products": [
                {
                    "id": "43521",
                    "name": "Сумка Яндекс",
                    "price": 654.32,
                    "brand": "Яндекс / Яndex",
                    "category": "Аксессуары/Сумки",
                    "quantity": 1,
                    "list": "Выдача категории",
                    "position": 2
                }
            ]
        }
    }
});

Удаление товара из корзины

Данные должны отправляться в момент удаления заказа из корзины.

dataLayer.push({
    "ecommerce": {
        "currencyCode": "RUB",
        "remove": {
            "products": [
                {
                    "id": "15243",
                    "name": "Набор протирашек для экрана телефона - Яндекс",
                    "category": "Аксессуары для мобильного телефона",
                    "quantity": 1,
                    "list": "Аксессуары",
                    "position": 3
                }
            ]
        }
    }
});

Покупка

Данные должны отправляться в момент подтверждения заказа.

dataLayer.push({
    "ecommerce": {
        "currencyCode": "RUB",
        "purchase": {
            "actionField": {
                "id" : "TRX987"
            },
            "products": [
                {
                    "id": "25341",
                    "name": "Толстовка Яндекс мужская",
                    "price": 1345.26,
                    "brand": "Яндекс / Яndex",
                    "category": "Одежда/Мужская одежда/Толстовки и свитшоты",
                    "variant": "Оранжевый цвет",
                    "quantity": 1,
                    "list": "Одежда",
                    "position": 1
                },
                {
                    "id": "25314",
                    "name": "Толстовка Яндекс женская",
                    "price": 1543.62,
                    "brand": "Яндекс / Яndex",
                    "category": "Одежда/Женская одежда/Толстовки и свитшоты",
                    "variant": "Белый цвет",
                    "quantity": 3,
                    "list": "Толстовки",
                    "position": 2
                }
            ]
        }
    }
});

Просмотр внутренней рекламы

Данные должны отправляться, когда пользователь просмотрел рекламные материалы.

dataLayer.push({
    "ecommerce": {
        "promoView": {
            "promotions": [
                {
                    "id": "BF001",          
                    "name": "Черная пятница",
                    "creative": "Баннер_1",
                    "position": "Слот1"
                },
                {
                    "id": "SUMMER002",
                    "name": "Летние распродажи",
                    "creative": "Баннер_3",
                    "position": "Слот2"
                }
            ]
        }
    }
});

Клики внутренней рекламы

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

dataLayer.push({
    "ecommerce": {
        "promoClick": {
            "promotions": [
                {
                    "id": "BF001",          
                    "name": "Черная пятница",
                    "creative": "Баннер_1",
                    "position": "Слот1"
                }
            ]
        }
    }
});