Імпорт товарного фіду до акаунту

У системі eSputnik товарний фід використовується для формування персоналізованих повідомлень на основі поведінки користувача на сайті, а також товарних рекомендацій на сайті. Перед імпортом фіду потрібно налаштувати веб-трекінг на вкладці Веб-трекінг.

Товарний фід використовують лише алгоритми веб-трекінгу й рекомендацій. Звернутися з повідомлення до фіда за довільним ID товару — наприклад, за тим, що зберігається в додатковому полі контакту, — не можна. У повідомленнях за замовленням дані про товари (назви, посилання, зображення) підставляються із самого замовлення, тому передавайте в замовленні повні дані позицій.

Завантаження фідів — товарного та ринкового — відбувається на вкладці Каталог товарів.

На вкладці Каталог товарів є три блоки:

• Дані про товари — завантаження основного товарного фіду;
• Ринковий фід — завантаження локальних цін, наявності та інших атрибутів для різних ринків;
• Інші можливості — замовлення налаштування додаткових фідів (наприклад, новинного або акційного) у служби підтримки.

Вимоги до товарного фіду

Дані мають бути у форматі XML, RSS 2.0 за специфікацією Google. Mime type файлу повинен відповідати специфікації XML application/xml, text/xml, application/rss+xml, application/xhtml+xml. Приклад можна переглянути на вкладці Приклад даних у блоці Дані про товари.

Існує перелік обов'язкових атрибутів товару залежно від того, який тариф eSputnik ви підключили.

Для налаштування деяких тригерів та рекомендацій на сайті можуть знадобитися додаткові атрибути. Щоб правильно визначити їх у фіді, зверніться до нашої служби підтримки.

Товари з варіантами: узгодження ID у фіді та подіях

Ідентифікатори товарів у подіях веб-трекінгу мають збігатися з ідентифікаторами у фіді. Якщо в події надходить ID, якого немає у фіді, товар не знаходиться і частина тригерних повідомлень не відправляється.

Для товарів з варіантами (розмір, колір тощо) є два валідні підходи:

1. Тільки батьківський товар. У фіді — один запис на товар, і саме його <g:id> передається в подіях перегляду, кошика та покупки. Варіанти в повідомленнях не розрізняються.
2. Дочірні товари. У фіді — окремі записи для кожного варіанта, об'єднані тегом <g:item_group_id> зі значенням ID батьківського товару. У подіях кошика та покупки передається ID дочірнього товару.

Якщо в листах потрібно показувати конкретний варіант із його ціною й характеристиками, використовуйте другий підхід.

Вимоги до зображень товарів

Зображення, які передаються в атрибуті <g:image_link>, мають відповідати таким вимогам:

• Допустимі формати — PNG або JPEG (WebP не підтримується).
• Розмір файлу — до 2 МБ; рекомендоване співвідношення сторін — квадратне.
• URL зображення має бути прямим посиланням із явним розширенням формату (наприклад, .../image.png). Посилання без розширення не проходять валідацію Viber-повідомлень — відправлення завершується помилкою Invalid Parameter: image not valid type.

Завантаження товарного фіду

У блоці Дані про товари натисніть Завантажити фід товарних даних. Стане доступним вікно налаштувань:

Тут необхідно заповнити таку інформацію:

1. У полі URL фіду вкажіть посилання на файл.
2. Мова фіду, яка використовується за замовчуванням.
3. Тип фіду (Товарні дані встановлений за замовчуванням).
4. Частота оновлення фіду — Щодня (можна обрати конкретний час або кілька разів на день, наприклад, о 07:00, 15:00, 21:00 та 02:00), Щотижня (з вибором дня тижня) або Інший період. Для запиту особливого розкладу оновлення оберіть Інший період і зверніться до служби підтримки.

Мультимовний фід

Якщо сайт має кілька мовних версій, і комунікація в розсилках відбувається різними мовами, ви можете додати до облікового запису eSputnik додаткові мовні версії фіду. Це також необхідно зробити для відображення товарних рекомендацій на сайті потрібною мовою.

