應使用目錄將庫存上傳到 Facebook。針對每個目錄,應以下列其中一種支援的格式來提供產品摘要:CSV、TSV、RSS XML、ATOM XML 或 Google 試算表。
格式 | 說明 |
---|---|
CSV | 逗號分隔值。適用於大多數試算表程式。第一列指定資料欄標題。後續資料列提供各個路由的對應值。 包含空白字元或逗號的欄位應以半形雙引號("")括住。以半形雙引號括住的欄位中,若有半形雙引號,則必須以兩個連續半形雙引號逸出。 範例: 巢狀或多值欄位(例如圖像)可使用 JSON 編碼值表示,或以一組使用 JSON 路徑語法標記的「扁平化」純文字直欄表示。 範例: 您可以在同一個檔案中交替使用這兩種慣例。 請參閱高效速成+ 目錄廣告 CSV 摘要和商務 CSV 摘要的範例。 建立摘要時,您可以參考我們的 CSV(.csv)範例檔案,但建議您使用商務管理工具做為主要來源。 |
TSV | 定位符分隔值。適用於大多數試算表程式。請參閱 CSV 準則。 |
RSS XML | 豐富內容網站摘要、可延伸標記語言。XML 根節點含括一組節點,每個節點各代表一個路由。檔案開頭必須是 通常由自動化摘要供應商系統或網頁伺服器產生。 下載(點擊右鍵 > 另存連結)如果發生錯誤,表示 XML 資料摘要檔案中的字行太長,超過我們的 5,242,880 個位元組或字元大小限制。請將 XML 重新格式化成多行,每行 1 個欄位,然後重新上傳檔案。如需詳細資訊,請參閱針對資料摘要錯誤進行疑難排解。 |
Atom XML | Atom 供稿格式(Atom Syndication Format)是一種用於網頁摘要的 XML 語言,而 Atom 出版協定(Atom Publishing Protocol,簡稱 AtomPub 或 APP)是用來建立和更新網頁資源的簡易 HTTP 型通訊協定。此格式通常是由自動化的摘要供應商系統或網頁伺服器產生。一組商品 XML 節點代表一個產品清單,必須以 |
商務管理工具現在也支援使用 Google 試算表進行排程摘要:
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>
若要排定資料摘要擷取時程,請參閱下面的建議格式。
摘要格式 | 使用案例 | 摘要範例 |
---|---|---|
CSV | 為商品子集更新 | |
TSV | 為商品子集重置 |
目錄欄位有助於提升顧客在您的 Facebook 或 Instagram 商店購買產品的體驗品質。
目錄欄位可用來填入各項商品的產品詳細資料頁面,包括產品說明、圖像、尺寸/顏色款式、價格和供貨狀況等重要資訊。遺漏或錯誤的資料可能會對用戶體驗產生負面影響、影響購買轉換率,或可能造成誤導和降低信任。
下表定義用來建立目錄的欄位,包括需求等級(必要和選用)。為符合資料欄命名慣例最佳作法,所有欄位皆使用美式英文。
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, unique manufacturer part number (MPN) or Global Trade Item Number (GTIN) of the item. You only need to enter one of these, not all of them. For GTIN, enter the item's UPC, EAN, JAN or ISBN. 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: array<string> | Max array size: 5000 Max single tag size: 110 characters Array of technical tags which can be applied to a product for the purpose of creating product sets. The content of this field is never displayed to consumers; therefore, updating it will not trigger an integrity review. Use lowercase letters only, leading and trailing whitespaces are not allowed. Example: |
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 | Product's Global Trade Item Number (GTINs). Exclude dashes and spaces. Submit only valid GTINs as defined by the GTIN validation guide. Supported values are Example: This field is supported by supplementary feeds. |
Type: string | Max characters: 100. Unique manufacturer ID for item. For commerce, Daily Deals inventory must also include 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
欄位。若要投放高效速成+ 目錄廣告,每項商品的編號必須與該商品在原始目錄資料摘要中的編號,以及像素中的內容編號相符。 override
欄位。針對您想要提供本地化資訊的語言或國家/地區,在此欄位中輸入 ISO 代碼。針對您想要提供本地化資訊的語言或國家/地區,在此欄位中輸入 ISO 代碼。override
資料欄中的值應該是支援的 ISO 語言代碼或支援的 ISO 國碼/區碼。深入瞭解支援的語言代碼和國碼/區碼。請參閱使用本地化庫存資訊來建立資料摘要的步驟 2 和 3,深入瞭解 id
和 override
欄位。
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
若要本地化任何 applink 欄位,您必須提供所有 applink 欄位。深入瞭解產品深層連結。
image[0].url
、image[0].tag[0]
若要本地化圖像,您必須使用 image[0].url
、image[0].tag[0]
巢狀圖像欄位。image_link
欄位不支援本地化。
如需參考資料,請參閱產品的主要欄位清單。
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
若要本地化任何 applink 欄位,您必須提供所有 applink 欄位。深入瞭解產品深層連結。
如需參考資料,請參閱飯店的主要欄位清單。
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
若要本地化任何 applink 欄位,您必須提供所有 applink 欄位。深入瞭解產品深層連結。
如需參考資料,請參閱航班的主要欄位清單。
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
若要本地化任何 applink 欄位,您必須提供所有 applink 欄位。深入瞭解產品深層連結。
如需參考資料,請參閱目的地的主要欄位清單。
name
description
price
url
image[0].url
、image[0].tag[0]
如需參考資料,請參閱房地產廣告的主要欄位清單。
title
description
price
sale_price
url
image[0].url
、image[0].tag[0]
如需參考資料,請參閱汽車的主要欄位清單。
每個欄位最多可包含 500 個字元。
名稱 | 說明 |
---|---|
| 必要項目。 商品的標題。支援像素型目錄。 |
| 必要項目。 商品的說明。支援像素型目錄。 |
| 必要項目。 產品頁面的完整網址。支援像素型目錄。 |
| 主要連結的必要項目。針對附加的圖像連結,此為選用項目。 連結到產品頁面上使用的圖像。主要圖像連結為必要項目。任何附加的圖像連結皆為選用項目。支援像素型目錄。 |
| 若是使用多語言目錄,此為必要項目。 指定產品來自哪個網站版本;例如, |
| 必要項目。 商品的目前價格。針對分隔符號,請使用「.」來表示小數點,而不是使用「,」。請勿在價格中包含「$」等符號。支援像素型目錄。 範例: |
| 必要項目。 ISO 格式的價格幣別。支援像素型目錄。 範例: |
| 必要項目。 商品的品牌名稱。支援像素型目錄。 |
| 必要項目。 商品目前的供貨狀況: |
| 選用項目。 商品的專屬目錄編號。可以是產品的不同款式。匯入產品後,此編號對應於 |
| 選用項目。 字元上限:250。支援像素型目錄。 用於高效速成+ 目錄廣告時,這代表來自 Google 產品分類法的預先定義值(字串或類別編號)。 用於商務時,這代表根據 Google 產品分類法的產品類別。深入瞭解用於商務的產品類別。 |
| 必要項目。 商品目前情況: |
| 選用項目。 字元上限:100 您想要包含的其他商品相關資訊。支援像素型目錄。 |
| 選用項目。 決定用來設定尺寸的性別: |
| 選用項目。 用於高效速成+ 目錄廣告時 - 這些商品是產品的不同款式。請為所有不同款式的商品提供相同的 item_group_id。例如,紅色 Polo 衫是 Polo 衫的一種款式。Facebook 取得您的摘要後,就會將此值對應至 retailer_product_group_id。透過高效速成+ 目錄廣告,Facebook 會根據我們從像素或應用程式事件收到的訊號,從群組中只挑選一項商品出來。 用於商務時 - 請為所有不同款式的商品提供相同的 product_group_id。例如,紅色 Polo 衫是 Polo 衫的一種款式。Facebook 取得您的摘要後,就會將此值對應至 retailer_product_group_id。深入瞭解「產品款式」。支援像素型目錄。 範例: |
| 選用項目。 產品的全球貿易商品編號(GTIN)。請勿包含破折號和空格。僅限提交 GTIN 驗證指南定義的有效 GTIN。支援的值為 範例: |
| 選用項目。 國際標準圖書編號。ISBN 由 13 碼數字組成。支援像素型目錄。 |
| 選用項目。 商品的專屬製造商零件編號。用於商務時,若有提供 範例: |
| 選用項目。 商品的製造材料。支援的值: 範例: |
| 若是使用多語言目錄,此為必要項目。 指定產品來自哪個網站版本;例如, |
| 必要項目。 商品的目前價格。針對分隔符號,請使用「.」來表示小數點,而不是使用「,」。請勿在價格中包含「$」等符號。支援像素型目錄。 範例: |
| 必要項目。 ISO 格式的價格幣別。支援像素型目錄。 範例: |
| 必要項目。 商品的零售商編號。支援像素型目錄。 |
| 選用項目。 折扣價(若為促銷商品)。請使用「.」做為優惠價的小數點。如果您打算使用疊加折扣價,就必須提供優惠價。支援像素型目錄。 注意:一般來說,針對像素型目錄,我們建議使用主要 og:price:amount 標籤,僅擷取價格的任何變更。如果您使用優惠價標籤,也請務必使用 範例: |
| 選用項目。 商品促銷時的折扣價幣別,3 碼的 ISO 幣別代碼。支援像素型目錄。 範例: |
| 選用項目。 您所在時區的促銷活動開始日期和時間,寫作 範例: |
| 選用項目。 您所在時區的促銷活動結束日期和時間,寫作 範例: |
每個欄位最多可包含 500 個字元。
名稱 | 說明 |
---|---|
| 商品的標題。 |
| 商品的品牌。 |
| 商品的說明。 |
| 商品的零售商編號。 |
| 產品頁面的完整網址。 |
| 連結到產品頁面上使用的圖像。 |
| 商品的目前價格。請勿在價格中包含「$」等符號。請在「優惠」下方加入此項目。以數字格式標示價格,後面接著 3 碼 ISO 幣別代碼(ISO 4217 標準),成本和幣別之間空一格。使用句點(「.」)做為小數點。 建議您在目錄中只包含一(1)種幣別,這樣顧客才不會在您的廣告或商務通路中看到產品的混合幣別。若要新增顯示於其他國家/地區或語言的產品資訊和價格,請將國家/地區摘要或語言摘要上傳到您的目錄。 |
| ISO 格式的價格幣別(例如 |
| 商品目前的供貨狀況: |
| 商品目前情況: |
每個欄位最多可包含 500 個字元。
名稱 | 說明 |
---|---|
| 商品的標題。 |
| 商品的品牌。 |
| 商品的說明。 |
| 商品的零售商編號。 |
| 產品頁面的完整網址。 |
|
|
| 連結到產品頁面上使用的圖像。 |
名稱 | 說明 |
---|---|
| 商品的目前價格。請勿在價格中包含「$」等符號。請在「優惠」下方加入此項目。 |
| ISO 格式的價格幣別(例如 |
| 商品目前的供貨狀況: |
| 商品目前情況: |
我們在這裡提供所有目錄主要欄位和類別欄位的 JSON 結構描述檔下載:
請注意,此 JSON 結構描述檔不是可上傳的摘要格式,而是在我們文件中既有的內容之外,另供參考的替代摘要欄位、範例和資料類型。該結構描述檔主要適用於想要以程式設計方式使內部類別和欄位對應方式與 Meta 目錄結構描述檔一致的開發人員。如需可上傳的摘要,請遵循本文件其他部分的摘要格式。
common
索引鍵下的所有欄位都會是主要欄位。否則,類別名稱會是上層索引鍵。每個欄位的格式皆遵循此範例:
"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 },
請注意,只有類別特定的欄位才會有 "recommended": true
值(因為這些都是選用性欄位),這是瞭解優先順序的最佳方式。