Odoo Doofinder Integration

Перед додаванням інсталяційного скрипту на ваш сайт необхідно отримати ідентифікатор магазину в Doofinder та визначити пошукову зону.

Отримання ідентифікатора магазину

• 01
  Авторизуйтесь у ваш обліковий запис Doofinder
• 02
  Перейдіть в меню Configuration — All stores
• 03
  Скопіюйте Store ID

Визначення пошукової зони

Пошукову зону потрібно визначити відповідно до регіону, у якому працює ваш інтернет-магазин.

• 01
  Відкрийте Configuration — General settings
• 02
  Знайдіть блок Installation script
• 03
  Перевірте адресу скрипту:

• eu1 — Європа
• us1 — Америка
• ap1 — Азія

Налаштування Search Layer у Doofinder

Search Layer використовується для інтеграції пошуку Doofinder з пошуковим полем вебсайту та відображення результатів пошуку безпосередньо на вашому сайті через інтерфейс Doofinder.

• 01
  Відкрийте Search — Layer settings
• 02
  Скопіюйте .o_doofinder_product_search та вставте у поле Enter the search input CSS selector
• 03
  Натисніть Save

Активація скрипту в Odoo

Після встановлення модуля активуйте скрипт, виконавши такі дії:

• 01
  Перейдіть до налаштувань веб-сайту
• 02
  Активуйте опцію Doofinder у розділі Tracking and SEO
• 03
  Вставте скопійований ідентифікатор магазину в поле Store ID
• 04
  У полі Search Zone оберіть регіон магазину
• 05
  Збережіть налаштування

Після цього модуль автоматично додає скрипт Doofinder на всі сторінки вашого вебсайту Odoo.

Підтвердження встановлення коду Doofinder

Щоб підтвердити, що код Doofinder встановлений на сайті, відкрийте будь-яку сторінку вашого веб-сайту Odoo.

Для тестування вийдіть з Odoo або використовуйте інший браузер, оскільки інсталяційний скрипт Doofinder не працює для внутрішніх користувачів Odoo.

Далі слідуйте наступними кроками:

• 01
  Натисніть правою кнопкою миші на сторінці сайту та виберіть Переглянути код сторінки
• 02
  Знайдіть у коді сторінки теги та
• 03
  Переконайтеся, що між цими тегами присутній інсталяційний скрипт Doofinder приблизно такого формату:

Doofinder рекомендує цю перевірку: якщо скрипт присутній у коді сторінки у такому форматі, він встановлений.

Після встановлення модуля відкрийте список фідів, щоб переглянути та налаштувати фід відповідно до потреб вашого магазину. Перейдіть до меню Веб-сайт — Електронна комерція — Фіди даних.

Модуль постачається з готовим шаблоном фіду, налаштованим відповідно до вимог Doofinder.

Шаблони фідів мають зелений колір у списку.

Зробіть копію фіда з шаблону через дію Дублювати. Копію фіда налаштовуйте під власні потреби, а шаблон залишайте без змін і використовуйте як зразок базових налаштувань.

Визначення вебсайту

У фіді на вкладці Налаштування фіда оберіть веб-сайт, для якого попередньо налаштовано та підключено скрипт Doofinder.

Визначення списку товарів

Фід працює з варіантами товарів. Якщо товар має кілька варіантів, кожен із них передається до Doofinder окремо.

За допомогою Фільтра товарів визначте, які товари потрібно включити до фіду даних.

Натисніть на Редагувати домен, щоб додати критерії відбору товарів для фіду даних.

Правило фільтрації Опубліковано є встановити обов'язкове, якщо товари продаються через сайт електронної комерції на базі Odoo.

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

Щоб переглянути список товарів фіду, натисніть на посилання з кількістю записів або на кнопку Товари у верхній частині екрану.

Місця зберігання товарів

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

Перейдіть до секції Наявність товарів на вкладці Налаштування фіду даних. Оберіть необхідні місця зберігання у полі Склади.

Таким чином, модуль розраховує залишки товарів для фіду даних лише за вказаними складськими локаціями.

Якщо не обирати Склади, модуль розраховує залишки та статуси наявності товарів для всіх складів компанії.

Doofinder підтримує два режими роботи з цінами. Вибір режиму залежить від поєднання мов, валют і прайс-листів, які використовуються в магазині.

Режим Single Price призначений для магазинів, де кожна мовна версія сайту має одну валюту. Для кожної комбінації мови та валюти у акаунті Doofinder налаштовується окремий Search Engine для магазину. Doofinder динамічно визначає потрібний Search Engine на основі поточних мови та валюти сайту.

Режим Multiprice призначений для магазинів, де одна мовна версія сайту має кілька валют або прайс-листів. У цьому режимі для однієї мовної версії використовується один Search Engine Doofinder, у якому зберігаються цінові дані для всіх налаштованих валют.

За замовчуванням фід працює в режимі Single Price.

Налаштування цін для режиму Single Price

Переконайтеся, що опція Multiprice для Doofinder вимкнена в налаштуваннях вебсайту.

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

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

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

Для вибраної мови у фіді та валюти прайс-листа в Doofinder має бути створено відповідний Search Engine.

Налаштування цін для режиму Multiprice

Увімкніть опцію Multiprice для Doofinder у налаштуваннях вебсайту.

Введіть у поле Doofinder Language код мови магазину, який використовується у відповідному Doofinder Search Engine. Код мови ви можете знайти у вашому акаунті Doofinder.

• 01
  Увійдіть до кабінету Doofinder
• 02
  У верхній частині сторінки виберіть потрібний Store
• 03
  Відкрийте Configuration
• 04
  Перейдіть у розділ Search Engines
• 05
  У списку Published знайдіть потрібний Search Engine
