↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Jak wyeksportować katalog do feedu XML dla dowolnego serwisu

    Jak wyeksportować feed produktów dla OpenAI (reklama w ChatGPT)

    6 min czytaniaZaktualizowano

    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_order lub out_of_stock wedł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:

    PoleWymaganie OpenAI
    item_idstały identyfikator, unikalny w pliku
    titlenazwa, do 150 znaków
    descriptionopis zwykłym tekstem bez , do 5000 znaków
    urlstrona produktu w Twoim sklepie, publiczny adres HTTP lub HTTPS (OpenAI zaleca HTTPS)
    brandprawdziwa nazwa marki, bez symboli zastępczych
    seller_namenazwa sprzedawcy
    image_urlbezpośredni link do zdjęcia JPEG lub PNG
    availabilityjedna z wartości in_stock, out_of_stock, pre_order, backorder, unknown
    pricekwota 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)”.

    Menu „Dodaj” w oknie eksportu z grupą „Plik cennika (XLSX, CSV)” i pozycją OpenAI (ChatGPT Ads) na pierwszym miejscu
    1Grupa „Plik cennika (XLSX, CSV)”
    2OpenAI (ChatGPT Ads)
    1. Nagłówek grupy — feed OpenAI to plik CSV, dlatego jest w grupie cenników XLSX/CSV.
    2. 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.

    Okno szablonu OpenAI (ChatGPT Ads) na zakładce „Wybór pól” z tabelą kolumn
    1Podpowiedź konfiguracji
    2Kolumna nazwy pola
    3Formuła url
    4Makro price
    1. Podpowiedź konfiguracji — co jeszcze trzeba zrobić ręcznie: adres Twojego sklepu, nazwa sklepu i producent.
    2. Nazwa pola — nazwa kolumny w pliku równa się nazwie pola OpenAI.
    3. Formuła url — zamień https://site.com/ na adres swojego sklepu.
    4. price — źródło to makra: program sam składa kwotę z walutą, więc nie trzeba pisać formuły.
    KolumnaCo do niej trafia
    item_id produktu w Elbuz — nie zmienia się między eksportami
    titlepełna nazwa produktu w języku szablonu; jeśli jest dłuższa niż 150 znaków, skróć ją w katalogu
    descriptionpeł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
    urladres sklepu + link SEO produktu
    brandproducent produktu
    image_urllink do pierwszego zdjęcia produktu
    additional_image_urlslinki do pozostałych zdjęć, rozdzielone przecinkami
    pricecena w domyślnej walucie Twojego konta: 249.00 PLN
    sale_pricecena promocyjna w tym samym formacie — tylko gdy jest większa od zera i mniejsza od zwykłej, w przeciwnym razie pusto
    availabilityin_stock, pre_order lub out_of_stock — reguła niżej
    gtin produktu, a jeśli jest pusty — kod kreskowy
    mpnkod (SKU) producenta
    product_categoryścieżka kategorii, poziomy rozdzielone znakiem >
    seller_namenazwa sklepu — tekstem w formule kolumny
    seller_urladres sklepu — tekstem w formule kolumny
    is_eligible_searchtrue
    is_ads_eligibletrue — 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ść

    1. in_stock — ilość produktu jest większa od zera albo produkt ma status dostępności z typem „Jest”.
    2. pre_order — w przeciwnym razie, jeśli status ma typ „Na zamówienie”.
    3. 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.

    Pole 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”.

    Okno ustawień FTP z polami serwera, portu, pola wyboru SFTP, nazwy użytkownika, hasła i ścieżki
    1Pole wyboru SFTP
    2Adres serwera i port
    3Nazwa użytkownika i hasło
    4„Sprawdź połączenie”
    1. Zaznacz SFTP: OpenAI przyjmuje plik tylko przez SFTP.
    2. Wpisz adres serwera i port z danych połączenia wydanych przez OpenAI.
    3. Wpisz nazwę użytkownika i hasło wydane przez OpenAI.
    4. „Sprawdź połączenie” testuje wpisany dostęp przed pierwszym eksportem.
    1. Włącz „SFTP (SSH File Transfer Protocol)”.
    2. 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.
    3. W „Nazwa użytkownika” i „Hasło” — login i hasło od OpenAI.
    4. „Ścieżka docelowa eksportu” zostaw pustą: OpenAI oczekuje pliku w katalogu głównym SFTP, bez podfolderów.
    5. 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ą.

    Wynik sprawdzenia szablonu eksportu dla jednego produktu z wierszami item_id, title, url, price i availability
    1Wiersz price
    2Wiersz availability
    3Wiersz url
    1. price — kwota i kod waluty oddzielone spacją.
    2. availability — kod dostępności zrozumiały dla OpenAI (in_stock).
    3. 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_url i seller_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.csv i 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

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo 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

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo