Obsługiwane formaty plików

Obecnie obsługujemy pliki danych przesyłane zarówno w formacie XML, jak i pliku rozdzielanego znakami tabulacji. Poniżej znajdziesz instrukcje, jak utworzyć plik w każdym z tych formatów.

Instrukcje dotyczące pliku rozdzielanego znakami tabulacji

Plik, w którym wartości są rozdzielane znakami tabulacji, czyli plik TSV, to jeden z dwóch obsługiwanych formatów w Manufacturer Center. Większość takich plików jest tworzona w arkuszach kalkulacyjnych. W pierwszym wierszu (nagłówku) podaj nazwy atrybutów rozdzielone znakami tabulacji. Zaczynając od drugiego wiersza, do każdej nazwy przypisz odpowiadające jej wartości. Do utworzenia tego pliku i zapisania go jako pliku rozdzielanego znakami tabulacji zalecamy użycie programu do obsługi arkuszy kalkulacyjnych, takiego jak Arkusze Google lub LibreOffice.

Tworzenie pliku danych

Krok 1. Otwórz program do obsługi arkuszy kalkulacyjnych

Użyj programu do obsługi arkuszy kalkulacyjnych, takiego jak Arkusze Google. Dzięki temu możesz łatwo utworzyć plik danych i przekonwertować go na odpowiedni format.

Krok 2. Utwórz wiersz nagłówka

W pierwszym wierszu arkusza kalkulacyjnego wpisz nazwy atrybutów opisujących Twoje produkty – każdy w osobnej kolumnie. Pamiętaj, żeby umieścić wszystkie atrybuty wymagane oraz istotne atrybuty zalecane.

Przykład z wykorzystaniem kilku atrybutów w wierszu nagłówka wyglądałby następująco:

	A	B	C	D	E	F
1	identyfikator [id]	marka [brand]	tytuł [title]	GTIN [gtin]	opis [description]	link do zdjęcia [image_link]

 

Krok 3. Wpisz informacje o swoich produktach

W wierszach pod nagłówkiem wpisz informacje o produktach, zgodnie z wybranymi atrybutami. Każdy produkt powinien być wymieniony w osobnym wierszu, a informacje o nim podzielone na kolumny, np. opis przedmiotu powinien znajdować się w kolumnie z nagłówkiem „opis”.

	A	B	C	D	E	F
1	identyfikator [id]	marka [brand]	tytuł [title]	GTIN [gtin]	opis [description]	link do zdjęcia [image_link]
2	123-zlmis	Acme Toys	Acme Toys – żółty miś	001234567890	przykładowy opis	link.com/pic
3	456-czrwmis	Acme Toys	Acme Toys – czerwony miś	001234598760	przykładowy opis	link.com/pic

 

Krok 4. Przekonwertuj swój arkusz

Większość arkuszy kalkulacyjnych umożliwia eksportowanie danych do pliku rozdzielanego znakami tabulacji. Każda z przedstawionych poniżej opcji pozwala utworzyć plik z rozszerzeniem .tsv. Taki plik prześlij na konto Manufacturer Center.

Jeśli korzystasz z Arkuszy Google:

• W menu Plik wybierz opcję Pobierz jako, a potem .Wartości rozdzielane tabulatorami (.tsv, bieżący arkusz). Twój plik tekstowy rozdzielany znakami tabulacji zostanie otwarty w nowym oknie.
• Nazwij plik i, jeśli wyświetli się prośba o wskazanie typu pliku, wybierz .tsv. Kliknij Zapisz.

Jeśli korzystasz z LibreOffice:

• Wybierz Plik > Zapisz jako....
• Wybierz format Tekst CSV (.csv). Mimo że w nazwie jest CSV, opcja ta generuje wszystkie rodzaje plików tekstowych.
• Zaznacz Edytuj ustawienia filtra. Kliknij Zapisz. Jeśli pojawi się ostrzeżenie, kontynuuj, wybierając format Tekst CSV.
• W wyskakującym oknie, które się pojawi, w sekcji Zestaw znaków zostaw Unicode (UTF-8); w opcji Ogranicznik pola zmień wartość na {Tab}; usuń wartość w opcji Separator tekstu; zostaw pozostałe pola tak, jak są, i kliknij OK.

Jeśli masz już zarejestrowany plik danych na swoim koncie Manufacturer Center, użyj tej samej nazwy pliku, która została podana podczas konfiguracji.

Krok 5. Prześlij plik w postaci pliku danych