• 06
  Поруч із назвою Search Engine відображається позначення у форматі код(валюта). На скріншоті:

• en — код мови
• ($) — позначення валюти

Щоб змінити мову Search Engine, необхідно натиснути три крапки праворуч від потрібного Search Engine та перейти в меню Edit setup.

Щоб автоматично активувати колонку df_multiprice у всіх Doofinder-фідах поточного вебсайту, натисніть Enable df_multiprice column у налаштуваннях. Ця колонка використовується для передачі цін товарів у різних валютах. Для її деактивації натисніть Disable df_multiprice column.

Next, go to the feed form and open the Settings tab. In the Advanced section, select the website Language for which pricelists in different currencies are used.

Щоб налаштувати прайс-листи для різних валют, перейдіть за посиланням Встановити прайс-листи у секції Мультиціна.

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

Після вибору прайс-листів налаштуйте, які типи цін потрібно передавати у фіді даних для колонки df_multiprice, яка відповідає у фіді за передачу цін у різних валютах. Для цього у розділі Multiprice натисніть Configure Prices та в спливаючому вікні оберіть потрібні типи цін.

• Regular Price: ціна товару згідно з основним прайс-листом
• Sale Price: ціна товару зі знижкою згідно з акційним прайс-листом
• Best Price: найвигідніша ціна продажу товару без урахування податків
• Purchase Price: закупівельна ціна або собівартість товару

За замовчуванням у шаблоні фіда обрані Regular Price та Sale Price.

Doofinder рекомендує передавати Best Price та Purchase Price разом, щоб отримувати інформацію про маржу товару та використовувати її для просування товарів.

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

Для керування колонками натисніть на Колонки у верхній частині вікна.

Список доступних колонок наведений в таблиці нижче.

Частина колонок у шаблоні фіду за замовчуванням неактивна. Перегляньте список і активуйте потрібні.

Колонка category

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

У списку доступних колонок відкрийте колонку category. Тут ви можете налаштувати перемикач Export All Categories, який визначає, чи передавати всі категорії товару або лише одну.

За замовчуванням увімкнено передачу всіх категорій товару.

Додаткові характеристики товару

Ви можете передавати до Doofinder додаткові характеристики товару, які не належать до стандартних полів фіду. Наприклад, матеріал, колір, розмір або інші характеристики, які використовуються у вашому інтернет-магазині.

Для кожної характеристики необхідно створити окрему колонку та налаштувати її.

У списку колонок натисніть Новий для створення нової колонки.

На формі нової колонки в полі Name вкажіть назву колонки, в полі Тип виберіть значення Спецтип, у полі Спеціальний Тип виберіть значення Атрибут Товару, далі в полі Атрибут із випадаючого списку оберіть потрібну характеристику.

Для назви колонки використовуйте одне слово маленькими літерами, наприклад, color.

Якщо товар має кілька значень вибраної характеристики, увімкніть Export all Attribute values, щоб передати до фіду всі доступні значення.

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

Налаштування фіду даних для Doofinder можна робити також в картці товару. Модулі для товарних фідів даних від Garazd Creation включають розширення, які дозволяють наповнювати ваші товари в Odoo додатковою інформацією та ділитися нею через фід:

• Product Brands for Data Feeds — додає можливість вказати бренд товару
• Number Fields for Data Feeds — додає поля для міжнародних номерів та кодів товару
• Product Data Feed — додає специфічні налаштування відповідно до аналітичної системи або торговельного майданчика

Нижче наведені налаштування товару, які релевантні для Doofinder.

Бренд

Щоб вказати бренд, відкрийте товар на вкладці General Information та заповніть поле Brand.

Коди

Товарні коди, такі як GTIN та MPN, можна вказати на вкладці Extra в розділі Codes.

Для підключення фіду даних до Doofinder потрібні налаштований фід даних та акаунт в Doofinder.

Попередній перегляд фіду

Перед підключенням фіду даних до Doofinder натисніть Preview, щоб переглянути результат налаштувань:

Попередній перегляд згенерованого фіду:

Як підключити фід до Doofinder

Щоб додати товарний фід до акаунту Doofinder, спочатку скопіюйте URL потрібного фіду даних в Odoo.

У вашому акаунті Doofinder у верхній частині сторінки виберіть потрібний Store. Перейдіть до меню Configuration — Search Engines та в списку Published знайдіть потрібний Search Engine та оберіть дію See indices.

Далі слідуйте наступними кроками:

• 01
  Натисніть на Add Source
• 02
  Вставте скопійоване URL фіда в поле та натисніть Add
• 03
  Натисніть на Process Now

Після обробки фіду Doofinder відображає повідомлення про результат індексації — успішну або неуспішну. У разі успішної індексації зазначається кількість проіндексованих товарів.

На цій самій сторінці нижче, у блоці Configuration:

• Налаштуйте частоту автоматичного оновлення
• Увімкніть Group variants as a single item, якщо використовуєте group_id та group_leader
• У разі потреби додайте в Additional indexed fields поля з фіду, які не індексуються за замовчуванням

Деякі додаткові характеристики товарів і створені користувачем колонки фіду можуть не індексуватися в Doofinder за замовчуванням.

Попередній перегляд результатів

Ви можете використовувати Results Preview, щоб протестувати Search Engine і перевірити, як Doofinder відображає товари з вашого фіду з урахуванням переданих колонок. Для цього перейдіть в Admin Panel — Search.

Кількість відображених товарів може бути меншою за кількість товарів у фіді, якщо увімкнено Group variants as a single item — у такому разі варіанти одного товару групуються та відображаються як один елемент.

Натисніть +, щоб відкрити детальну інформацію про товар і перевірити передані у фіді поля та їхні значення.