NovitàProduct Score, 4T Segmentation, Price War e Broken Size sono disponibili.Scopri le novità
Feedance
Logo di eMAGeMAGCanale · Marketplace e app
Integrazione con eMAG

Invia a eMAG i prodotti
che vale la pena mostrare

Feedance crea il tuo feed per eMAG e aggiunge a ogni prodotto etichette per punteggio, segmento 4T, posizione di prezzo e taglie mancanti, così ogni prodotto porta con sé il proprio segnale di performance.

Feed di prodotto eMAG
Generato da Feedance
Export XML, CSV o JSONAggiornato a ogni sincronizzazione
<item>
  <id>TS-1042</id>
  <title>T-shirt girocollo</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>
Etichette Feedance, scritte come etichette personalizzate
Cosa invia Feedance a eMAG

Un catalogo con un segnale di performance su ogni prodotto

eMAG legge i tuoi prodotti dal feed. Feedance invia un feed completo e valido, più i segnali che eMAG da solo non ha.

Product Scorecustom_label_0Un punteggio da 0 a 100 basato su visualizzazioni, aggiunte al carrello e acquisti a 1, 7 e 30 giorni.
Segmento 4Tcustom_label_1Top, Tolerable, Tranquil o Toxic, in base al traffico e al ritorno di ciascun prodotto.
Price Warcustom_label_2Più economico, allo stesso prezzo o più caro rispetto a concorrenti specifici.
Broken Sizecustom_label_3Segnala i modelli con la maggior parte delle taglie esaurite.
Creativitàimage_linkImmagini brandizzate da Creative Suite, con prezzo e dettagli della campagna presi dal feed.
Come usarlo: suddividi campagne, gruppi di prodotti o set di prodotti in base a queste etichette, ad esempio solo i prodotti Top, oppure tutto tranne i Toxic e i modelli con taglie mancanti. Gli slot delle etichette sono configurabili. Feedance non modifica le tue offerte né i tuoi budget.

Che cos'è eMAG?

eMAG è il più grande marketplace e-commerce della Romania e gestisce piattaforme Marketplace equivalenti in Bulgaria (emag.bg) e Ungheria (emag.hu) con lo stesso programma per venditori. I venditori terzi non vendono tramite un negozio separato: pubblicano le offerte direttamente sul catalogo prodotti di eMAG tramite eMAG Marketplace, e ogni offerta compete sulla stessa pagina prodotto con le inserzioni retail di eMAG e con quelle degli altri venditori del marketplace. eMAG offre ai venditori due modi per pubblicare e mantenere il catalogo: la eMAG Marketplace API (JSON, attualmente documentata alla versione 4.5.1) oppure un Feed Import XML/CSV ospitato che eMAG scarica e rielabora a intervalli programmati.

Perché collegare il tuo feed di prodotto a eMAG?

Reinserire manualmente i prodotti e digitare a mano le variazioni di stock o prezzo nel pannello venditore di eMAG non è sostenibile quando il catalogo supera qualche decina di SKU, ed è la principale causa di prezzi non aggiornati e overselling su un marketplace così dinamico. Alimentare eMAG in modo programmatico ti permette di inviare nuove offerte, variazioni di prezzo e livelli di stock dal tuo PIM o dal tuo negozio nel momento stesso in cui cambiano, invece che quando qualcuno si ricorda di accedere e modificare le inserzioni a mano. Ti permette inoltre di raggiungere tre mercati (Romania, Bulgaria e Ungheria) con gli stessi dati di prodotto di base, poiché tutti e tre funzionano con le stesse meccaniche di Marketplace API e Feed Import.

Come funziona il modello a commissione di eMAG

eMAG non applica costi di iscrizione, abbonamenti mensili né tariffe per inserzione. I venditori pagano una commissione basata sulla categoria solo sulle vendite completate, e la documentazione per i venditori di eMAG indica che la commissione 'varia tra il 7 e il 25%, a seconda della categoria' in cui il prodotto è pubblicato; la percentuale esatta per ogni categoria è stabilita nel contratto Marketplace del venditore. La commissione viene trattenuta automaticamente prima del pagamento, e i venditori vengono pagati due volte al mese. I venditori che aderiscono a Fulfilled by eMAG (FBE) pagano costi di stoccaggio aggiuntivi in base a quanto tempo la merce resta in un magazzino eMAG, più una tariffa di gestione per ordine che parte da 3,99 RON e cresce con dimensioni e peso del pacco.