Sprawdź, czy plik spełnia nasze wymagania dotyczące formatowania, i prześlij go do nas.

Wymagania dotyczące formatowania

• Wartości w pliku muszą być rozdzielone znakami tabulacji.
• Pierwszy wiersz pliku stanowi nagłówek – musi on zawierać nazwy atrybutów rozdzielone znakami tabulacji.
• Jeden produkt w linii, każdy atrybut rozdzielony znakiem tabulacji.
• Bez dodatkowych znaków tabulacji na końcu.
• Bez dodatkowych znaków tabulacji i podziałów wierszy w atrybutach.

Formatowanie powtórzonych atrybutów

Poniżej znajduje się lista powtórzonych atrybutów:

• GTIN [gtin]
• Typ produktu [product_type]
• Link do dodatkowego zdjęcia [additional_image_link]
• Link do filmu [video_link]

 

Powtórzony atrybut to taki, który przyjmuje więcej niż jedną wartość.

• Wartości powtórzonego atrybutu muszą być rozdzielone przecinkami.
  • GTIN [gtin]
    001234567898, 001234567876
• Jeżeli wartości powtórzonego atrybutu zawierają przecinek, należy ująć je w cudzysłów amerykański.
  • Typ produktu [product_type]
    „Dom i ogród > Kuchnia i jadalnia > Sprzęt AGD > Lodówki”, Sprzęt AGD > Kuchnia > Lodówki
• Jeżeli cytowana wartość już zawiera cudzysłów amerykański, należy go powtórzyć.
  • Tablet "Sharp 7"" (323 ppi)", "Długa żywotność baterii, nawet 9–10 godzin aktywnego użytkowania", czterordzeniowy procesor i 2GB RAM, wbudowany system Android 4.3

 

Poniżej znajdują się powtórzone atrybuty grupowe:

• Szczegóły produktu [product_detail]
• Opis cech [feature_description]

Atrybut grupowy to taki, który ma atrybuty podrzędne.

• Atrybut product detail ma 3 atrybuty podrzędne:
  • Nazwa sekcji [section_name]
  • Nazwa atrybutu [attribute_name]
  • Wartość atrybutu [attribute_value]
• Atrybut feature description także ma 3 atrybuty podrzędne:
  • Nagłówek [headline]
  • Tekst [text]
  • Link do zdjęcia [image_link]

Atrybut grupowy podaje się poprzez wpisanie wartości wszystkich jego atrybutów podrzędnych rozdzielonych dwukropkiem.

• product detail
  Ekran:Rozdzielczość:1920 x 1200
• Podobnie jak w przypadku standardowych atrybutów powtórzonych, wiele atrybutów grupowych podaje się, rozdzielając je przecinkami.
  • product detail
    Ekran:Rozdzielczość:1920 x 1200,Ekran:Waga:8 kg
• Podobnie jak w przypadku atrybutów powtórzonych, wartości zawierające przecinek lub dwukropek należy wziąć w cudzysłów amerykański. Cudzysłów amerykański znajdujący się w wartości także musi być powtórzony.
  • Opis cech [feature_description]
    Ulepszone powiększenie w nowej wersji:Dzięki ulepszonemu powiększeniu najnowszej generacji zobaczysz jeszcze więcej otaczającego Cię świata.:"http://example.com/zdjecie1.png",Wyższa rozdzielczość:"Produkt jest teraz wyposażony w 15-calowy wyświetlacz o 10-krotnie większej ostrości od poprzedników. Dodatkową zaletą jest 3,5-krotny zoom.":"http://example.com/zdjecie2.jpg"

Przykład: szablon pliku Manufacturer Center – TSV.tsv.

Instrukcje dla pliku XML

XML (Extensible Markup Language) to elastyczny sposób kodowania uporządkowanych danych w formacie do odczytu zarówno przez człowieka, jak i maszynę. Zalecamy korzystanie z plików XML, jeśli stosujesz system zarządzania informacjami o produktach (PIM), który ma rozbudowane opcje eksportowania.

Google obsługuje rozszerzoną wersję standardu RSS 2.0 z atrybutami standardowymi połączonymi z odpowiednimi sekcjami w oficjalnej specyfikacji RSS 2.0, aby pomóc Ci uzyskiwać dodatkowe informacje na temat komponentów zawartych w naszych przykładach. Chociaż udostępniamy przykładowe pliki RSS 2.0, informacje o RSS 2.0 ograniczyliśmy do minimum. Więcej informacji o tym standardzie znajdziesz na stronie http://blogs.law.harvard.edu/tech/rss.

