Distribuire la tua prima libreria di regole feed

Introduzione

Quando inizi a lavorare con i feed di prodotti, i dati grezzi provenienti dalle tue fonti raramente sono pronti per l'esportazione. Valori di disponibilità incoerenti, spazi bianchi non intenzionali, formati di prezzo variabili e altre anomalie sono comuni. Invece di creare regole da zero per risolvere ogni problema, puoi distribuire una libreria di regole preconfigurata che affronta questi problemi standard in pochi clic.

Questa guida ti insegnerà come esplorare le librerie di regole disponibili, visualizzare l'impatto su un campione dei tuoi prodotti e distribuire una libreria con un solo clic. Al termine, avrai un insieme di regole attive che normalizzano i dati a ogni esportazione, fornendoti una base solida su cui costruire regole personalizzate in futuro.

Prerequisiti

Prima di iniziare, assicurati di avere:

• Almeno una fonte di prodotto connessa o importata nel tuo account (ad esempio un feed CSV, un collegamento a Shopify o un'altra piattaforma di e-commerce).
• Accesso a livello Editor o superiore in DataHub per visualizzare e distribuire le regole.

Se non hai ancora configurato una fonte di prodotto, consulta la documentazione sulla connessione della tua piattaforma specifica prima di procedere.

Passaggio 1: Accedi all'area Regole in DataHub

Prima: I tuoi dati di prodotto rimangono grezzi e non standardizzati, senza alcuna regola applicata.

Procedura:

1. Accedi al tuo account e vai a DataHub.
2. Nel menu laterale, individua la sezione Regole.
3. Fai clic su Regole per aprire l'editor delle regole.

Vedrai una panoramica dello stato attuale delle tue regole. Se è la tua prima volta, l'area sarà vuota o mostrerà solo regole predefinite di base.

Dopo: Sei ora nell'area Regole, dove puoi visualizzare, creare e gestire tutte le regole del tuo feed.

Passaggio 2: Esplora le librerie di regole disponibili

Prima: Non sai quali librerie di regole sono disponibili o cosa fanno.

Procedura:

1. Nella pagina Regole, cerca il pulsante o il collegamento Librerie oppure Sfoglia librerie.
2. Fai clic per aprire il catalogo delle librerie di regole preconfigurate.
3. Vedrai almeno due categorie principali:
   - Normalizzazione dati: contiene regole per standardizzare formati comuni (spazi bianchi, valori di disponibilità, valute e simili).
   - Best practice: contiene regole che implementano linee guida del settore e standard di piattaforma.

Ogni libreria mostra una breve descrizione di ciò che fa e quali campi interesserà.

Dopo: Conosci le librerie disponibili e comprendi quale potrebbe adattarsi meglio al tuo flusso di lavoro.

Passaggio 3: Visualizza l'anteprima della libreria di normalizzazione dati

Prima: Non sai come la libreria di normalizzazione dati modificherà i tuoi prodotti reali.

Procedura:

1. Nella lista delle librerie, individua la libreria Normalizzazione dati.
2. Fai clic sul pulsante Anteprima o Visualizza anteprima.
3. Il sistema caricherà un campione dei tuoi prodotti e mostrerà il risultato dell'applicazione delle regole della libreria.
4. Esamina i campi modificati. Vedrai colonne come:
   - Campo: il nome del campo (ad esempio, availability, price, title).
   - Valore originale: come appariva il dato grezzo.
   - Valore trasformato: come apparirà dopo l'applicazione delle regole.

Per esempio, potrai vedere che il campo availability passa da valori incoerenti come 'In stock', 'in Stock', 'available' a un formato standardizzato come 'in stock'.

Dopo: Hai confermato che la libreria risolverà i problemi comuni nei tuoi dati e sei pronto a distribuirla.

Passaggio 4: Distribuisci la libreria con un clic

Prima: La libreria è visualizzata in anteprima, ma nessuna regola è ancora attiva nel tuo account.

Procedura:

1. Nella schermata di anteprima, individua il pulsante Distribuisci o Applica libreria.
2. Fai clic su di esso.
3. Il sistema ti chiederà di confermare. Leggi il messaggio di conferma per assicurarti che stai distribuendo la libreria corretta.
4. Fai clic su Conferma o Distribuisci per completare l'azione.
5. Attendi che il sistema elabori la distribuzione. Vedrai un messaggio di stato che indica il successo.

Dopo: La libreria è stata distribuita. Un record di distribuzione mostra la data, l'ora e lo stato (ad esempio, 'Distribuita con successo' il 15/01/2025).

Passaggio 5: Esamina le regole create dalla libreria

Prima: Non sai quali regole specifiche sono state create dalla libreria.

Procedura:

1. Torna alla pagina principale delle Regole.
2. Vedrai ora un elenco di regole attive generate dalla libreria distribuita.

3. Ogni regola mostra:
   - Il nome della regola (ad esempio, 'Normalizza valori di disponibilità').
   - Il campo interessato (ad esempio, availability, price, title).
   - La logica applicata (ad esempio, 'Rimuovi spazi iniziali e finali', 'Converti a minuscole').
   - Lo stato (attivo o inattivo).

4. Fai clic su una regola per visualizzarne i dettagli completi e, se necessario, modificarla per esigenze specifiche.

Dopo: Comprendi esattamente quali trasformazioni sono in corso e puoi ispezionare o estendere le regole in futuro.

Passaggio 6: Esegui un'esportazione di test per visualizzare l'effetto

Prima: Le regole sono attive, ma non hai visto l'effetto reale sui tuoi dati esportati.

Procedura:

1. Vai alla sezione Esportazioni o Test esportazione in DataHub.
2. Seleziona una fonte di prodotto importata da cui desideri esportare.
3. Fai clic su Esporta o Test esportazione.
4. Il sistema elaborerà i tuoi prodotti applicando tutte le regole attive.
5. Una volta completata l'esportazione, visualizza il Diff esportazione (differenza).

6. Nel diff, vedrai due colonne:
   - Dati grezzi: i valori originali senza regole.
   - Dati esportati: i valori dopo l'applicazione delle regole della libreria.

7. Scorri il diff per identificare i campi che sono stati modificati. Dovresti vedere miglioramenti come:
   - Spazi bianchi rimossi da title, description e altri campi di testo.
   - Valori di availability standardizzati.
   - Formati di prezzo coerenti.

Dopo: Hai confermato che le regole della libreria stanno funzionando come previsto e i tuoi dati sono ora più puliti e standardizzati.

Perché iniziare con una libreria di regole

Costruire regole da zero è possibile, ma richiede tempo e una profonda conoscenza dei problemi comuni nei dati dei prodotti. Le librerie di regole preconfigurate risolvono questo problema.

Le librerie di normalizzazione dati codificano correzioni comuni che la maggior parte dei commercianti deve affrontare:

• Rimozione di spazi bianchi iniziali e finali dai campi di testo.
• Standardizzazione dei valori di disponibilità (in stock, out of stock, preorder) in formati coerenti.
• Normalizzazione dei formati di prezzo e valuta.
• Pulizia di caratteri speciali e codifiche errate.
• Conversione di valori booleani in formati standardizzati.

Distribuendo una libreria, ottieni immediatamente una base solida di trasformazioni dati. Successivamente, puoi creare regole personalizzate per affrontare esigenze specifiche del tuo settore o piattaforma di destinazione.

Questo approccio riduce gli errori, accelera il time-to-market e assicura che i tuoi feed rispettino gli standard di settore sin dal primo giorno.

Checkpoint: cosa dovresti vedere

Una volta completata questa procedura, dovresti osservare:

1. Record di distribuzione: nella sezione Librerie o nella cronologia delle distribuzioni, vedrai un record che mostra:
   - Il nome della libreria distribuita (ad esempio, 'Normalizzazione dati').
   - La data e l'ora della distribuzione.
   - Lo stato 'Distribuita con successo'.

2. Elenco delle regole attive: nella pagina Regole principale, vedrai un elenco di regole attive generate dalla libreria. Ogni regola avrà un badge 'Attivo' e mostrerà il campo e la logica interessati.

3. Diff esportazione: quando esegui un'esportazione di test, il diff mostrerà chiaramente i campi modificati dalle regole. Dovresti vedere almeno alcune trasformazioni (ad esempio, spazi rimossi, valori standardizzati).

Se tutti e tre questi elementi sono presenti, la libreria è stata distribuita correttamente e le regole stanno normalizzando i tuoi dati come previsto.

Prossimi passi

Ora che hai una libreria di regole di base in atto, puoi:

• Creare regole personalizzate per affrontare problemi specifici dei tuoi dati.
• Distribuire librerie aggiuntive se necessario (ad esempio, best practice per piattaforme specifiche).
• Monitorare gli export regolari per assicurarti che i dati rimangono coerenti.
• Condividere la configurazione delle regole con il tuo team per garantire coerenza tra i feed.

La libreria di regole è il primo passo verso un flusso di feed robusto e affidabile.