Accedi

Benvenuto al nostro Centro Assistenza

Ottieni aiuto con integrazione e campagne live.

Benvenuto al nostro Centro Assistenza. Ottieni aiuto con integrazione e campagne live.

Specifiche Feed Prodotto Criteo

1 - Panoramica

Un feed prodotto è un file che contiene informazioni in merito a tutti i prodotti sul tuo sito. Utilizzeremo queste informazioni per creare banner di prodotto dinamici.

In questo articolo, troverai i dettagli relativi a ciò che puoi includere nel tuo feed e come formattare ogni campo.

2 - Formati feed supportati da Criteo

Per essere sicuri che Criteo possa recuperare il tuo feed prodotto, utilizzare uno di questi formati:

Formato feed

Dettagli

Download

TSV

Questo formato è basato sul valore separato da tabulazione. L'intestazione deve essere dichiarata nella prima riga del file. I nomi del campo possono contenere spazi o trattini bassi (ad es. image_link or image link)

 Esempio feed

CSV

Questo formato è basato sul valore separato da virgola. L'intestazione deve essere dichiarata nella prima riga del file. I nomi del campo possono contenere spazi o trattini bassi (ad es. image_link or image link)

 Esempio feed

XML

Questo formato deve rispettare i criteri di base della struttura XML. I prodotti sono rappresentati da un set di nodi XML. L'elenco prodotto deve iniziare con tag di dichiarazione <?xml. 

 Esempio feed

 

 

3 - Informazioni prodotto da fornire

Tutti i nomi dei file devono essere in inglese. Le informazioni del prodotto non contengono tag HTML o tag di stile.

3.1 - Campi necessari per pubblicizzare i tuoi prodotti

3.1.1 ID

Questo campo è necessario per tutti i prodotti nel feed, e non può essere vuoto/bianco.

The ID is a unique product identifier that represents only one product. Once an ID is assigned to a product and imported, it may not be used for a different product, nor can the ID for a particular product change. If you have item_group_id also populated, populate ID with the child ID/SKU.

Character Requirements: The ID must only contain ASCII characters, and must not contain quotation marks.

Limite: 240

Tipo: Stringa

Esempio: abc123-black-7.5

3.1.2 titolo

Questo campo è necessario per tutti i prodotti nel feed, e non può essere vuoto/bianco.

Il titolo è il nome del prodotto, solitamente com'è visualizzato sulla pagina dettaglio del prodotto. Esso sarà usato come descrittore di testo principale nei banner per un dato prodotto. 

 

Requisiti carattere: il nome deve iniziare con una lettera o un numero.

Limite: 150

Tipo: Stringa

Esempio: stivali da lavoro – Misura 7.5

3.1.3 descrizione

The description is a short piece of text that gives more information about a product in addition to its name. Because of banners' design, shorter descriptions (under 50 characters) are more likely to fit in Criteo’s formats and layouts. However, not all formats and layouts will have a description.

Requisiti carattere: la descrizione deve iniziare con una lettera o un numero. Rimuovere tutti i tag HTML da questo campo, incluso i tag di stile, nascosti, oggetto e ancora.

Limite: 5000 

Tipo: Stringa

Esempio: eccellente per uso quotidiano.

3.1.4 google_product_category

Gli attributi Livello categoria indicano la categoria del prodotto da inviare, secondo la tassonomia prodotto Google.

Se il tuo prodotto può essere collegato a più categorie, vogliamo solo quella più importante.

Requisiti carattere: accettiamo entrambi gli ID e percorso categoria intero

Tipo: Stringa

Esempio: per donne > Scarpe > Stivali da lavoro O 2271

3.1.5 link

Questo campo è necessario per tutti i prodotti nel feed, e non può essere vuoto/bianco.

