Feed di prodotti

I Feed sono strumenti di esportazione dinamica che trasformano i prodotti del tuo store in file strutturati (XML, CSV, JSON) seguendo una sintassi definita. Vengono generati automaticamente ogni notte (00:00 CET) e caricati sulla nostra Edge Network per essere consumati da marketplace, comparatori di prezzi o strumenti di marketing.

Path e Accessibilità

I feed vengono generati per ogni lingua attiva nel tuo store e sono accessibili tramite URL pubblico distribuito via CDN. Il pattern del percorso è: https://cdn.webround.com/{{userId}}/{{storeId}}/feeds/{{langCode}}/{{marketplaceName}}.{{format}}

Esempio: Supponiamo che tu abbia configurato la lingua italiana come unica lingua su Webround, che il tuo storeId sia 32d20f24-6c99-4e72-bdde-a25f91aabb91, che il tuo userId sia k9J2bWz7vM4nLpXqR1tG8sY3dF5A e che tu abbia creato il Feed con Marketplace Google_Shopping con estensione XML. Allora, in seguito alla generazione, il tuo file di feed si troverà all'indirizzo: https://cdn.webround.com/k9J2bWz7vM4nLpXqR1tG8sY3dF5A/32d20f24-6c99-4e72-bdde-a25f91aabb91/feeds/it/Google_Shopping.xml

---

Struttura del Feed

La configurazione di un feed si basa su due pilastri principali che definiscono la struttura del file:

1. Wrapper Template: Definisce la struttura esterna del file (es. l'header XML o l'intestazione CSV). Deve contenere il segnaposto {{items}}, dove verranno iniettati i prodotti.
2. Item Template: Definisce come deve essere rappresentata la singola variante di prodotto.

Segnaposti Disponibili (Dynamic Tags)

Puoi utilizzare i seguenti tag all'interno dei template per mappare i dati:

Tag	Descrizione
{{product.id}}	ID univoco del prodotto
{{product.name}}	Nome del prodotto (multilingua)
{{product.seoDescription}}	Descrizione SEO (multilingua)
{{product.htmlDescription}}	Descrizione HTML completa (multilingua)
{{variant.id}}	ID univoco della variante
{{variant.sku}}	SKU della variante
{{variant.ean}}	EAN
{{variant.gtin}}	GTIN
{{variant.mpn}}	MPN
{{variant.name}}	Nome della variante (multilingua)
{{variant.price}}	Prezzo netto (cadenza: once)
{{variant.comparePrice}}	Prezzo barrato
{{variant.availability}}	Disponibilità numerica (quantità)
{{variant.availabilityLabel}}	Disponibilità testuale (in stock / out of stock)
{{variant.quantity}}	Quantità in magazzino
{{variant.slug}}	Slug URL della variante
{{variant.weight}}	Peso in grammi
{{variant.weightKg}}	Peso in kg (es. 1.500)
{{variant.length}}	Lunghezza in cm
{{variant.width}}	Larghezza in cm
{{variant.height}}	Altezza in cm
{{variant.volume}}	Volume in cm³ (L×W×H)
{{variant.externalId}}	ID esterno (es. ID PrestaShop)
{{variant.metadata.X}}	Campo metadata variante (sostituisci X con la chiave)
{{product.metadata.X}}	Campo metadata prodotto (sostituisci X con la chiave)
{{asset.0}}	Immagine principale
{{asset.1}}	Seconda immagine
{{asset.2}}	Terza immagine
{{asset.N}}	N-esima immagine
{{asset.50}}	Cinquantesima immagine
{{tag.brand}}	Brand
{{tag.color}}	Colore
{{tag.material}}	Materiale
{{tag.size}}	Taglia/Misura
{{tag.gender}}	Genere
{{tag.age_group}}	Fascia età
{{tag.condition}}	Condizione
{{tag.product_type}}	Tipo prodotto
{{tag.energy_class}}	Classe energetica
{{tag.manufacturer}}	Produttore
{{tag.model}}	Modello
{{tag.pattern}}	Pattern
{{store.name}}	Nome dello store
{{store.domain}}	Dominio dello store

Multilingua

I dati multilingua vengono automaticamente risolti nella generazione, salvando un feed specifico per ogni lingua configurata sullo store.

---

Logica di Generazione

• Scoping: Il feed opera a livello di variante. Se un prodotto ha 5 taglie, verranno generati 5 elementi nel feed (necessario per marketplace come Google Shopping).
• Visibilità: Vengono esportate solo le varianti impostate come visibili.
• Ereditarietà: Se una variante eredita asset o dimensioni dal prodotto padre, il feed risolverà automaticamente i dati corretti.
• Filtri: Puoi collegare uno o più filterIds. In questo caso, il feed conterrà solo i prodotti che soddisfano i criteri dei filtri selezionati (es. solo prodotti di una certa categoria o brand).
• Sitemap: Contestualmente alla generazione dei feed, Webround aggiorna automaticamente la sitemap-products.xml per ottimizzare l'indicizzazione SEO.

---

Esempi di Configurazione

1. Google Shopping (XML)

Wrapper Template:

<?xml version="1.0"?>
<rss xmlns:g="http://base.google.com/ns/1.0" version="2.0">
  <channel>
    <title>{{store.name}}</title>
    <link>{{store.domain}}</link>
    <items>
      {{items}}
    </items>
  </channel>
</rss>

Item Template:

<item>
  <g:id>{{variant.id}}</g:id>
  <g:title>{{product.name}} - {{variant.name}}</g:title>
  <g:description>{{product.seoDescription}}</g:description>
  <g:link>{{store.domain}}/p/{{variant.slug}}</g:link>
  <g:image_link>{{asset.0}}</g:image_link>
  <g:price>{{variant.price}} EUR</g:price>
  <g:availability>{{variant.availabilityLabel}}</g:availability>
  <g:brand>{{tag.brand}}</g:brand>
  <g:gtin>{{variant.gtin}}</g:gtin>
</item>

2. Esportazione CSV Semplice

Wrapper Template:

id,sku,name,price,availability
{{items}}

Item Template:

"{{variant.id}}","{{variant.sku}}","{{product.name}}","{{variant.price}}","{{variant.availabilityLabel}}"

suggerimento

Puoi generare un feed su richiesta tramite il pulsante dopo averne creato uno.