Elbuz buduje feed produktów do reklamy w ChatGPT według schematu OpenAI i sam wysyła go na serwer SFTP OpenAI. Kolumny w gotowym szablonie „OpenAI (ChatGPT Ads)” są już nazwane i wypełnione tak, jak wymaga OpenAI — nie trzeba ich układać ręcznie.
Kiedy to się przyda:
- Uruchamiasz reklamę produktów w ChatGPT — szablon daje CSV z 17 polami OpenAI, ceną z kodem waluty i statusem dostępności.
- Ceny i stany zmieniają się codziennie — harmonogram szablonu codziennie buduje świeży plik i wysyła go na SFTP.
- OpenAI dodał nowe pole — dodajesz je zwykłą kolumną z nazwą pola OpenAI.
Od czego zacząć: „Eksport danych” → „Dodaj” → „OpenAI (ChatGPT Ads)”, dalej scenariusz pierwszego uruchomienia.
Co potrafi szablon OpenAI
- 17 gotowych kolumn — nazwa kolumny równa się nazwie pola OpenAI, cenę z walutą, dostępność, zdjęcia i opis liczy program.
- Dostępność —
in_stock,pre_orderlubout_of_stockwedług ilości i typu statusu dostępności. - Wysyłka na SFTP — po każdym eksporcie plik zastępuje poprzedni na serwerze OpenAI.
- Próbny eksport jednego produktu — pokazuje wartość każdej kolumny i niczego nie wysyła.
- Harmonogram — codzienna aktualizacja cen i dostępności bez Twojego udziału.
- Nowe pola — każde pole schematu OpenAI dodaje się zwykłą kolumną.
Co OpenAI przyjmuje i czego wymaga
OpenAI przyjmuje plik produktów w formacie CSV (separator — przecinek), TSV lub JSONL w kodowaniu . Szablon Elbuz tworzy CSV z przecinkiem.
Dostarczenie — tylko przez SFTP: OpenAI nie pobiera feedu z linku, jak robi to Google Merchant Center. Adres połączenia i hasło wydaje OpenAI, gdy dla Twojego konta reklamowego zostanie włączony dostęp do feedów produktów. Jeśli takiego dostępu nie ma, OpenAI radzi zwrócić się do swojego zespołu obsługi kont — w Elbuz nie da się go włączyć.
Pola obowiązkowe, bez których OpenAI nie przyjmie produktu:
| Pole | Wymaganie OpenAI |
|---|---|
item_id | stały identyfikator, unikalny w pliku |
title | nazwa, do 150 znaków |
description | opis zwykłym tekstem bez , do 5000 znaków |
url | strona produktu w Twoim sklepie, publiczny adres HTTP lub HTTPS (OpenAI zaleca HTTPS) |
brand | prawdziwa nazwa marki, bez symboli zastępczych |
seller_name | nazwa sprzedawcy |
image_url | bezpośredni link do zdjęcia JPEG lub PNG |
availability | jedna z wartości in_stock, out_of_stock, pre_order, backorder, unknown |
price | kwota i kod waluty oddzielone spacją: 79.99 USD |
Symbole zastępcze w rodzaju n/a czy null OpenAI zabrania: nieznane pole nieobowiązkowe trzeba zostawić puste.
Jak utworzyć szablon
Gdzie: „Eksport danych” → przycisk „Dodaj” → grupa „Plik cennika (XLSX, CSV)” → „OpenAI (ChatGPT Ads)”.
1
Grupa „Plik cennika (XLSX, CSV)”2
OpenAI (ChatGPT Ads)- Nagłówek grupy — feed OpenAI to plik CSV, dlatego jest w grupie cenników XLSX/CSV.
- OpenAI (ChatGPT Ads) — jedno kliknięcie tworzy szablon z gotowymi kolumnami.
Zaraz po utworzeniu otwiera się okno „Dodatkowe ustawienia OpenAI (ChatGPT Ads) #‹numer szablonu›”. Jest w nim już włączony format CSV z przecinkiem, archiwizacja wyłączona, a nazwa pliku to openai_products.csv. Nad listą kolumn — podpowiedź, co zostało do ustawienia ręcznie.
Do pliku trafia produkt, który jednocześnie:
- jest aktywny;
- ma znacznik „Eksportuj do pliku (do sklepu)”;
- jest w kategorii oznaczonej do eksportu;
- ma opis w języku szablonu — produkt bez rekordu opisu w wybranym języku wypada z pliku całkowicie.
Zawęzić skład jeszcze bardziej możesz na zakładce „Ograniczenie eksportu (filtr)”. Jak działają warunki filtra: Gdzie ustawia się filtr produktów.
Co trafia do pliku
Na zakładce „Wybór pól” jest 17 kolumn. Nazwa kolumny to nazwa pola OpenAI i w takiej kolejności trafiają one do pliku.
1
Podpowiedź konfiguracji2
Kolumna nazwy pola3
Formuła url4
Makro price- Podpowiedź konfiguracji — co jeszcze trzeba zrobić ręcznie: adres Twojego sklepu, nazwa sklepu i producent.
- Nazwa pola — nazwa kolumny w pliku równa się nazwie pola OpenAI.
- Formuła url — zamień https://site.com/ na adres swojego sklepu.
- price — źródło to makra: program sam składa kwotę z walutą, więc nie trzeba pisać formuły.
| Kolumna | Co do niej trafia |
|---|---|
item_id | produktu w Elbuz — nie zmienia się między eksportami |
title | pełna nazwa produktu w języku szablonu; jeśli jest dłuższa niż 150 znaków, skróć ją w katalogu |
description | pełny opis bez tagów HTML, przycięty do 5000 znaków; ", – i podobne kody zamieniają się na zwykłe cudzysłowy i myślniki |
url | adres sklepu + link SEO produktu |
brand | producent produktu |
image_url | link do pierwszego zdjęcia produktu |
additional_image_urls | linki do pozostałych zdjęć, rozdzielone przecinkami |
price | cena w domyślnej walucie Twojego konta: 249.00 PLN |
sale_price | cena promocyjna w tym samym formacie — tylko gdy jest większa od zera i mniejsza od zwykłej, w przeciwnym razie pusto |
availability | in_stock, pre_order lub out_of_stock — reguła niżej |
gtin | produktu, a jeśli jest pusty — kod kreskowy |
mpn | kod (SKU) producenta |
product_category | ścieżka kategorii, poziomy rozdzielone znakiem > |
seller_name | nazwa sklepu — tekstem w formule kolumny |
seller_url | adres sklepu — tekstem w formule kolumny |
is_eligible_search | true |
is_ads_eligible | true — bez niego OpenAI nie bierze produktu do reklamy |
Cenę, dostępność, zdjęcia, opis i kod kreskowy liczy sam program: w kolumnie jest pole systemowe, a nie formuła, więc przypadkowa edycja go nie zepsuje. Walutę i listę statusów dostępności program czyta przy każdym eksporcie — jeśli zmienisz domyślną walutę, następny plik będzie już z nową.
Jak ustalana jest dostępność
in_stock— ilość produktu jest większa od zera albo produkt ma status dostępności z typem „Jest”.pre_order— w przeciwnym razie, jeśli status ma typ „Na zamówienie”.out_of_stock— we wszystkich pozostałych przypadkach.
Typ statusu ustawia się w słowniku statusów dostępności.
Jak dodać nowe pole OpenAI
Szablon to zwykły cennik, więc każdą kolumnę można dodać, usunąć lub zmienić. Gdy OpenAI zacznie przyjmować nowe pole albo zechcesz wypełnić nieobowiązkowe, kliknij „Dodaj pole do eksportu” i nazwij kolumnę dokładnie tak jak pole w schemacie OpenAI.
Przykład: pole condition (stan produktu). Dodaj „Własna formuła”, nazwij kolumnę condition i wpisz w formule "new" — w każdym wierszu pliku będzie new.
Pola systemowe „Cena z walutą (79.99 USD)”, „Dostępność, kod (in_stock / out_of_stock / pre_order)”, „Link do głównego zdjęcia produktu”, „Pełny opis jako tekst (bez HTML, do 5000 znaków)” i inne są dostępne także w zwykłym cenniku — przydadzą się w feedach CSV innych marketplace’ów.
Co trzeba poprawić ręcznie
Program nie zna dwóch rzeczy o Twoim biznesie i trzeba je wpisać samodzielnie.
Adres sklepu. Program bierze go z ustawień sklepu głównego. Jeśli jest tam pusto, w kolumnach url i seller_url stoi https://site.com/. Kliknij komórkę „Formuła” w wierszu kolumny i zamień ten adres na swój. W url po adresie musi zostać makro linku SEO produktu — to ono dopisuje do adresu ścieżkę do konkretnego produktu.
Nazwa sklepu. Do kolumny seller_name trafia nazwa sklepu głównego. Jeśli jest tam nazwa domyślna, zamień ją w formule na prawdziwą: OpenAI wymaga rzeczywistej nazwy sprzedawcy.
brand jest obowiązkowe. W produktach bez producenta będzie puste i OpenAI takie produkty odrzuci. Uzupełnij producenta w katalogu przed pierwszym eksportem.Jaka część katalogu jest gotowa do reklamy w ChatGPT, pokaże okno „Jakość feedu”, zakładka „Gotowość na AI”: wynik katalogu i każdej kategorii oraz czego brakuje produktom — kodu kreskowego, marki, zdjęć, opisu, atrybutów. Okno dla tego szablonu otwiera przycisk „Jakość feedu” w bloku „Powiązane ustawienia”. Więcej: Gotowość katalogu na AI.
Jak wysłać plik na SFTP OpenAI
Gdzie: zakładka „Ustawienia” → blok „Powiązane ustawienia” → „Ustawienia FTP”.
1
Pole wyboru SFTP2
Adres serwera i port3
Nazwa użytkownika i hasło4
„Sprawdź połączenie”- Zaznacz SFTP: OpenAI przyjmuje plik tylko przez SFTP.
- Wpisz adres serwera i port z danych połączenia wydanych przez OpenAI.
- Wpisz nazwę użytkownika i hasło wydane przez OpenAI.
- „Sprawdź połączenie” testuje wpisany dostęp przed pierwszym eksportem.
- Włącz „SFTP (SSH File Transfer Protocol)”.
- W „Adres serwera FTP” wpisz serwer z adresu połączenia OpenAI, w „Port” — port z tego samego adresu. Dla SFTP program bierze port bez zmian i sam nie zamienia 21 na 22.
- W „Nazwa użytkownika” i „Hasło” — login i hasło od OpenAI.
- „Ścieżka docelowa eksportu” zostaw pustą: OpenAI oczekuje pliku w katalogu głównym SFTP, bez podfolderów.
- Kliknij „Sprawdź połączenie”.
Po każdym eksporcie plik openai_products.csv trafia do tego folderu pod tą samą nazwą i zastępuje poprzedni. Wysyłka następuje tylko wtedy, gdy wypełnione są i serwer, i nazwa użytkownika: jeśli jedno z nich jest puste, plik się buduje, ale nigdzie nie jest wysyłany, a w dzienniku nie będzie błędu.
Jak sprawdzić szablon i uruchomić pierwszy eksport
Przycisk z kolbą w nagłówku okna szablonu wykonuje próbny eksport jednego produktu: pokazuje każdą kolumnę z jej wartością. Plik nie jest przy tym nigdzie wysyłany. Sprawdź url — link musi się otwierać — i price z walutą.
1
Wiersz price2
Wiersz availability3
Wiersz url- price — kwota i kod waluty oddzielone spacją.
- availability — kod dostępności zrozumiały dla OpenAI (in_stock).
- url — sprawdź, czy link prowadzi do Twojego sklepu.
Pełny eksport uruchamia przycisk „Eksportuj ten szablon” w wierszu szablonu. W dzienniku po udanej wysyłce pojawi się wiersz „Wyeksportowano pliki przez FTP: 1 z 1”. Co jeszcze pokazuje dziennik przebiegu: Dziennik przebiegu i historia uruchomień.
Przed pierwszym eksportem
Jak codziennie aktualizować ceny
Ceny i dostępność w OpenAI aktualizuje tylko nowy plik. Żeby przychodził sam, włącz harmonogram.
Gdzie: zakładka „Ustawienia” → „Powiązane ustawienia” → „Ustawienia harmonogramu”.
Każde uruchomienie według harmonogramu buduje plik od nowa z bieżących danych katalogu i wysyła go na SFTP. Jak działa harmonogram: Uruchamianie ręczne i według harmonogramu.
Scenariusze
Pierwsze uruchomienie reklamy produktów w ChatGPT
- Co skonfigurować: „Dodaj” → „OpenAI (ChatGPT Ads)”; w formułach
url,seller_urliseller_name— swój sklep i nazwa sklepu; „Ustawienia FTP” z zaznaczonym SFTP i danymi OpenAI → „Sprawdź połączenie”; próbny eksport jednego produktu. - Efekt: „Eksportuj ten szablon” buduje
openai_products.csvi umieszcza go w katalogu głównym SFTP OpenAI; w dzienniku — „Wyeksportowano pliki przez FTP: 1 z 1”.
Codzienna aktualizacja cen i dostępności
- Co skonfigurować: „Ustawienia harmonogramu” w bloku „Powiązane ustawienia”.
- Efekt: każde uruchomienie buduje plik z bieżących cen i stanów i zastępuje poprzedni na SFTP.
Reklama tylko części katalogu
- Co skonfigurować: warunki na zakładce „Ograniczenie eksportu (filtr)”.
- Efekt: do pliku trafiają tylko produkty, które przeszły filtr; pozostałych w reklamie OpenAI nie będzie.
OpenAI zaczął przyjmować nowe pole
- Co skonfigurować: „Dodaj pole do eksportu” → „Własna formuła”, nazwa kolumny — nazwa pola OpenAI (przykład z condition).
- Efekt: nowe pole trafia do pliku od następnego eksportu.
Co zrobić, gdy OpenAI nie przyjmuje produktów
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Błąd logowania do serwera SFTP!” w dzienniku | Błędny login lub hasło. Jeśli po tekście jest komunikat „Cannot connect to …” — program nie dotarł do serwera: błędny adres lub port | Porównaj dane z adresem połączenia OpenAI i kliknij „Sprawdź połączenie” (wysyłka na SFTP) |
| Plik zbudowany, a wiersza „Wyeksportowano pliki przez FTP” nie ma i błędu też nie ma | W „Ustawienia FTP” serwer lub nazwa użytkownika są puste | Wypełnij oba pola (wysyłka na SFTP) |
W url stoi https://site.com/… |
W sklepie głównym nie podano adresu sklepu | Zamień adres w formułach url i seller_url (co poprawić) |
OpenAI odrzuca produkty z powodu pustego brand |
Produkty nie mają uzupełnionego producenta | Uzupełnij producenta w katalogu (co poprawić) |
Produkt jest dostępny, a w pliku out_of_stock |
Ilość wynosi zero, a status dostępności produktu nie ma typu „Jest” | Zmień typ statusu w słowniku statusów dostępności (jak ustalana jest dostępność) |
| Produktu nie ma w pliku | Nie ma opisu w języku szablonu albo odcina go jeden z warunków filtra | Sprawdź warunki składu pliku i dlaczego produkt nie trafił do pliku |
Najczęstsze pytania
Czy można dać OpenAI link do pliku zamiast SFTP?
Nie. OpenAI przyjmuje plik produktów tylko przez SFTP. Linku do pliku w chmurze, który Elbuz tworzy po eksporcie, OpenAI nie pobiera.
Czy przecinek w nazwie produktu zepsuje plik?
Nie. Wartości z przecinkiem lub cudzysłowem program bierze w cudzysłów, a cudzysłowy wewnątrz podwaja — to standard CSV i OpenAI czyta takie wiersze poprawnie. Podziały wierszy i tabulatory w opisach są zamieniane na spację.
W jakiej walucie idzie cena?
W domyślnej walucie Twojego konta, jej kod jest dopisywany do kwoty: 249.00 PLN. Po zmianie domyślnej waluty następny plik będzie już z nową.
Jak często aktualizują się ceny w OpenAI?
Tak często, jak eksportujesz plik: między eksportami OpenAI widzi poprzednie ceny i dostępność. Szybkiego kanału zmian OpenAI (Delta ) Elbuz nie używa. Do codziennej aktualizacji włącz harmonogram.
Czy można wyeksportować warianty produktu jedną grupą?
Nie. Każdy produkt idzie osobnym wierszem: pól group_id i variant_dict w zestawie szablonu nie ma.
Czy można wyeksportować nazwy i opisy po angielsku?
Tak, jeśli teksty po angielsku są w katalogu. Język wybiera się na zakładce „Ustawienia” w polu „ID języka”: title i description są brane właśnie w tym języku. Produkt bez opisu po angielsku w ogóle nie trafi do pliku.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Eksport danych
- Inne wejścia
- ołówek w wierszu szablonu — karta „Dodatkowe ustawienia …”
- Uprawnienia
- okna „Eksport” i „Szczegółowa konfiguracja szablonu eksportu”
- Przygotuj
- dostęp do feedów na koncie reklamowym OpenAI i dane SFTP od OpenAI
Bez uprawnienia do „Szczegółowa konfiguracja szablonu eksportu” szablon widać na liście, ale nie da się go skonfigurować: karta, próbny eksport i są zamknięte tym uprawnieniem.
Powiązane tematy
- Jeśli trzeba zrozumieć, dlaczego szablon się nie uruchomił albo produkt nie trafił do pliku — Eksport produktów na marketplace, do sklepu i do pliku.
- Jeśli obok potrzebny jest feed dla Zakupów Google — Feed Google Merchant.
- Jeśli produkt jest dostępny, a w feedzie
out_of_stock— Statusy dostępności. - Jeśli produkty nie mają zdjęć, bez których OpenAI nie przyjmie produktu — Zdjęcia produktów.
