Configurare un'API vtwonen

1

Passo 1: Crea una nuova connessione

• Vai a [Il tuo progetto] > Canali.

• Clicca +Aggiungi nuova API. Questo ti reindirizzerà alla pagina delle connessioni della tua azienda.

• Nella pagina delle connessioni, seleziona +Aggiungi un nuovo collegamento.

• Cerca il collegamento "vtwonen" sfogliando le pagine e selezionalo cliccandoci sopra.

• Aggiungi un'etichetta.

• Clicca Crea. Verrai reindirizzato a vtwonen per il passo successivo.

• Una volta reindirizzato, accedi usando le tue credenziali vtwonen.

Dopo aver effettuato l'accesso con successo, la connessione con vtwonen è pronta. Successivamente verrai riportato alla configurazione dell'API.

2

Passo 2: Crea l'API

Una volta creata la connessione, devi selezionare la tua nuova connessione vtwonen e configurare le impostazioni dell'API:

• Nella Nome campo, inserisci un nome per la tua API.

• Scegli la ID univoco per articolo dal menu a tendina. Consigliamo il campo 'id'.

• Seleziona il Lingua per la tua API.

• Clicca Continua per creare la tua API vtwonen.

3

Passo 3: Crea le tue inserzioni prodotto

Segui questi passaggi per configurare il tuo canale.

1

Classifica i tuoi prodotti

Per impostare i dati dei prodotti, assegna categorie ai tuoi prodotti.

• Categorizzazione prodotti tramite AI: Assegna automaticamente le categorie dei prodotti tramite il nostro algoritmo.

• Categorizzazione manuale: Assegna manualmente le categorie dei prodotti con regole personalizzate. Puoi creare filtri dettagliati per mappare ogni prodotto nella categoria corretta.

• Articoli non categorizzati: prodotti che devono ancora essere revisionati e categorizzati

Per saperne di più sulla categorizzazione per i marketplace

2

Imposta le regole

Le regole ti aiutano a ottimizzare rapidamente i dati dei prodotti per il marketplace su cui vuoi vendere.

• Modelli di regole: Regole comunemente usate che puoi adattare al tuo caso d'uso.

• Configurazione delle regole: Imposta regole per affinare i dati dei prodotti. Questo può includere filtrare, modificare o arricchire i campi per soddisfare i requisiti del marketplace.

Leggi di più sull’utilizzo delle regole per i marketplace

3

Costruisci le tue inserzioni

Il Build passo è dove configuri i tuoi annunci prodotto per soddisfare i requisiti del marketplace. È un passaggio essenziale per mettere i tuoi prodotti online ed evitare errori.

Campi obbligatori e opzionali:

• Campi obbligatori : Richiesto per pubblicare i tuoi prodotti su questo marketplace

• Consigliato : Consigliato per evitare errori

• Facoltativo : Non richiesto per la pubblicazione

Attributi condivisi

• Gli attributi condivisi sono i campi comuni che si applicano ai tuoi prodotti, come EAN, prezzi e titoli. Questo passaggio garantisce uniformità nelle informazioni di base across i tuoi annunci.

• Usa valori statici o dinamici:

  • Valori statici: valori fissi che non cambiano (es. nome del brand, produttore)

  • Valori dinamici: campi che cambiano automaticamente in base ai dati collegati (es. stock, prezzi)

Attributi specifici per categoria

• Gli attributi specifici per categoria sono campi che si applicano in modo specifico alla categoria dei tuoi prodotti. Questo passaggio aiuta a perfezionare le tue inserzioni per soddisfare i requisiti di categoria del marketplace.

