OLX — найбільший майданчик оголошень України й Польщі. Він влаштований інакше, ніж маркетплейс: тут немає спільних карток товарів і немає кошика — є оголошення, і покупець звертається до продавця напряму. Elbuz підключається до акаунта OLX, забирає оголошення в базовий каталог і керує ними: оновлює ціни, вмикає й вимикає за наявністю, публікує нові.
Загальний порядок для всіх API-джерел каталогу описано в огляді імпорту каталогу через API. Тут — про OLX і його особливості, яких досить багато.
Це головне, що варто зрозуміти до налаштування. У партнерському API OLX немає замовлень — є тільки оголошення й повідомлення покупців. Покупець пише або телефонує вам напряму, і жодного документа майданчик не створює. Тому підключення OLX в Elbuz — це керування вітриною, а не приймання замовлень. Якщо ввімкнути галочку завантаження замовлень, Elbuz не зламається: він просто напише в журнал, що замовлення через API не передаються, і піде далі.
Де це у програмі
У вікні завантаження створіть шаблон і оберіть тип «OLX». Файл не потрібен: підключення відбувається прив'язкою акаунта.
1
Регіон: ua або pl2
ID міста — для публікації3
Телефон для оголошень- Регіон — вкажіть ua (Україна) або pl (Польща) залежно від акаунта OLX.
- ID міста (city_id) потрібен для публікації оголошень.
- Телефон для оголошень — контакт, який побачать покупці.
Як підключити: код прив'язки
Реєструвати застосунок в OLX не потрібно. У формі шаблону є картка встановлення застосунку: натискаєте «Підключити», підтверджуєте доступ до свого акаунта OLX і вводите короткий код прив'язки. Далі доступ продовжується автоматично — і це принципово саме для OLX, бо його доступ оновлюється щодня, і робити це руками означало б починати кожен ранок з налаштувань.
У картці «Підключення» три поля:
| Поле | Навіщо |
|---|---|
| Регіон | ua (Україна) або pl (Польща). Визначає і майданчик, і валюту оголошень: гривня чи злотий |
| ID міста | Місто, в якому публікуються оголошення. Потрібне лише для публікації |
| Телефон | Контакт в оголошенні. Теж потрібен лише для публікації |
Кнопка «Перевірити підключення» у відповідь покаже майданчик і назву вашого акаунта.
Як підключити крок за кроком
Створіть шаблон типу «OLX» і збережіть його — прив'язка працює вже для збереженого шаблону. Оберіть регіон, натисніть «Підключити», підтвердіть доступ до свого акаунта OLX і вставте у форму короткий код прив'язки. Перевірте результат кнопкою «Перевірити підключення»: у відповіді має бути майданчик і назва акаунта.
Якщо ви плануєте не лише забирати оголошення, а й публікувати нові, відразу заповніть ID міста й телефон — без них публікація не почнеться. Запустіть завантаження вручну й подивіться, що приїхало: оголошення мають лягти в каталог із цінами, описами й фотографіями. Далі поставте шаблон на розклад, а керування цінами й наявністю налаштуйте окремим шаблоном вивантаження.
Що приходить у каталог
| Дані OLX | Поле товару в Elbuz |
|---|---|
| заголовок оголошення | Назва |
| опис | Опис |
| ціна | Ціна |
| стан оголошення | Статус і наявність |
| категорія OLX | Категорія |
| параметри оголошення | Характеристики |
| фотографії | Фотографії (якщо ввімкнено галочку) |
В OLX у товару немає кількості: оголошення або активне, або зняте. Тому Elbuz працює за простим правилом: активне оголошення — залишок 1, зняте — 0. У зворотний бік правило дзеркальне: якщо у вашому каталозі залишок більший за нуль, Elbuz активує оголошення, якщо нуль — знімає його. Саме так наявність з вашого складу перетворюється на видимість оголошення для покупців.
Ціни й наявність назад в OLX
Зворотний напрямок — окремий шаблон вивантаження типу «OLX». По кожному пов'язаному оголошенню Elbuz робить дві речі. Ціна: читає оголошення, порівнює з вашою ціною і, якщо вона змінилася, відправляє оголошення назад цілком — OLX приймає оголошення повністю, а не частинами, тому Elbuz дбайливо переносить усе інше без змін. Наявність: вмикає або знімає оголошення за залишком.
Публікація нових оголошень
Якщо ввімкнено галочку створення товарів, Elbuz публікує нові оголошення з ваших карток. Вимоги OLX до оголошення досить суворі, і їх варто знати заздалегідь, бо саме на них спотикається більшість перших запусків:
| Вимога OLX | Що це означає для каталогу |
|---|---|
| Заголовок від 16 до 150 символів | Надто короткі назви Elbuz добирає до мінімуму автоматично |
| Опис від 80 символів | Товар із коротким описом пропускається, про це буде запис у журналі |
| Кінцева категорія OLX | Має бути сопоставлена для категорії товару, інакше пропуск |
| Обов'язкові параметри категорії | Беруться з характеристик товару за назвою; якщо чогось бракує — пропуск із переліком у журналі |
| Місто й телефон | Заповнюються в шаблоні один раз |
Кількість безкоштовних оголошень в OLX обмежена, і коли ліміт вичерпано, майданчик приймає оголошення зі статусом «обмежене»: воно створене, але не показується, доки не куплено пакет. Elbuz такі оголошення не оплачує — він створює зв'язок із товаром і пише в журнал, скільки оголошень опинилося в цьому стані. Далі рішення за вами: купити пакет у кабінеті або зменшити кількість публікацій.
Обов'язкові параметри: як їх заповнити
Це найчастіша причина, чому оголошення не публікуються. У кожної кінцевої категорії OLX є свій набір обов'язкових параметрів — стан, розмір, марка тощо. Elbuz бере їх з характеристик товару, зіставляючи за назвою або кодом параметра, а для параметрів зі списком значень ще й підбирає правильний варіант зі списку. Якщо потрібної характеристики у товару немає, оголошення пропускається, а в журналі перелічується, чого саме забракло.
Починайте з однієї категорії. Опублікуйте кілька товарів, подивіться в журнал, які параметри OLX вимагає саме для неї, і заведіть ці характеристики у своєму каталозі з такими самими назвами. Далі та сама категорія публікуватиметься без пропусків, і можна братися за наступну.
Часті труднощі
Перша — прив'язка не спрацювала: код прив'язки живе недовго, тож вставляйте його одразу після отримання. Перевірка підключення має відповісти майданчиком і назвою акаунта.
Друга — оголошення не вмикається чи не вимикається. Часто це не помилка, а вже потрібний стан: якщо оголошення й так активне, повторна команда нічого не змінює. Дивіться на підсумок у журналі, а не на окремі рядки.
Третя — ціна не оновилася. Elbuz змінює ціну лише тоді, коли вона реально відрізняється від тієї, що стоїть в оголошенні. Якщо цифри збігаються, запит не відправляється зовсім — і це правильно, бо кожна зайва зміна оголошення на OLX ні до чого.
Навіщо вести OLX з Elbuz
Оголошення легко завести й важко підтримувати: ціни змінюються, товар закінчується, а знімати оголошення руками ніколи. Через це на OLX годинами висять пропозиції, яких уже немає, — і замість продажу продавець отримує дзвінок із розчаруванням. Коли вітрина OLX зв'язана з каталогом, наявність і ціна оновлюються самі: товар закінчився — оголошення зникло, з'явився — повернулося. А каталог при цьому лишається спільним з іншими каналами, тож вести окремий список «що в мене на OLX» більше не потрібно.
Часті питання
Чому з OLX не приходять замовлення?
Тому що їх немає в API: OLX — майданчик оголошень, покупець зв'язується з продавцем напряму, а документ замовлення майданчик не створює. Elbuz керує вітриною OLX — оголошеннями, цінами й наявністю. Якщо галочку завантаження замовлень увімкнено, у журналі просто з'явиться відповідне пояснення.
Як передається наявність, якщо в оголошенні немає кількості?
Наявність перетворюється на видимість: залишок більший за нуль — оголошення активне, залишок нуль — оголошення зняте. У зворотний бік так само: активне оголошення приходить у каталог із залишком 1, зняте — з нулем.
Чому оголошення не публікується?
Найчастіше через вимоги OLX: опис коротший за 80 символів, не сопоставлена кінцева категорія або не вистачає обов'язкових параметрів категорії. Усі три випадки Elbuz пише в журнал із назвою товару й переліком того, чого бракує.
Що означає «обмежене» оголошення?
Що вичерпано ліміт безкоштовних публікацій: оголошення створене, але не показується, доки не куплено пакет у кабінеті OLX. Elbuz пакети не купує — він лише повідомляє в журналі, скільки оголошень у такому стані.
Що обрати в полі «Регіон»?
ua для України, pl для Польщі. Це визначає і майданчик, з яким працює Elbuz, і валюту оголошень — гривню або злотий. Для роботи в обох країнах заведіть два шаблони.