Як підключити фід із Mergado до OpenAI Ads Manager#

Щоб ваші товари могли показуватися в рекламі в ChatGPT, OpenAI Ads Manager потрібен ваш товарний фід. Mergado підготує його у форматі ChatGPT Shopping і подбає про його регулярне доставлення. Облікові записи Mergado та Ads Manager при цьому жодним чином не пов’язуються, Mergado лише надсилає актуальний фід туди, куди ви йому вкажете.

У цій статті дізнаєтеся, який спосіб підключення вибрати, як крок за кроком налаштувати рекомендоване підключення через SFTP (і під час створення нового проєкту, і в проєкті, який у вас уже є) та що робити, якщо товари в Ads Manager не збігаються.

Який спосіб підключення вибрати#

Під час створення фіду Ads Manager пропонує три варіанти:

SFTP не варто боятися. Звучить технічно, але налаштовується лише один раз. Дані для доступу згенерує Ads Manager, а далі Mergado надсилатиме фід самостійно.

Перш ніж почати#

• Перевірте якість фіду в інструменті Mergado Audit. Ads Manager майже не дає зворотного зв’язку щодо помилок у даних, тож краще виправити їх заздалегідь. Найчастіше бракує опису (description) або бренду (brand).
• Відкрийте поруч два вікна: Ads Manager і Mergado. Дані для доступу копіюватимете з одного в інше.

Крок 1: Створіть фід в Ads Manager#

1. В Ads Manager перейдіть до Tools → Feeds.
2. Натисніть Create Feed.
3. Заповніть Display name, наприклад назву інтернет-магазину та країну.
4. У пункті How will you send products? виберіть SFTP connection.
5. Натисніть Create.

Крок 2: Згенеруйте дані для доступу до SFTP#

Після створення фіду відкриється панель Connect your feed via SFTP.

1. У частині Choose authentication виберіть вхід за паролем і згенеруйте пароль.
2. Одразу скопіюйте та збережіть пароль. Після закриття вікна ви його більше не побачите. Якщо ви його втратите, доведеться згенерувати новий і змінити його також у Mergado Keychain (див. Часті запитання).
3. У частині Add connection details знайдете дані, які знадобляться в Mergado:
   • Host: адреса сервера, наприклад sftp.commerce.openai.com або sftp-prod3.commerce.openai.com
   • Username: довгий рядок, що починається з oaiproductfeedprod
   • Upload path: /
   • Port: 443

⚠️ Адреса сервера (Host) відрізняється від фіду до фіду. Завжди копіюйте її точно з Ads Manager. Ім’я користувача та пароль до іншого сервера не працюватимуть.

Залиште панель відкритою, з неї копіюватимете дані до Mergado.

Крок 3: Заповніть підключення в Mergado#

Підключення в Mergado можна налаштувати двома способами залежно від того, чи ви проєкт лише створюєте, чи він у вас уже є:

• Створюєте новий проєкт? Підключення заповните одразу в майстрі створення проєкту (варіант А). Потім нічого не доведеться налаштовувати додатково.
• Проєкт у вас уже є, наприклад лише з адресою вихідного фіду і без SFTP? Підключення додасте в налаштуваннях проєкту (варіант Б).

Варіант А: під час створення нового проєкту#

Цей порядок дій показано у відео:

1. Почніть створювати новий проєкт за інструкцією Як створити новий проєкт у Mergado?
2. На кроці вибору вихідного формату виберіть країну, а як вихідний формат ChatGPT Shopping (наприклад, ChatGPT Shopping [CZ] TSV).
3. Під вибором формату ввімкніть перемикач Upload output feed to OpenAI SFTP (optional). Підключення до OpenAI вже заповнене наперед, досить додати дані для входу.
4. Заповніть Username (Username з Ads Manager), залиште вибраний вхід через Password і вставте Password, згенерований в Ads Manager.
5. Натисніть Show advanced settings і перевірте Server URL. Наперед заповнено sftp.commerce.openai.com. Якщо Ads Manager для вашого фіду вказує інший Host, перепишіть її. Порт 443 і віддалений каталог / залиште без змін.
6. Пройдіть майстер до кінця.