• Compila gli attributi specifici per la categoria selezionata (es. taglia per l'abbigliamento o dimensioni per i mobili).

Scopri di più sul passo Build per i marketplace

4

Controlla la qualità della tua configurazione

Il Qualità Questo passo fornisce feedback sul tuo canale prima di attivarlo. Evidenzia errori obbligatori e opzionali per assicurarsi che i dati dei tuoi prodotti rispettino i requisiti per la pubblicazione sul marketplace.

• Risolvi gli errori, dando priorità prima a quelli obbligatori.

Azioni:

• Visualizza articoli: Visualizza i prodotti con problemi specifici.

• Per maggiori informazioni sull’attributo e sui valori accettati, passa il cursore su .: Reindirizza al Build passo per mappare le informazioni mancanti.

• Imposta categorie: Porta a Passo categorie passo per categorizzare gli articoli.

• Mostra sorgente: Disponibile per i campi ID. Porta a Impostazioni passo.

Scopri di più sul passo Qualità per i marketplace

5

Anteprima prima dell'attivazione

Il Anteprima Il passo mostra gli attributi che hai mappato nel Build passo, aiutandoti a verificare che tutto sia configurato correttamente fornendo una panoramica dei tuoi prodotti e degli eventuali errori.

Filtraggio:

• Filtra per errore: clicca il tutti menu a tendina e seleziona se vuoi filtrare per mostrare solo i prodotti con errori, o i prodotti con un errore specifico.

• Filtra per categoria: clicca il tutte le categorie menu a tendina e seleziona la categoria per cui vuoi filtrare.

Prima di continuare:

• Controlla gli attributi condivisi: Assicurati che tutti gli attributi condivisi obbligatori siano compilati.

• Controlla gli attributi specifici della categoria: Assicurati che tutti gli attributi obbligatori della categoria siano compilati.

• Controlla la presenza di errori: Correggi eventuali campi evidenziati in rosso.

Scopri di più sul passo Anteprima per i marketplace

4

Requisiti aggiuntivi per vtwonen

Questi requisiti di attributi sono specifici per vtwonen e si applicano agli attributi nella Build passo.

scheda Attributi condivisi

• Classe di spedizione (classe logistica): le classi logistiche determinano i rispettivi costi di spedizione per i tuoi articoli. Inserisci la classe logistica del tuo prodotto.

• Tempo di evasione della spedizione: il tempo di evasione indica il periodo necessario fino alla consegna del pacco al corriere. Indica il tempo di spedizione in giorni.

Requisiti del titolo

I titoli dei prodotti dovrebbero essere composti dai seguenti elementi:

Marca	Il nome del brand così come è registrato
Tipo di prodotto	La categoria del prodotto, per esempio "sofa". Deve essere scritta in minuscolo
Nome della serie/prodotto	La serie o il nome del prodotto che aiuta a identificare la variante del prodotto. Ogni parola deve essere scritta con la lettera iniziale maiuscola
Attributi	Le caratteristiche distintive del prodotto, per esempio colore, dimensioni o materiale

• Struttura: Brand Tipo di prodotto Nome - Attributi

• Esempio: lampada a sospensione vtwonen Titan - nero.

Descrizione del prodotto

Le descrizioni dei prodotti per la tua API vtwonen dovrebbero:

• rivolgersi al cliente (“tu” e “il tuo”)

• essere scritte con un tono amichevole, utile e rispettoso

• evitare gerghi o termini tecnici, se non rilevanti per il pubblico di riferimento

• descrivere le caratteristiche del prodotto e i benefici e l'esperienza d'uso

• usare parole chiave pertinenti

• non contenere abbreviazioni

Le descrizioni dei prodotti dovrebbero consistere di quanto segue:

Descrizione breve	Una panoramica del prodotto per mettere in evidenza le caratteristiche più importanti. HTML non consentito
Punti elenco	Le caratteristiche chiave e i benefici del prodotto. Minimo 3 e massimo 5 punti
Descrizione lunga	Informazioni dettagliate sulle caratteristiche, specifiche, materiali e modalità d'uso del prodotto. Anche consigli di styling e manutenzione. HTML consentito (grassetto e liste)

Requisiti delle immagini

Risoluzione minima	800 x 800 px
Risoluzione massima	4472 x 4472 px
Formati supportati	JPEG, PNG, WebP, GIF
Stile	Nessuna filigrana, logo o componenti testuali

Requisiti video

Durata	Tra 30 sec. e 2 min
Risoluzione	1080p o superiore
Formati supportati	.mp4, .mov, .avi, .flv
Stile	Niente bordi, schizzi, filigrane, loghi, etichette o prezzi

5

Buone pratiche

• Aggiunta di più valori di attributo: quando aggiungi più valori in un campo attributo per i marketplace Mirakl, separa ogni valore con il simbolo pipe "|" per garantire la corretta individuazione e gestione.

• ID prodotto del venditore per prodotti singoli/semplici: Esistono due attributi chiamati rispettivamente 'SellerArticleId' e 'SellerProductId'. 'SellerProductId' si riferisce all'ID Parent, mentre 'SellerArticleId' si riferisce agli articoli varianti. Per i prodotti singoli, entrambi gli attributi devono essere compilati con lo stesso valore.

Per maggiori informazioni sugli errori del marketplace Mirakl, how-to e best practice, consulta la nostra guida dedicata.

6

Passo 4: Invia le tue inserzioni prodotto a vtwonen

Una volta che le tue inserzioni prodotto sono pronte, devi inviarle a vtwonen:

• Se non hai attivato il progetto, vai su [Il tuo progetto] > Impostazioni e clicca Attiva progetto.

• In [Il tuo progetto] > Api, vai su [La tua vtwonenAPI] > Impostazioni.

• Clicca Attiva API.

• Una volta attivata l'Api, torna a Api.

• Clicca su Esegui pulsante nella colonna 'Status' per inviare le tue inserzioni prodotto a vtwonen.

7

Passo 5: Controlla le tue inserzioni prodotto per errori

• Per controllare gli errori, vai alla Risultato > scheda Errori. Qui c'è l'elenco delle inserzioni prodotto che contengono errori.

• Clicca sull'errore specifico per visualizzare maggiori informazioni su cosa causa l'errore.