NowośćProduct Score, 4T Segmentation, Price War i Broken Size są już dostępne.Zobacz, co nowego
Feedance
Logo eMAGeMAGKanał · Marketplace’y i aplikacje
Integracja z eMAG

Wyślij do eMAG produkty warte pokazania.

Feedance tworzy twój feed dla eMAG i dodaje etykiety na poziomie produktu: wynik, segment 4T, pozycję cenową i niepełną rozmiarówkę, dzięki czemu każdy produkt niesie własny sygnał efektywności.

Feed produktowy dla eMAG
Wygenerowany przez Feedance
Eksport XML, CSV lub JSONAktualizowany przy każdej synchronizacji
<item>
  <id>TS-1042</id>
  <title>T-shirt z okrągłym dekoltem</title>
  <price>49.90 USD</price>
  <availability>in stock</availability>
  <custom_label_0>score_86</custom_label_0>
  <custom_label_1>top</custom_label_1>
  <custom_label_2>best_price</custom_label_2>
  <custom_label_3>size_ok</custom_label_3>
</item>
Etykiety Feedance zapisane jako custom labels
Co Feedance wysyła do eMAG

Katalog z sygnałem efektywności przy każdym produkcie.

eMAG odczytuje twoje produkty z feedu. Feedance wysyła kompletny, poprawny feed oraz sygnały, do których eMAG nie ma samodzielnie dostępu.

Product Scorecustom_label_0Wynik od 0 do 100 na podstawie wyświetleń, dodań do koszyka i zakupów z 1, 7 i 30 dni.
Segment 4Tcustom_label_1Top, Tolerable, Tranquil lub Toxic, na podstawie ruchu i zwrotu każdego produktu.
Price Warcustom_label_2Najlepsza cena, taka sama lub drożej niż wskazani konkurenci.
Broken Sizecustom_label_3Oznacza modele, których rozmiarówka jest w większości wyprzedana.
Kreacjeimage_linkBrandowane grafiki z Creative Suite, z ceną i szczegółami kampanii pobranymi z feedu.
Jak z tego korzystasz: dziel kampanie, grupy produktów lub zestawy produktów według tych etykiet, np. tylko produkty Top albo wszystko poza Toxic i niepełnymi rozmiarówkami. Sloty etykiet można konfigurować. Feedance nie zmienia twoich stawek ani budżetów.

Czym jest eMAG?

eMAG to największy marketplace e-commerce w Rumunii, prowadzący też odpowiadające mu platformy Marketplace w Bułgarii (emag.bg) i na Węgrzech (emag.hu) w ramach tego samego programu dla sprzedawców. Zewnętrzni sprzedawcy nie sprzedają przez osobny sklep – wystawiają oferty bezpośrednio do produktów z katalogu eMAG za pośrednictwem eMAG Marketplace, a każda oferta konkuruje na tej samej stronie produktu z ofertami detalicznymi samego eMAG i innych sprzedawców. eMAG daje sprzedawcom dwa sposoby publikowania i utrzymywania katalogu: eMAG Marketplace API (JSON, obecnie udokumentowane w wersji 4.5.1) lub hostowany plik XML/CSV w ramach Feed Import, który eMAG pobiera i przetwarza ponownie według harmonogramu.

Dlaczego warto połączyć feed produktowy z eMAG?

Ręczne wprowadzanie produktów i przepisywanie zmian stanów czy cen w panelu sprzedawcy eMAG przestaje się sprawdzać, gdy katalog przekracza kilkadziesiąt SKU, i jest największym źródłem nieaktualnych cen oraz sprzedaży ponad stan na szybko zmieniającym się marketplace. Programowe zasilanie eMAG pozwala wysyłać nowe oferty, zmiany cen i stany magazynowe z twojego PIM lub sklepu w chwili, gdy się zmieniają, a nie wtedy, gdy ktoś przypomni sobie, by zalogować się i ręcznie edytować oferty. Pozwala też dotrzeć do trzech rynków – Rumunii, Bułgarii i Węgier – z tych samych danych produktowych, ponieważ wszystkie trzy działają na tym samym Marketplace API i mechanizmie Feed Import.

Jak działa model prowizji eMAG

eMAG nie pobiera opłaty rejestracyjnej, miesięcznego abonamentu ani opłaty za wystawienie oferty. Sprzedawcy płacą prowizję zależną od kategorii wyłącznie od zrealizowanej sprzedaży, a dokumentacja eMAG dla sprzedawców podaje, że prowizja „wynosi od 7 do 25%, w zależności od kategorii”, w której wystawiony jest produkt – dokładna stawka dla każdej kategorii jest określona w umowie Marketplace sprzedawcy. Prowizja jest potrącana automatycznie przed wypłatą, a sprzedawcy otrzymują płatności dwa razy w miesiącu. Sprzedawcy korzystający z Fulfilled by eMAG (FBE) płacą dodatkowe opłaty magazynowe zależne od tego, jak długo towar leży w magazynie eMAG, oraz opłatę za obsługę zamówienia, która zaczyna się od 3,99 RON i rośnie wraz z rozmiarem i wagą paczki.

