Powrót do wszystkich poradników

Tester synchronizacji i struktura pliku Google Sheets

Tester synchronizacji sprawdza, czy plik produktowy Google Sheets ma prawidłową strukturę, i pokazuje, jak B2BLIX przetworzyłby niewielki zestaw produktów. Generuje testowy wynik XML bez bezpośredniego publikowania cen na marketplace.

Do czego służy tester synchronizacji

Tester synchronizacji to narzędzie przygotowawcze dla sprzedawców, którzy chcą sprawdzić plik produktowy przed skonfigurowaniem regularnej synchronizacji.

Możesz utworzyć niewielki dokument Google Sheets zawierający rzeczywiste lub reprezentatywne produkty, przesłać jego adres URL i jednokrotnie uruchomić proces obliczania BuyBox. B2BLIX odczyta przesłane dane produktów, wykorzysta dostępne wykryte informacje z marketplace’ów oraz skonfigurowane reguły BuyBox i przygotuje plik XML z obliczonymi wynikami.

Ta strona jest szczególnie przydatna, gdy chcesz:

  • Potwierdzić prawidłowe nazwy kolumn i strukturę pliku.
  • Zrozumieć znaczenie poszczególnych obsługiwanych pól produktu.
  • Przetestować ceny ogólne i ceny właściwe dla konkretnych marketplace’ów.
  • Sprawdzić minimalne i maksymalne limity cenowe.
  • Przetestować reguły wykluczeń lub nietypowe sytuacje dotyczące produktów.
  • Sprawdzić wynik XML przed skonfigurowaniem regularnej synchronizacji.

Tester synchronizacji jest zwykle używany przed dodaniem ostatecznego źródła produktów w Ustawieniach synchronizacji. Po skonfigurowaniu i uruchomieniu regularnej synchronizacji z testera należy korzystać wyłącznie z zachowaniem szczególnej ostrożności.

Ważne: uruchomienie testu nie wysyła bezpośrednio cen do Pigu, 220.lv, Kaup24.ee ani HobbyHall.fi. Test może jednak zaktualizować wygenerowany publiczny plik XML pod tym samym stałym adresem URL. Nie uruchamiaj testu, gdy adres URL tego pliku XML jest połączony z działającym marketplace’em lub innym systemem, ponieważ połączony system może otrzymać tymczasowe dane testowe.

Strona Testera synchronizacji z polem adresu URL Google Sheets, przełącznikiem trybu rabatowego, przyciskiem przykładowego arkusza i tabelą obsługiwanych atrybutów
Interfejs Testera synchronizacji pokazuje, gdzie wprowadzić adres URL Google Sheets, jak włączyć tryb rabatowy, gdzie otworzyć przykładowy dokument oraz które atrybuty produktów są obsługiwane.

Co możesz zrobić na tej stronie

  • Otworzyć przykładowy dokument Google Sheets o oczekiwanej strukturze.
  • Wprowadzić adres URL własnego pliku produktowego Google Sheets.
  • Wybrać sposób prezentowania cen wyjściowych i obliczonych w pliku XML.
  • Sprawdzić akceptowane nazwy pól i alternatywne nazwy kolumn.
  • Uruchomić jednorazowy test synchronizacji.
  • Wygenerować plik XML zawierający przetworzone produkty i obliczone ceny.
  • Sprawdzić wygenerowany wynik w procesie raportowania synchronizacji.

Test wykonuje rzeczywistą procedurę obliczeniową, ale obliczona lub wyeksportowana cena nie staje się automatycznie ceną aktywną na marketplace. Cena staje się aktywna dopiero wtedy, gdy zewnętrzna integracja wykorzysta wygenerowane dane, a marketplace zaakceptuje i zastosuje tę cenę.

Główne pola i elementy sterujące

