Що таке розширення Symlink Stork?#

Symlink Stork — це розширення, яке слугує для безпечного надання фідів даних і керування доступом до них. Воно працює як посередник, який для початкової наявної URL-адреси файлу створює одну або кілька нових унікальних адрес, так званих симлінків. Створені симлінки потім можна надавати своїм партнерам і контролювати, хто має до них доступ.

Головна мета — контролювати, хто звертається до даних, і мати змогу будь-коли скасувати доступ конкретному суб’єкту, не впливаючи на інші суб’єкти, яким потрібен доступ до тих самих даних.

Розширення підтримує поширені файли даних, як-от XML, CSV або ZIP. Воно не призначене насамперед для HTML-сторінок, у яких могли б неправильно завантажуватися стилі CSS і графіка.

Розширення ідеально підходить для:

  • Оптових компаній, які надають товарні дані багатьом роздрібним продавцям.
  • Афілійованого маркетингу, де існує ризик зловживання фідами з боку конкурентів або колишніх партнерів.
  • Фахівців з маркетингу, які керують підключенням інтернет-магазинів до різних рекламних і зовнішніх систем.

Ціна та виставлення рахунків#

Ціна розширення:

  • 286 CZK на місяць за щомісячного виставлення рахунків,
  • 228,80 CZK на місяць за щорічного виставлення рахунків.

Ціна встановлена для одного інтернет-магазину (у Mergado) і є фіксованою, незалежно від кількості створених симлінків у межах цього інтернет-магазину.

З огляду на технічну залежність рахунки за розширення виставляються відповідно до частоти виставлення рахунків, вибраної в Mergado Editor. Для окремих послуг не можна вибрати різну частоту виставлення рахунків.

Розширення Symlink Stork має 30-денний безкоштовний пробний період.

Symlink Stork можна використовувати і без платного проєкту в Mergado. Однак потрібно створити обліковий запис у Mergado для авторизації користувачів і виставлення рахунків та інтернет-магазин для керування доступом користувачів. І те, і те можна створити в Mergado безкоштовно навіть без платного проєкту.

  • Симлінк – Нова унікальна URL-адреса, яку важко вгадати, створена для файлу на початковій адресі.
  • Персона – Іменована ідентичність «відвідувача» (системи або користувача) симлінку, яку розширення розпізнає на основі IP-адреси та User Agent.
  • User Agent – Позначення програмного забезпечення, яке звертається до посилання (наприклад, конкретний браузер або бот).
  • Обліковий запис у Mergado Editor і створений у ньому інтернет-магазин.
  • Наявний файл даних, доступний за загальнодоступною URL-адресою (наприклад, вихідний фід із Mergado, але це може бути й файл із будь-якої іншої системи).

Технічна інформація#

Symlink Stork завантажує дані з початкової URL на своїх серверах і передає результат на симлінк. Якщо ваш початковий файл захищено білим списком IP-адрес, потрібно додати до білого списку IP-адресу 178.238.44.138, з якої Symlink Stork звертається до файлу.

