Import pliku produktowego - Instrukcja krok po kroku

1. Wprowadzenie

Import pliku produktowego to funkcja umożliwiająca masowe dodanie produktów do Twojego projektu w Data Octopus poprzez wczytanie pliku XML zawierającego dane produktowe.

Kiedy używać importu pliku produktowego:

Chcesz dodać wiele produktów jednocześnie
Masz katalog produktowy w formacie XML
Importujesz dane z Google Merchant Center

2. Wymagania dotyczące pliku

Format pliku

Plik produktowy musi spełniać następujące wymagania:

✅ Format: XML
✅ Zgodność: Format kompatybilny z Google Merchant Center (w plikach XML, które mają inne nazewnictwo kolumn niż dokumentacja Google Merchant Center należy ręcznie dodać schemat danych)
✅ Kodowanie: UTF-8 (zalecane)

Wymagane kolumny (zgodne z Google Merchant Center)

Plik XML musi zawierać standardowe nazwy kolumn używane przez Google Merchant Center:

id - unikalny identyfikator produktu
title - nazwa produktu
description - opis produktu
link - link do produktu
image_link - link do głównego zdjęcia
price - cena produktu
availability - dostępność (in stock, out of stock, preorder)
brand - marka produktu
condition - stan produktu (new, used, refurbished)
google_product_category - kategoria Google

💡 Wskazówka: Pełną listę dostępnych atrybutów znajdziesz w dokumentacji Google Merchant Center.

3. Instrukcja krok po kroku

Krok 1: Dostęp do funkcji importu

Zaloguj się do aplikacji i przejdź do ekranu głównego
Kliknij na wybrany sklep, do którego chcesz zaimportować produkty
W menu sklepu znajdź i kliknij sekcję "Imports"

Krok 2: Rozpoczęcie procesu importu

W sekcji "Imports" znajdź opcję "Add Data"
Z dostępnych opcji wybierz "Product Feed"
W polu "Import URL" wklej pełny adres URL do Twojego pliku XML

⚠️ Uwaga: URL musi wskazywać bezpośrednio na plik XML i być publicznie dostępny (chyba że używasz autoryzacji - patrz sekcja 5).

Krok 3: Wybór opcji przetwarzania

Sprawdź, czy nazwy kolumn w Twoim pliku są zgodne z formatem Google Merchant Center
- Jeśli TAK - przejdź do kroku 8
- Jeśli NIE - przejdź do sekcji "Konfiguracja schematu" (punkt 4)

4. Konfiguracja schematu (Schema Options)

Kiedy używać schema buildera

Schema builder jest potrzebny, gdy:

Twój plik XML ma niestandardowe nazwy kolumn
Nazwy kolumn nie są zgodne ze standardem Google Merchant Center
Chcesz zmapować własne pola na standardowe atrybuty

Instrukcja konfiguracji schematu

W sekcji "Schema Options" kliknij "Add Schema with Builder"
Dla każdej kolumny w Twoim pliku XML określ:
Nazwa kolumny: Wprowadź dokładną nazwę kolumny z Twojego pliku XML

Typ danych: Wybierz odpowiedni typ danych:
- string - dla tekstu (tytuły, opisy)
- integer - dla licz całkowitych
- float - dla liczb dziesiętnych
- boolean - dla wartości tak/nie
- date - dla dat
Powtórz mapowanie dla wszystkich potrzebnych kolumn

💡 Wskazówka: Nie musisz mapować wszystkich kolumn - tylko te, które chcesz zaimportować.

5. Autoryzacja plików chronionych

Kiedy potrzebna jest autoryzacja

Jeśli Twój plik XML jest chroniony hasłem lub wymaga uwierzytelnienia, skonfiguruj dostęp w sekcji "Security".

Konfiguracja autoryzacji

W sekcji "Security" wprowadź dane uwierzytelniające:
- User Login: Twoja nazwa użytkownika
- Password: Twoje hasło dostępu do pliku

⚠️ Uwaga: Dane logowania są przechowywane bezpiecznie i używane tylko do pobrania pliku.

6. Finalizacja importu

Ostatnie kroki

Sprawdź wszystkie ustawienia:
- URL pliku XML
- Konfigurację schematu (jeśli używana)
- Dane autoryzacji (jeśli potrzebne)
Rozpocznij import:
- Kliknij przycisk "Import File"
- Proces importu zostanie rozpoczęty
Monitorowanie procesu:
- System wyświetli status importu
- Czas przetwarzania zależy od rozmiaru pliku
- Otrzymasz powiadomienie o zakończeniu procesu

7. Rozwiązywanie problemów

Typowe błędy i rozwiązania

Kroki diagnostyczne

Sprawdź URL pliku - otwórz link w przeglądarce
Zweryfikuj format XML - użyj online XML validator
Sprawdź nazwy kolumn - porównaj z wymaganiami Google Merchant Center
Testuj na małej próbce - zacznij od pliku z kilkoma produktami

⚠️ Uwaga: Jeśli problem się powtarza, skontaktuj się z pomocą techniczną, załączając szczegóły błędu.

8. Najczęściej zadawane pytania (Q&A)

Q: Jakie formaty plików są obsługiwane?
A: Obecnie obsługiwany jest tylko format XML zgodny ze standardem Google Merchant Center.

Q: Czy mogę importować produkty z różnych kategorii jednocześnie?
A: Tak, w jednym pliku XML możesz umieścić produkty z różnych kategorii.

Q: Jak długo trwa proces importu?
A: Czas zależy od liczby produktów. Zwykle: do 20 000 produktów - kilka minut, 20 000+ produktów - do 15 minut.

Q: Jakie są limity rozmiaru pliku?
A: Limit rozmiaru pliku nie jest ustalony, ale przy plikach zawierających więcej niż 1,5 miliona produktów należy skontaktować się z działem pomocy Data Octopus.