Pole lub element sterujący Znaczenie Kiedy używać
Adres URL Google Sheets Adres dokumentu Google Sheets zawierającego produkty, które chcesz przetestować. Wklej adres URL po przygotowaniu arkusza z obsługiwanymi nazwami kolumn. Upewnij się, że B2BLIX może uzyskać dostęp do dokumentu za pomocą podanego adresu URL.
Tryb rabatowy Określa sposób przedstawienia przesłanej i obliczonej ceny w pliku XML. Włącz go, gdy plik XML ma zachować przesłaną cenę jako cenę pierwotną i pokazywać obliczoną cenę jako cenę po rabacie.
Otwórz przykład: Google Sheets Otwiera przykładowy arkusz o oczekiwanej strukturze. Użyj go przed utworzeniem własnego dokumentu lub podczas sprawdzania pisowni i kolejności kolumn.
Tabela atrybutów Zawiera główną akceptowaną nazwę pola, obsługiwane alternatywy i krótki opis. Użyj jej podczas nazywania kolumn w dokumencie Google Sheets.
Uruchom test Odczytuje przesłany arkusz, przetwarza jego produkty, stosuje dostępne ustawienia BuyBox i generuje wynik testu. Użyj po sprawdzeniu adresu URL źródła, identyfikatorów produktów, cen, limitów i wartości regionalnych.

Jak przygotować dokument Google Sheets

Użyj jednego wiersza dla każdego produktu. Pierwszy wiersz powinien zawierać nazwy obsługiwanych atrybutów.

Tester akceptuje główne nazwy atrybutów pokazane na stronie oraz, w przypadku niektórych pól, nazwy alternatywne. Używaj dokładnie podanej pisowni. Nie dodawaj spacji ani nie zmieniaj znaków podkreślenia i łączników, chyba że dana alternatywa została wymieniona na liście.

Strona nie oznacza każdej możliwej kolumny jako wymaganej. W praktyce główną wartością używaną do dopasowania produktu jest EAN lub GTIN. Dodaj pozostałe pola potrzebne w sytuacji, którą chcesz przetestować.

Identyfikator produktu powinien odnosić się do produktu znajdującego się w ofertach sprzedawcy na marketplace’ie i wykrytego przez B2BLIX. Nieznany lub nieprawidłowy EAN może uniemożliwić dopasowanie produktu do dostępnych informacji z marketplace’u.

Przyrostki marketplace’ów

Niektóre rodziny pól obsługują zarówno wartość ogólną, jak i wartość dla konkretnego marketplace’u. Marketplace jest określany przez przyrostek na końcu nazwy kolumny.

Przyrostek Marketplace Przykładowe pole
_lv 220.lv na Łotwie price_lv
_lt Pigu.lt na Litwie price_lt
_ee Kaup24.ee w Estonii price_ee
_fi HobbyHall.fi w Finlandii price_fi

Jak działają wartości ogólne i właściwe dla marketplace’u

Pole bez przyrostka marketplace’u pełni funkcję wartości ogólnej dla wszystkich obsługiwanych marketplace’ów. Pole właściwe dla konkretnego marketplace’u zastępuje wartość ogólną wyłącznie dla tego marketplace’u.

Załóżmy na przykład, że wiersz produktu zawiera:

Kolumna Wartość
price 100
price_lv 90

Efektywne przesłane ceny wynoszą:

  • Łotwa: 90, ponieważ price_lv zastępuje wartość ogólną.
  • Litwa: 100 z pola price.
  • Estonia: 100 z pola price.
  • Finlandia: 100 z pola price.

Ta sama zasada dotyczy:

  • Godzin odbioru lub dostawy.
  • Cen przed rabatem.
  • Cen po rabacie.
  • Minimalnych dozwolonych cen.
  • Maksymalnych dozwolonych cen.

Nie musisz powtarzać tej samej wartości we wszystkich czterech kolumnach marketplace’ów. Wprowadź wartość ogólną i dodaj tylko różniące się wyjątki regionalne.

Pola identyfikacji produktu

Atrybut Akceptowana alternatywa Znaczenie i zastosowanie
ean gtin

Główny identyfikator produktu używany do dopasowania przesłanego wiersza do produktu na marketplace.

EAN powinien należeć do produktu dostępnego w ofertach sprzedawcy w Pigu Group i znanego B2BLIX.
sku sku

Identyfikator Stock Keeping Unit nadany przez sprzedawcę.

