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

Для передачи действий пользователя с ECommerce данными необходимо собрать и передать данные в событие в определенном формате <TrackerTop100ECommerce>:

Формат данных <TrackerTop100ECommerce>

Поле	Тип данных	Описание
currencyCode	String	Трехбуквенный код валюты по ISO 4217. Если передается иная валюта, будут отправлены нулевые значения вместо валюты и суммы.
action	<TrackerTop100ECommAction>	Дополнительные данные, описывающие действие, произведённое с товаром или набором товаров. Данные передаются в виде объекта <TrackerTop100ECommAction>.
products	[<TrackerTop100ECommProduct>]	Список описаний товаров, с которыми было произведено указанное действие. Описание каждого из товаров представляет собой объект вида <TrackerTop100ECommProduct>.
impressions	[<TrackerTop100ECommProduct>]	Список описаний товаров, относящихся к действию impressions (показ товара или набора товаров). Данные передаются в виде объекта <TrackerTop100ECommProduct>.
promotions	[<TrackerTop100ECommPromo>]	Массив данных, описывающих связанное с рекламной акцией действие. Данные передаются в виде объекта <TrackerTop100ECommPromo>.

Отправка события ECommerce

Swift

TrackerTop100.trackEcomm(eventName: "EVENT_NAME", ecommParams: ECOMM_PARAMS)

Objective-C

[TrackerTop100 trackEcommWithEventName: @"EVENT_NAME" ecommParams: ECOMM_PARAMS];

EVENT_NAME (обязательный) — произвольное название события

ECOMM_PARAMS (опциональный) — ECommerce данные о событии, соответствующие формату <TrackerTop100ECommerce>

Примеры передачи ECommerce данных

Показ товара (impressions):

Swift

import TrackerTop100SDK
// ...
let product1 = TrackerTop100ECommProduct(
    id: "25317",
    name: "Майка",
    list: "Результаты поиска",
    brand: "Печки-лавочки",
    category: "Одежда/Мужская одежда/Футболки",
    position: "1",
    price: "1499.00",
    variant: "Зеленый цвет"
)

let product2 = TrackerTop100ECommProduct(
    id: "25315",
    name: "Футболка с рисунком",
    list: "Результаты поиска",
    brand: "Печки-лавочки",
    category: "Одежда/Мужская одежда/Футболки",
    position: "2",
    price: "2345.50",
    variant: "Серый цвет"
)

let ecommParams = TrackerTop100ECommerce(
    currencyCode: "RUB",
    impressions: [product1, product2]
)
        
TrackerTop100.trackEcomm(eventName: "impressions", ecommParams: ecommParams)

Objective-C

@import TrackerTop100SDK;
// ...
TrackerTop100ECommProduct *product1 = [[TrackerTop100ECommProduct alloc]
                                           initWithId: @"25317"
                                           name: @"Майка"
                                           list: @"Результаты поиска"
                                           brand: @"Печки-лавочки"
                                           category: @"Одежда/Мужская одежда/Футболки"
                                           coupon: nil
                                           position: @"1"
                                           price: @"1499.00"
                                           quantity: nil
                                           variant: @"Зеленый цвет"];
    
TrackerTop100ECommProduct *product2 = [[TrackerTop100ECommProduct alloc]
                                           initWithId: @"25315"
                                           name: @"Футболка с рисунком"
                                           list: @"Результаты поиска"
                                           brand: @"Печки-лавочки"
                                           category: @"Одежда/Мужская одежда/Футболки"
                                           coupon: nil
                                           position: @"2"
                                           price: @"2345.50"
                                           quantity: nil
                                           variant: @"Серый цвет"];
    
TrackerTop100ECommerce *ecommParams = [[TrackerTop100ECommerce alloc]
                                           initWithCurrencyCode: @"RUB"
                                           action: nil
                                           products: nil
                                           impressions: @[product1, product2]
                                           promotions: nil];
    
[TrackerTop100 trackEcommWithEventName: @"impressions" ecommParams: ecommParams];

Клик по промо-акции:

Swift

import TrackerTop100SDK
// ...
let promo = TrackerTop100ECommPromo(
    id: "P15432",
    name: "Сезонная распродажа",
    creative: "sale_banner1",
    position: "slot_2"
)
        
let ecommParams = TrackerTop100ECommerce(
    currencyCode: "RUB",
    promotions: [promo]
)
        
TrackerTop100.trackEcomm(eventName: "promoClick", ecommParams: ecommParams)

Objective-C

@import TrackerTop100SDK;
// ...
TrackerTop100ECommPromo *promo = [[TrackerTop100ECommPromo alloc]
                                      initWithId: @"P15432"
                                      name: @"Сезонная распродажа"
                                      creative: @"sale_banner1"
                                      position: @"slot_2"];
    
TrackerTop100ECommerce *ecommParams = [[TrackerTop100ECommerce alloc]
                                           initWithCurrencyCode:@"RUB"
                                           action: nil
                                           products: nil
                                           impressions: nil
                                           promotions: @[promo]];
    
[TrackerTop100 trackEcommWithEventName: @"promoClick" ecommParams: ecommParams];

Клик по товару:

Swift