Jakiego formatu feedu wymaga eMAG?

eMAG obsługuje dwie odrębne ścieżki integracji, a Feedance opiera się na ścieżce API, ponieważ daje ona największą kontrolę nad walidacją i czasem aktualizacji:

  1. Marketplace API (zalecane do automatyzacji) – dane JSON wysyłane uwierzytelnionymi żądaniami POST do punktów końcowych zasobów, takich jak product_offer, category i order (np. product_offer/save, product_offer/read, product_offer/count). Każda odpowiedź to ustandaryzowany JSON zawierający wartość logiczną isError i tablicę messages, a pojedyncze wywołanie save jest ograniczone do 50 obiektów (10–50 to zakres zalecany przez eMAG dla niezawodnego przetwarzania), z twardym limitem 4000 elementów na wywołanie.
  2. Feed Import (XML/CSV) – jeden hostowany adres URL pliku, który moduł Feed Import eMAG pobiera ponownie według harmonogramu ustawionego w panelu sprzedawcy. Plik feedu może mieć maksymalnie 100 MB, zawierać do 100 000 produktów i do 150 kategorii.

Obie ścieżki ostatecznie zasilają te same rekordy produktów/ofert, więc wybór sprowadza się do tego, jak dużej kontroli w czasie rzeczywistym potrzebujesz nad odpowiedziami walidacyjnymi i obsługą błędów – dlatego Feedance domyślnie korzysta z API JSON.

Które atrybuty produktu są wymagane?

AtrybutWymagany?Format / uwagi
idWymaganyLiczba całkowita 1–16 777 215 – twój wewnętrzny identyfikator produktu, używany jako klucz główny przy każdej przyszłej aktualizacji tej oferty.
category_idWymaganyLiczba całkowita identyfikująca kategorię produktu w eMAG; sprzedawcy nie mogą tworzyć ani modyfikować kategorii, a jedynie wybierać z istniejącego drzewa eMAG przez zasób category.
nameWymaganyCiąg znaków, 1–255 znaków.
part_numberWymaganyCiąg znaków, 1–128 znaków – numer części/modelu producenta, używany przez eMAG do wykrywania duplikatów produktów.
brandWymaganyCiąg znaków, 1–255 znaków.
sale_priceWymaganyLiczba dziesiętna większa od 0, do 4 miejsc po przecinku; cena bez VAT.
vat_idWymaganyLiczba całkowita wskazująca obowiązującą stawkę VAT.
stockWymaganyTablica obiektów warehouse_id/value – liczbowy stan dla każdego magazynu.
min_sale_price / max_sale_priceWymagane przy pierwszym zapisieGraniczne wartości dziesiętne; każda późniejsza aktualizacja sale_price musi mieścić się w tym przedziale, inaczej oferta zostanie odrzucona.
eanWymagany warunkowoTablica kodów kreskowych, 6–14 cyfr (EAN-8/13, UPC-A/E, GTIN-14 itp.); odpowiedź category/read informuje dla każdej kategorii, czy EAN jest obowiązkowy, czy opcjonalny.
imagesOpcjonalny, ale w praktyce wymaganyTablica adresów URL zdjęć; maks. 6000x6000 px i 8 MB na zdjęcie, tylko JPG/JPEG/PNG.
characteristicsOpcjonalny, ale w praktyce wymaganyTablica par id/value; każdy identyfikator cechy musi być prawidłowy dla wybranego category_id, inaczej zapis zostanie odrzucony jako niezgodność kategorii i cechy.
warrantyOpcjonalnyLiczba całkowita, liczba miesięcy gwarancji, 0–255 (domyślnie 0).
handling_timeOpcjonalnyTablica dni wysyłki/obsługi dla poszczególnych magazynów.

Jak połączyć eMAG z Feedance

  1. Uzyskaj zatwierdzenie konta sprzedawcy eMAG Marketplace i wygeneruj dane dostępowe API w panelu sprzedawcy.
  2. W Feedance dodaj eMAG jako miejsce docelowe i wprowadź te dane, aby Feedance mógł uwierzytelniać się w Marketplace API.
  3. Zmapuj pola katalogu produktów na schemat product_offer – name, part_number, brand, sale_price, vat_id, stock, EAN, zdjęcia oraz cechy specyficzne dla kategorii, których eMAG wymaga dla każdego category_id, w którym sprzedajesz.
  4. Ustaw granice min_sale_price / max_sale_price, aby przyszłe aktualizacje cen nie były po cichu odrzucane, gdy oferta będzie już aktywna.
  5. Pozwól Feedance zweryfikować zmapowany feed, podzielić go na zalecane przez eMAG partie po 10–50 obiektów na wywołanie save i wysłać – automatycznie rozkładając żądania w czasie, aby nie przekroczyć limitu zapytań eMAG, zamiast wysyłać wszystko naraz.
  6. Przeglądaj odpowiedzi isError / messages, które Feedance zwraca po każdym wysłaniu, aby odrzucone oferty (błędne powiązanie kategorii i cechy, cena poza przedziałem, nieprawidłowy EAN itp.) zostały oznaczone do poprawy, a nie po cichu znikały.