The link is the product’s dedicated detail page. The link is usually, although not necessarily, unique to a given product. The product information on this URL should match the corresponding information provided in your feed. Please specify the protocol (http:// or https://) for all URLs.

Requisiti carattere: il link deve iniziare con il protocollo (http:// o https://) seguito dall'URL completo della pagina dettaglio prodotto. Tutti i simboli devono essere codificati. Ad es. $ deve essere sostituito da %24.

Limite: 1024

Tipo: Stringa

Esempio: http://www.example.com/product/working-boots

3.1.6 image_link

Questo campo è necessario per tutti i prodotti nel feed, e non può essere vuoto/bianco.

The image_link is a URL that specifies a file path to a given product’s image. The image_link will be used to display the product’s image in the banners. Ideally, images should be at least 800x800 pixels and under 16MB. The image must have a Content-Type header specified, either image/png, image/gif or image/jpeg. If you restrict your images from being accessible via cURL, please whitelist our user-agent so we may display your images in the Criteo banners: curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn.

Requisiti carattere:  l'image_link deve iniziare con http:// o https:// seguito dall'URL completo dell'immagine del prodotto. Tutti i simboli devono essere codificati. Ad es. $ deve essere sostituito da %24.  

Limite: 2000

Tipo: Stringa

Esempio: http://www.example.com/product/image/working-boots.png

3.1.7 additional_image_link

 

 

The is the price the manufacturer recommends the product be sold for. If a given product is “on sale”, the price field would be populated with the higher price. The price should be in the same currency as the site. Only populate price with the numeric value using a period (.) as the decimal separator and no thousands separator.

Requisiti carattere: il separatore decimale deve essere un punto (.) con nessun separatore delle migliaia.

Limite: 14

Tipo: Stringa

Esempio: 1299.99

3.1.10 sale_price

Il sale_price è il prezzo a cui il prodotto è disponibile per l'acquisto sul sito, se un dato prodotto è 'in vendita', il sale_price deve essere inserito con il prezzo di vendita più basso. Il sale_price deve essere nella stessa valuta del sito. Solo un sale_price indicato con il valore numerico usando (.) come separatore decimale e non separatore di migliaia.

Requisiti carattere: il separatore decimale deve essere un punto (.) con nessun separatore delle migliaia.

 

Tipo: Stringa

Limite: 50

Esempio: 0001234560012

 

3.1.12  mpn 

MPN is the number that uniquely identifies the product to its manufacturer.

Limite: 70

Tipo: Stringa

Esempio: 4060882

 

3.1.13 marchio

 Questo campo è necessario per Criteo Sponsored Products

La marca indica il nome della marca del prodotto. Alcuni prodotti non hanno una marca chiara associata. In questo caso questa informazione non è necessaria.

Requisiti caratteri: il nome deve essere una lettera o un numero, e può contenere solo caratteri ASCII. Rimuovere tutti i tag HTML da questo campo, incluso i tag di stile.

Limite: 70

Tipo: Stringa

Esempio: Criteo

 

3.1.15 product_type

Questo campo è necessario per Criteo Sponsored Products

The product_type is a category (or list of categories) to which the product belongs. The product_type field lists your merchandising category, or set of merchandising categories for this product. It must match your website categories. Each level in the hierarchy needs to be delimited by " > ". If a product is available in multiple categories, please send the different categories as comma (,) delimited with the primary category first. product_type is case-sensitive, so if you use 'women’s' for one product and 'Women’s' for another, Criteo will interpret these as two different categories.

Requisiti carattere: il product_type deve iniziare con una lettera o un numero e può contenere solo caratteri ASCII. Il delimitatore tra le categorie deve essere > (&gt; per feed XML). Supportiamo solo il percorso categoria intero. Se un prodotto è disponibile in più categorie, inviare le diverse categorie come virgola (,) delimitate con la categoria principale prima. Non accettiamo l'ID categorie del percorso. Gli ID devono essere inseriti nel campo product_type_key. 

Limite: 500

Tipo: Stringa

Esempio:

  • Singolo: Computer &gt; tastiere e mouse &gt; mouse &gt; mouse wireless
  • Multiplo: Computer &gt; tastiere e mouse &gt; mouse &gt; mouse wireless, regali &gt; per papà &gt; mouse

3.1.16 product_type_key

Questo campo è necessario per Criteo Sponsored Products

Questo campo indica l'ID unico e la gerarchia per il product_type o set di product_type. Ogni chiave nella gerarchia deve essere delimitata da " > ". Se un prodotto è disponibile in più categorie, inviare come virgola (,) delimitate con la categoria principale nell'array prima.

Requisiti carattere: il product_type_key può contenere solo caratteri ASCII. Il delimitatore tra le categorie deve essere > (&gt; per feed XML). Se un prodotto è disponibile in più categorie, inviare le diverse categorie come virgola (,) delimitate con la categoria principale prima.

Limite: 500

Tipo: Stringa

Esempio:

  • Singolo: XY1 &gt; YZ1 &gt; Z1
  • Multiplo: XY1 &gt; YZ1 &gt; Z1 , AB1 &gt; BC2 &gt; A

3.1.17 number_of_reviews

Questo campo è raccomandato per Criteo Sponsored Products

This field contains the number of reviews for the product. number_of_reviews is required if you want this information to be displayed in the ad.

Limite: 8

Tipo: Numero intero

Esempio: 2456

3.1.18 product_rating

Questo campo è raccomandato per Criteo Sponsored Products

This field represents the rating of the product. product_rating is required if you want this information to be displayed in the ad.

Requisiti carattere: il separatore decimale deve essere un punto (.) con nessun separatore delle migliaia.

Limite: 8

Tipo: Stringa

Esempio: 4.5

3.1.19 filtri

Questo campo è necessario per Criteo Sponsored Products

filtri sono attributi per designare le differenze tra prodotti nella stessa categoria. I filtri dovrebbero essere forniti come un elenco separato da virgola di coppia di valore nome attributo. Essi devono corrispondere all'elenco di filtri disponibili sul proprio sito Web e corrispondere a questo prodotto. Ciò è critico per prodotti sponsorizzati Criteo.

Requisiti carattere le coppie Chiave=Valore devono essere separate da virgola (,) e più valori separati da barra (|).

Limite: 2000

Tipo: Stringa

Esempio: Colore=Rosso|Nero, Misura=XL, Dimensioni schermo = 15"

3.2 - Campi opzionali

3.2.1 mobile_link

The mobile_link is the link to the mobile-optimized version of your product landing page. This url should be different from the one that you provide in the 'link' field. By providing a mobile link: you will improve your customers’ user experience, and reduce the landing page loading latencies.

Requisiti carattere: il link deve iniziare con il protocollo (http:// o https://) seguito dall'URL completo della pagina dettaglio prodotto. Tutti i simboli devono essere codificati. Ad es. $ deve essere sostituito da %24.

Limite: 2000

Tipo: Stringa

Esempio: http://m.example.com/product/working-boots

3.2.2 condizione

La condizione è usata per qualificare il prodotto con tre diversi valori accettati: 'nuovo', 'rinnovato' e 'usato'.

Requisiti carattere: sono accettati solo 3 valori:

  • 'new' [nuovo]
  • 'refurbished' [rinnovato]
  • 'used' [usato]

Tipo: Stringa

Esempio: nuovo

---

Varianti prodotto

3.2.3 item_group_id

L'item_group_id è un identificatore di prodotto unico di livello principale. Esso può contenere caratteri alfanumerici che rappresentano un prodotto che può essere espresso come una raccolta di prodotti secondari. Una volta che un item_group_id è assegnato a un prodotto e importato, l'item_group_id non può essere usato per un prodotto diverso, né l'item_group_id può essere per un cambio di prodotto particolare. Poiché item_group_id può rappresentare una raccolta di prodotti, molti prodotti possono avere lo stesso valore dell'item_group_id

Requisiti carattere: l'item_group_id può contenere solo caratteri ASCII e non deve contenere virgolette.

Limite: 240

Tipo: Stringa

Esempio: abc123

 

3.2.4 colore

Dettagli: questo attributo indicherà il colore dominante del prodotto.

Limite: 100

Tipo: Stringa

Esempio: nero

3.2.5 genere

Necessario per tutti i prodotti in un gruppo di articoli che variano per genere.

Requisiti carattere: sono accettati solo 3 valori:

  • 'male' [uomo]
  • 'female' [donna]
  • 'unisex' [unisex]

Tipo: Stringa

Esempio: uomo

3.2.6 age_group

Questo attributo sarà usato per indicare il gruppo di età di destinazione per il proprio prodotto.

Requisiti di carattere: sono accettati solo 5 valori:

  • 'newborn' [neonato]
  • 'infant' [infante]
  • 'toddler' [bambino ai primi passi]
  • 'kids' [ragazzi]
  • 'adult' [adulto]

Tipo: Stringa

Esempio: adulto

3.2.7 materiale

Questo attributo indicherà il materiale o il tessuto di cui è costituito il prodotto. Necessario per tutti i prodotti in un gruppo di articoli che variano per materiale.

Limite: 200

Tipo: Stringa

Esempio: pelle

3.2.8 modello

This attribute indicates the pattern or the graphic print for the product. Required for all products in an item group that vary by pattern.

Limite: 100

Tipo: Stringa

Esempio: a strisce

3.2.9 misura

Questo attributo indicherà la misura del prodotto. Necessario per tutti i prodotti in un gruppo di articoli che variano per misura.

Limite: 100

Tipo: Stringa

Esempio: L

3.2.10 size_type

È possibile specificare il sistema di misura del paese del prodotto aggiungendo il modello di misura.

Requisiti di carattere: sono accettati solo 5 valori:

  • 'regular' [regulare]
  • 'petite' [petite]
  • 'plus' [plus]
  • 'big and tall' [grande e alto]
  • 'maternity' [maternità]

Limite: N/D

Tipo: Stringa

Esempio: regolare

3.2.11 size_system

Dettaglio: è possibile specificare il sistema di misura del paese del prodotto aggiungendo il modello di misura.

Requisiti carattere: ci sono 11 valori accettati: US, UK, EU, DE, FR, JP, CN (Cina), IT, BR, MEX, AU

Limite: N/D

Tipo: Stringa

Esempio: US

---

Per venditori marketplace

 

3.2.12 cross_sellers_product_id

Questo campo è necessario solo se sei un marketplace e stai rivendendo un prodotto per più venditori.

Il cross_sellers_product_id è un identificatore prodotto unico che raggruppa più id che si riferiscono allo stesso prodotto venduto da diversi venditori, Una volta che un cross_sellers_product_id è assegnato a un prodotto e importato, il cross_sellers_product_id non può essere usato per un prodotto diverso, né il cross_sellers_product_id può essere modificato per un particolare prodotto. Poiché cross_sellers_product_id rappresenta una raccolta di prodotti, più prodotti possono avere lo stesso valore per cross_sellers_product_id

Requisiti carattere: il cross_sellers_id deve iniziare con una lettera o un numero e può contenere solo caratteri ASCII.

Limite: 250

Tipo: Stringa

Esempio: abc123

3.2.13 seller_name

Questo campo è necessario solo se sei un marketplace e stai rivendendo un prodotto per più venditori.

Il seller_name identifica il nome visualizzato di un venditore. Questo nome è generalmente il nome visualizzato con un prodotto particolare sulla pagina di un venditore o nella casella di acquisto. Dovrebbe esserci un rapporto uno a uno tra seller_name e seller_id.

Limite: 200

Tipo: Stringa

Esempio: Il mio negozio di elettronica

3.2.14 seller_id

Questo campo è necessario solo se sei un marketplace e stai rivendendo un prodotto per più venditori.

Il seller_id è un identificatore unico che rappresenta un venditore sul sito del tuo venditore al dettaglio. Dovrebbe esserci un rapporto uno a uno tra seller_id e seller_name.

Limite: 200

Tipo: Stringa

Esempio: 3265fd

---

Informazioni spedizione

3.2.15 spedizione

Questo attributo sarà usato per specificare i dettagli di spedizione per ogni paese supportato, indicando il prezzo e il servizio

Tipo: Stringa

Esempio:

 <shipping>
<country>US</country>
<service>Standard</service>
<price>15.5 USD</price>
</shipping>

3.2.16 shipping_weight

shipping_weight rappresenta il peso del prodotto.

Requisiti carattere: sono accettate solo le seguenti unità: lb, oz, g, kg

Tipo: Stringa

Esempio: 1 kg

3.2.17 shipping_height

shipping_height rappresenta l'altezza del prodotto.

3.2.18 shipping_width

shipping_width rappresenta la larghezza del prodotto

3.2.19 shipping_length

Dettaglio: shipping_length rappresenta la lunghezza del prodotto.

3.2.20 shipping_label

Questo attributo può essere usato per assegnare etichette a prodotti specifici usando valori della tua scelta, come deperibile, voluminoso o promozione.

Limite: 100

Tipo: Stringa

Esempio: promozione

---

Confezione e rotolo del prodotto

3.2.21 multipack

Questo attributo specifica una confezione di prodotti identici.

Tipo: Numero intero

Esempio: 2

3.2.22 is_bundle

Questo attributo specifica un gruppo di prodotti diversi.

 Tipo: Booleano

Esempio: FALSO

3.2.23 promotion_id

Dettaglio: questo attributo specifica un ID promozione.

Limite: stringa

Tipo: 60

Esempio: 123654

3.2.24 promo_text

Dettagli: questo file contiene il testo promozionale per questo prodotto

Limite: stringa

Tipo: 60

Esempio: Acquisto speciale

---

Attributi aggiuntivi

3.2.25 custom_label_0

Aggiungere informazioni personalizzate aggiuntive relative al prodotto.

Requisiti carattere: sono autorizzati solo 5 livelli di etichetta personalizzata (da 0 a 4)

Limite: 100

Tipo: Stringa

 

3.2.27 adwords_redirect

URL per monitorare separatamente tutti i clic da Google Shopping.

Limite: 200

Tipo: URL

Esempio: http://www.mywebsite.com/productpage.html

3.2.28 excluded_destination

L'attributo 'destinazione esclusa' previene che un articolo appaia in determinate destinazioni anche se appare nei dati del tuo prodotto.

 

3.2.30 unit_pricing_measure

L'attributo 'misura prezzo unitario' definisce la misura e le dimensioni di un articolo. Ad es. 25floz o 15oz.

Esempio: 15oz

3.2.31 unit_pricing_base_measure

L'attributo 'misura base prezzo unitario' specifica la tua preferenza del denominatore del prezzo unitario. Ad es. 50floz.

Esempio: 50oz

3.2.32 display_ads_title

Se lo si desidera questo campo può essere usato per visualizzare un titolo diverso in Visualizza annunci pubblicitari (diverso da 'titolo').

Poiché titoli più brevi si adattano con maggiore probabilità alla nostra visualizzazione banner, ma titoli più lunghi funzionano meglio per Criteo Search, raccomandiamo titoli completi/lunghi in 'titolo' e titoli più brevi in 'display_ads_title'.

Limite: 150 (25 è raccomandato)

Tipo: Stringa

3.2.33 display_ads_value

Contiene il margine dell'articolo nella stessa valuta del prezzo dell'articolo. Può anche essere usato un multiplo del margine per nascondere il margine prodotto attuale, ma deve essere consistente tra i prodotti.

Limite valore : 10 volte il prezzo del prodotto

Tipo: Stringa

Esempio : 299,99

3.2.34 map_price

Il campo map_price rappresenta il "Prezzo inserzionista minimo" di un prodotto. Questo valore campo non è mai visualizzato nei nostri annunci pubblicitari e deve essere specificato se per qualche motivo non è possibile visualizzare negli annunci pubblicitari un prezzo inferiore a map_price. Se il prezzo corrente del prodotto è inferiore a map_price, il prezzo non sarà visualizzato nell'annuncio pubblicitario.

Requisiti carattere: Il separatore decimale deve essere un punto (.) con nessun separatore delle migliaia.

Tipo: Stringa

Esempio : 1299,99

3.2.34 model_number

Il model_number è usato per differenziare un prodotto dall'altro in una serie. Il model_number è spesso usato mediante marchi per differenziare prodotti simili nella stessa categoria. Lo stesso modello_numero può a volte apparire su varianti di prodotto simili con diversi valori id.

Limite: 200

Requisiti carattere: il model_number può contenere solo caratteri ASCII.

Tipo: Stringa

Esempio: AXY27

 

Esempio struttura catalogo

Esempio Feed XML

XML

<rss xmlns:g="http://base.google.com/ns/1.0"version="2.0">

    <channel>

        <title>Your Website</title>

        <link>http://www.yoursite.com/us/</link>

        <description>Your Website</description>

        <item>

            <g:id>abc123-black-7.5</g:id>

            <g:title>Working Boots Size 7.5</g:title>

            <g:description>Excellent for daily use</g:description>

            <g:google_product_category>Women’s > Shoes > Working Boots</g:google_product_category>

            <g:link>http://www.example.com/product/working-boots</g:link>

            <g:image_link>http://www.example/com/product/image/working-boots.png</g:image_link>

            <g:additional_image_link>http://www.example.com/product/image/working-boots-side.png</g:additional_image_link>

            <g:additional_image_link>http://www.example.com/product/image/working-boots-side_2.png</g:additional_image_link>

            <g:availability>in stock</g:availability>

            <g:price>1299.99</g:price>

            <g:sale_price>1199.99</g:sale_price>

            <g:gtin>0001234560012</g:gtin>

            <g:brand>Criteo</g:brand>

            <g:adult>no</g:adult>

            <g:product_type>Women’s &gt; Shoes &gt; Working Boots</g:product_type>

            <g:mobile_link>http://m.example.com/product/working-boots</g:mobile_link>

            <g:condition>new</g:condition>

            <g:availability>in stock</g:availability>

            <g:availability_date>2016-06-25T13:00-0800</g:availability_date>

            <g:sale_price_effective_date>2016-03-01T13:00-0800/2016-03-11T15:30-0800</g:sale_price_effective_date>

            <g:item_group_id>abc123</g:item_group_id>

            <g:color>Black</g:color>

            <g:gender>male</g:gender>

            <g:age_group>adult</g:age_group>

            <g:material>leather</g:material>

            <g:pattern>Striped</g:pattern>

            <g:size>L</g:size>

            <g:size_type>regular</g:size_type>

            <g:size_system>US</g:size_system>

            <g:shipping>

                <g:country>US</g:country>

                <g:service>Standard</g:service>

                <g:price>5.5 USD</g:price>

            </g:shipping>

            <g:shipping_weight>1 kg</g:shipping_weight>

            <g:shipping_label>promotion</g:shipping_label>

            <g:multipack>2</g:multipack>

            <g:is_bundle>FALSE</g:is_bundle>

            <g:custom_label_0>custom data 0</g:custom_label_0>

            <g:custom_label_1>custom data 1</g:custom_label_1>

            <g:custom_label_2>custom data 2</g:custom_label_2>

            <g:custom_label_3>custom data 3</g:custom_label_3>

            <g:custom_label_4>custom data 4</g:custom_label_4>

            <g:sale_price_effective_date>2016-03-01T13:00-0800/2016-03-11T15:30-0800</g:sale_price_effective_date>

            <g:adwords_redirect>http://www.mywebsite.com/productpage.html</g:adwords_redirect>

            <g:excluded_destination>Shopping</g:excluded_destination>

            <g:expiration_date>2016-07-24</g:expiration_date>

            <g:unit_pricing_measure>15oz</g:unit_pricing_measure>

            <g:unit_pricing_base_measure>50oz</g:unit_pricing_base_measure>

        </item>

    </channel>

</rss>

 



Questo articolo ti è stato utile?
Utenti che ritengono sia utile: 1 su 1
Powered by Zendesk