import TrackerTop100SDK
// ...
let product1 = TrackerTop100ECommProduct(
    id: "25317",
    name: "Майка",
    list: "Результаты поиска",
    brand: "Печки-лавочки",
    category: "Одежда/Мужская одежда/Футболки",
    position: "1",
    price: "1499.00",
    variant: "Зеленый цвет"
)
        
let ecommParams = TrackerTop100ECommerce(
    currencyCode: "RUB",
    products: [product1]
)
        
TrackerTop100.trackEcomm(eventName: "click", ecommParams: ecommParams)

Objective-C

@import TrackerTop100SDK;
// ...
TrackerTop100ECommProduct *product1 = [[TrackerTop100ECommProduct alloc]
                                           initWithId: @"25317"
                                           name: @"Майка"
                                           list: @"Результаты поиска"
                                           brand: @"Печки-лавочки"
                                           category: @"Одежда/Мужская одежда/Футболки"
                                           coupon: nil
                                           position: @"1"
                                           price: @"1499.00"
                                           quantity: nil
                                           variant: @"Зеленый цвет"];
    
TrackerTop100ECommerce *ecommParams = [[TrackerTop100ECommerce alloc]
                                           initWithCurrencyCode:@"RUB"
                                           action: nil
                                           products: @[product1]
                                           impressions: nil
                                           promotions: nil];
    
[TrackerTop100 trackEcommWithEventName: @"click" ecommParams: ecommParams];

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

Swift

import TrackerTop100SDK
// ...
let product1 = TrackerTop100ECommProduct(
    id: "43521",
    name: "Часы Citizen",
    brand: "Печки-лавочки",
    category: "Аксессуары/Часы",
    price: "3654.32",
    quantity: "5"
)
        
let ecommParams = TrackerTop100ECommerce(
    currencyCode: "RUB",
    products: [product1]
)
        
TrackerTop100.trackEcomm(eventName: "add", ecommParams: ecommParams)

Objective-C

@import TrackerTop100SDK;
// ...
TrackerTop100ECommProduct *product1 = [[TrackerTop100ECommProduct alloc]
                                           initWithId: @"43521"
                                           name: @"Часы Citizen"
                                           list: nil
                                           brand: @"Печки-лавочки"
                                           category: @"Аксессуары/Часы"
                                           coupon: nil
                                           position: nil
                                           price: @"3654.32"
                                           quantity: @"5"
                                           variant: nil];
    
TrackerTop100ECommerce *ecommParams = [[TrackerTop100ECommerce alloc]
                                           initWithCurrencyCode:@"RUB"
                                           action: nil
                                           products: @[product1]
                                           impressions: nil
                                           promotions: nil];
    
[TrackerTop100 trackEcommWithEventName: @"add" ecommParams: ecommParams];

Покупка товаров:

Swift

import TrackerTop100SDK
// ...
let action = TrackerTop100ECommAction(
    id: "b52314",
    step: "2",
    option: "Самовывоз"
)

let product1 = TrackerTop100ECommProduct(
    id: "25317",
    name: "Майка",
    brand: "Печки-лавочки",
    category: "Одежда/Мужская одежда/Футболки",
    price: "1499.00",
    variant: "Зеленый цвет"
)

let product2 = TrackerTop100ECommProduct(
    id: "25315",
    name: "Футболка с рисунком",
    brand: "Печки-лавочки",
    category: "Одежда/Мужская одежда/Футболки",
    price: "2345.50",
    variant: "Серый цвет"
)

let ecommParams = TrackerTop100ECommerce(
    currencyCode: "RUB",
    action: action,
    products: [product1, product2]
)
        
TrackerTop100.trackEcomm(eventName: "purchase", ecommParams: ecommParams)

Objective-C

@import TrackerTop100SDK;
// ...
TrackerTop100ECommAction *action = [[TrackerTop100ECommAction alloc]
                                        initWithId: @"b52314"
                                        coupon: nil
                                        revenue: nil
                                        affilation: nil
                                        tax: nil
                                        shipping: nil
                                        list: nil
                                        step: @"2"
                                        option: @"Самовывоз"];
    
TrackerTop100ECommProduct *product1 = [[TrackerTop100ECommProduct alloc]
                                           initWithId: @"25317"
                                           name: @"Майка"
                                           list: @"Результаты поиска"
                                           brand: @"Печки-лавочки"
                                           category: @"Одежда/Мужская одежда/Футболки"
                                           coupon: nil
                                           position: @"1"
                                           price: @"1499.00"
                                           quantity: nil
                                           variant: @"Зеленый цвет"];
    
TrackerTop100ECommProduct *product2 = [[TrackerTop100ECommProduct alloc]
                                           initWithId: @"25315"
                                           name: @"Футболка с рисунком"
                                           list: @"Результаты поиска"
                                           brand: @"Печки-лавочки"
                                           category: @"Одежда/Мужская одежда/Футболки"
                                           coupon: nil
                                           position: @"2"
                                           price: @"2345.50"
                                           quantity: nil
                                           variant: @"Серый цвет"];
    
TrackerTop100ECommerce *ecommParams = [[TrackerTop100ECommerce alloc]
                                           initWithCurrencyCode:@"RUB"
                                           action: action
                                           products: nil
                                           impressions: @[product1, product2]
                                           promotions: nil];
    
[TrackerTop100 trackEcommWithEventName: @"purchase" ecommParams: ecommParams];