Jak często aktualizować feed?

Wytyczne eMAG dotyczące tempa zapytań są jednoznaczne: Marketplace API pozwala na maksymalnie 1 żądanie co 3 sekundy i 20 żądań na minutę na konto, a eMAG odradza planowanie wywołań na okrągłe, stałe godziny (np. zalecając start partii o 12:04:42 zamiast o 12:00:00), aby zadania wielu sprzedawców nie zbiegały się w tej samej sekundzie. W ramach tego limitu najczęściej warto aktualizować cenę i stany magazynowe – najlepiej przy każdej zmianie po twojej stronie, a co najmniej kilka razy dziennie – ponieważ nieaktualny stan na szybkim marketplace bezpośrednio kosztuje cię zamówienia, których nie zrealizujesz, lub pozycję względem konkurencyjnych ofert na tej samej stronie produktu. Pełna ponowna synchronizacja katalogu (nowe produkty, zaktualizowane opisy, zdjęcia, cechy) raz dziennie jest rozsądna dla większości sprzedawców; jeśli zamiast API korzystasz z Feed Import, plik jest tak aktualny, jak ostatnie pobranie twojego hostowanego adresu URL przez moduł Feed Import eMAG, więc sprawdź interwał odświeżania ustawiony w panelu sprzedawcy.

Najczęstsze błędy feedu

Najczęstsze odrzucenia opisane w dokumentacji Marketplace API eMAG to:

  • isError: true z tablicą messages – standardowa struktura błędu eMAG; każde żądanie trzeba sprawdzać pod tym kątem, zamiast zakładać sukces tylko dlatego, że zwróciło HTTP 200.
  • Nieprawidłowa cena (status walidacji 11) – pojawia się, gdy aktualizacja sale_price wypada poza przedział min_sale_price/max_sale_price ustawiony przy pierwszym zapisie oferty.
  • Walidacja EAN/marki/dokumentacji w toku lub odrzucona (statusy 1–8) – eMAG przeprowadza nowe oferty przez etapy walidacji Marketplace, marki, EAN i dokumentacji, zanim oferta zostanie zatwierdzona (status 9); źle sformatowany kod kreskowy (musi mieć 6–14 cyfr w rozpoznawanym formacie EAN/UPC/GTIN) to częsta przyczyna utknięcia na etapie EAN.
  • Niezgodność kategorii i cechy – wysłanie wpisu characteristics z identyfikatorem nieprawidłowym dla category_id oferty powoduje odrzucenie zapisu.
  • Błędy zdjęć – zdjęcia większe niż 6000x6000 px lub 8 MB albo w formacie innym niż JPG/JPEG/PNG są odrzucane.
  • HTTP 429 – przekroczony limit zapytań – zwracany po przekroczeniu 1 żądania na 3 sekundy lub 20 żądań na minutę, wraz z nagłówkami X-RateLimit-Limit-3second / X-RateLimit-Remaining-3second, które pozwalają zwolnić, zanim ponownie osiągniesz limit.

Wskazówki optymalizacyjne

  • Jeśli produkt już istnieje w katalogu eMAG, dołącz do niego swoją ofertę za pomocą part_number_key zamiast zgłaszać zupełnie nowy produkt – pozwala to pominąć ponowną walidację i szybciej uruchomić ofertę.
  • Od początku ustaw realistyczne granice min_sale_price/max_sale_price; zbyt wąski przedział oznacza, że rutynowe zmiany cen będą później odrzucane, a eMAG pozwala ustawić te wartości tylko przy pierwszym zapisie.
  • Za pierwszym razem podaj poprawny EAN – walidacja kodu kreskowego to jeden z wolniejszych etapów zatwierdzania, a odrzucony EAN blokuje uruchomienie całej oferty, nie tylko tego pola.
  • Uzupełniaj wszystkie obowiązkowe dla kategorii cechy, a nie tylko minimum potrzebne do przejścia walidacji – filtry w serwisie eMAG są budowane z tych wartości, a niekompletne cechy po cichu ograniczają znajdowalność twojej oferty podczas przeglądania kategorii.
  • Grupuj wywołania product_offer/save w zalecanym przez eMAG zakresie 10–50 obiektów i przesuwaj start swojego zadania poza okrągłe minuty, aby uniknąć kolizji z zaplanowanymi zadaniami innych sprzedawców w ramach limitu zapytań.
  • Traktuj każdą odpowiedź isError: true jako sygnał do działania, a nie kosmetykę – dokumentacja eMAG wskazuje, że niektóre nieudane zapisy są częściowo przetwarzane, co przy zignorowaniu błędu może pozostawić ofertę w niespójnym stanie.