Якщо у фіді є необов'язковий параметр language згідно з Google-специфікацією, мова визначається автоматично. Якщо параметра немає, вкажіть мову вручну: натисніть на піктограму земної кулі в полі URL фіду і виберіть мову зі списку.

Вкажіть мову основного фіду, щоб з'явилася можливість додати ще одну мовну версію через кнопку Додати перекладений фід.

Фід повинен бути таким самим за змістом та структурою, тільки іншою мовою. Вказавши посилання на місце розташування фіду, встановіть значення його мовної версії, знову натиснувши на піктограму земної кулі.

Видаляти можна додані мовні версії фіду, окрім основної (дефолтної).

Якщо ви робите мультимовні розсилки, підстановка даних із фіду в повідомлення залежатиме від трьох параметрів:

• основна мова повідомлення;
• наявність мовних версій фіду;
• мова, записана у картці контакту.

Наприклад, мовою мультимовного повідомлення за замовчуванням обрано українську, також існують версії повідомлень німецькою та англійською. При цьому фіди завантажені тільки на DE та ENG, останній заданий дефолтним. У такому разі надсилання повідомлень відбуватиметься таким чином:

❗️Важливо

Завжди встановлюйте однакову мову за замовчуванням для повідомлень та фіду.

Якщо у вас є необхідність працювати з іншими фідами, наприклад, новинними або акційними, замовте їх налаштування у фахівців служби підтримки eSputnik у блоці Інші можливості.

Натисніть Завантажити зараз, щоб імпортувати фід до eSputnik, або Завантажити за розкладом, щоб дочекатися наступного запланованого оновлення.

Ринковий фід

Якщо у вас кілька департаментів, регіонів або точок продажу (наприклад, мережа з кількома філіями), у яких ціни на товари та їх наявність відрізняються, для цього призначений ринковий фід — він дозволяє налаштувати локальні ціни, наявність та інші параметри для кожного ринку. Ринковий фід не замінює основний товарний фід, а доповнює його локальними значеннями.

Ринок (Market) — це регіон, який визначає клієнт самостійно: країна, місто, конкретний магазин або будь-яка інша зона. Кожному ринку відповідає унікальний ідентифікатор ринку. Цей же ідентифікатор зберігається як системне поле в картці контакту і в замовленні — це дозволяє показувати користувачу рекомендації та ціни, що відповідають саме його ринку.

Завантаження ринкового фіду

На вкладці Каталог товарів у блоці Ринковий фід натисніть Завантажити ринковий фід.

Вкажіть посилання на CSV-файл у полі URL фіду.

Натисніть Завантажити зараз з товарним фідом, щоб імпортувати ринковий фід одразу разом з основним, або Завантажити за розкладом, щоб дочекатися наступного запланованого оновлення.

Вимоги до ринкового фіду

Ринковий фід — це CSV-файл. Якщо товару немає в ринковому фіді для певного ринку, він вважається недоступним для контакту, у якого вказано marketId цього ринку, і не буде показаний користувачу.

Обов'язкові поля:

• id — має збігатися з id в основному фіді товарів;
• marketId — ідентифікатор ринку;

• availability — наявність товару на цьому ринку (1 — товар в наявності, 0 — немає в наявності);
• salePrice — поточна ціна товару на цьому ринку.

Опційні поля:

• price — стара ціна (до знижки);
• currency — код валюти;
• new — індикатор нового товару.

Переглянути формат файлу можна на вкладці Приклад даних у блоці Ринковий фід:

Приклад CSV-файлу:

id,marketId,availability,price,salePrice,currency,new
TV_123456,Kyiv_1,1,3000.00,2980.00,UAH,1
TV_123456,Kyiv_2,1,2990.00,2960.00,UAH,0
Laptop_1234590,Dnipro,1,12900.00,12800.00,UAH,1
Laptop_1234590,Odessa,0,13100.00,13000.00,UAH,0

У цьому прикладі товар TV_123456 доступний на двох ринках (Kyiv_1 та Kyiv_2) з різними цінами — salePrice є поточною ціною, price — старою. Товар Laptop_1234590 недоступний на ринку Odessa (availability дорівнює 0).