Może stanowić dodatkowe odwołanie lub wartość weryfikacyjną produktu. Nie zastępuje EAN, gdy wymagane jest dopasowanie produktu na podstawie EAN.

Pole stanu magazynowego

Atrybut Akceptowana alternatywa Znaczenie i zastosowanie
stock stock

Dostępna liczba produktów.

Wprowadź ją jako liczbę całkowitą, na przykład 0, 3 lub 25. Jeśli wybrany proces XML lub API obejmuje informacje o stanie magazynowym, B2BLIX użyje przesłanej ilości w danych wyjściowych.

Wartość 0 oznacza, że obecnie nie ma dostępnych sztuk. Dokładnie sprawdź stany magazynowe podczas testowania danych wyjściowych, które mogą być odczytywane przez inny system.

Pola godzin odbioru i dostawy

Pola te opisują czas dostawy lub odbioru produktu dla obsługiwanych marketplace’ów.

Atrybut Akceptowana alternatywa Dotyczy
collectionhours collection_hours Wartość ogólna dla wszystkich marketplace’ów, chyba że zostanie zastąpiona.
collectionhours_lv collection_hours_lv Tylko Łotwa.
collectionhours_lt collection_hours_lt Tylko Litwa.
collectionhours_ee collection_hours_ee Tylko Estonia.
collectionhours_fi collection_hours_fi Tylko Finlandia.

Użyj pola ogólnego, gdy czas dostawy jest taki sam na każdym rynku. Dodaj pole właściwe dla marketplace’u, gdy w jednym kraju czas dostawy jest inny.

Pola ceny przed rabatem

Pola te zawierają przesłaną cenę produktu przed zastosowaniem rabatów. Wartość ogólna jest używana dla każdego marketplace’u, chyba że podano wartość regionalną.

Atrybut Akceptowane alternatywy Dotyczy
price price_before_discount, price-before-discount Cena ogólna dla wszystkich marketplace’ów, chyba że zostanie zastąpiona.
price_lv price_before_discount_lv, price-before-discount-lv Tylko Łotwa.
price_lt price_before_discount_lt, price-before-discount-lt Tylko Litwa.
price_ee price_before_discount_ee, price-before-discount-ee Tylko Estonia.
price_fi price_before_discount_fi, price-before-discount-fi Tylko Finlandia.

Ta przesłana cena jest danymi wejściowymi. Niekoniecznie jest ostateczną sugerowaną ceną, ponieważ podczas testu B2BLIX może zastosować skonfigurowaną strategię cenową i limity bezpieczeństwa.

Pola ceny po rabacie

Pola te przedstawiają przesłaną cenę produktu po rabacie. Określają również sposób interpretowania informacji o cenie, gdy używany jest tryb rabatowy.

Atrybut Akceptowane alternatywy Dotyczy
price_after_discount price_after_discount, price-after-discount Ogólna cena po rabacie, chyba że zostanie zastąpiona.
price_after_discount_lv price_after_discount_lv, price-after-discount-lv Tylko Łotwa.
price_after_discount_lt price_after_discount_lt, price-after-discount-lt Tylko Litwa.
price_after_discount_ee price_after_discount_ee, price-after-discount-ee Tylko Estonia.
price_after_discount_fi price_after_discount_fi, price-after-discount-fi Tylko Finlandia.

Pola ceny minimalnej

Cena minimalna to najniższa dozwolona cena produktu. Chroni sprzedawcę przed spadkiem obliczonej ceny poniżej wybranego limitu.

Atrybut Znaczenie
min Ogólna cena minimalna dla wszystkich marketplace’ów, chyba że zostanie zastąpiona.
min_lv Minimalna dozwolona cena na Łotwie.
min_lt Minimalna dozwolona cena na Litwie.
min_ee Minimalna dozwolona cena w Estonii.
min_fi Minimalna dozwolona cena w Finlandii.

Bezpieczeństwo cen: sprawdź każdą cenę minimalną przed uruchomieniem testu. Minimalne wartości na poziomie produktu są ważnymi limitami bezpieczeństwa i mogą wpływać na obliczony wynik dla każdego marketplace’u.

