Feed produktowy dla Meta – wymagane pola, formaty pliku i najczęstsze błędy

Aleksandra Marecka
Aleksandra Marecka
Head of Digital Marketing
Feed produktowy dla Meta – wymagane pola, formaty pliku i najczęstsze błędy
Feed produktowy Facebook – czyli plik z danymi produktów, który zasila katalog w Commerce Managerze Meta – decyduje o tym, jak sklep wygląda w reklamach katalogowych na Facebooku i Instagramie. Od jakości tego pliku zależy, czy produkty w ogóle trafią do reklam, czy ceny i dostępność będą aktualne i czy reklamy pokażą klientom właściwe produkty. Błędy w feedzie to jedna z najczęstszych przyczyn słabych wyników reklam katalogowych Advantage+ (dawniej reklam dynamicznych).
W tym poradniku opisujemy wymagane i najważniejsze opcjonalne pola, obsługiwane formaty plików i limity, zasady dotyczące tytułów, opisów, cen i zdjęć, konfigurację wariantów oraz najczęstsze błędy i sposoby ich naprawy. Opieramy się na specyfikacji danych produktów i artykułach Pomocy Meta. Specyfikacja jest aktualizowana, dlatego przed budową dużego pliku warto zajrzeć do jej aktualnej wersji.
Czym jest feed produktowy i kiedy go używać
Feed to plik, w którym każdy wiersz (lub element XML) opisuje jeden produkt, a kolumny odpowiadają polom zdefiniowanym przez Meta. Plik możesz wgrać jednorazowo z komputera albo udostępnić pod stałym adresem, z którego Meta pobiera go według harmonogramu: co godzinę, codziennie lub co tydzień. Inne sposoby zasilania katalogu, takie jak integracje platform czy ręczne dodawanie produktów, opisujemy w poradniku katalog produktów na Facebooku.
Plik produktowy wybiera się zwykle wtedy, gdy integracja platformy sklepu nie istnieje, nie przekazuje potrzebnych danych albo gdy sklep chce mieć pełną kontrolę nad zawartością katalogu – tytułami, etykietami niestandardowymi czy wykluczeniami produktów. Feed możesz wygenerować z platformy sklepu, z systemu wielokanałowego (na przykład tak, jak opisujemy w tekście o katalogu Meta z Base) albo z zewnętrznego narzędzia do zarządzania plikami produktowymi.
Wymagane pola w feedzie
Specyfikacja danych produktów Meta wymienia pola wymagane dla każdego produktu. Nazwy pól i część obsługiwanych wartości muszą być podane po angielsku, nawet jeśli treść opisów jest po polsku.
Pole | Wymagania według Meta | Na co uważać |
id | Unikalny identyfikator, najlepiej SKU; do 100 znaków; rozróżnia wielkość liter | Musi być identyczny z identyfikatorem w zdarzeniach piksela |
title | Konkretny tytuł produktu; do 200 znaków, zalecane poniżej 65 | Bez upychania słów kluczowych i haseł promocyjnych |
description | Szczegółowy opis w czystym tekście, inny niż tytuł; do 9999 znaków | Bez HTML, linków i tekstu pisanego wielkimi literami |
availability | in stock lub out of stock | Produkty niedostępne nie są pokazywane w reklamach |
condition | new, refurbished lub used | Wartości po angielsku |
price | Liczba, spacja i trzyliterowy kod waluty, np. 149.00 PLN | Kropka jako separator dziesiętny, bez symboli waluty |
link | Adres strony produktu, zaczynający się od http lub https | Link do konkretnego produktu, nie do kategorii |
image_link | Adres głównego zdjęcia; JPEG lub PNG, min. 500 × 500 px, do 8 MB | Przy wymianie zdjęcia trzeba zmienić jego adres URL |
brand | Marka produktu; do 100 znaków | Spójna pisownia w całym pliku |
Meta podkreśla, że identyfikator produktu musi dokładnie odpowiadać identyfikatorowi tego samego produktu w kodzie piksela – inaczej reklamy katalogowe Advantage+ nie będą działać poprawnie. Każdy identyfikator może wystąpić w katalogu tylko raz i musi się różnić od identyfikatorów grup wariantów. Pole rozróżnia wielkość liter, więc abc123 i ABC123 to dla Meta dwa różne produkty.
[#wazne] Zanim zaczniesz budować feed, sprawdź w narzędziu testowania zdarzeń, jaki identyfikator produktu wysyła piksel w Twoim sklepie. Najczęstszy błąd, z jakim się spotykamy, to katalog oparty na SKU przy pikselu wysyłającym wewnętrzne numery produktów ze sklepu. Plik przechodzi wtedy bez błędów, ale reklamy katalogowe nie dopasowują produktów do zachowań klientów. O porządkowaniu numerów produktów piszemy w artykule o EAN i SKU w Base.
Najważniejsze pola opcjonalne
Pola opcjonalne nie są wymagane do wgrania produktu, ale wiele z nich bezpośrednio wpływa na możliwości kampanii. Poniżej te, które w e-commerce przydają się najczęściej.
Pole | Do czego służy | Przykład zastosowania |
item_group_id | Łączy warianty jednego produktu | Koszulka w kilku rozmiarach i kolorach |
sale_price | Cena promocyjna, niższa od podstawowej | Wyprzedaż i prezentacja rabatu w kreacjach |
gtin | Globalny numer produktu (np. EAN), jeśli masz pewność, że jest poprawny | Lepsza klasyfikacja produktu |
custom_label_0–4 | Do pięciu własnych etykiet tekstowych | Grupa marżowa, sezon, bestseller |
custom_number_0–4 | Do pięciu pól liczbowych do filtrowania | Marża, ocena, liczba sprzedanych sztuk |
color, size, material, pattern, gender | Atrybuty wariantów | Rozróżnienie wariantów w grupie |
rich_text_description | Opis z podstawowym HTML | Tylko sklepy na Facebooku i Instagramie, nie reklamy |
Etykiety niestandardowe to jedno z najbardziej niedocenianych narzędzi. Pozwalają oznaczyć produkty na przykład według marży albo sezonu, a potem budować z nich zestawy produktów w katalogu Meta pod osobne kampanie. Meta wskazuje też, że etykiety mogą być użyte w treści kreacji, na przykład w nagłówku.
Wykres – jak przygotować feed produktowy dla Meta krok po kroku. [#chart:m30]
Feed produktowy Facebook – czyli plik z danymi produktów, który zasila katalog w Commerce Managerze Meta – decyduje o tym, jak sklep wygląda w reklamach katalogowych na Facebooku i Instagramie. Od jakości tego pliku zależy, czy produkty w ogóle trafią do reklam, czy ceny i dostępność będą aktualne i czy reklamy pokażą klientom właściwe produkty. Błędy w feedzie to jedna z najczęstszych przyczyn słabych wyników reklam katalogowych Advantage+ (dawniej reklam dynamicznych).
W tym poradniku opisujemy wymagane i najważniejsze opcjonalne pola, obsługiwane formaty plików i limity, zasady dotyczące tytułów, opisów, cen i zdjęć, konfigurację wariantów oraz najczęstsze błędy i sposoby ich naprawy. Opieramy się na specyfikacji danych produktów i artykułach Pomocy Meta. Specyfikacja jest aktualizowana, dlatego przed budową dużego pliku warto zajrzeć do jej aktualnej wersji.
Czym jest feed produktowy i kiedy go używać
Feed to plik, w którym każdy wiersz (lub element XML) opisuje jeden produkt, a kolumny odpowiadają polom zdefiniowanym przez Meta. Plik możesz wgrać jednorazowo z komputera albo udostępnić pod stałym adresem, z którego Meta pobiera go według harmonogramu: co godzinę, codziennie lub co tydzień. Inne sposoby zasilania katalogu, takie jak integracje platform czy ręczne dodawanie produktów, opisujemy w poradniku katalog produktów na Facebooku.
Plik produktowy wybiera się zwykle wtedy, gdy integracja platformy sklepu nie istnieje, nie przekazuje potrzebnych danych albo gdy sklep chce mieć pełną kontrolę nad zawartością katalogu – tytułami, etykietami niestandardowymi czy wykluczeniami produktów. Feed możesz wygenerować z platformy sklepu, z systemu wielokanałowego (na przykład tak, jak opisujemy w tekście o katalogu Meta z Base) albo z zewnętrznego narzędzia do zarządzania plikami produktowymi.
Wymagane pola w feedzie
Specyfikacja danych produktów Meta wymienia pola wymagane dla każdego produktu. Nazwy pól i część obsługiwanych wartości muszą być podane po angielsku, nawet jeśli treść opisów jest po polsku.
Pole | Wymagania według Meta | Na co uważać |
id | Unikalny identyfikator, najlepiej SKU; do 100 znaków; rozróżnia wielkość liter | Musi być identyczny z identyfikatorem w zdarzeniach piksela |
title | Konkretny tytuł produktu; do 200 znaków, zalecane poniżej 65 | Bez upychania słów kluczowych i haseł promocyjnych |
description | Szczegółowy opis w czystym tekście, inny niż tytuł; do 9999 znaków | Bez HTML, linków i tekstu pisanego wielkimi literami |
availability | in stock lub out of stock | Produkty niedostępne nie są pokazywane w reklamach |
condition | new, refurbished lub used | Wartości po angielsku |
price | Liczba, spacja i trzyliterowy kod waluty, np. 149.00 PLN | Kropka jako separator dziesiętny, bez symboli waluty |
link | Adres strony produktu, zaczynający się od http lub https | Link do konkretnego produktu, nie do kategorii |
image_link | Adres głównego zdjęcia; JPEG lub PNG, min. 500 × 500 px, do 8 MB | Przy wymianie zdjęcia trzeba zmienić jego adres URL |
brand | Marka produktu; do 100 znaków | Spójna pisownia w całym pliku |
Meta podkreśla, że identyfikator produktu musi dokładnie odpowiadać identyfikatorowi tego samego produktu w kodzie piksela – inaczej reklamy katalogowe Advantage+ nie będą działać poprawnie. Każdy identyfikator może wystąpić w katalogu tylko raz i musi się różnić od identyfikatorów grup wariantów. Pole rozróżnia wielkość liter, więc abc123 i ABC123 to dla Meta dwa różne produkty.
[#wazne] Zanim zaczniesz budować feed, sprawdź w narzędziu testowania zdarzeń, jaki identyfikator produktu wysyła piksel w Twoim sklepie. Najczęstszy błąd, z jakim się spotykamy, to katalog oparty na SKU przy pikselu wysyłającym wewnętrzne numery produktów ze sklepu. Plik przechodzi wtedy bez błędów, ale reklamy katalogowe nie dopasowują produktów do zachowań klientów. O porządkowaniu numerów produktów piszemy w artykule o EAN i SKU w Base.
Najważniejsze pola opcjonalne
Pola opcjonalne nie są wymagane do wgrania produktu, ale wiele z nich bezpośrednio wpływa na możliwości kampanii. Poniżej te, które w e-commerce przydają się najczęściej.
Pole | Do czego służy | Przykład zastosowania |
item_group_id | Łączy warianty jednego produktu | Koszulka w kilku rozmiarach i kolorach |
sale_price | Cena promocyjna, niższa od podstawowej | Wyprzedaż i prezentacja rabatu w kreacjach |
gtin | Globalny numer produktu (np. EAN), jeśli masz pewność, że jest poprawny | Lepsza klasyfikacja produktu |
custom_label_0–4 | Do pięciu własnych etykiet tekstowych | Grupa marżowa, sezon, bestseller |
custom_number_0–4 | Do pięciu pól liczbowych do filtrowania | Marża, ocena, liczba sprzedanych sztuk |
color, size, material, pattern, gender | Atrybuty wariantów | Rozróżnienie wariantów w grupie |
rich_text_description | Opis z podstawowym HTML | Tylko sklepy na Facebooku i Instagramie, nie reklamy |
Etykiety niestandardowe to jedno z najbardziej niedocenianych narzędzi. Pozwalają oznaczyć produkty na przykład według marży albo sezonu, a potem budować z nich zestawy produktów w katalogu Meta pod osobne kampanie. Meta wskazuje też, że etykiety mogą być użyte w treści kreacji, na przykład w nagłówku.
Wykres – jak przygotować feed produktowy dla Meta krok po kroku. [#chart:m30]
- Analiza kampanii, grup odbiorców i kreacji
- Sprawdzenie Piksela, API konwersji i zdarzeń
- Plan obniżenia kosztu pozyskania klienta
Formaty plików i limity
Meta obsługuje pliki CSV, TSV, XLSX, XML (RSS/ATOM) oraz arkusze Google. Inne formaty, na przykład HTML, nie zostaną przyjęte. Specyfikacja podaje też kilka limitów, które mają znaczenie przy większych sklepach.
Parametr | Limit lub zalecenie według Meta |
Rozmiar pliku – jednorazowe wgranie | 100 MB |
Rozmiar pliku – harmonogram | 4 GB |
Kompresja | Zalecana ZIP lub GZIP dla plików powyżej 1 GB |
Liczba produktów w jednym pliku | Zalecane do 1 miliona; większe oferty podziel na kilka plików |
Długość jednego wiersza | 5 MB |
Harmonogram pobierania | Co godzinę, codziennie lub co tydzień |
Przy pliku CSV tworzonym w prostym edytorze tekstu albo generowanym przez własny skrypt pamiętaj, że pola zawierające przecinki trzeba ująć w cudzysłów, a cudzysłów wewnątrz takiego pola zapisać podwójnie. W przeciwnym razie przecinek w opisie zostanie potraktowany jak separator kolumn i plik zwróci błąd niewłaściwej liczby kolumn. Arkusze kalkulacyjne, takie jak Excel czy Arkusze Google, robią to automatycznie.
Jeśli Twój plik jest przygotowany pod Google Merchant Center, przy dodawaniu go w Commerce Managerze możesz wskazać ten format. To wygodne rozwiązanie dla sklepów, które mają już feed do Google, na przykład wygenerowany tak, jak opisujemy w tekście o feedzie do Google Merchant Center z Base. Po pierwszym pobraniu sprawdź jednak, czy wszystkie pola zostały poprawnie rozpoznane.
Przy pobieraniu według harmonogramu masz do wyboru dwa tryby. Zastępowanie traktuje każdy nowy plik jako pełną listę produktów: dodaje nowe, aktualizuje istniejące i usuwa te, których w pliku zabrakło. Aktualizacja działa szybciej, ale ignoruje produkty usunięte z pliku – żeby je skasować, trzeba dodać pole delete z wartością true. Meta sugeruje łączenie obu trybów, na przykład częstą aktualizację cen i stanów oraz rzadsze pełne zastąpienie, które porządkuje katalog z wycofanych produktów. Jeśli generujesz plik z systemu wielokanałowego, zajrzyj też do naszego tekstu o eksporcie produktów z Base, gdzie opisujemy budowę własnych eksportów XML i CSV.
Tytuły, opisy, ceny i zdjęcia – zasady Meta
Specyfikacja tytułów produktów zaleca tytuły zwięzłe i opisowe, krótsze od opisu, bez upychania słów kluczowych, haseł promocyjnych w rodzaju „wyprzedaż” czy „darmowa dostawa” oraz subiektywnych określeń typu „bestseller” czy „świetny prezent”. Informacje o promocji należy podawać w odpowiednich polach, a nie w tytule. Meta zaleca też zapis liczb cyframi i unikanie pisania całych tytułów wielkimi literami. Zalecenie pisania każdego słowa wielką literą dotyczy przede wszystkim tytułów anglojęzycznych – w polskich tytułach naturalniejsza jest zwykła pisownia.
Opis: czysty tekst, inny niż tytuł, bez linków i bez pisania wielkimi literami. HTML jest obsługiwany tylko w polu rich_text_description, które działa w sklepach, a nie w reklamach.
Cena: liczba z kropką jako separatorem dziesiętnym, spacja i kod waluty, np. 89.99 PLN. W jednym pliku tylko jedna waluta – ceny w innych walutach dodaje się w plikach krajowych.
Cena promocyjna: w polu sale_price, niższa od ceny podstawowej. Po zakończeniu promocji usuń ją z pliku.
Zdjęcie: JPEG lub PNG, co najmniej 500 × 500 pikseli, do 8 MB. Nie używaj zastępczych grafik typu „zdjęcie wkrótce”, bo przy późniejszej wymianie trzeba zmienić adres URL zdjęcia.
Dostępność: produkty z wartością out of stock nie są pokazywane w reklamach, choć w sklepach na Facebooku i Instagramie mogą być widoczne do 56 dni jako wyprzedane.
[#przyklad] Sklep z akcesoriami kuchennymi miał tytuły w stylu „HIT! Nóż szefa kuchni stal nierdzewna kuchnia gotowanie prezent DARMOWA DOSTAWA”. Po zmianie na „Nóż szefa kuchni 20 cm, stal nierdzewna” i przeniesieniu informacji o promocji do pola sale_price tytuły przestały się ucinać w reklamach, a produkty przestały trafiać na listę z ostrzeżeniami w diagnostyce katalogu.
Dobrym nawykiem jest też przygotowanie opisów z myślą o kliencie, a nie tylko o specyfikacji. Opis powinien zawierać najważniejsze cechy produktu: materiał, wymiary, przeznaczenie czy kompatybilność. To właśnie te informacje pomagają klientowi podjąć decyzję po kliknięciu w reklamę i porównać produkt z innymi ofertami, zanim przejdzie do sklepu.
Warianty produktów w feedzie
Według Pomocy Meta warianty w pliku konfiguruje się za pomocą pola item_group_id: wszystkie warianty jednego produktu mają ten sam identyfikator grupy, a każdy wariant – własny, unikalny id. Identyfikatory grup nie mogą powtarzać się wśród identyfikatorów produktów. Do rozróżnienia wariantów służą atrybuty: color, size, material, pattern, gender lub additional_variant_attribute. Wszystkie warianty w grupie powinny mieć wypełnione te same atrybuty, a każda kombinacja musi być unikalna.
W praktyce najważniejsza jest spójność z pikselem. Jeśli w pliku są warianty, zdarzenia ViewContent i AddToCart powinny przesyłać identyfikator wariantu. Jeśli piksel wysyła identyfikator produktu głównego, Meta nie dopasuje zdarzenia do pozycji w katalogu. Branże z dużą liczbą wariantów, takie jak moda, opisujemy szerzej w artykule o Meta Ads dla branży modowej, a parametry zdarzeń – w tekście o zdarzeniach piksela Meta w e-commerce.
Najczęstsze błędy w feedzie i jak je naprawić
Pomoc Meta o błędach pliku produktowego dzieli problemy na dwie grupy: błędy całego pliku, które mogą zatrzymać jego wgranie, oraz błędy dotyczące pojedynczych produktów. Raport z błędami pobierzesz w Commerce Managerze w zakładce źródeł danych, po wybraniu pliku.
Błąd | Przyczyna | Rozwiązanie |
Plik niedostępny lub błąd połączenia z serwerem | Meta nie może pobrać pliku spod podanego adresu | Sprawdź link w przeglądarce, uprawnienia serwera i plik robots.txt (facebookexternalhit/1.1 nie może być blokowany) |
Nieobsługiwany format HTML | Link prowadzi do strony, a nie do pliku | Podaj bezpośredni adres pliku CSV, XML lub innego obsługiwanego formatu |
Niewłaściwa liczba kolumn | Przecinki w polach CSV bez cudzysłowu | Ujmij pola z przecinkami w cudzysłów lub wygeneruj plik w arkuszu |
Niedozwolony HTML | Znaczniki HTML w polu description | Usuń HTML lub użyj pola rich_text_description |
Pole pisane wielkimi literami | Opis w całości wielkimi literami | Zmień na zwykłą pisownię, np. regułą danych |
Konflikt identyfikatora z identyfikatorem grupy | To samo id użyte jako item_group_id | Nadaj grupom identyfikatory różne od produktów |
Nieprawidłowe wartości | Wartości spoza listy, np. dostępne zamiast in stock | Użyj wartości ze specyfikacji Meta |
Pomoc Meta zwraca uwagę na jeszcze jedną rzecz: jeśli zaplanowane pobieranie pliku kilka razy z rzędu się nie powiedzie, harmonogram może zostać wstrzymany. Wtedy trzeba go ręcznie wznowić w ustawieniach pliku. Dlatego po każdej awarii serwera albo zmianie adresu pliku warto sprawdzić, czy harmonogram nadal działa.
Część problemów da się naprawić bez zmiany samego pliku. Reguły danych w Commerce Managerze pozwalają masowo poprawiać wartości, na przykład zmieniać wielkość liter w opisach, a pliki uzupełniające dodają brakujące pola do produktów z głównego źródła. Produkty odrzucone z powodu zasad handlowych lub braków w danych opisujemy osobno w artykule o odrzuconych produktach w katalogu Meta.
Wykres – najczęstsze błędy w feedzie produktowym dla Meta. [#chart:m30b]
[#uwaga] Nie poprawiaj masowo tytułów i opisów tuż przed ważną kampanią. Według Meta zmiana większości danych produktu, takich jak tytuł, opis czy zdjęcie, wysyła produkt do ponownej weryfikacji i czasowo wyłącza go z reklam. Cenę, dostępność czy etykiety wewnętrzne można zmieniać bez ponownej weryfikacji, dlatego to one są bezpieczne do aktualizacji w trakcie promocji.
Lista kontrolna przed wgraniem feedu
[#checklista] Przed dodaniem pliku do katalogu sprawdź: czy identyfikatory są zgodne z pikselem i unikalne, czy wszystkie wymagane pola są wypełnione, czy ceny mają kropkę i kod waluty, czy dostępność ma wartości in stock lub out of stock, czy opisy nie zawierają HTML ani tekstu wielkimi literami, czy linki prowadzą do konkretnych produktów, czy zdjęcia spełniają wymagania i czy warianty mają wspólne item_group_id.
Gdy plik jest poprawny, a katalog połączony ze zbiorem danych, możesz uruchomić reklamy katalogowe Advantage+ i dopracować ich wygląd – piszemy o tym w tekście o kreacjach katalogowych. Jeśli korzystasz z platformy z oficjalną integracją, na przykład Shopify, feed może być zbędny – wtedy te same zasady jakości danych dotyczą produktów w samym sklepie.
Najczęściej zadawane pytania
Jaki format feedu wybrać dla Meta?
Meta przyjmuje CSV, TSV, XLSX, XML (RSS/ATOM) i Arkusze Google. Wybór zależy głównie od tego, co potrafi wygenerować Twoja platforma lub narzędzie. Przy dużych ofertach popularne są XML i CSV, bo dobrze sprawdzają się przy pobieraniu według harmonogramu.
Czy mogę użyć tego samego feedu co w Google Merchant Center?
Tak, przy dodawaniu pliku w Commerce Managerze możesz wskazać format Google Merchant Center. Po pierwszym pobraniu sprawdź, czy pola zostały poprawnie rozpoznane, i w razie potrzeby dodaj reguły danych.
Jak często Meta może pobierać feed?
Harmonogram można ustawić co godzinę, codziennie lub co tydzień. Meta zaleca ustawienie pobierania chwilę po tym, jak plik zwykle się aktualizuje.
Dlaczego feed się wgrywa, ale reklamy pokazują złe produkty?
Najczęściej identyfikatory w pliku nie odpowiadają identyfikatorom wysyłanym przez piksel. Porównaj pole id w katalogu z wartościami content_ids w zdarzeniach i sprawdź wskaźnik dopasowania w diagnostyce katalogu.
Czy w opisie produktu mogę użyć HTML?
W polu description nie. HTML jest obsługiwany tylko w polu rich_text_description, i to wyłącznie w sklepach na Facebooku i Instagramie, a nie w reklamach. Obsługiwane są tylko podstawowe znaczniki.
Ile produktów może zawierać jeden feed?
Meta zaleca do miliona produktów w jednym pliku. Większą ofertę lepiej podzielić na kilka plików i wgrać je osobno.
Podsumowanie
Feed produktowy dla Meta musi zawierać wymagane pola – id, title, description, availability, condition, price, link, image_link i brand – w formacie zgodnym ze specyfikacją. Kluczowe są identyfikatory zgodne z pikselem, poprawny format cen, czyste opisy, dobre zdjęcia i poprawnie skonfigurowane warianty. Raporty błędów, reguły danych i pliki uzupełniające pomagają utrzymać katalog w dobrym stanie bez ciągłego przerabiania pliku.
Jeśli chcesz, żebyśmy przygotowali lub poprawili feed Twojego sklepu i poprowadzili reklamy katalogowe, zobacz naszą obsługę kampanii Meta Ads.
Formaty plików i limity
Meta obsługuje pliki CSV, TSV, XLSX, XML (RSS/ATOM) oraz arkusze Google. Inne formaty, na przykład HTML, nie zostaną przyjęte. Specyfikacja podaje też kilka limitów, które mają znaczenie przy większych sklepach.
Parametr | Limit lub zalecenie według Meta |
Rozmiar pliku – jednorazowe wgranie | 100 MB |
Rozmiar pliku – harmonogram | 4 GB |
Kompresja | Zalecana ZIP lub GZIP dla plików powyżej 1 GB |
Liczba produktów w jednym pliku | Zalecane do 1 miliona; większe oferty podziel na kilka plików |
Długość jednego wiersza | 5 MB |
Harmonogram pobierania | Co godzinę, codziennie lub co tydzień |
Przy pliku CSV tworzonym w prostym edytorze tekstu albo generowanym przez własny skrypt pamiętaj, że pola zawierające przecinki trzeba ująć w cudzysłów, a cudzysłów wewnątrz takiego pola zapisać podwójnie. W przeciwnym razie przecinek w opisie zostanie potraktowany jak separator kolumn i plik zwróci błąd niewłaściwej liczby kolumn. Arkusze kalkulacyjne, takie jak Excel czy Arkusze Google, robią to automatycznie.
Jeśli Twój plik jest przygotowany pod Google Merchant Center, przy dodawaniu go w Commerce Managerze możesz wskazać ten format. To wygodne rozwiązanie dla sklepów, które mają już feed do Google, na przykład wygenerowany tak, jak opisujemy w tekście o feedzie do Google Merchant Center z Base. Po pierwszym pobraniu sprawdź jednak, czy wszystkie pola zostały poprawnie rozpoznane.
Przy pobieraniu według harmonogramu masz do wyboru dwa tryby. Zastępowanie traktuje każdy nowy plik jako pełną listę produktów: dodaje nowe, aktualizuje istniejące i usuwa te, których w pliku zabrakło. Aktualizacja działa szybciej, ale ignoruje produkty usunięte z pliku – żeby je skasować, trzeba dodać pole delete z wartością true. Meta sugeruje łączenie obu trybów, na przykład częstą aktualizację cen i stanów oraz rzadsze pełne zastąpienie, które porządkuje katalog z wycofanych produktów. Jeśli generujesz plik z systemu wielokanałowego, zajrzyj też do naszego tekstu o eksporcie produktów z Base, gdzie opisujemy budowę własnych eksportów XML i CSV.
Tytuły, opisy, ceny i zdjęcia – zasady Meta
Specyfikacja tytułów produktów zaleca tytuły zwięzłe i opisowe, krótsze od opisu, bez upychania słów kluczowych, haseł promocyjnych w rodzaju „wyprzedaż” czy „darmowa dostawa” oraz subiektywnych określeń typu „bestseller” czy „świetny prezent”. Informacje o promocji należy podawać w odpowiednich polach, a nie w tytule. Meta zaleca też zapis liczb cyframi i unikanie pisania całych tytułów wielkimi literami. Zalecenie pisania każdego słowa wielką literą dotyczy przede wszystkim tytułów anglojęzycznych – w polskich tytułach naturalniejsza jest zwykła pisownia.
Opis: czysty tekst, inny niż tytuł, bez linków i bez pisania wielkimi literami. HTML jest obsługiwany tylko w polu rich_text_description, które działa w sklepach, a nie w reklamach.
Cena: liczba z kropką jako separatorem dziesiętnym, spacja i kod waluty, np. 89.99 PLN. W jednym pliku tylko jedna waluta – ceny w innych walutach dodaje się w plikach krajowych.
Cena promocyjna: w polu sale_price, niższa od ceny podstawowej. Po zakończeniu promocji usuń ją z pliku.
Zdjęcie: JPEG lub PNG, co najmniej 500 × 500 pikseli, do 8 MB. Nie używaj zastępczych grafik typu „zdjęcie wkrótce”, bo przy późniejszej wymianie trzeba zmienić adres URL zdjęcia.
Dostępność: produkty z wartością out of stock nie są pokazywane w reklamach, choć w sklepach na Facebooku i Instagramie mogą być widoczne do 56 dni jako wyprzedane.
[#przyklad] Sklep z akcesoriami kuchennymi miał tytuły w stylu „HIT! Nóż szefa kuchni stal nierdzewna kuchnia gotowanie prezent DARMOWA DOSTAWA”. Po zmianie na „Nóż szefa kuchni 20 cm, stal nierdzewna” i przeniesieniu informacji o promocji do pola sale_price tytuły przestały się ucinać w reklamach, a produkty przestały trafiać na listę z ostrzeżeniami w diagnostyce katalogu.
Dobrym nawykiem jest też przygotowanie opisów z myślą o kliencie, a nie tylko o specyfikacji. Opis powinien zawierać najważniejsze cechy produktu: materiał, wymiary, przeznaczenie czy kompatybilność. To właśnie te informacje pomagają klientowi podjąć decyzję po kliknięciu w reklamę i porównać produkt z innymi ofertami, zanim przejdzie do sklepu.
Warianty produktów w feedzie
Według Pomocy Meta warianty w pliku konfiguruje się za pomocą pola item_group_id: wszystkie warianty jednego produktu mają ten sam identyfikator grupy, a każdy wariant – własny, unikalny id. Identyfikatory grup nie mogą powtarzać się wśród identyfikatorów produktów. Do rozróżnienia wariantów służą atrybuty: color, size, material, pattern, gender lub additional_variant_attribute. Wszystkie warianty w grupie powinny mieć wypełnione te same atrybuty, a każda kombinacja musi być unikalna.
W praktyce najważniejsza jest spójność z pikselem. Jeśli w pliku są warianty, zdarzenia ViewContent i AddToCart powinny przesyłać identyfikator wariantu. Jeśli piksel wysyła identyfikator produktu głównego, Meta nie dopasuje zdarzenia do pozycji w katalogu. Branże z dużą liczbą wariantów, takie jak moda, opisujemy szerzej w artykule o Meta Ads dla branży modowej, a parametry zdarzeń – w tekście o zdarzeniach piksela Meta w e-commerce.
Najczęstsze błędy w feedzie i jak je naprawić
Pomoc Meta o błędach pliku produktowego dzieli problemy na dwie grupy: błędy całego pliku, które mogą zatrzymać jego wgranie, oraz błędy dotyczące pojedynczych produktów. Raport z błędami pobierzesz w Commerce Managerze w zakładce źródeł danych, po wybraniu pliku.
Błąd | Przyczyna | Rozwiązanie |
Plik niedostępny lub błąd połączenia z serwerem | Meta nie może pobrać pliku spod podanego adresu | Sprawdź link w przeglądarce, uprawnienia serwera i plik robots.txt (facebookexternalhit/1.1 nie może być blokowany) |
Nieobsługiwany format HTML | Link prowadzi do strony, a nie do pliku | Podaj bezpośredni adres pliku CSV, XML lub innego obsługiwanego formatu |
Niewłaściwa liczba kolumn | Przecinki w polach CSV bez cudzysłowu | Ujmij pola z przecinkami w cudzysłów lub wygeneruj plik w arkuszu |
Niedozwolony HTML | Znaczniki HTML w polu description | Usuń HTML lub użyj pola rich_text_description |
Pole pisane wielkimi literami | Opis w całości wielkimi literami | Zmień na zwykłą pisownię, np. regułą danych |
Konflikt identyfikatora z identyfikatorem grupy | To samo id użyte jako item_group_id | Nadaj grupom identyfikatory różne od produktów |
Nieprawidłowe wartości | Wartości spoza listy, np. dostępne zamiast in stock | Użyj wartości ze specyfikacji Meta |
Pomoc Meta zwraca uwagę na jeszcze jedną rzecz: jeśli zaplanowane pobieranie pliku kilka razy z rzędu się nie powiedzie, harmonogram może zostać wstrzymany. Wtedy trzeba go ręcznie wznowić w ustawieniach pliku. Dlatego po każdej awarii serwera albo zmianie adresu pliku warto sprawdzić, czy harmonogram nadal działa.
Część problemów da się naprawić bez zmiany samego pliku. Reguły danych w Commerce Managerze pozwalają masowo poprawiać wartości, na przykład zmieniać wielkość liter w opisach, a pliki uzupełniające dodają brakujące pola do produktów z głównego źródła. Produkty odrzucone z powodu zasad handlowych lub braków w danych opisujemy osobno w artykule o odrzuconych produktach w katalogu Meta.
Wykres – najczęstsze błędy w feedzie produktowym dla Meta. [#chart:m30b]
[#uwaga] Nie poprawiaj masowo tytułów i opisów tuż przed ważną kampanią. Według Meta zmiana większości danych produktu, takich jak tytuł, opis czy zdjęcie, wysyła produkt do ponownej weryfikacji i czasowo wyłącza go z reklam. Cenę, dostępność czy etykiety wewnętrzne można zmieniać bez ponownej weryfikacji, dlatego to one są bezpieczne do aktualizacji w trakcie promocji.
Lista kontrolna przed wgraniem feedu
[#checklista] Przed dodaniem pliku do katalogu sprawdź: czy identyfikatory są zgodne z pikselem i unikalne, czy wszystkie wymagane pola są wypełnione, czy ceny mają kropkę i kod waluty, czy dostępność ma wartości in stock lub out of stock, czy opisy nie zawierają HTML ani tekstu wielkimi literami, czy linki prowadzą do konkretnych produktów, czy zdjęcia spełniają wymagania i czy warianty mają wspólne item_group_id.
Gdy plik jest poprawny, a katalog połączony ze zbiorem danych, możesz uruchomić reklamy katalogowe Advantage+ i dopracować ich wygląd – piszemy o tym w tekście o kreacjach katalogowych. Jeśli korzystasz z platformy z oficjalną integracją, na przykład Shopify, feed może być zbędny – wtedy te same zasady jakości danych dotyczą produktów w samym sklepie.
Najczęściej zadawane pytania
Jaki format feedu wybrać dla Meta?
Meta przyjmuje CSV, TSV, XLSX, XML (RSS/ATOM) i Arkusze Google. Wybór zależy głównie od tego, co potrafi wygenerować Twoja platforma lub narzędzie. Przy dużych ofertach popularne są XML i CSV, bo dobrze sprawdzają się przy pobieraniu według harmonogramu.
Czy mogę użyć tego samego feedu co w Google Merchant Center?
Tak, przy dodawaniu pliku w Commerce Managerze możesz wskazać format Google Merchant Center. Po pierwszym pobraniu sprawdź, czy pola zostały poprawnie rozpoznane, i w razie potrzeby dodaj reguły danych.
Jak często Meta może pobierać feed?
Harmonogram można ustawić co godzinę, codziennie lub co tydzień. Meta zaleca ustawienie pobierania chwilę po tym, jak plik zwykle się aktualizuje.
Dlaczego feed się wgrywa, ale reklamy pokazują złe produkty?
Najczęściej identyfikatory w pliku nie odpowiadają identyfikatorom wysyłanym przez piksel. Porównaj pole id w katalogu z wartościami content_ids w zdarzeniach i sprawdź wskaźnik dopasowania w diagnostyce katalogu.
Czy w opisie produktu mogę użyć HTML?
W polu description nie. HTML jest obsługiwany tylko w polu rich_text_description, i to wyłącznie w sklepach na Facebooku i Instagramie, a nie w reklamach. Obsługiwane są tylko podstawowe znaczniki.
Ile produktów może zawierać jeden feed?
Meta zaleca do miliona produktów w jednym pliku. Większą ofertę lepiej podzielić na kilka plików i wgrać je osobno.
Podsumowanie
Feed produktowy dla Meta musi zawierać wymagane pola – id, title, description, availability, condition, price, link, image_link i brand – w formacie zgodnym ze specyfikacją. Kluczowe są identyfikatory zgodne z pikselem, poprawny format cen, czyste opisy, dobre zdjęcia i poprawnie skonfigurowane warianty. Raporty błędów, reguły danych i pliki uzupełniające pomagają utrzymać katalog w dobrym stanie bez ciągłego przerabiania pliku.
Jeśli chcesz, żebyśmy przygotowali lub poprawili feed Twojego sklepu i poprowadzili reklamy katalogowe, zobacz naszą obsługę kampanii Meta Ads.


Aleksandra Marecka
Head of Digital Marketing
Projektuje i skaluje strategie marketingowe e-commerce: social media, e-mail, content. Optymalizuje działania pod zwrot z inwestycji.
Projektuje i skaluje strategie marketingowe e-commerce: social media, e-mail, content. Optymalizuje działania pod zwrot z inwestycji.
Obsługa kampanii Meta Ads
Aleksandra i nasz zespół pomogą Ci wdrożyć to na Twoim koncie – bez zobowiązań.
- Analiza Twojego konta i obecnych działań
- Konkretny plan poprawek do wdrożenia
- Bezpłatna konsultacja – bez zobowiązań

Przeczytaj także
Więcej porad z naszej bazy wiedzy – przesuń, aby zobaczyć kolejne artykuły.
Masz pytania? Chętnie porozmawiamy!
Masz pytania? Chętnie porozmawiamy!
Masz pytania? Chętnie porozmawiamy!

Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie – przyjdzie i to zrobi."

Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie – przyjdzie i to zrobi."