Jako sprzedawca możesz przesyłać swoje produkty na Pinteresta jako Piny produktowe. Piny produktowe są specjalnie sformatowane tak, aby osoby przeglądające Pinteresta wiedziały, że dane produkty można kupić. Zawierają one tytuł i opis produktu, a także informacje o cenie i dostępności.
Dodaj źródło danych katalogu sprzedaży detalicznej do Pinteresta, aby jednocześnie przesłać wiele produktów jako Piny produktowe. Następnie możesz promować je na Pintereście jako reklamy produktowe. Możesz podać link URL do hostowanego źródła danych lub przesłać źródło danych ręcznie.
Oto co musisz zrobić, zanim dodasz katalog sprzedaży detalicznej:
Jeśli nie spełniasz powyższych wymagań,
Katalogi sprzedaży detalicznej działają w zależności od sposobu dodania źródła danych, z którego możemy uzyskać dostęp do katalogu.
Jeśli podasz link URL do hostowanego źródła danych, będziemy codziennie uzyskiwać dostęp do Twojego źródła danych, co pozwoli nam dynamicznie tworzyć Piny produktowe dla każdego produktu w Twoim katalogu sprzedaży detalicznej. Zadbaj o to, aby zaktualizowane źródło danych było dostępne codziennie, dzięki czemu szczegóły produktu będą aktualne. Możesz nawet zaplanować zestawienie danych z wyprzedzeniem.
Jeśli przesyłasz źródło danych ręcznie, uzyskamy dostęp do Twojego źródła danych po jego przesłaniu i za każdym razem, gdy prześlesz zaktualizowane źródło, co pozwoli nam tworzyć Piny produktowe lub aktualizować metadane istniejących Pinów dla każdego produktu w katalogu sprzedaży detalicznej.
Powiadomimy Cię o błędach. Zapoznaj się z nimi i napraw je jak najszybciej, aby zadbać o prawidłowość i aktualność informacji o produktach. Jeden błąd może oznaczać, że nie zaktualizuje się cały wykaz, inny — że nie zaktualizują się tylko niektóre pozycje albo że należy dokonać pewnych zmian w formatowaniu.
Możemy przetworzyć do 20 milionów produktów na jeden katalog sprzedaży detalicznej. Jeśli masz ponad 20 milionów produktów,
Jest to ważne tylko wtedy, gdy prowadzisz hosting źródła danych. Jeśli przesyłasz źródło danych ręcznie, możesz pominąć tę sekcję.
Konieczne jest zapewnienie hostingu źródła danych na serwerze FTP/SFTP/WebDAV lub udostępnienie linku do pobierania bezpośrednio ze strony HTTP/HTTPS. Link musi być dostępny dla agenta użytkownika i nie może być przy tym wymagane dodanie adresu IP ani klucza SSH do białej listy. Jeśli korzystasz z linku umożliwiającego bezpośrednie pobranie pliku, uzyskanie dostępu nie może wiązać się z dodatkowymi działaniami nawigacyjnymi po naszej stronie.
Obsługujemy następujące formaty:
Rozdzielone tabulatorami (TSV) | (Pobierz przykładowy plik TSV) |
Rozdzielone przecinkami (CSV) | (Pobierz przykładowy plik CSV) |
XML (RSS 2.0, ATOM 1.0) | (Pobierz przykładowy plik XML) |
Uwaga: akceptujemy pliki skompresowane (.zip, .giz, .gz, .bz2 i inne), ale obecnie nie obsługujemy zaszyfrowanych, skompresowanych plików chronionych hasłem ani plików w usługach Dysk Google ani Dropbox.
Katalog sprzedaży detalicznej musi zawierać następujące pola sformatowane dokładnie tak, jak je widzisz. Ich brak bądź nieprawidłowy format spowoduje błąd zestawiania całego katalogu.
Nazwa kolumny | Opis | Składnia / prawidłowe wartości | Przykład |
---|---|---|---|
id |
Unikatowy identyfikator reprezentujący produkt. |
Maksymalnie 127 znaków. | DS0294-L |
title | Nazwa produktu (musi być taka sama jak nazwa produktu ze strony docelowej, w tym uwzględniać szczegóły wariantu takie jak kolor i rozmiar). | Maksymalnie 500 znaków. | Damska koszula jeansowa, rozmiar L |
description | Opis produktu. | Maksymalnie 10 000 znaków jako zwykły tekst (nie kod HTML). | Dżinsowa koszula o swobodnym kroju wykonana z najwyższej jakości japońskiego dżinsu. |
link | Strona docelowa produktu (musi prowadzić bezpośrednio do tego samego produktu i prezentować te same dane). |
Adres URL. Maksymalnie 511 znaków, adres URL musi rozpoczynać się od http:// (strona docelowa nie powinna wymagać rejestracji). |
https://www.przykład.pl/cat/kobiety-ubrania/koszula-jeansowa-0294 |
image_link |
Link do głównego obrazu produktu (o rozdzielczości co najmniej 75x75 pikseli, dostępny dla naszego agenta użytkownika, bez szablonu ani obrazów zastępczych). Jeśli zechcesz później zmienić obraz, pamiętaj, że musi on mieć inny link — w przeciwnym razie nie zostanie zaktualizowany. |
Adres URL. Maksymalnie 2000 znaków, rozpoczynając od http:// lub https:// (zakoduj lub usuń przecinki). Zalecane: ujęcie ciągu w cudzysłów. |
https://scene.example.com/image/image.jpg |
price |
Cena produktu (powinna odzwierciedlać rzeczywisty koszt produktu i uwzględniać walutę w formacie ISO-4217, jeśli nie są to dolary amerykańskie, w przeciwnym razie domyślnie będą to dolary amerykańskie). |
<numeryczna> <ISO 4217> Waluta może pojawić się przed wartością numeryczną ceny lub po niej — ze spacją lub bez spacji i musi być zgodna ze standardowym kodem ISO-4217. Nie używaj wartości 0 ani symboli walut. |
24.99 USD 24.99USD 24,99 USD 24,99USD 24.99 24,99 GBP24.99 24,99 GBP 24,99 GBP 24,99 GBP |
availability | Dostępność produktu. |
Powinna stanowić jedną z poniższych wartości: in stock |
in stock |
item_group_id (wymagane tylko wtedy, gdy produkty mają wiele wariantów) | Identyfikator nadrzędny produktu. | Maksymalnie 127 znaków. | DS0294 |
Do katalogu sprzedaży detalicznej możesz dodać pola opcjonalne, aby ułatwić nam mapowanie Twoich produktów dla użytkowników. Im więcej podasz informacji, tym lepiej Twoje Piny będą dopasowane do użytkowników, którzy je widzą. Poniżej możesz dowiedzieć się więcej na temat pól opcjonalnych.
Nazwa kolumny | Opis | Składnia / prawidłowe wartości | Przykład |
---|---|---|---|
product_type | Kategoria produktu na podstawie niestandardowej taksonomii produktów. |
Maksymalnie pięć podkategorii zawierających maksymalnie 1000 znaków, które muszą być oddzielone znakiem > otoczonym spacjami. (Inne separatory np. przecinek czy kreska pionowa nie są rozpoznawane). |
Odzież > Damska > Koszule > Jeans |
additional_image_link |
Linki do maksymalnie 10 dodatkowych obrazów produktu (o rozdzielczości co najmniej 75x75 pikseli, dostępne dla naszego agenta użytkownika, bez szablonów ani obrazów zastępczych). Utworzymy nowego Pina dla każdego przesłanego linku do każdego przesłanego obrazu dodatkowego. Jeśli zechcesz później zmienić obraz, pamiętaj, że musi on mieć inny link — w przeciwnym razie nie zostanie zaktualizowany. |
Każdy maksymalnie 2000 znaków, rozpoczynając od http:// lub https:// (zakoduj lub usuń przecinki). Zalecane: ujęcie ciągu w cudzysłów. |
„https://scene.example.com/image/image_v2.jpg, https://scene.example.com/image/image_v3.jpg” |
mobile_link | Wersja strony docelowej zoptymalizowana pod kątem urządzeń mobilnych. | Musi rozpoczynać się od http:// lub https://. | https://m.przykład.pl/cat/kobiety-ubrania/koszula-jeansowa-0294 |
sale_price |
Obniżona cena produktu (powinna być niższa niż cena i uwzględniać walutę w formacie ISO-4217, jeśli nie są to dolary amerykańskie, w przeciwnym razie domyślnie będą to dolary amerykańskie). W przypadku podania ceny promocyjnej zostanie ona użyta jako aktualna cena produktu. |
<numeryczna> <ISO 4217> Waluta może pojawić się przed wartością numeryczną ceny lub po niej — ze spacją lub bez spacji i musi być zgodna ze standardowym kodem ISO-4217. Nie używaj wartości 0 ani symboli walut. |
14.99 USD 14.99USD 14,99 USD 14,99USD 14.99 14,99 GBP 14.99 GBP14.99 GBP 14,99 GBP14,99 |
average_review_rating | Średnia liczba opinii na temat produktu. |
<numeryczna> Od 1 do 5 |
5 |
number_of_ratings | Liczba ocen produktu. | <numeryczna> | 2 |
number_of_reviews | Liczba opinii na temat produktu. | <numeryczna> | 4 |
description_html |
Opis HTML produktu. Zalecane: korzystanie z tej opcji, jeżeli opis przekracza 200 znaków. Jeśli to pole zostanie wypełnione, wykorzystamy je zamiast wymaganego pola opisu. |
Formatowanie HTML | <body> <h1>Mój produkt</h1> <p>Kup teraz</p> </body> |
video_link |
Hostowany link do filmu o produkcie. Filmy w linkach muszą mieć format .mp4, .mov lub .m4v. Rozmiar pliku nie może przekraczać 2 GB. |
Adres URL. Maksymalnie 2000 znaków — począwszy od http:// lub https:// |
https://www.example.com/example.mp4 |
Nazwa kolumny | Opis | Składnia / prawidłowe wartości | Przykład |
---|---|---|---|
item_group_id | Identyfikator nadrzędny produktu. | Maksymalnie 127 znaków. | DS0294 |
brand |
Marka produktu | Maksymalnie 100 znaków. | Josie’s Denim |
gtin | Unikatowy uniwersalny identyfikator produktu. | Wartość numeryczna zgodna z wytycznymi GTIN | 3234567890126 |
mpn | Numer części producenta produktu. |
Maksymalnie 70 znaków alfanumerycznych. |
„mpn”: „PI12345NTEREST” |
Nazwa kolumny | Opis | Składnia / prawidłowe wartości | Przykład |
---|---|---|---|
color |
Główny kolor produktu. | Maksymalnie 30 znaków. | blue |
gender | Płeć przypisana do produktu. | Powinna być jedną z następujących wartości: „male” (dla mężczyzn) „female” (dla kobiet) „unisex” (dla obu płci). |
MALE |
age_group | Wiek przypisany do produktu. |
Powinna stanowić jedną z poniższych wartości: newborn |
newborn |
material | Materiał użyty do wytworzenia produktu. | Maksymalnie 30 znaków. | cotton |
pattern | Wzór używany dla produktu. | Maksymalnie 30 znaków. | plaid |
size | Rozmiar produktu. | Maksymalnie 30 znaków. | M |
size_type | Dodatkowy opis rozmiaru produktu. |
Powinna stanowić jedną z poniższych wartości: regular |
regular |
size_system | Rozmiarówka kraju, w którym przesyłasz produkt. | Kod kraju. |
USA |
alt_text | Opis tego, co pojawia się na głównych obrazach produktu. | Jedna wartość tekstu alternatywnego lub więcej wartości oddzielonych przecinkami. Liczba wartości tekstu alternatywnego powinna odpowiadać liczbie obrazów w polu image_link. Przecinki należy zakodować jako , albo usunąć, jeśli są częścią tekstu alternatywnego. Przecinków należy używać do oddzielania od siebie poszczególnych tekstów alternatywnych. | Błękitna czapeczka niemowlęca na szydełku z frędzelkami |
variant_names | Opcje dla tego wariantu produktu (użytkownicy Pinteresta zobaczą te opcje obok Twojego Pina i będą mogli wybrać dowolną z nich). | Teksty oddzielone przecinkami podane w kolejności, w której mają być wyświetlane. | Kolor, rozmiar |
variant_values | Opcje wartości dla tego wariantu produktu (użytkownicy Pinteresta zobaczą te opcje obok Twojego Pina i będą mogli wybrać dowolną z nich). |
Teksty oddzielone przecinkami podane w kolejności, w której mają być wyświetlane. Powinny być zgodne z kolejnością pola variant_names. |
Czerwony, mały |
adult | Niezależnie od tego, czy produkt jest przeznaczony dla dorosłych. Produkty dla dorosłych nie będą wyświetlane na Pintereście. |
Powinna stanowić jedną z poniższych wartości: TRUE |
false |
Nazwa kolumny | Opis | Składnia / prawidłowe wartości | Przykład |
---|---|---|---|
tax | Szczegóły podatkowe produktu |
Grupa obejmująca do czterech elementów: country, region, rate (elementy wymagane) oraz tax_ship (element opcjonalny). Dwukropki są wymagane, również w przypadku pustych wartości. country:region:rate(wymagany):tax_ship |
US:1025433:6.00:y |
shipping | Szczegóły dostawy produktu. |
Grupa obejmująca do czterech elementów: country, region, service (elementy opcjonalne) oraz price (element wymagany). Dwukropki są wymagane, również w przypadku pustych wartości. country:region:service:price(wymagany) |
US::Express:13.12 |
shipping_weight |
Waga produktu. |
<numeryczne> <jednostka> Pamiętaj o spacji pomiędzy ciągiem liczb a jednostką. |
5 lb |
shipping_width | Szerokość paczki potrzebnej do wysyłki produktu. |
<numeryczne> <jednostka> Pamiętaj o spacji pomiędzy ciągiem liczb a jednostką. |
16 in |
shipping_height | Wysokość paczki potrzebnej do wysyłki produktu. |
<numeryczne> <jednostka> Pamiętaj o spacji pomiędzy ciągiem liczb a jednostką. |
12 in |
average_review_rating |
Określa, czy oferujesz darmową wysyłkę produktu. Jeśli tak, wprowadź 0 w polu free_shipping_limit. Jeśli oferujesz darmową wysyłkę tylko wtedy, gdy ktoś wyda określoną sumę, wprowadź tę kwotę w polu free_shipping_limit. |
Powinna stanowić jedną z poniższych wartości: TRUE |
true |
free_shipping_limit | Minimalna wartość zamówienia, przy której przysługuje darmowa wysyłka produktu. |
<numeryczna> <ISO 4217> |
35USD |
Nazwa kolumny | Opis | Składnia / prawidłowe wartości | Przykład |
---|---|---|---|
custom_label_0 | Niestandardowe grupowanie produktów (do pięciu) | Maksymalnie 200 znaków |
Promocja wakacyjna |
custom_label_1 | Niestandardowe grupowanie produktów (do pięciu) | Maksymalnie 200 znaków | Bestsellery |
custom_label_2 | Niestandardowe grupowanie produktów (do pięciu) | Maksymalnie 200 znaków | Nowe produkty |
custom_label_3 | Niestandardowe grupowanie produktów (do pięciu) | Maksymalnie 200 znaków | Wyprzedaż |
custom_label_4 | Niestandardowe grupowanie produktów (do pięciu) | Maksymalnie 200 znaków | Pół ceny |
Nazwa kolumny | Opis | Składnia / prawidłowe wartości | Przykład |
---|---|---|---|
ad_link | Link, za pomocą którego możesz śledzić ruch pochodzący z reklam produktowych na Pintereście. |
Adres URL. Należy wysłać pełny adres URL służący do śledzenia, a nie jedynie parametry śledzenia. Obecnie nie obsługujemy śledzenia wyświetleń. Łącza muszą zaczynać się od fragmentu http:// lub https:// |
https://www.przykład.pl/cat/koszula-jeansowa/item012?utm_source=Pinterest |
condition | Stan produktu. |
Powinna stanowić jedną z poniższych wartości: new |
new |
google_product_category | Kategoria produktu na podstawie znormalizowanej taksonomii produktów Google. |
Zobacz pełną angielską taksonomię. Odwiedź centrum pomocy Google, aby uzyskać dostęp do taksonomii w innych językach. Akceptowane są zarówno wartości tekstowe, jak i kody numeryczne. |
Odzież i akcesoria > Odzież > Koszule i topy 21 |
Pamiętaj, aby przestrzegać
Dowiedz się, jak