На останньому екрані майстра побачите зелене повідомлення про те, що файл експортується на зовнішній сервіс SFTP, разом з адресою сервера. Підключення у фоновому режимі збережеться в Mergado Keychain, і Mergado завантажить на нього фід одразу після першого експорту. Перейдіть до кроку 4.

Варіант Б: у наявному проєкті#

Цей порядок дій також показано у відео:

1. У Mergado відкрийте проєкт із вихідним форматом ChatGPT Shopping і перейдіть до Settings.
2. Знайдіть розділ SFTP/FTP/FTPS server і натисніть New connection.
3. Заповніть форму:
   • Connection type: SFTP
   • Username: Username з Ads Manager
   • Authentication: Password
   • Password: пароль, згенерований в Ads Manager
   • Server URL: Host з Ads Manager
   • Port: 443 (стандартне значення 22 перепишіть)
   • Remote directory: /
   • File name: будь-яка, наприклад chatgpt-shopping-cz
   • Connection name: необов’язкова, допоможе розрізнити підключення, якщо їх у вас кілька
4. Натисніть Save.

Після цього в огляді підключень з’явиться нове підключення зі статусом Connected. Підключення збережеться також у Mergado Keychain, тож його можна використати й в інших проєктах.

💡 У налаштуваннях проєкту підключення можна лише створити, переглянути або від’єднати. Змінити наявне підключення, наприклад пароль чи адресу сервера, можна лише в Mergado Keychain.

Крок 4: Перевірте завантаження#

1. У наявному проєкті (варіант Б) натисніть у Settings проєкту Regenerate changed. Mergado створить експорт і одразу завантажить його на SFTP. У новому проєкті (варіант А) перший експорт і завантаження відбудуться автоматично після завершення майстра. Наступні завантаження вже відбуваються автоматично після кожної перегенерації проєкту.
2. Перевірте завантаження в Mergado:
   • на сторінці Overview проєкту в рядку Last upload to external storage,
   • в History проєкту після фільтрування події External storage. Якщо завантаження не вдалося, тут побачите й причину.
3. Перевірте результат в Ads Manager. На панелі SFTP-фіду є частина Upload and verify, яка сама розпізнає завантажений файл і покаже результат обробки. Якщо нічого не відбувається, натисніть Refresh. Загальну кількість товарів потім знайдете в Tools → Feeds у стовпці Products, а подробиці окремих завантажень на вкладці Upload History.

Обробка на боці OpenAI може тривати якийсь час, тому кількість товарів може оновитися не одразу після завантаження.

Кількість в обох місцях може відрізнятися. Upload History показує, скільки товарів містив завантажений файл, зокрема й товари, яких немає в наявності. Стовпець Products на вкладці Feed Connection показує лише товари, які OpenAI обробило й може використати в рекламі. Детальну розбивку побачите, якщо наведете курсор на значок біля числа.

Що робити, якщо щось не працює#

В Ads Manager я бачу набагато більше товарів, ніж є в моєму фіді#

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

Рішення:

• Видаліть старий файл. Підключіться до SFTP з тими самими даними, що й у Mergado, наприклад через FileZilla або Cyberduck, і видаліть усі файли, крім того, назва якого відповідає File name в налаштуваннях проєкту. Файл status.json належить OpenAI, його залиште.
• Або почніть із чистого фіду. В Ads Manager створіть новий фід із новими даними для доступу, його папка буде порожньою. У Mergado потім від’єднайте старе підключення й заповніть нове. Кампанії, підключені до старого фіду, потрібно буде підключити до нового.

В Ads Manager я бачу менше товарів, ніж є в моєму фіді#

