Questa guida spiega come generare un file XML contenente l'intero catalogo prodotti, essenziale per sincronizzare i tuoi prodotti con piattaforme pubblicitarie e di vendita come Google Merchant Center, TikTok Shop o Facebook Catalog.
Poiché la generazione del feed avviene tramite un indirizzo web specifico (URL), la configurazione viene effettuata aggiungendo parametri all'indirizzo stesso.
1. Costruzione dell'URL Base
Per generare il feed, devi accedere a un URL specifico del tuo sito. L'URL base dipende dal formato e dalla piattaforma di destinazione.
1. Identifica il tuo dominio (es. https://tuosito.com).
2. Aggiungi il percorso del feed /api/plugin/ecommerceFeeds/.
3. Scegli il tipo di feed da generare:
| Piattaforma | Tipo di Feed | URL Base Esempio |
|---|---|---|
| Google Merchant / Standard | standard.xml | https://tuosito.com/api/plugin/ecommerceFeeds/standard.xml |
| TikTok Shop | tiktok.xml | https://tuosito.com/api/plugin/ecommerceFeeds/tiktok.xml |
> Nota: Se accedi a questo URL senza parametri aggiuntivi, verrà generato il feed completo di tutti i prodotti attivi.
2. Configurazione Avanzata del Feed (Filtri e Varianti)
Puoi personalizzare il contenuto del feed aggiungendo parametri di configurazione dopo un punto interrogativo (?) nell'URL base.
2.1. Inclusione delle Varianti (Taglia, Colore, Brand)
Se i tuoi prodotti hanno varianti (es. taglie o colori), devi specificare quali attributi devono essere mappati nei campi standard di Google/TikTok (color, size, brand).
Devi identificare l'ID numerico dell'attributo che rappresenta la Taglia, il Colore, ecc., nel tuo sistema di gestione prodotti.
| Scopo | Parametro | Esempio (Se l'ID 5 è il Colore) |
|---|---|---|
| Colore | v[c]=ID_ATTRIBUTO | ?v[c]=5 |
| Taglia | v[s]=ID_ATTRIBUTO | ?v[s]=12 |
| Brand | v[b]=ID_ATTRIBUTO | ?v[b]=8 |
Esempio di URL con Varianti:
Se vuoi includere le varianti Taglia (ID 12) e Colore (ID 5):
.../tiktok.xml?v[s]=12&v[c]=5
2.2. Filtrare per Categoria
È possibile includere o escludere prodotti in base alle categorie, utilizzando gli ID delle categorie.
| Scopo | Parametro | Esempio |
|---|---|---|
| Includi Categorie | include_cats=ID1,ID2 | ?include_cats=1,2,5 |
| Escludi Categorie | exclude_cats=ID1,ID2 | ?exclude_cats=10,11 |
2.3. Mappatura delle Etichette Personalizzate (Custom Labels)
Le etichette personalizzate (customlabel0 fino a customlabel4) sono utili per organizzare i prodotti nelle campagne pubblicitarie. Puoi mappare queste etichette a:
- Categorie: Per inserire la gerarchia di categorie del prodotto.
- Attributi: Per inserire il valore di un attributo specifico (ID numerico).
- Testo Fisso: Per inserire una stringa fissa.
| Etichetta | Parametro | Valore Esempio | Descrizione |
|---|---|---|---|
customlabel0 | c[0] | categories | Inserisce il percorso completo delle categorie. |
customlabel1 | c[1] | 15 | Inserisce il valore dell'Attributo con ID 15. |
customlabel2 | c[2] | Estate2024 | Inserisce la stringa fissa "Estate2024". |
3. Generazione del Feed Finale
Per generare il feed, incolla l'URL completo nel browser (o forniscilo alla piattaforma di destinazione).
Esempio di URL Completo (TikTok Shop):
Genera il feed per TikTok Shop, includendo le varianti Taglia (ID 12) e Colore (ID 5), e mappando customlabel0 al percorso delle categorie:
https://tuosito.com/api/plugin/ecommerceFeeds/tiktok.xml?v[s]=12&v[c]=5&c[0]=categories
Una volta aperto l'URL, il sistema elaborerà i dati e restituirà direttamente il file XML (o CSV, se richiesto) che potrai salvare o utilizzare per la sincronizzazione automatica.
> Importante: Il processo di generazione del feed può richiedere diversi secondi (fino a 120 secondi, a seconda del numero di prodotti) per evitare interruzioni.