Під час завантаження розширення ідентифікує себе за допомогою User Agent SymlinkStorkBot/1.0 (+https://store.mergado.com/detail/symlinkstork/). Цей рядок ви побачите в серверних журналах початкового файлу. Отже, це не сторонній доступ, а саме розширення, яке завантажує дані й передає їх на створений симлінк.

Основні функції#

1. Створення симлінків#

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

2. Керування симлінками#

Керування симлінками дає вам повний контроль над розповсюдженням даних, якого звичайні системи інтернет-магазинів не надають.

  • Видалення або тимчасова деактивація симлінку – Якщо, наприклад, ви припините співпрацю з партнером, його конкретний симлінк можна видалити або тимчасово деактивувати, не впливаючи на інших партнерів, які мають власні симлінки.

  • Розширене керування доступом для кожного симлінку – Безпосередньо в деталях кожного симлінку ви визначаєте його режим безпеки. Можна налаштувати, щоб до даних із конкретного посилання мала доступ лише схвалена особа/особи (персона), або, навпаки, заборонити доступ конкретним небажаним персонам. Доступ можна додатково захистити паролем, який має ввести система, що завантажує дані.

3. Зміна джерела без зміни симлінку#

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

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

4. Ідентифікація звернень за допомогою персон#

Можливість ідентифікувати й назвати конкретних партнерів, роботів (наприклад, Googlebot) або звернення з власного офісу. Ідентифікація відбувається на основі IP-адреси та User Agent.

5. Відстеження історії завантаження даних#

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

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

В афілійованому маркетингу рекламні мережі надають URL-адресу вашого фіду даних своїм паблішерам. Головний ризик полягає в тому, що паблішером може стати практично будь-хто, зокрема ваш прямий конкурент.

Якщо рекламодавець надасть пряме посилання на свій фід (наприклад, у вигляді мій-магазин.cz/heureka.xml), він наражається на такі загрози:

  • Неконтрольований видобуток даних – Конкурент може занотувати адресу фіду й завантажувати та аналізувати ваші дані (ціноутворення, асортимент, параметри) навіть після того, як ви видалите фід із каталогу афілійованої мережі.
  • Легке зловживання даними – Дані з фіду обробляти набагато простіше, ніж автоматизовано обходити (краулити) вебсторінки.
  • Неможливість вибіркового блокування – Без симлінку ви не можете припинити доступ одному конкретному партнерові, не змінивши адресу для всіх інших.

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

Розширення активуєте в Mergado Store: I want to activate → виберіть інтернет-магазин, для якого хочете увімкнути розширення → Activate.

В інтерфейсі розширення Symlink Stork ви побачите в меню три основні розділи: Links, History, Personas.

Розділ Links — це основний робочий простір розширення Symlink Stork, де відбувається все керування розповсюдженням ваших даних. У цьому розділі ви бачите список усіх створених активних і неактивних симлінків. Для кожного посилання показано таку інформацію:

  • Name – Ваша внутрішня назва, щоб легко орієнтуватися.
  • Original address – URL джерельного файлу, з якого беруться дані.
  • New address – Згенерований симлінк, який ви надаєте партнерам.
  • Access status – Значок, що показує поточне налаштування доступу. Зелена крапка означає вільний доступ («усі, крім»), замок — обмеження конкретними персонами («ніхто, крім»).
  • Last visit – Дата й час, коли симлінк востаннє використовувався для завантаження даних.

Безпосередньо з цього списку можна виконувати з посиланнями інші дії за допомогою значків:

  • Edit (значок олівця) – Дає змогу змінювати налаштування доступу, назву або джерельну URL.
  • Deactivate/Activate – Посилання можна тимчасово вимкнути, не видаляючи його.
  • Duplicate – Корисно для швидкого створення кількох схожих симлінків із тим самим джерелом, але іншим налаштуванням персон.
  • Delete – Остаточне видалення посилання. Після видалення URL-адреса в партнера одразу перестане працювати. Цей крок незворотний.

Як створити новий симлінк?#

  1. На вкладці Links натисніть кнопку Create new link.
  2. Введіть Name – Назвіть посилання так, щоб одразу було зрозуміло, кому воно призначене (наприклад, «XML-фід для партнера ABC»).
  3. Вставте Original address – Скопіюйте в поле URL-адресу джерельного файлу (наприклад, адресу вихідного фіду з вашого проєкту в Mergado, але й із будь-якої іншої системи).
  4. Визначте New address – Укажіть кінцеву частину посилання. Для максимальної безпеки й неможливості вгадати адресу радимо створити власну систему найменування, наприклад поєднання назви партнера й випадкового «секретного» ключа (наприклад, /partner_xy-f5t8z2). Конкретний вигляд вирішуєте ви, можна використати й символ крапки.
  5. Додайте примітку (необов’язково) – Можна додати додаткову інформацію для власних потреб.
  6. Налаштуйте обмеження доступу – У правій частині форми виберіть один із двох режимів захисту за допомогою персон:
    а. Everyone except the listed personas has access to the symlink – Працює як чорний список: ви забороняєте доступ конкретним персонам, яких виберете й позначите в полі нижче.
    б. No one except the listed personas has access – Працює як білий список: ви дозволяєте доступ лише конкретним персонам, яких виберете й позначите в полі нижче.
  7. Захист паролем (необов’язково) – Доступ до даних можна додатково захистити вимогою ввести пароль у полі Restrict access with password.
  8. Натисніть кнопку Save link, і симлінк активується та буде готовий до надсилання партнерові.

Після збереження новий симлінк з’явиться в списку, звідки можна скопіювати його нову URL-адресу. Щойно партнер уперше звернеться до цього посилання, ви побачите цей запис у розділі History.

History #

Розділ History у розширенні Symlink Stork слугує для детального відстеження всіх звернень до створених симлінків. Він працює як ключовий аналітичний і діагностичний інструмент, який дає вам огляд того, що відбувається з вашими наданими даними.

Для кожної спроби доступу до унікального посилання Symlink Stork записує такі ключові дані:

  • Who – Показує IP-адресу та User Agent (позначення програмного забезпечення або браузера) відвідувача. Якщо цю IP-адресу або User Agent уже призначено конкретній персоні, в огляді ви побачите її назву.
  • When – Дата й точний час завантаження даних або спроби їх завантажити.
  • Access status – Symlink Stork розрізняє дозволений і відхилений доступ до посилання. Заблоковані спроби завантаження позначено червоною крапкою, успішні завантаження — зеленою крапкою.

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

Практичне використання розділу History в реальних ситуаціях

Інформацію з історії можна використати, наприклад, для:

  • Розв’язання технічних суперечок і проблем – Якщо партнер (наприклад, роздрібний продавець) стверджує, що не має актуальних товарних даних, в історії можна легко перевірити, коли його система насправді востаннє завантажила файл. Якщо в історії ви побачите, що останнє завантаження відбулося, наприклад, місяць тому, очевидно, що помилка — в автоматизації на боці партнера.
  • Захист даних – Історія дає змогу виявити підозрілі системи або невідомі IP-адреси, які звертаються до ваших фідів. Потім для цих систем ви просто створите персони й забороните їм доступ.
  • Аналітика завантажень – Дає змогу відстежувати, як часто й у який час завантажуються ваші дані.

Створення персони безпосередньо з розділу History

Якщо в списку ви побачите неназване звернення, яке хочете ідентифікувати, достатньо натиснути значок олівця в цьому рядку (редагування). Розширення дасть вам змогу з цього конкретного «відбитка» (IP-адреси та User Agent) одразу створити й назвати нову персону.

Якщо ви самі відкриєте конкретний симлінк у браузері, свій власний «відбиток» ви також побачите в історії.

⚠️ Історія прив’язана до активного стану розширення. Якщо ви вимкнете Symlink Stork, негайно й безповоротно буде видалено всю історію і всі створені симлінки.

Personas #

Розділ Personas у розширенні Symlink Stork слугує для ідентифікації та найменування конкретних користувачів або автоматизованих систем (ботів), які звертаються до ваших даних (симлінків). Завдяки персонам анонімні звернення з історії можна перетворити на зрозумілий огляд конкретних суб’єктів, як-от ділові партнери, роботи або ваші працівники. Потім вибраним персонам можна дозволити або заборонити доступ до створених симлінків.

Що таке персони?#

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

Як створити персону?

Є два способи додати нову персону в систему:

  • На вкладці Personas — натисніть кнопку Create persona і заповніть ідентифікаційні дані.
  • На вкладці History — натисніть значок олівця в конкретному рядку історії звернень. У цьому разі розширення автоматично попередньо заповнить виявлену IP-адресу та User Agent, а вам залишиться лише додати назву.

Параметри ідентифікації персони

Для правильного розпізнавання персони Symlink Stork використовує два технічні параметри:

  • IP-адреса – Розширення підтримує стандарт IPv4. Ідентифікація за IP надійна для суб’єктів із фіксованою (статичною) адресою, як-от корпоративні мережі або центри обробки даних.
  • User Agent – Текстовий рядок, яким програмне забезпечення ідентифікує себе під час комунікації (наприклад, позначення конкретного бота або браузера).

Під час налаштування можна вказати лише один із параметрів або обидва одночасно. Якщо ви заповните обидва параметри, для успішного розпізнавання персони мають бути виконані обидві умови водночас. Розширення вимагає точного збігу, воно не підтримує введення діапазонів IP-адрес і пошук частин тексту в User Agent.

Пріоритети призначення звернень персонам

Якщо одне звернення відповідає налаштуванням кількох персон одночасно, Symlink Stork ідентифікує їх за таким пріоритетом:

  1. Збігаються і IP-адреса, і User Agent.
  2. Збігається лише IP-адреса.
  3. Збігається лише User Agent.

Використання персон на практиці

Створені персони — необхідна передумова для просунутих функцій розширення:

  • Керування доступом (білий / чорний список) – Для кожного посилання можна налаштувати, чи мають до нього доступ усі персони, крім вибраних (наприклад, блокування конкретних ботів), чи не має доступу ніхто, крім вибраних схвалених персон.
  • Внутрішня аналітика – Назвавши персону «Офіс» або «Дім», ви відрізните власні тестові звернення від завантаження даних партнерами.
  • Ідентифікація ботів – За допомогою User Agent можна розпізнати й назвати автоматизовані системи (наприклад, Googlebot, Seznambot) і відстежувати їхню активність.
  • Діагностика для партнерів – Якщо в партнера проблема з неактуальними даними, в історії під його ім’ям (персоною) можна легко перевірити, коли він насправді востаннє завантажив дані.

Порада: Якщо вам потрібно дізнатися власну IP-адресу для створення персони, достатньо відкрити ваш симлінк у браузері, і потім у розділі History ви побачите свій поточний «відбиток», який можна одним кліком перетворити на персону.

Часті запитання#

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

Коли ви надаєте звичайне пряме посилання, ви не маєте жодного контролю над тим, хто і як довго звертається до ваших даних. Адресу фіду може зберегти будь-хто й завантажувати дані навіть після того, як ви припините співпрацю. Symlink Stork розв’язує цю проблему. Кожен партнер має власну адресу, яку можна будь-коли деактивувати або видалити, а початкова адреса вашого файлу залишається прихованою.

Ні. Symlink Stork можна використовувати і без платного проєкту в Mergado. Достатньо мати безкоштовний обліковий запис Mergado і створений у ньому інтернет-магазин, який слугує для керування доступом і виставлення рахунків.

Ні. Розширення працює з будь-яким файлом, доступним за загальнодоступною URL-адресою, незалежно від того, звідки файл походить. Це може бути вихідний фід із Mergado, але й файл із системи вашого інтернет-магазину, системи складського обліку або іншого джерела.

Розширення підтримує поширені формати даних – XML, CSV, ZIP і загалом будь-який файл із власною URL-адресою. Однак воно не призначене насамперед для HTML-сторінок, у яких могли б неправильно завантажуватися стилі CSS або графіка.

Ціна становить 286 CZK на місяць за щомісячного виставлення рахунків або 228,80 CZK на місяць за щорічного виставлення рахунків. Ціна фіксована для одного інтернет-магазину в Mergado, незалежно від кількості створених симлінків.

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

Скільки симлінків можна створити для одного файлу?#

Необмежену кількість. З однієї початкової URL можна створити будь-яку кількість унікальних симлінків – кожен для іншого партнера або іншої мети.

Чи дізнається партнер, яка початкова адреса мого файлу?#

Ні. Партнерові ви передаєте лише симлінк. Дані він завантажує через сервер Symlink Stork, який приховує початкову адресу. Із симлінку партнер її не з’ясує.

Чи можна змінити симлінк після створення?#

Так. Для кожного симлінку можна будь-коли змінити назву, примітку, налаштування доступу або початкову джерельну URL-адресу.

Чи можна змінити джерельний файл, не надсилаючи партнерові нову адресу?#

Так. У наявному симлінку достатньо під час редагування замінити початкову адресу на нову. Симлінк партнера й далі працюватиме.

Як швидко спрацьовує видалення або деактивація симлінку?#

Негайно. Щойно ви видалите або деактивуєте симлінк, URL-адреса в партнера перестане працювати без жодної затримки.

Яка різниця між видаленням і деактивацією симлінку?#

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

Що таке персона?#

Персона — це названа вами ідентичність системи або користувача, що звертається до даних. Розширення розпізнає її за IP-адресою, User Agent або за обома параметрами одночасно. Завдяки персонам в історії звернень ви бачите зрозумілі імена (наприклад, «Партнер ABC», «Офіс») замість анонімних IP-адрес і згодом можете окремим персонам дозволити або заборонити доступ до вибраних симлінків.

Ідентифікація відбувається на основі IP-адреси та/або User Agent. Завжди потрібен точний збіг – розширення не підтримує діапазони IP-адрес і часткові збіги в тексті User Agent. Якщо одне звернення відповідає кільком персонам, діє такий пріоритет: спершу збіг IP і User Agent, потім збіг лише IP, насамкінець збіг лише User Agent.

Чи можна налаштувати, щоб симлінк працював лише для конкретного партнера й ніхто інший не завантажив дані?#

Так. Для кожного симлінку можна обмежити доступ за допомогою персон. Спочатку створіть для партнера персону з його назвою й визначте його IP-адресу або User Agent. Потім для симлінку налаштуйте режим «доступу не має ніхто, крім зазначених персон» і виберіть саме його персону. Відтоді дані успішно завантажуватиме лише цей партнер. Інші звернення буде заблоковано. Як альтернативу можна налаштувати й протилежний режим «доступ мають усі, крім конкретних вибраних персон», що стане в пригоді, наприклад, для блокування небажаних ботів або колишніх партнерів.

Чи можна призначити персонам лише IP-адресу без User Agent?#

Так. Під час створення персони достатньо заповнити лише один із параметрів. Якщо ви заповните лише IP-адресу, персона охопить усі звернення з цього місця незалежно від того, яке програмне забезпечення звертається.

Що можна дізнатися з історії?#

Для кожного звернення до симлінку Symlink Stork записує IP-адресу та User Agent системи, що звертається, дату й час звернення та результат, тобто чи було доступ дозволено (зелена крапка), чи заблоковано (червона крапка). Якщо систему, що звертається, призначено персоні, замість анонімних даних показується її назва.

Партнер каже, що не має актуальних даних. Як це перевірити?#

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

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

Під час завантаження даних із початкової URL розширення ідентифікує себе за допомогою User Agent SymlinkStorkBot/1.0 (+https://store.mergado.com/detail/symlinkstork/). Якщо ви побачите цей рядок у журналах свого сервера, це стандартна поведінка розширення, а не сторонній доступ.

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

Чи була ця стаття корисною?
Назад Symlink Stork Pairing Bear Вперед