Sekcja 1. RSS 2.0

W oparciu o specyfikację RSS 2.0, na poziomie produktu występują trzy z góry określone elementy: tytuł, link oraz opis. Chociaż są one opcjonalne w standardzie RSS 2.0, pliki danych produktów ich wymagają.

Pliki danych produktów wymagają też dodatkowych elementów, takich jak identyfikator [id], marka [brand] czy GTIN [gtin]. Aby można było uwzględnić te elementy oraz inne szczegółowe informacje o produkcie, rozszerzyliśmy RSS 2.0 o przestrzeń nazw pliku danych Google Manufacturer Center. Jej zdefiniowanie umożliwia dodanie elementów, zwanych „atrybutami”, a także zwiększa ilość informacji, jakie można dodać o każdym z produktów w pliku danych.

Poniżej znajduje się przykład podstawowego dokumentu RSS 2.0 zawierającego jeden produkt:

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">
  <channel>
    <title>Acme Inc</title>
    <link>http://www.amce.com</link>
    <description>Przykładowy plik danych dla linii produktów Acme Inc</strong> description>
    <item>
      <g:id>actb7-16-B</g:id>
      <g:brand>Acme</g:brand>
      <g:title>Tablet Acme – WiFi – 16 GB – czarny</g:title>
      <g:gtin>001234567895</g:gtin>
      <g:gtin>1001234567894</g:gtin>
      <g:mpn>ACMETAB16</g:mpn>
      <g:disclosure_date>2013-01-15</g:disclosure_date>
      <g:release_date>2013-03-04</g:release_date>
      <g:suggested_retail_price>129.00 PLN</g:suggested_retail_price>
      <g:product_name>AcTab 7</g:product_name>
      <g:product_line>AcTab</g:product_line>
      <g:product_type>Urządzenia &gt; Tablety</g:product_type>
      <g:product_type>Komputery &gt; Tablety</g:product_type>
      <g:item_group_id>AcTab-7-2013</g:item_group_id>
      <g:color>Czarny</g:color>
      <g:product_detail> 
        <g:section_name>Ogólne</g:section_name>
        <g:attribute_name>Typ produktu</g:attribute_name>
        <g:attribute_value>Odtwarzacz cyfrowy</g:attribute_value>
      </g:product_detail>
      <g:product_detail>
        <g:section_name>Ogólne</g:section_name>
        <g:attribute_name>Typ cyfrowego odtwarzacza</g:attribute_name>
        < g:attribute_value>Z pamięcią flash</g:attribute_value>
      </g:product_detail>
      <g:product_detail>
        <g:section_name>Wyświetlacz</g:section_name>
        <g:attribute_name>Rozdzielczość</g:attribute_name>
        <g:attribute_value>432 x 240</g:attribute_value>
      </g:product_detail>
      <g:product_detail>
        <g:section_name >Wyświetlacz</g:section_name>
        <g:attribute_name>Przekątna</g:attribute_name>
        <g:attribute_value>2,5"</g:attribute_value>
      </g:product_detail>
      <g:description>Teraz cieńszy, lżejszy i szybszy – AcTab to idealne połączenie wydajności i mobilności. Wyposażony w wyraźny 7-calowy ekran.</g:description>
      <g:feature_description>
        <g:headline>Wyjątkowo wyraźny ekran 7".</g:header>
        <g:text>Ten 7-calowy tablet o wysokiej rozdzielczości to ponad 2,3 miliona pikseli w Twojej dłoni.</g:text>
        <g:image_link>http://www.acme.com/actab7/screen</g:image_link>
      </g:feature_description>
      <g:feature_description>
        <g:headline>Dźwięk, który Cię otacza.</g:headline>
        <g:text>Tablet AcTab7 wyposażony jest w głośniki przestrzenne, co zapewnia bogate wrażenia dźwiękowe. Teraz usłyszysz wszystko dzięki dopracowanej technologii zwiększania głośności, która sprawia, że każdy dialog staje się niezwykle wyraźny.</g:text>
        <g:image_link>http://www.acme.com/actab7/sound</g:image_link>
      </g:feature_description>
      <g:feature_description>
        <g:headline>Niebywała lekkość i dłuższa praca.</g:headline>
        <g:text>AcTab waży zaledwie 300 g – jest więc wystarczająco lekki, by zabrać go ze sobą w dowolne miejsce. Z łatwością mieści się w torbie, plecaku, a nawet tylnej kieszeni spodni. 9 godzin odtwarzania filmów w jakości HD i 10 godzin przeglądania stron internetowych lub czytania e-booków zapewni rozrywkę na cały dzień, a wbudowana funkcja ładowania bezprzewodowego oznacza, że możesz szybko naładować urządzenie i ruszać w drogę.</g:text>
        <g:image_link>http://www.acme.com/actab7/battery</g:image_link>
      </g:feature_description>
      <g:image_link>https://acme.com/actab7.png</g:image_link>
      <g:additional_image_link>https://acme.com/actab7.png</g:additional_image_link>
      <g:additional_image_link>https://acme.com/actab7-front.png</g:additional_image_link>
      <g:additional_image_link>https://acme.com/actab7-back.png</g:additional_image_link>
      <g:video_link>https://www.youtube.com/watch?v=abc</g:video_link>
      <g:product_page_url>http://www.acme.com/actab</g:product_page_url>
    </item>
  </channel>