FAQ

Czy eMAG używa feedu XML czy API JSON?
Istnieją oba. Marketplace API to JSON przesyłany uwierzytelnionymi żądaniami POST i to tę ścieżkę automatyzuje Feedance. eMAG oferuje też osobną opcję Feed Import, która przyjmuje hostowany plik XML lub CSV o rozmiarze do 100 MB, z maksymalnie 100 000 produktów i 150 kategoriami.

Czy jeden feed może obsłużyć jednocześnie Rumunię, Bułgarię i Węgry?
Każdy kraj ma własne konto Marketplace i własną instancję API/panelu sprzedawcy (emag.ro, emag.bg, emag.hu), więc z każdym łączysz się osobno, choć schemat i mechanizmy są takie same we wszystkich trzech.

Co się stanie, jeśli przekroczę limit zapytań API eMAG?
Otrzymasz odpowiedź HTTP 429 z komunikatem o przekroczeniu limitu. Limit eMAG to 1 żądanie co 3 sekundy i 20 żądań na minutę na konto.

Czy korzystanie z samego eMAG Marketplace API jest płatne?
Nie – za dostęp do API nie ma osobnej opłaty. Przychody eMAG pochodzą z prowizji zależnej od kategorii (ok. 7–25%) naliczanej od zrealizowanej sprzedaży, a nie od integracji czy wystawiania ofert.

Ile produktów mogę umieścić w jednym wywołaniu zapisu API?
Do 50 obiektów na wywołanie product_offer/save, przy czym dla niezawodnego przetwarzania zalecane jest 10–50, z ogólnym limitem 4000 elementów na wywołanie.

O eMAG

Emag to platforma e-commerce oferująca konsumentom szeroki wybór produktów. Została uruchomiona w 2001 roku, co czyni ją jednym z najstarszych i najbardziej ugruntowanych marketplace'ów internetowych. Krajem pochodzenia Emag jest Rumunia, a od tego czasu firma rozszerzyła działalność na inne kraje Europy Środkowo-Wschodniej.

Platforma zapewnia klientom zróżnicowany wybór produktów, w tym elektronikę, sprzęt AGD, modę, kosmetyki, sprzęt sportowy, artykuły dla domu i ogrodu i wiele więcej. Dzięki przyjaznemu interfejsowi i szerokiej ofercie Emag chce odpowiadać na różnorodne potrzeby i preferencje swoich klientów.

Jedną z kluczowych cech Emag jest silny nacisk na obsługę i zadowolenie klientów. Platforma stawia na płynne i niezawodne zakupy dzięki bezpiecznym metodom płatności, sprawnej dostawie i szybko reagującemu zespołowi obsługi klienta. To zaangażowanie w zadowolenie klientów pozwoliło jej przez lata zbudować grono lojalnych klientów.

Emag nawiązał też współpracę z wieloma markami i sprzedawcami, aby oferować klientom ogromny wybór produktów. Daje to klientom wiele możliwości i konkurencyjne ceny. Ponadto platforma często prowadzi kampanie promocyjne, rabaty i ekskluzywne oferty, aby jeszcze skuteczniej przyciągać i zatrzymywać klientów.

W ostatnich latach Emag dodatkowo rozszerzył swoje usługi, wprowadzając nowe funkcje, takie jak Emag Pay – cyfrowy portfel umożliwiający szybkie i bezpieczne płatności – oraz Emag Marketplace, który pozwala zewnętrznym sprzedawcom wystawiać i sprzedawać produkty na platformie.

Jako czołowa platforma e-commerce Emag otrzymał wiele wyróżnień i nagród za wkład w rozwój branży. Jego wzrost i sukces wynikają z dbałości o zadowolenie klientów, przywiązania do jakości i ciągłych innowacji zapewniających płynne zakupy online.

Podsumowując, Emag to ugruntowana platforma e-commerce, która powstała w Rumunii w 2001 roku. Oferuje klientom szeroki wybór produktów i skupia się na doskonałej obsłudze klienta. Stały wzrost i ekspansja sprawiły, że Emag jest popularnym wyborem przy zakupach online w Europie Środkowo-Wschodniej.

Zobacz, które
produkty zarabiają.

Połącz swój feed i GA4. Pokażemy Product Score, 4T, Price War i Broken Size na twoim własnym katalogu.