Pola ceny maksymalnej

Cena maksymalna to najwyższa dozwolona cena produktu. Ogranicza zakres, w jakim obliczona cena może zostać podwyższona.

Atrybut Znaczenie
max Ogólna cena maksymalna dla wszystkich marketplace’ów, chyba że zostanie zastąpiona.
max_lv Maksymalna dozwolona cena na Łotwie.
max_lt Maksymalna dozwolona cena na Litwie.
max_ee Maksymalna dozwolona cena w Estonii.
max_fi Maksymalna dozwolona cena w Finlandii.

Sprawdź, czy wartości minimalne i maksymalne tworzą sensowny dozwolony zakres. Podczas przygotowywania obliczonych cen tester używa tych limitów wraz ze skonfigurowanymi regułami BuyBox.

Jak tryb rabatowy zmienia dane wyjściowe XML

Tryb rabatowy nie włącza ani nie wyłącza obliczania BuyBox. Zmienia sposób umieszczania pierwotnej przesłanej ceny i ceny obliczonej w polach cenowych XML.

Tryb rabatowy Cena przed rabatem Cena po rabacie
Włączony Pierwotna cena przesłana w pliku źródłowym. Cena obliczona przez B2BLIX.
Wyłączony Cena obliczona przez B2BLIX. Cena obliczona przez B2BLIX.

Włącz tryb rabatowy, gdy system odbierający powinien widzieć zarówno cenę pierwotną, jak i niższą lub w inny sposób zmienioną cenę obliczoną. Pozostaw go wyłączonym, gdy oba pola cenowe XML powinny zawierać wartość obliczoną.

Co dzieje się po kliknięciu przycisku uruchomienia testu

Tester wykonuje jednorazową procedurę synchronizacji:

  1. B2BLIX otwiera przesłany dokument Google Sheets.
  2. Odczytywane są wiersze produktów i obsługiwane pola.
  3. Produkty są dopasowywane za pomocą dostępnych identyfikatorów, przede wszystkim EAN lub GTIN.
  4. Do obliczeń wykorzystywane są dostępne, wykryte informacje z marketplace’ów.
  5. W stosownych przypadkach stosowane są skonfigurowane reguły BuyBox, wykluczenia i limity cenowe.
  6. Generowany jest wynik XML z przetworzonymi danymi produktów i obliczonymi cenami.
  7. Wynik można sprawdzić w procesie raportowania synchronizacji.

To marketplace decyduje, który sprzedawca otrzyma BuyBox. Wynik testu pokazuje obliczenia B2BLIX; nie gwarantuje pozycji w BuyBox, kolejności, przychodu ani zysku.

Jak interpretować wygenerowany plik XML

Plik XML grupuje przesłane wiersze jako osobne produkty. Każdy produkt może zawierać identyfikator, SKU, stan magazynowy oraz osobne pola cenowe dla Łotwy, Litwy, Estonii i Finlandii.

Wynik może na przykład zawierać osobne elementy dla:

  • GTIN produktu.
  • SKU sprzedawcy.
  • Przesłanej ilości produktu w magazynie.
  • Ceny przed rabatem dla każdego marketplace’u.
  • Obliczonej ceny po rabacie dla każdego marketplace’u.
Przykładowy wygenerowany XML z trzema produktami, GTIN, SKU, stanem magazynowym oraz cenami przed rabatem i po rabacie właściwymi dla marketplace’u
Ten przykład pokazuje strukturę wygenerowanego wyniku XML. Każdy produkt ma własny identyfikator oraz osobne pola cenowe dla Łotwy, Litwy, Estonii i Finlandii.

XML jest dokumentem wyjściowym. Należy go sprawdzić przed połączeniem jego publicznego adresu URL z marketplace’em lub innym systemem produkcyjnym.