</rss>

Dwie główne zmiany w tym przykładzie to dodatkowa deklaracja przestrzeni nazw [xmlns:g="http://base.google.com/ns/1.0"] i uwzględnienie atrybutów Manufacturer Center, np. GTIN [gtin], MPN [mpn], sugerowana cena detaliczna [suggested_retail_price] i data premiery [release_date].

Deklaracja przestrzeni nazw Manufacturer Center

Poniższa deklaracja przestrzeni nazw jest wymagana, aby możliwe było korzystanie z atrybutów zdefiniowanych w przestrzeni nazw Manufacturer Center: [xmlns:g="http://base.google.com/ns/1.0"]

Oprócz deklaracji przestrzeni nazw Manufacturer Center konieczne jest również dodanie prefiksu do każdego tagu atrybutu. Ma to na celu odróżnienie atrybutów zdefiniowanych w naszej przestrzeni nazw od elementów zdefiniowanych w RSS 2.0. Prefiks wybrany do tej deklaracji przestrzeni nazw to „g”:<g:image_link>http://www.google.com/images/google_sm.gif</g:image_link>

Atrybuty w przestrzeni nazw Manufacturer Center muszą zawierać ten prefiks – w przeciwnym razie zostaną zignorowane wraz z przypisanymi do nich wartościami.

Atrybuty

Możesz zastosować dowolną liczbę atrybutów. Podanie dodatkowych informacji o Twoich produktach za ich pomocą znacznie zwiększy szansę na to, że produkty pojawią się w wynikach wyszukiwania reklam produktowych. Poza tym wiele atrybutów zdefiniowanych w przestrzeni nazw Manufacturer Center można w ramach jednego produktu wykorzystać więcej niż raz. Dzięki temu możesz dodać więcej istotnych informacji o produktach w pliku danych.

Sekcja 2. Ważna lista kontrolna

Przed przesłaniem pliku zalecamy sprawdzenie tej listy, aby sprawdzić, czy plik jest prawidłowo sformatowany:

1. Nazwa pliku danych zarejestrowana na koncie Manufacturer Center musi odpowiadać rzeczywistej nazwie pliku.
2. Dodaj taką deklarację przestrzeni nazw: [xmlns:g="http://base.google.com/ns/1.0"]
3. Sprawdź, czy prefiks w tagach atrybutów w Manufacturer Center zgadza się z prefiksem określonym w deklaracji przestrzeni nazw.
4. Usuń atrybuty niezawierające żadnych wartości.

Sekcja 3. Uwagi końcowe

Przykładowy wpis w dokumencie został uproszczony, by lepiej zobrazować podstawy tworzenia pliku danych o produktach w formacie XML. Akceptujemy pliki zawierające inne elementy zdefiniowane w standardzie RSS 2.0 lub w Twojej własnej przestrzeni nazw, jednak wszelkie informacje w nich zawarte będą ignorowane podczas przetwarzania i nie pojawią się w reklamach. Na tym etapie przetwarzane będą jedynie dane zawarte w domyślnych elementach RSS 2.0 oraz w atrybutach w przestrzeni nazw Manufacturer Center.

Przykład: szablon pliku Manufacturer Center – XML.xml.

Podczas tworzenia pliku danych pamiętaj, by zapisać go w jednym z obsługiwanych formatów z odpowiednim rozszerzeniem:

• .tsv: wartości rozdzielane znakami tabulacji
• .xml: XML
• .gz: GNU zip, skompresowany tekst lub XML
• .zip: zip, skompresowany tekst lub XML
• .bz2: Bzip2, skompresowany tekst lub XML