L'inventario deve essere caricato su Facebook usando un catalogo. Per ogni catalogo, deve essere fornito un elenco prodotti in uno dei formati supportati: CSV, TSV, RSS XML, ATOM XML o Fogli Google (per maggiori istruzioni, consultare l'articolo nel Centro assistenza).
Formato | Descrizione |
---|---|
CSV | Valori separati da virgole. Funziona con la maggior parte dei programmi con fogli di calcolo. La prima riga indica l'intestazione della colonna. Le righe successive forniscono i valori corrispondenti per ciascuna voce del catalogo. I campi contenenti spazi vuoti o virgole devono essere inclusi fra "virgolette doppie". Le virgolette doppie in un campo con virgolette doppie devono avere come carattere di escape due virgolette doppie consecutive. Esempio: I campi nidificati o con più valori, ad esempio image, possono essere rappresentati usando valori con codifica JSON o tramite una serie di colonne a testo semplice senza struttura, etichettate usando una sintassi con percorso in stile JSON. Esempio: Entrambe le convenzioni possono essere usate in modo intercambiabile all'interno dello stesso file. Consulta esempi di elenco CSV per le inserzioni del catalogo Advantage+ ed elenco CSV per le vendite. Scarica (clic con il tasto destro > Salva link con nome) Puoi fare riferimento ai nostri file CSV di esempio (.csv) mentre crei il tuo elenco, ma ti consigliamo di usare Gestore delle vendite come fonte principale. |
TSV | Valori separati da tabulazione. Funziona con la maggior parte dei programmi con fogli di calcolo. Consulta le linee guida per i file CSV. Scarica (clic con il tasto destro del mouse > Salva link con nome) |
RSS XML | Rich-Site Summary, Extensible Markup Language. Un nodo XML radice racchiude un insieme di nodi, ognuno dei quali rappresenta un percorso. Il file deve iniziare con il tag Solitamente è generato da sistemi di provider di elenchi automatizzati o server web. Scarica (clic con il tasto destro del mouse > salva link con nome)Se viene generato un errore, una riga nel file XML con elenco di dati è troppo lunga e supera la dimensione limite di 5 242 880 byte o caratteri. Riformatta il tuo XML in più righe con 1 campo per riga e carica di nuovo il tuo file. Per maggiori informazioni, consulta Risoluzione dei problemi relativi agli errori nell'elenco di dati. |
Atom XML | L'Atom Syndication Format è un linguaggio XML usato per i feed web, mentre l'Atom Publishing Protocol (AtomPub o APP) è un semplice protocollo basato su HTTP per creare e aggiornare risorse web. Il formato è generalmente generato da sistemi automatizzati di feed provider o server web. Un insieme di nodi XML rappresenta una lista di prodotti e deve iniziare con il tag di dichiarazione Scarica (clic con il tasto destro del mouse > Salva link con nome) |
Gestore delle vendite ora supporta anche Fogli Google per gli elenchi programmati:
id,title,description,availability,condition,price,link,image_link,brand,additional_image_link,age_group,color,gender,item_group_id,google_product_category,pattern,product_type,sale_price,sale_price_effective_date,size,FB_product_1234,Facebook T-Shirt (Unisex),A vibrant crewneck for all shapes and sizes. Made from 100% cotton.,in stock,new,9.99 USD,https://www.facebook.com/facebook_t_shirt,https://www.facebook.com/t_shirt_image_001.jpg,Facebook,https://www.facebook.com/t_shirt_image_002.jpg,adult,blue,unisex,FB1234_shirts,Apparel & Accessories > Clothing > Shirts,stripes1,Apparel & Accessories > Clothing > Shirts,4.99 USD,2017-12-01T0:00-23:59/2017-12-31T0:00-23:59,small,2.99 USD,2018-11-01T12:00-0300/2018-12-01T00:00-0300
id,title,description,rich_text_description,availability,condition,price,link,image_link,brand,additional_image_link,age_group,color,gender,item_group_id,google_product_category,product_type,sale_price,sale_price_effective_date,size,status,inventory FB_product_1234,Facebook T-Shirt (Unisex),A vibrant crewneck for all shapes and sizes. Made from 100% cotton.,"<p>A vibrant crewneck for all shapes and sizes. Made from 100% cotton.</p> <p> Made of 52% combed and ringspun cotton, 48% polyester.</p>",in stock,new,9.99 USD,https://www.facebookswagstore.com/American-Apparel-T-Shirt-P395.aspx,https://www.facebookswagstore.com/GetImage.ashx?Path=%7e%2fAssets%2fFB00-0967-Group_Full.jpg&maintainAspectRatio=true&maxHeight=400&maxWidth=400,Facebook,https://www.facebookswagstore.com/Assets/ProductImages/FB00-0475.jpg,adult,blue,unisex,FB1234_shirts,Apparel & Accessories > Clothing > Shirts & Tops,Apparel & Accessories > Clothing > Shirts,4.99 USD,2017-12-01T0:00-23:59/2017-12-31T0:00-23:59,small,2.99 USD,2018-11-01T12:00-0300/2018-12-01T00:00-0300,published,200 FB_product_1235,Facebook T-Shirt (Unisex),A vibrant crewneck for all shapes and sizes. Made from 100% cotton.,"<p>A vibrant crewneck for all shapes and sizes. Made from 100% cotton.</p> <p> Made of 52% combed and ringspun cotton, 48% polyester.</p>",in stock,new,9.99 USD,https://www.facebookswagstore.com/American-Apparel-T-Shirt-P395.aspx,https://www.facebookswagstore.com/GetImage.ashx?Path=%7e%2fAssets%2fFB00-0967-Group_Full.jpg&maintainAspectRatio=true&maxHeight=400&maxWidth=400,Facebook,https://www.facebookswagstore.com/Assets/ProductImages/FB00-0475.jpg,adult,blue,unisex,FB1234_shirts,Apparel & Accessories > Clothing > Shirts & Tops,Apparel & Accessories > Clothing > Shirts,4.99 USD,2017-12-01T0:00-23:59/2017-12-31T0:00-23:59,medium,2.99 USD,2018-11-01T12:00-0300/2018-12-01T00:00-0300,published,200 FB_product_1236,Facebook T-Shirt (Unisex),A vibrant crewneck for all shapes and sizes. Made from 100% cotton.,"<p>A vibrant crewneck for all shapes and sizes. Made from 100% cotton.</p> <p> Made of 52% combed and ringspun cotton, 48% polyester.</p>",in stock,new,9.99 USD,https://www.facebookswagstore.com/American-Apparel-T-Shirt-P395.aspx,https://www.facebookswagstore.com/GetImage.ashx?Path=%7e%2fAssets%2fFB00-0967-Group_Full.jpg&maintainAspectRatio=true&maxHeight=400&maxWidth=400,Facebook,https://www.facebookswagstore.com/Assets/ProductImages/FB00-0475.jpg,adult,blue,unisex,FB1234_shirts,Apparel & Accessories > Clothing > Shirts & Tops,Apparel & Accessories > Clothing > Shirts,4.99 USD,2017-12-01T0:00-23:59/2017-12-31T0:00-23:59,large,2.99 USD,2018-11-01T12:00-0300/2018-12-01T00:00-0300,published,200 FB_product_1237,Facebook T-Shirt (Unisex),A vibrant crewneck for all shapes and sizes. Made from 100% cotton.,"<p>A vibrant crewneck for all shapes and sizes. Made from 100% cotton.</p> <p> Made of 52% combed and ringspun cotton, 48% polyester.</p>",in stock,new,9.99 USD,https://www.facebookswagstore.com/American-Apparel-T-Shirt-P395.aspx,https://www.facebookswagstore.com/GetImage.ashx?Path=%7e%2fAssets%2fFB00-0967-Group_Full.jpg&maintainAspectRatio=true&maxHeight=400&maxWidth=400,Facebook,https://www.facebookswagstore.com/Assets/ProductImages/FB00-0475.jpg,adult,black,unisex,FB1234_shirts,Apparel & Accessories > Clothing > Shirts & Tops,Apparel & Accessories > Clothing > Shirts,4.99 USD,2017-12-01T0:00-23:59/2017-12-31T0:00-23:59,small,2.99 USD,2018-11-01T12:00-0300/2018-12-01T00:00-0300,published,200 FB_product_1238,Facebook T-Shirt (Unisex),A vibrant crewneck for all shapes and sizes. Made from 100% cotton.,"<p>A vibrant crewneck for all shapes and sizes. Made from 100% cotton.</p> <p> Made of 52% combed and ringspun cotton, 48% polyester.</p>",in stock,new,9.99 USD,https://www.facebookswagstore.com/American-Apparel-T-Shirt-P395.aspx,https://www.facebookswagstore.com/GetImage.ashx?Path=%7e%2fAssets%2fFB00-0967-Group_Full.jpg&maintainAspectRatio=true&maxHeight=400&maxWidth=400,Facebook,https://www.facebookswagstore.com/Assets/ProductImages/FB00-0475.jpg,adult,black,unisex,FB1234_shirts,Apparel & Accessories > Clothing > Shirts & Tops,Apparel & Accessories > Clothing > Shirts,4.99 USD,2017-12-01T0:00-23:59/2017-12-31T0:00-23:59,medium,2.99 USD,2018-11-01T12:00-0300/2018-12-01T00:00-0300,published,200 FB_product_1239,Facebook T-Shirt (Unisex),A vibrant crewneck for all shapes and sizes. Made from 100% cotton.,"<p>A vibrant crewneck for all shapes and sizes. Made from 100% cotton.</p> <p> Made of 52% combed and ringspun cotton, 48% polyester.</p>",in stock,new,9.99 USD,https://www.facebookswagstore.com/American-Apparel-T-Shirt-P395.aspx,https://www.facebookswagstore.com/GetImage.ashx?Path=%7e%2fAssets%2fFB00-0967-Group_Full.jpg&maintainAspectRatio=true&maxHeight=400&maxWidth=400,Facebook,https://www.facebookswagstore.com/Assets/ProductImages/FB00-0475.jpg,adult,black,unisex,FB1234_shirts,Apparel & Accessories > Clothing > Shirts & Tops,Apparel & Accessories > Clothing > Shirts,4.99 USD,2017-12-01T0:00-23:59/2017-12-31T0:00-23:59,large,2.99 USD,2018-11-01T12:00-0300/2018-12-01T00:00-0300,published,200
<?xml version="1.0" encoding="utf-8"?> <rss version="2.0" xmlns:g="http://base.google.com/ns/1.0" xmlns:atom="http://www.w3.org/2005/Atom"> <channel> <title>My Deal Shop Products</title> <description>Product Feed for Facebook</description> <link>https://www.mydealsshop.foo</link> <atom:link href="https://www.mydealsshop.foo/pages/test-feed" rel="self" type="application/rss+xml" /> <item> <g:item_group_id>SKU-123123</g:item_group_id> <g:gtin>12345678912345</g:gtin> <g:google_product_category>Toys & Games > Toys > Executive Toys > Magnet Toys</g:google_product_category> <g:id>SKU-123123-RED</g:id> <g:title>WidgetThing</g:title> <g:description>This product is the product you need to do the thing</g:description> <g:link>https://www.mydealsshop.foo/products/widgetthing</g:link> <g:image_link>https://cdn.mycdn.foo/files/123123123.jpg</g:image_link> <additional_image_link>https://cdn.mycdn.foo/files/123123123_image2.jpg</additional_image_link> <additional_image_link>https://cdn.mycdn.foo/files/123123123_image3.jpg</additional_image_link> <color>Red</color> <additional_variant_attribute> <label>Style</label> <value>Cool</value> </additional_variant_attribute> <g:brand>AcmeCo</g:brand> <g:condition>New</g:condition> <g:availability>in stock</g:availability> <g:price>19.99 USD</g:price> <g:sale_price>9.99 USD</g:sale_price> </item> <item> <g:item_group_id>SKU-123123</g:item_group_id> <g:gtin>12345678912346</g:gtin> <g:google_product_category>Toys & Games > Toys > Executive Toys > Magnet Toys</g:google_product_category> <g:id>SKU-123123-GREEN</g:id> <g:title>WidgetThing</g:title> <g:description>This product is the product you need to do the thing</g:description> <g:link>https://www.mydealsshop.foo/products/widgetthing</g:link> <g:image_link>https://cdn.mycdn.foo/files/123123123.jpg</g:image_link> <additional_image_link>https://cdn.mycdn.foo/files/123123123_image2.jpg</additional_image_link> <additional_image_link>https://cdn.mycdn.foo/files/123123123_image3.jpg</additional_image_link> <color>Green</color> <additional_variant_attribute> <label>Style</label> <value>Cool</value> </additional_variant_attribute> <g:brand>AcmeCo</g:brand> <g:condition>New</g:condition> <g:availability>in stock</g:availability> <g:price>19.99 USD</g:price> <g:sale_price>9.99 USD</g:sale_price> </item> </channel> </rss>
Per programmare il recupero degli elenchi di dati, consulta i formati suggeriti di seguito.
Formato elenco | Caso d'uso | Elenco di esempio |
---|---|---|
CSV | Aggiorna | Scarica (clic con il tasto destro del mouse e salva il link con nome) |
TSV | Reimposta | Scarica (clic con il tasto destro del mouse e salva il link con nome) |
I campi del catalogo sono fondamentali per la qualità dell'esperienza dei clienti che acquistano prodotti sul tuo Shop su Facebook o Instagram.
I campi del catalogo sono usati per popolare la pagina Dettagli del prodotto per ogni articolo. Questo include informazioni importanti come la descrizione del prodotto, immagini, varianti di dimensione/colore, prezzo e disponibilità. Dati mancanti o errati possono influire negativamente sull'esperienza utente, sulla conversione in acquisti o risultare fuorvianti e compromettere la fiducia.
La seguente tabella indica i campi usati per creare un catalogo, compreso il livello dei requisiti (obbligatorio vs. facoltativo). Per le convenzioni di denominazione delle colonne da best practice, usa l'inglese statunitense per tutti i campi.
Each field in your data feed represents information about your products. All field names and certain supported values must be in US English. The following fields are required for each product in your catalog. Note: If any required fields are missing or formatted incorrectly, products may not upload to your catalog.
Attribute and Type | Description |
---|---|
Type: string | Max character limit: 100 A unique content ID for the item. Use the item's SKU if possible. Each content ID must appear only once in your catalog. If there are multiple instances of the same ID, we ignore all instances. Note: For dynamic ads, this ID must exactly match the content ID for the same item in your Meta Pixel. Example: This field is required for supplementary feeds. Each item’s content ID must exactly match in the supplementary feed and the main feed it’s linked to. This indicates it’s the same item in both feeds. |
Type: string | Character limit: 200, but we recommend a maximum of 65 to avoid longer titles being cut off. A specific, relevant title for the item. See product title specifications. Example: This field is supported by supplementary feeds. |
type: string | Max character limit: 9999 A relevant description of the item. Include specific and unique product features, such as material or color. Use plain text (not HTML) and don't enter text in all capital letters or include any links. The description should be different than the title. See product description specifications. Example: A comfortable royal blue women's T-shirt in organic cotton. Cap sleeves and relaxed fit. Perfect for warm summer days. This field is supported by supplementary feeds. |
Type: string | The current availability of the item. Must be written in U.S. English. Supported values:
Items that are out of stock display as "sold out" in your shop. They don't display at all in your ads. Example: |
Type: string | The condition of the item. Supported values: Example: |
type: string | The price of the item. Format the price as a number, followed by a space and then the 3-letter ISO 4217 currency code (ISO 4217 standards). Always use a period (.) as the decimal point, not a comma (,). Don't include currency symbols such as $, € or £. To add product information and prices that will display for other countries or languages, upload a country feed or language feed to your catalog. Example: |
Type: string | The URL to the specific product page for the item on your business's website where people can learn more about or buy that exact item. Links must begin with http:// or https://, be valid and be hosted on your business’s website domain. Don't provide a link to a Facebook domain (such as your business's Facebook Page) or somewhere else. Example: |
Type: string | The URL for the main image of your item. Images must be in JPEG or PNG format, at least 500 x 500 pixels and up to 8 MB. See product image specifications. Example: Note: If you change the image later, the new image must use a different URL or the change won't be recognized. This field is supported by supplementary feeds. |
Type: string | Max characters: 100 The brand name of the item. Example: |
Checkout on Facebook and Instagram (US only) allows customers to complete purchases directly on Facebook and Instagram. To sell items with this checkout method, provide the following additional fields for each product in your catalog. If items are missing these fields, people won't be able to buy them or they may not show in your shop at all.
Attribute and Type | Description |
---|---|
Type: integer | The quantity of this item that you have available to sell on Facebook and Instagram. Enter a whole number. To prevent overselling, the item's quantity will be automatically reduced each time a purchase order is confirmed through checkout. Note: To display as in stock for checkout, an item's Example: This field was previously called |
Type: string | Required for items in specific product categories including clothing and shoes. Max character limit: 200 The size of the item. Enter the size as a word, abbreviation or number, such as "Small", "XL", "12" or "One Size". Example: This field is supported by supplementary feeds. |
You can also include many optional fields to share more product information with customers or control how items are displayed.
Attribute and Type | Description |
---|---|
Type: string | If the item is on sale, enter its discounted price. Use the same formatting as the Example: |
Type: two ISO-8601 timestamp | The date, time and time zone when your sale starts and ends. If you don't add this field, any items with a
Example (using PST time zone -08:00):
|
Type: string | Max character limit: 100 Allows you to set up variants of the same product, such as different sizes, colors or patterns. Enter the same group ID in this field for all variants of the same product to indicate they're part of a group. Learn more about product variants. Example: |
Type: string | Controls whether the item is active or archived in your catalog. Only active items can be seen by people in your ads, shops or any other channels. Supported values: Example: Note: Some partner platforms such as Shopify may sync items to your catalog with a status called staging, which behaves the same as This field was previously called |
Type: string | Maximum character limit: 2000 URLs for up to 20 additional images of your item, separated by a comma (,), semicolon (;), space ( ) or vertical bar (|). Follow the same image specifications as Since this field takes a string, the entire list of URLs must be formatted with double quotes. For example: To display additional images in your ads, see Dynamic Ads, Ad Template This field is supported by supplementary feeds. |
Type: string | Provide the most specific Google product category possible from this list: Excel (.xls) or Plain text (.txt). Enter either the category name (not case sensitive) or its ID number. Example: Learn more about product categories (Business Help Center article). Note: The category lists above are in US English. You can download other languages from Google Merchant Help Center. This field is supported by supplementary feeds. |
Type: string | Provide the most specific Facebook product category possible from this list: Spreadsheet (.csv) or Plain text (.txt). Enter either the category name (not case sensitive) or its ID number. Example: Learn more about product categories (Business Help Center article). Note: The category lists above are in US English. You can download other languages here. This field is supported by supplementary feeds. |
Category-specific fields | When you provide a Google or Facebook product category ( This field is supported by supplementary feeds. |
Type: string | Max character limit: 200 The main color of the item. Describe the color in words, not a hex code. Example: This field is supported by supplementary feeds. |
Type: string | The gender your item is targeted towards. Supported values: Example: This field is supported by supplementary feeds. |
Type: string | Max character limit: 200 The size of the item. Enter the size as a word, abbreviation or number, such as "Small", "XL", "12" or "One Size". Example: This field is supported by supplementary feeds. |
Type: string | The age group the item is targeted towards. Accepted values: Example: This field is supported by supplementary feeds. |
Type: string | Character limit: 200 Example: This field is supported by supplementary feeds. |
Type: string | Max character limit: 100 The pattern or graphic print on the item. Example: This field is supported by supplementary feeds. |
Type: string | This allows you to use a shipping-related overlay in your ads. Shipping details for the item, formatted as:
Example: |
Type: string | Shipping weight of the item in Example: |
Type: string | Add internal labels to help filter items when you create product sets. For example, you could add a “summer” label to all items that are part of a summer promotion and then filter those items into a set. Labels are only visible to you Enclose each label in single quotes (') and separate multiple labels with commas (,). Don’t include white spaces at the beginning or end of a label. Character limit: Up to 5,000 labels per product and 110 characters per label. Example (TSV, XLSX, Google Sheets): ['summer','trending'] Example (CSV): “['summer','trending']” Note: If you’re currently using custom labels ( This field was previously called |
Type: string | Max character limit: 100 Up to five custom fields for any additional information you want to filter items by when you create sets. For example, you could use a custom field to indicate all items that are part of a summer sale, and then filter those items into a set. This field supports any text value, including numbers. Example: This field is supported by supplementary feeds. |
Type: int | Up to five custom fields for any additional number-related information you want to filter items by when you create sets. This field allows you to filter by number ranges (is greater than and is less than) when you create a set. For example, you could use this field to indicate the year an item was produced, and then filter a certain year range into a set. This field supports whole numbers between 0 and 4294967295. It doesn't support negative numbers, decimal numbers or commas, such as -2, 5.5 or 10,000. Example: |
Type: string | Max characters: 9999 The rich text (HTML) description for item. Note: If this field is provided, we use it instead of Supported tags include:
Note: Any attributes of the html tags such as Example: <html> <p>Unisex cotton T-shirt with 3/4 length sleeves in royal blue. Great for everyday casual wear. Features graphic print of logo in white on upper left sleeve.</p> <ul> <li>100% Cotton</li> <li>Relaxed Fit</li> </ul> </html> This field is supported by supplementary feeds. |
Type: string | Max character limit: 750 Category the item belongs to, according to your business's product categorization system, if you have one. You can also enter a Google product category. For commerce, represents the product category in your internal system. Learn more about product categories for commerce. Example: |
Type: string | Up to 20 fields each containing a link to a video of your item. Must be a direct link to download the video file, not a link to a video player such as YouTube. The maximum video file size is 200 MB. Supported formats include: .3g2, .3gp, .3gpp, .asf, .avi, .dat, .divx, .dv, .f4v, .flv, .gif, .m2ts, .m4v, .mkv, .mod, .mov, .mp4, .mpe, .mpeg, .mpeg4, .mpg, .mts, .nsv, .ogm, .ogv, .qt, .tod, .ts, .vob and .wmv Example: http://www.jaspersmarket.com/product_video.avi This field is supported by supplementary feeds. |
Type: string | Additional attributes that are not core attributes (size, color, gender, pattern, and so on). Do not use a core attribute as an additional attribute. Learn more about Product Variants. Example: This field is supported by supplementary feeds. |
Type: string | Provide this information for any products customarily sold by a unit of measurement (for example "$10 / pound"). To specify this information, provide the following: Amount value: this is a float Centiliters: This information is uploaded via feed uploads in the {value: 10.0, currency: "USD", unit: "lb"} It can also be uploaded via XML as follows: <unit_price> <value>10</value> <currency>USD</currency> <unit>lb</unit> </unit_price> Example: Download a sample CSV file with an example of adding |
Type: string | The item’s Global Trade Item Number (GTIN). Providing a GTIN is recommended to help classify the item. The GTIN may appear on the barcode, packaging or book cover. Not all items have a GTIN. Only provide one if you’re sure it’s correct. Don’t include dashes or spaces. GTIN types:
Example: This field is supported by supplementary feeds. |
Type: string | Max characters: 100. The item’s manufacturer part number (MPN), a unique alphanumeric code assigned by the manufacturer in some industries to identify a specific item or part. It may appear on the packaging, label or etched directly onto the item. Providing a MPN is recommended to help classify the item if there is no GTIN. Not all items have a MPN. Only provide one if you’re sure it’s correct. Example: |
Type: date | Product expiration. If the product is expired, it won't be shown on Facebook. This date should follow the ISO‑8601 (YYYY‑MM‑DD) format. |
Type: string | Specify a return window for this item, which overrides your shop's default return window. Using this field in your data feed is an alternative to setting up a custom return window manually in Commerce Manager. Learn more about return windows. Indicate whether the item is final sale (true or false) and the number of days of the the return window (for final sale, enter 0 days). Example of an item with a 30 day return window: {is_final_sale: "false", return_policy_days: "30"} Example of a final sale item: {is_final_sale: "true", return_policy_days: "0"} |
Type: string | Link to mobile-optimized page for item on the merchant's website. |
Type: string | Provide deep links in feed following the App Links specification. Deep link information in feed takes precedence over any information we collect with App Links metadata with our web crawler. If you already have deep link information from App Links, you don't need to specify this data. Information from App Links is used to display the correct deep link. To display deep links in your ads, see Dynamic Ads, Ad Template. Supported applinks: For Android, we require Learn more about product deep links. |
| Used to control the channel visibility of each specific product in your catalog. With this feature, you can enable or disable your products from being displayed in Shops, Marketplace Shops, Instagram Product Tagging, Dynamic Ads, and Mini Shops. Learn more about |
Attribute and Type | Description |
---|---|
| The item's country of origin. Enter the two-letter ISO country code Example value: This field is supported by supplementary feeds. |
| If the country of origin is not India, provide the legal entity name of the item's importer Example value: This field is supported by supplementary feeds. |
| If the country of origin is not India, provide the operational address of the importer. This field uses a JSON structure, which contains the following fields:
The overall address will be displayed to users in the following format:
This example value: ` { street1: "1 Hacker Way", street2: "Building 18", city: "Menlo Park", region: "CA", postal_code: "94025", country: "US" } will be rendered as "1 Hacker Way, Building 18, Menlo Park, CA 94025 United States of America" This field is supported by supplementary feeds. |
| Required for Shops only. Information about the product's manufacturer, such as the manufacturer name and address. Example: The Manufacturer Co. - 1 Hacker Way, Menlo Park, CA 94025 USA This field is supported by supplementary feeds. |
| Required for selling on WhatsApp only. If the item is a non-physical good sold in India, such as a service, use this field to indicate that the item is exempt from providing the country of origin ( Supported values (case sensitive):
|
id
nel tuo file con elenco di dati secondario. Per pubblicare inserzioni del catalogo Advantage+, l'ID di ogni articolo deve corrispondere all'ID presente nell'elenco di dati del catalogo originale e all'ID contenuto del tuo pixel. override
. In questo campo, inserisci i codici ISO per le lingue o i Paesi per cui vuoi fornire informazioni localizzate. In questo campo, inserisci i codici ISO per le lingue o i Paesi per cui vuoi fornire informazioni localizzate. Il valore nella colonna override
deve essere un codice lingua ISO supportato o un codice Paese ISO supportato. Scopri di più sui codici delle lingue e dei Paesi supportati.price
, sale_price
, unit_price
, base_price
, status
(visibilità) e availability
devono essere forniti solo in un elenco per un Paese. Questi campi non possono essere forniti in un elenco per una lingua. Questo aiuta a garantire che i clienti vedano i dati corretti localizzati dei prodotti.Scopri di più sui campi id
e override
in Crea un elenco di dati con informazioni localizzate sull'inventario, passaggi 2 e 3.
title
description
availability
link
brand
price
sale_price
sale_price_effective_date
color
size
material
pattern
custom_label_0
custom_label_1
custom_label_2
custom_label_3
custom_label_4
short_description
additional_variant_attribute
applink.ios_url
, applink.ios_app_store_id
, applink.ios_app_name
, applink.android_url
, applink.android_package
, applink.android_app_name
, applink.windows_phone_url
, applink.windows_phone_app_id
, applink.windows_phone_app_name
, applink.ipad_url
, applink.ipad_app_store_id
, applink.ipad_app_name
Per localizzare qualsiasi campo applink, devi fornirli tutti. Scopri di più sui deep link dei prodotti.
image[0].url
, image[0].tag[0]
Per localizzare un'immagine, devi usare i campi immagine nidificati image[0].url
, image[0].tag[0]
. Il campo image_link
non è supportato per la localizzazione.
Per riferimento, consulta l'elenco principale dei campi per i prodotti.
name
description
base_price
sale_price
brand
url
neighborhood
longitude
latitude
image[0].url
, image[0].tag[0]
applink.ios_url
, applink.ios_app_store_id
, applink.ios_app_name
, applink.android_url
, applink.android_package
, applink.android_app_name
, applink.windows_phone_url
, applink.windows_phone_app_id
, applink.windows_phone_app_name
, applink.ipad_url
, applink.ipad_app_store_id
, applink.ipad_app_name
Per localizzare qualsiasi campo applink, devi fornirli tutti. Scopri di più sui deep link dei prodotti.
Per riferimento, consulta l'elenco principale dei campi per gli hotel.
description
url
origin_city
destination_city
price
one_way_price
image[0].url
, image[0].tag[0]
applink.ios_url
, applink.ios_app_store_id
, applink.ios_app_name
, applink.android_url
, applink.android_package
, applink.android_app_name
, applink.windows_phone_url
, applink.windows_phone_app_id
, applink.windows_phone_app_name
, applink.ipad_url
, applink.ipad_app_store_id
, applink.ipad_app_name
Per localizzare qualsiasi campo applink, devi fornirli tutti. Scopri di più sui deep link dei prodotti.
Per riferimento, consulta l'elenco principale dei campi per i voli.
name
description
url
price
neighborhood
longitude
latitude
image[0].url
, image[0].tag[0]
applink.ios_url
, applink.ios_app_store_id
, applink.ios_app_name
, applink.android_url
, applink.android_package
, applink.android_app_name
, applink.windows_phone_url
, applink.windows_phone_app_id
, applink.windows_phone_app_name
, applink.ipad_url
, applink.ipad_app_store_id
, applink.ipad_app_name
Per localizzare qualsiasi campo applink, devi fornirli tutti. Scopri di più sui deep link dei prodotti.
Per riferimento, consulta l'elenco principale dei campi per le destinazioni.
name
description
price
url
image[0].url
, image[0].tag[0]
Per riferimento, consulta l'elenco principale dei campi per gli annunci immobiliari.
title
description
price
sale_price
url
image[0].url
, image[0].tag[0]
Per riferimento, consulta l'elenco principale dei campi per i veicoli.
Ogni campo ha un massimo di 500 caratteri.
Nome | Descrizione |
---|---|
| Obbligatorio. Titolo dell'articolo. Supporta i cataloghi basati sul pixel. |
| Obbligatorio. Descrizione dell'articolo. Supporta i cataloghi basati sul pixel. |
| Obbligatorio. URL completo per la pagina del prodotto. Supporta i cataloghi basati sul pixel. |
| Obbligatorio per il link principale. Facoltativo per link di immagini aggiuntivi. Link all'immagine usata sulla pagina del prodotto. Il link dell'immagine principale è obbligatorio. Eventuali link di immagini aggiuntive sono facoltativi. Supporta i cataloghi basati sul pixel. |
| Obbligatorio se si utilizzano cataloghi multilingua. Specifica da quale versione del sito web proviene il prodotto; ad esempio |
| Obbligatorio. Prezzo attuale dell'articolo. Usa "." e non "," come separatore decimale. Non includere simboli, come "$" nel prezzo. Supporta i cataloghi basati sul pixel. Esempio: |
| Obbligatorio. Valuta per il prezzo in formato ISO. Supporta i cataloghi basati sul pixel. Esempio: |
| Obbligatorio. Nome del brand dell'articolo. Supporta i cataloghi basati sul pixel. |
| Obbligatorio. Disponibilità attuale dell'articolo: |
| Facoltativo. ID catalogo univoco per l'articolo. Può essere una variante di un prodotto. Questo viene associato al |
| Facoltativo. Limite massimo di caratteri: 250. Supporta i cataloghi basati sul pixel. Per le inserzioni del catalogo Advantage+, rappresenta valori predefiniti (ID stringa o categoria) dalla tassonomia dei prodotti Google. Per le vendite, rappresenta la categoria del tuo prodotto secondo la tassonomia dei prodotti Google. Scopri di più sulle categorie di prodotti per le vendite. Scopri di più sulla Categoria dei prodotti Google per articoli del catalogo, Centro assistenza per le inserzioni. |
| Obbligatorio. Condizione attuale dell'articolo: |
| Facoltativo. Limite massimo di caratteri: 100 Informazioni aggiuntive sull'articolo che vuoi includere. Supporta i cataloghi basati sul pixel. |
| Facoltativo. Determina il genere per la taglia: |
| Facoltativo. Per le inserzioni del catalogo Advantage+ - Articoli che sono varianti di un prodotto. Fornisci lo stesso item_group_id per tutti gli articoli che sono varianti. Ad esempio, una polo rossa è una variante della polo. Facebook associata questo valore al retailer_product_group_id una volta ricevuto il tuo elenco. Con le inserzioni del catalogo Advantage+, Facebook sceglie solo un articolo dal gruppo in base al segnale che riceviamo dal pixel o dall'evento nell'app. Per le vendite: fornisci lo stesso product_group_id per tutti gli articoli che sono varianti. Ad esempio, la polo rossa è una variante della polo. Facebook associa questo valore al retailer_product_group_id una volta ricevuto il tuo elenco. Scopri di più sulle varianti dei prodotti. Supporta i cataloghi basati sul pixel. Esempio: |
| Facoltativo. Global Trade Item Number (GTIN) del prodotto. Escludi trattini e spazi. Invia solo GTIN validi come definito dalla guida di convalida GTIN. I valori supportati sono Esempio: |
| Facoltativo. International Standard Book Number. Gli ISBN sono composti da 13 cifre. Supporta i cataloghi basati sul pixel. |
| Facoltativo. Codice univoco del produttore per l'articolo. Per le vendite, l'inventario delle offerte giornaliere deve includere anche il brand se viene fornito Esempio: |
| Facoltativo. Materiale con cui è realizzato l'oggetto. Valori supportati: Esempio: |
| Obbligatorio se si utilizzano cataloghi multilingua. Specifica da quale versione del sito web proviene il prodotto; ad esempio |
| Obbligatorio. Prezzo attuale dell'articolo. Usa "." e non "," come separatore decimale. Non includere simboli, come "$" nel prezzo. Supporta i cataloghi basati sul pixel. Esempio: |
| Obbligatorio. Valuta per il prezzo in formato ISO. Supporta i cataloghi basati sul pixel. Esempio: |
| Obbligatorio. ID del rivenditore dell'articolo. Supporta i cataloghi basati sul pixel. |
| Facoltativo. Prezzo scontato se l'articolo è in saldo. Usa "." come separatore decimale per il prezzo promozionale. Il prezzo promozionale è obbligatorio se intendi usare un overlay per prezzi scontati. Supporta i cataloghi basati sul pixel. Nota: in generale, per i cataloghi basati sul pixel, consigliamo di registrare qualsiasi cambiamento di prezzo usando il tag principale og:price:amount. Se usi il tag del prezzo promozionale, assicurati di usare anche i tag Esempio: |
| Facoltativo. Valuta del prezzo scontato se l'articolo è in promozione in un codice valuta ISO a 3 cifre. Supporta i cataloghi basati sul pixel. Esempio: |
| Facoltativo. Data e ora di inizio della promozione nel tuo fuso orario, scritte nel formato Esempio: |
| Facoltativo. Data e ora di fine della promozione nel tuo fuso orario, scritte nel formato Esempio: |
Ogni campo ha un massimo di 500 caratteri.
Nome | Descrizione |
---|---|
| Titolo dell'articolo. |
| Brand dell'articolo. |
| Descrizione dell'articolo. |
| ID del rivenditore dell'articolo. |
| URL completo per la pagina del prodotto. |
| Link all'immagine usata sulla pagina del prodotto. |
| Prezzo attuale dell'articolo. Non includere simboli, come "$" nel prezzo. Includi questa voce sotto "offerte". Formatta il prezzo come numero, seguito dal codice valuta ISO a 3 cifre (standard ISO 4217), con uno spazio tra costo e valuta. Usa il punto (".") come separatore decimale. Ti consigliamo di includere solo una (1) valuta nel tuo catalogo in modo che i clienti non vedano valute miste per i prodotti nelle inserzioni o nei canali di vendita. Per aggiungere informazioni su prodotti e prezzi che saranno visualizzati per altri Paesi o lingue, carica un elenco di Paesi o lingue nel tuo catalogo. |
| Valuta per il prezzo, in formato ISO (per esempio |
| Disponibilità attuale dell'articolo: |
| Condizione attuale dell'articolo: |
Ogni campo ha un massimo di 500 caratteri.
Nome | Descrizione |
---|---|
| Titolo dell'articolo. |
| Brand dell'articolo. |
| Descrizione dell'articolo. |
| ID del rivenditore dell'articolo. |
| URL completo per la pagina del prodotto. |
| Array di oggetti del tipo |
| Link all'immagine usata sulla pagina del prodotto. |
Nome | Descrizione |
---|---|
| Prezzo attuale dell'articolo. Non includere simboli, come "$" nel prezzo. Includi questa voce sotto "offerte". |
| Valuta per il prezzo, in formato ISO (per esempio |
| Disponibilità attuale dell'articolo: |
| Condizione attuale dell'articolo: |
Qui è disponibile un download di uno schema JSON di tutti i campi principali del catalogo e delle categorie:
Tieni presente che questo schema JSON non è un formato di elenco caricabile, ma è fornito come riferimento alternativo per campi, esempi e tipi di dati dell'elenco diversi da quelli già presenti nella nostra documentazione. Lo schema è pensato principalmente per gli sviluppatori che desiderano allineare programmaticamente la categoria interna e la mappatura dei campi con lo schema del catalogo di Meta. Consultare alla formattazione dell'elenco altrove in questa documentazione per gli elenchi caricabili.
Tutti i campi sotto la chiave common
saranno campi principali. Altrimenti, il nome della categoria sarà la chiave genitore. Il formato di ciascun campo segue questo esempio:
"item_group_id": { "description": "Use this field to create variants of the same item. Enter the same group ID for all variants within a group. Learn more about variants: https:\/\/www.facebook.com\/business\/help\/2256580051262113 Character limit: 100.", "example": "K456653443", "type": "String", "required": false, "recommended": false },
Per capire meglio la priorità, solo i campi specifici per categoria avranno un valore "recommended": true
(perché altrimenti sono tutti opzionali).