Контакт відноситься до певного ринку лише тоді, коли в його профілі вказано значення marketId. Якщо у контакта немає marketId, обмеження ринкового фіду на нього не поширюються.

Керування ринковим фідом

Щоб потрапити на сторінку налаштувань, де ви раніше додавали ринковий фід, натисніть у блоці Ринковий фід кнопку Налаштування фіду.

Щоб видалити ринковий фід, натисніть кнопку Видалити фід у блоці Ринковий фід та підтвердіть видалення у вікні підтвердження.

Перевірка коректності завантаження товарного фіду та передперегляд товарів

Після успішного завантаження основного товарного фіду з'явиться інформація про:

• кількість товарів у фіді;
• товари в наявності;
• товари з ціною, що дорівнює 0;
• товари з неіснуючими категоріями (наприклад, у вас є категорія 1, категорія 2, категорія 3, а деяким товарам надано категорії 4-7, яких не існує);
• товари без категорій.

Чим менше товарів з ціною, що дорівнює 0, неіснуючими категоріями та без категорій, тим краще.

Якщо ви завантажили мультимовний фід, з'явиться кілька вкладок з відповідними мовними версіями.

Натисніть на кнопку Перегляд товарів, щоб переконатися, що дані про товари підтягнулися коректно.

Крім невалідних груп товарів, тут можна побачити всі позиції фіду або створити певний сегмент для перегляду. Наприклад, товари в категорії Fitness Equipment.

Червоним буде відзначено товарну інформацію, що відсутня. Для виведення даних про помилку за потрібним параметром скористайтеся фільтром у верхньому лівому куті. Фільтр допомагає знайти товари з помилками у таких товарних параметрах:

• ID;
• назва;
• бренд;
• URL цільової сторінки;
• ціна;
• категорія;
• наявність товару;
• наявність зображення.

Щоб потрапити на сторінку налаштувань, де ви раніше додавали товарний фід та задавали частоту його оновлення, натисніть у блоці Дані про товари кнопку Налаштування фіду.

Щоб оновити товарний фід вручну, натисніть кнопку Оновити фід зараз.

Можливі помилки

Фід може не завантажитися через певні помилки. У такому разі з'явиться повідомлення з описом помилки.

Якщо сповіщення про помилки фіда не ввімкнено, ви не отримаєте листа про невдале оновлення. Фід може лишатися неоновленим, а ви про це не дізнаєтеся — щоб увімкнути сповіщення, зверніться до підтримки.

Спільні помилки для товарного і ринкового фіду:

Помилки, специфічні для товарного фіду:

Помилки, специфічні для ринкового фіду:

У випадку використання мультимовного фіду помилки можуть виявитися лише в окремих його версіях. Тоді вкладка з таким фідом буде виділена червоним кольором. Ця версія не вплине на роботу з іншими фідами, і вам потрібно буде виправити помилку тільки в ній. При появі повідомлення про помилку потрібно скористатися вказаними рекомендаціями, внести необхідні зміни та завантажити фід повторно. До цього буде використовуватися попередня успішно завантажена версія, або нічого, якщо додавання перше.

Поширені запитання

Що станеться, якщо для товару немає рядка в ринковому фіді?

Товар вважатиметься недоступним на тому ринку, для якого немає відповідного рядка, для контактів з відповідним marketId, і не буде показаний користувачу в рекомендаціях.

У якому порядку завантажувати товарний і ринковий фід?

Спочатку завантажте основний товарний фід. Без нього завантажити ринковий фід не вдасться: ринковий фід містить лише локальні ціни, наявність та інші атрибути, він посилається на товари за полем id з основного фіду і не містить даних про сам товар (назву, опис, зображення тощо).

Чи потрібно вказувати ідентифікатор ринку контакту окремо?

Так. Щоб рекомендації та ціни відповідали ринку конкретного користувача, ідентифікатор ринку потрібно передавати в подіях веб-трекінгу та зберігати в картці контакту. Якщо у контакту немає ідентифікатора ринку, рекомендації формуються без урахування ринку — на основі загального каталогу.

Фід завантажується за посиланням. Ручного завантаження файлу немає, навіть разового, тож файл має бути доступний за адресою, яку платформа може запитати.