OpenAI не обробляє для реклами товари, яких немає в наявності, тобто товари зі значенням out_of_stock в елементі availability. На вкладці Upload History ви все одно побачите їх серед завантажених, але в стовпці Products на вкладці Feed Connection їх немає. Меншу частину різниці зазвичай становлять товари, які OpenAI не схвалило. Їхню кількість побачите в рядку Not approved, якщо наведете курсор на значок біля кількості товарів.

Рішення:

• Приховайте товари, яких немає в наявності. Створіть вибірку товарів, яких немає в наявності, за елементом наявності у вашому фіді, і використайте її в правилі Приховування товару. Тоді фід міститиме лише товари, які можуть з’явитися в рекламі, і кількість у Mergado та в Ads Manager збігатиметься. Щойно товар знову з’явиться в наявності, він автоматично повернеться у фід.
• Перевірте несхвалені товари в Mergado Audit. Ads Manager здебільшого не вказує причину відхилення, найчастіше бракує обов’язкових даних, наприклад бренду.

Завантаження на SFTP не працює#

Причину помилки побачите в History проєкту в події External storage. Найчастіші причини:

• Ви змінили пароль. Коли в Ads Manager згенеруєте новий пароль, старий перестає діяти. Новий пароль змініть у наявному SFTP-підключенні в Mergado Keychain. У налаштуваннях проєкту змінити підключення не можна.
• Не збігається адреса сервера. Кожен фід може мати інший Host. Порівняйте Server URL у підключенні в Mergado Keychain зі значенням Host в Ads Manager і за потреби виправте її там.
• Неправильний порт. OpenAI використовує порт 443, а не стандартний 22.

Фід має 0 товарів або Ads Manager відхилив його без пояснення причини#

Ads Manager часто не вказує, що йому не подобається в даних. Перевірте фід у Mergado Audit, який для кожної помилки покаже й порядок її виправлення. Помилки потім виправте правилами в Mergado, а не вручну товар за товаром.

Підключення через Hosted URL не вдається зберегти або фід не завантажується#

Щодо підключення через URL ми фіксуємо випадки, коли Ads Manager його не приймає, хоча той самий фід через SFTP проходить. Якщо URL у вас не працює, перейдіть на SFTP за цією інструкцією.

Фід або зображення не завантажуються через firewall#

Якщо ваш інтернет-магазин захищає Cloudflare або інший firewall, він може блокувати завантаження вхідного фіду та зображень. Дійте за інструкцією Як налаштувати Cloudflare, щоб він не блокував завантаження фіду та зображень?

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

Чи обов’язково підключати фід через SFTP?#

Ні, SFTP не обов’язковий. Фід можна додати до Ads Manager і як Hosted URL. Але SFTP ми рекомендуємо, бо він надійніший і Mergado завантажує на нього фід після кожної перегенерації.

Чи можна додати SFTP до проєкту, який у мене вже є?#

Так. Дійте за варіантом Б у кроці 3. Проєкт не потрібно створювати заново.

Як часто оновлюється фід в Ads Manager?#

Mergado завантажує актуальний фід на SFTP після кожної перегенерації проєкту. Коли його обробить OpenAI, визначає вже Ads Manager.

Чи можна надсилати кілька проєктів із Mergado до одного фіду в Ads Manager?#

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

Чи показуватимуться товари з фіду і у звичайних відповідях ChatGPT?#

Ні. Фід, завантажений до Ads Manager, слугує лише для платної реклами. Органічний показ товарів у ChatGPT є окремою програмою OpenAI.

Втратили пароль до SFTP. Що робити?#

Пароль в Ads Manager показується лише один раз. Дійте так:

1. В Ads Manager у налаштуваннях SFTP-підключення фіду згенеруйте новий пароль. Старий тим самим перестане діяти.
2. У Mergado відкрийте Mergado Keychain, знайдіть наявне SFTP-підключення до OpenAI і змініть у ньому пароль.
3. Збережіть. Під час наступної перегенерації проєкту Mergado ввійде вже з новим паролем.

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