Quale formato di feed richiede eMAG?

eMAG supporta due modalità di integrazione distinte, e Feedance si basa sulla modalità API perché offre il controllo più stretto su convalida e tempistiche degli aggiornamenti:

  1. Marketplace API (consigliata per l'automazione): payload JSON inviati tramite richieste POST autenticate a endpoint di risorse come product_offer, category e order (ad esempio product_offer/save, product_offer/read, product_offer/count). Ogni risposta è un JSON standardizzato contenente un booleano isError e un array messages, e una singola chiamata save è limitata a 50 entità (10-50 è l'intervallo che eMAG consiglia per un'elaborazione affidabile), con un limite massimo assoluto di 4000 elementi per chiamata.
  2. Feed Import (XML/CSV): un unico URL di file ospitato che il modulo Feed Import di eMAG riscarica secondo una pianificazione che configuri nel pannello venditore. Un file di feed è limitato a 100 MB, a un massimo di 100.000 prodotti e a un massimo di 150 categorie per feed.

Entrambe le modalità alimentano gli stessi record di prodotto/offerta, quindi la scelta dipende da quanto controllo in tempo reale ti serve sulle risposte di convalida e sulla gestione degli errori: per questo Feedance usa di default l'API JSON.

Quali attributi di prodotto sono obbligatori?

AttributoObbligatorio?Formato / note
idObbligatorioIntero da 1 a 16.777.215: il tuo ID prodotto interno, usato come chiave primaria per ogni futuro aggiornamento di questa offerta.
category_idObbligatorioIntero che identifica la categoria di prodotto eMAG; i venditori non possono creare o modificare categorie, ma solo selezionarle dall'albero esistente di eMAG tramite la risorsa category.
nameObbligatorioStringa, 1-255 caratteri.
part_numberObbligatorioStringa, 1-128 caratteri: il codice articolo/modello del produttore, usato da eMAG per individuare i prodotti duplicati.
brandObbligatorioStringa, 1-255 caratteri.
sale_priceObbligatorioDecimale, deve essere maggiore di 0, fino a 4 decimali; prezzo IVA esclusa.
vat_idObbligatorioIntero che fa riferimento all'aliquota IVA applicabile.
stockObbligatorioArray di oggetti warehouse_id/value: stock numerico per magazzino.
min_sale_price / max_sale_priceObbligatorio al primo salvataggioLimiti decimali; ogni successivo aggiornamento di sale_price deve rientrare in questa fascia, altrimenti l'offerta viene rifiutata.
eanObbligatorio a determinate condizioniArray di codici a barre, 6-14 caratteri numerici (EAN-8/13, UPC-A/E, GTIN-14 ecc.); la risposta di category/read indica per ogni categoria se l'EAN è obbligatorio o facoltativo.
imagesFacoltativo ma di fatto necessarioArray di URL di immagini; massimo 6000x6000 px e 8 MB per immagine, solo JPG/JPEG/PNG.
characteristicsFacoltativo ma di fatto necessarioArray di coppie id/value; ogni ID di caratteristica deve essere valido per il category_id scelto, altrimenti il salvataggio viene rifiutato per incongruenza tra categoria e caratteristica.
warrantyFacoltativoIntero, mesi di garanzia, 0-255 (default 0).
handling_timeFacoltativoArray di giorni di spedizione/gestione specifici per magazzino.

Come collegare eMAG a Feedance

  1. Fai approvare il tuo account venditore eMAG Marketplace e genera le credenziali API dal pannello venditore.
  2. In Feedance, aggiungi eMAG come destinazione e inserisci queste credenziali così Feedance può autenticarsi sulla Marketplace API.
  3. Mappa i campi del tuo catalogo prodotti sullo schema product_offer: name, part_number, brand, sale_price, vat_id, stock, EAN, immagini e le caratteristiche specifiche che eMAG richiede per ogni category_id in cui vendi.
  4. Imposta i limiti min_sale_price / max_sale_price così i futuri aggiornamenti di prezzo non vengano rifiutati senza avviso una volta che l'offerta è online.
  5. Lascia che Feedance convalidi il feed mappato, lo suddivida in blocchi da 10-50 entità per chiamata save come consigliato da eMAG e lo invii, dosando automaticamente le richieste per restare sotto il limite di frequenza di eMAG invece di inviare tutto in una volta.
  6. Controlla le risposte isError / messages che Feedance riporta da ogni invio, così le offerte rifiutate (abbinamento categoria-caratteristica errato, prezzo fuori fascia, EAN non valido ecc.) vengono segnalate per la correzione invece di sparire senza avviso.

Con quale frequenza dovrebbe aggiornarsi il feed?

Le indicazioni di eMAG sui ritmi sono esplicite: la Marketplace API consente al massimo 1 richiesta ogni 3 secondi e 20 richieste al minuto per account, ed eMAG sconsiglia di pianificare le chiamate a orari tondi e fissi (ad esempio è meglio avviare un blocco alle 12:04:42 anziché alle 12:00:00), così che i job di molti venditori non si sovrappongano nello stesso secondo. Entro questo limite, prezzo e stock sono i campi da aggiornare più spesso, idealmente ogni volta che cambiano dal tuo lato e almeno più volte al giorno, perché su un marketplace dinamico uno stock non aggiornato ti costa direttamente ordini che non puoi evadere o posizioni rispetto alle offerte concorrenti sulla stessa pagina prodotto. Una risincronizzazione completa del catalogo (nuovi prodotti, descrizioni aggiornate, immagini, caratteristiche) a cadenza giornaliera è ragionevole per la maggior parte dei venditori; se usi Feed Import invece dell'API, il file è aggiornato solo quanto l'ultima volta in cui il modulo Feed Import di eMAG ha riscaricato il tuo URL, quindi controlla l'intervallo di aggiornamento configurato nel pannello venditore.

Errori comuni del feed

I rifiuti più comuni documentati nel riferimento della Marketplace API di eMAG sono:

  • isError: true con un array messages: il formato standard di errore di eMAG; ogni richiesta va controllata per questo valore, invece di considerarla riuscita solo perché ha restituito HTTP 200.
  • Prezzo non valido (stato di convalida 11): si verifica quando un aggiornamento di sale_price esce dalla fascia min_sale_price/max_sale_price impostata al primo salvataggio dell'offerta.
  • Convalida di EAN/brand/documentazione in sospeso o rifiutata (stati 1-8): eMAG sottopone le nuove offerte a fasi di convalida Marketplace, brand, EAN e documentazione prima di approvarle (stato 9); un codice a barre malformato (deve avere 6-14 caratteri numerici in un formato EAN/UPC/GTIN riconosciuto) è una causa frequente di blocco nella fase EAN.
  • Incongruenza tra categoria e caratteristica: inviare una voce characteristics con un ID non valido per il category_id dell'offerta fa rifiutare il salvataggio.
  • Errori delle immagini: le immagini oltre 6000x6000 px o 8 MB, o in un formato diverso da JPG/JPEG/PNG, vengono rifiutate.
  • HTTP 429 limite di frequenza superato: restituito quando superi 1 richiesta ogni 3 secondi o 20 richieste al minuto, insieme agli header X-RateLimit-Limit-3second / X-RateLimit-Remaining-3second che puoi usare per rallentare prima di raggiungere di nuovo il limite.

Consigli di ottimizzazione

  • Se un prodotto esiste già nel catalogo eMAG, collega la tua offerta con part_number_key invece di inviare un prodotto completamente nuovo: salti la riconvalida e la tua offerta va online più velocemente.
  • Imposta fin dall'inizio limiti min_sale_price/max_sale_price realistici; una fascia troppo stretta significa che le normali variazioni di prezzo verranno poi rifiutate, ed eMAG ti permette di impostarli solo al primo salvataggio.
  • Inserisci l'EAN corretto al primo colpo: la convalida dei codici a barre è una delle fasi di approvazione più lente, e un EAN rifiutato blocca la pubblicazione dell'intera offerta, non solo di quel campo.
  • Compila ogni caratteristica obbligatoria per la categoria, non solo il minimo per superare la convalida: i filtri del sito eMAG si basano su questi valori, e caratteristiche incomplete riducono silenziosamente la reperibilità della tua offerta nella navigazione per categoria.
  • Raggruppa le chiamate product_offer/save nell'intervallo di 10-50 entità consigliato da eMAG e sposta l'orario di avvio dei tuoi job lontano dai minuti tondi per evitare conflitti di frequenza con i job programmati di altri venditori.
  • Tratta ogni risposta isError: true come un segnale da gestire, non come un dettaglio estetico: la documentazione di eMAG indica che alcuni salvataggi falliti vengono comunque elaborati in parte, il che può lasciare un'inserzione in uno stato incoerente se l'errore viene ignorato.

FAQ

eMAG usa un feed XML o un'API JSON?
Esistono entrambi. La Marketplace API usa JSON tramite richieste POST autenticate ed è la modalità che Feedance automatizza. eMAG offre anche un'opzione Feed Import separata che accetta un file XML o CSV ospitato, con un limite di 100 MB, 100.000 prodotti e 150 categorie.

Un solo feed può coprire contemporaneamente Romania, Bulgaria e Ungheria?
Ogni Paese ha il proprio account Marketplace e la propria istanza di API e pannello venditore (emag.ro, emag.bg, emag.hu), quindi ti colleghi a ciascuno separatamente, anche se schema e meccaniche sono gli stessi in tutti e tre.

Cosa succede se supero il limite di frequenza dell'API di eMAG?
Ricevi una risposta HTTP 429 con un messaggio di limite superato. Il limite di eMAG è di 1 richiesta ogni 3 secondi e 20 richieste al minuto per account.

L'uso della eMAG Marketplace API ha un costo?
No, non c'è una tariffa separata per l'accesso API. I ricavi di eMAG provengono dalla commissione basata sulla categoria (circa 7-25%) applicata sulle vendite completate, non dall'integrazione o dalla pubblicazione delle inserzioni.

Quanti prodotti posso includere in una singola chiamata di salvataggio API?
Fino a 50 entità per chiamata product_offer/save, con 10-50 consigliate per un'elaborazione affidabile, e un limite complessivo di 4000 elementi per chiamata.

Informazioni su eMAG

Emag è una piattaforma e-commerce che offre ai consumatori un'ampia gamma di prodotti. È stata lanciata nel 2001, il che la rende uno dei marketplace online più longevi e affermati. Emag è nata in Romania e da allora ha esteso le proprie attività ad altri Paesi dell'Europa centrale e orientale.

La piattaforma offre ai clienti un assortimento variegato che comprende elettronica, elettrodomestici, moda, bellezza, articoli sportivi, casa e giardino e molto altro. Con un'interfaccia facile da usare e un'ampia scelta di prodotti, Emag punta a soddisfare le diverse esigenze e preferenze dei suoi clienti.

Una delle caratteristiche principali di Emag è la forte attenzione al servizio clienti e alla soddisfazione. La piattaforma punta a offrire un'esperienza d'acquisto fluida e affidabile grazie a metodi di pagamento sicuri, servizi di consegna efficienti e un team di assistenza clienti reattivo. Questo impegno per la soddisfazione dei clienti è stato determinante per conquistare nel corso degli anni una clientela fedele.

Emag ha inoltre stretto partnership con diversi brand e venditori per offrire ai clienti un vasto assortimento di prodotti. Ciò consente di offrire più alternative e prezzi competitivi. La piattaforma propone spesso anche campagne promozionali, sconti e offerte esclusive per attirare e fidelizzare ulteriormente i clienti.

Negli ultimi anni Emag ha ampliato ulteriormente i suoi servizi lanciando funzionalità aggiuntive come Emag Pay, un portafoglio digitale che permette ai clienti di effettuare pagamenti rapidi e sicuri, ed Emag Marketplace, che consente a venditori terzi di pubblicare e vendere i propri prodotti sulla piattaforma.

In quanto piattaforma e-commerce di primo piano, Emag ha ricevuto diversi riconoscimenti e premi per il suo contributo al settore. La sua crescita e il suo successo sono dovuti alla dedizione alla soddisfazione dei clienti, all'impegno per la qualità e all'innovazione continua nell'offrire un'esperienza di shopping online fluida.

In conclusione, Emag è una piattaforma e-commerce affermata nata in Romania nel 2001. Offre ai clienti un'ampia varietà di prodotti e si concentra su un servizio clienti eccellente. La crescita costante e l'espansione di Emag l'hanno resa una scelta popolare per lo shopping online in Europa centrale e orientale.

Scopri quali
prodotti rendono.

Collega il tuo feed e GA4. Mostriamo Product Score, 4T, Price War e Broken Size sul tuo catalogo.