Zalecany bezpieczny proces

  1. Otwórz przykładowy dokument Google Sheets.
  2. Utwórz osobny arkusz testowy zamiast używać pełnego źródła produkcyjnego.
  3. Dodaj niewielką liczbę produktów ze znanymi numerami EAN.
  4. Potwierdź, że produkty już znajdują się w ofertach na marketplace’ach i zostały wykryte przez B2BLIX.
  5. Dodaj bieżącą cenę, stan magazynowy oraz wymagane informacje o dostawie.
  6. Dodaj dokładnie sprawdzone ceny minimalne i maksymalne.
  7. Użyj wartości ogólnych dla wszystkich rynków i dodaj kolumny regionalne tylko dla wyjątków.
  8. Wybierz odpowiedni tryb rabatowy.
  9. Upewnij się, że publiczny testowy adres URL XML nie jest połączony z działającym miejscem docelowym.
  10. Uruchom test i sprawdź wygenerowany XML.
  11. Porównaj wynik z wartościami źródłowymi i skonfigurowanymi regułami BuyBox.
  12. Po pomyślnym zakończeniu testów skonfiguruj rzeczywiste źródło i dane wyjściowe w Ustawieniach synchronizacji.

Najczęstsze błędy

  • Uruchamianie testera, gdy wygenerowany XML jest używany przez działającą integrację. Tymczasowe produkty i ceny testowe mogą zastąpić treść odczytywaną przez tę integrację.
  • Używanie numeru EAN, który nie znajduje się w ofercie lub nie został wykryty. B2BLIX może nie być w stanie połączyć wiersza z oczekiwanymi informacjami o produkcie na marketplace.
  • Zmiana pisowni nazwy kolumny. Użyj dokładnie głównej nazwy atrybutu lub jednej z wymienionych alternatyw.
  • Oczekiwanie, że wartość ogólna zastąpi wartość regionalną. Pole takie jak price_lv ma priorytet przed price na Łotwie.
  • Wprowadzanie stanu magazynowego jako tekstu lub wartości dziesiętnej. Stan magazynowy powinien być podany jako liczba całkowita.
  • Używanie niesprawdzonych cen minimalnych i maksymalnych. Nieprawidłowe limity mogą prowadzić do wyników, które nie odpowiadają zamierzonemu zakresowi cen sprzedawcy.
  • Niewłaściwe rozumienie trybu rabatowego. Zmienia on sposób przedstawiania cen pierwotnych i obliczonych w XML; samodzielnie nie publikuje rabatu.
  • Założenie, że wygenerowany XML jest już aktywny. Dane wyjściowe nie są publikowane na marketplace, chyba że inny skonfigurowany system je odczyta i zastosuje.
  • Natychmiastowe testowanie pełnego katalogu. Zacznij od kilku reprezentatywnych produktów, aby łatwiej zweryfikować dane źródłowe i obliczone wyniki.

Przykładowe zastosowanie

Sprzedawca chce przetestować jeden produkt oferowany na wszystkich czterech marketplace’ach. Standardowa przesłana cena wynosi 100, ale cena na Łotwie powinna wynosić 90. Dozwolony zakres cen to od 80 do 120.

Kolumna Przykładowa wartość Cel
ean 123456789 Dopasowuje wiersz do produktu znanego B2BLIX.
sku TEST-001 Zawiera wewnętrzne oznaczenie produktu sprzedawcy.
stock 5 Ustawia dostępną ilość w danych wyjściowych testu.
price 100 Ustawia ogólną przesłaną cenę.
price_lv 90 Zastępuje cenę ogólną na Łotwie.
min 80 Ustawia ogólną minimalną dozwoloną cenę.
max 120 Ustawia ogólną maksymalną dozwoloną cenę.

Podczas testu Łotwa rozpoczyna od przesłanej wartości regionalnej 90. Litwa, Estonia i Finlandia korzystają z wartości ogólnej 100. Następnie B2BLIX ocenia produkt na podstawie skonfigurowanych reguł BuyBox i utrzymuje każdy obliczony wynik w dostępnych granicach minimalnej i maksymalnej ceny.

Sprzedawca może sprawdzić wynikowy XML, potwierdzić prawidłowe zastosowanie zmiany ceny dla Łotwy oraz zweryfikować, czy sugerowane ceny pozostają w zamierzonym zakresie, zanim przeniesie źródło produktów do regularnej synchronizacji.