참고 자료 - 카탈로그

지원되는 피드 형식

카탈로그를 사용하여 인벤토리를 Facebook에 업로드해야 합니다. 각 카탈로그에서 제품 피드는 지원되는 형식(CSV, TSV, RSS XML, ATOM XML, Google 스프레드시트) 중 하나로 제공해야 합니다(자세한 지침은 고객 센터 문서 참조).

형식	설명
CSV	쉼표로 구분된 값입니다. 대부분의 스프레드시트 프로그램에서 사용할 수 있습니다. 첫 번째 행에는 열 제목을 지정하고, 그다음 행부터는 각 경로의 해당 값을 입력합니다. 공백이나 쉼표가 포함된 필드는 '큰따옴표'로 묶어야 합니다. 큰따옴표로 묶은 필드 안의 큰따옴표는 두 개의 연속된 큰따옴표로 이스케이프해야 합니다. 예: `"Join our ""Royal"" membership program"`. 중첩된 필드 또는 다중값 필드(예: 이미지)는 JSON 인코딩된 값을 사용하거나 JSON 경로 구문을 사용하여 레이블이 지정된 '병합된' 일반 텍스트 열의 세트로 나타날 수 있습니다. 예: `image[0].url`, `image[0].tag[0]`, `image[0].tag[1])` 같은 파일 내에서 두 규칙은 상호 교환 가능합니다. 어드밴티지+ 카탈로그 광고용 CSV 피드 및 커머스용 CSV 피드 예시를 참조하세요. 다운로드(마우스 오른쪽 버튼 클릭 > 다른 이름으로 링크 저장) 피드를 만들 때 CSV(.csv) 예제 파일을 참조할 수 있으나 커머스 관리자를 기본 소스로 사용하는 것이 좋습니다.
TSV	탭으로 구분된 값입니다. 대부분의 스프레드시트 프로그램에서 사용할 수 있습니다. CSV 가이드라인을 참조하세요. 다운로드(마우스 오른쪽 버튼 클릭 > 다른 이름으로 링크 저장)
RSS XML	리치 사이트 요약, 확장 가능한 마크업 언어입니다. 루트 XML 노드는 노드 세트를 포함하며 각각의 노드가 하나의 경로를 나타냅니다. 파일은 `declaration` 태그로 시작해야 합니다. 형식은 일반적으로 자동화된 피드 공급자 시스템이나 웹 서버를 통해 생성됩니다. 품목 XML 노드 세트는 제품 리스트를 나타내며 `<?xml` 선언 태그로 시작해야 합니다. 일반적으로 자동화된 피드 공급자 시스템이나 웹 서버에 의해 생성됩니다. 다운로드(마우스 오른쪽 버튼 클릭 > 다른 이름으로 링크 저장) 오류가 발생하는 경우, 이는 XML 데이터 피드 파일의 줄이 너무 길고 크기 제한인 5,242,880바이트 또는 문자를 초과했음을 의미합니다. 여러 줄로 분할하고 각 줄당 하나의 필드를 포함하도록 XML 형식을 수정한 다음 파일을 다시 업로드하세요. 자세한 내용은 데이터 피드 오류 문제 해결을 참조하세요.
Atom XML	Atom Syndication Format은 웹 피드에 사용하는 XML 언어이고 Atom Publishing Protocol(AtomPub 또는 APP)은 웹 리소스를 만들고 업데이트하기 위한 단순한 HTTP 기반 프로토콜입니다. 형식은 일반적으로 자동화된 피드 공급자 시스템이나 웹 서버를 통해 생성됩니다. 품목 XML 노드 세트는 제품 리스트를 나타내며 `<?xml` 선언 태그로 시작해야 합니다. 일반적으로 자동화된 피드 공급자 시스템이나 웹 서버에 의해 생성됩니다. 커머스용 XML 피드(Atom) 예시를 참조하세요. 다운로드(마우스 오른쪽 버튼 클릭 > 다른 이름으로 링크 저장)

Google 스프레드시트

이제 커머스 관리자가 예약된 피드에 대해 Google 스프레드시트도 지원합니다.

Google 스프레드시트에서 데이터 피드를 스프레드시트로 만들고 공유 가능한 링크를 얻습니다.
커머스 관리자에서 제품을 추가할 때 Google 스프레드시트 옵션을 선택합니다. 공유 가능한 링크를 복사하여 붙여넣고 업로드를 완료합니다.
그 이후에 Google 스프레드시트에서 인벤토리를 계속 관리하고 계시면 Meta에서 예약된 시간에 인벤토리를 가져옵니다.

더 알아보기

피드 예

CSV 피드 예 — 어드밴티지+ 카탈로그 광고

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

CSV 피드 예 — 커머스

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 피드 예(Atom) — 커머스

<?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 &amp; 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 &amp; 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	하위 품목에 대해 `price` 및 `availability`를 업데이트합니다.	다운로드(마우스 오른쪽 버튼 클릭 및 다른 이름으로 링크 저장)
TSV	하위 품목에 대해 `sale_price`를 재설정하고 `custom_label_0`을 업데이트합니다.	다운로드(마우스 오른쪽 버튼 클릭 및 다른 이름으로 링크 저장)

지원되는 카탈로그 필드

카탈로그 필드는 고객이 Facebook 또는 Instagram Shop에서 제품을 구매하는 경험의 품질에 기여합니다.

카탈로그 필드는 각 품목의 제품 상세 정보 페이지를 작성하는 데 사용됩니다. 여기에는 제품 설명, 이미지, 크기/색 에디션, 가격, 재고 여부 등의 중요한 정보가 포함됩니다. 데이터를 누락하거나 데이터가 잘못되면 사용자 경험에 부정적인 영향을 미치거나, 구매로의 전환에 영향을 미치거나, 오해를 유발하여 신뢰를 잃게 될 수 있습니다.

제품에 지원되는 필드

다음 표에서는 요구 사항 수준(필수 항목 vs. 선택 사항)을 포함하여 카탈로그를 만드는 데 사용하는 필드를 정의합니다. 모범적인 열 이름 지정 규약을 준수하기 위해서 모든 필드에 미국 영어를 사용하세요.

Required Fields (for Ads and Commerce)
Additional Required Fields for Checkout on Facebook and Instagram (US Only)
Optional Fields
Additional Required Fields for Selling in India

Required Fields (for Ads and Commerce)

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

Attribute and Type	Description
`id` 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: `12345` 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.
`title` 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: `Blue Cotton T-Shirt` This field is supported by supplementary feeds.
`description` 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.
`availability` Type: string	The current availability of the item. Must be written in U.S. English. Supported values: `in stock` `out of stock` Items that are out of stock display as "sold out" in your shop. They don't display at all in your ads. Example: `in stock`
`condition` Type: string	The condition of the item. Supported values: `new`, `refurbished`, `used`. Example: `new`
`price` 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: `9.99 USD`, `7.99 EUR`
`link` 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: `http://www.jaspersmarket.com/products/shirt`
`image_link` 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: `http://www.jaspersmarket.com/products/shirt.jpg` 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.
`brand` Type: string	Max characters: 100 The brand name of the item. Example: `Jasper's Market`

id

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: 12345

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.

title

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: Blue Cotton T-Shirt

This field is supported by supplementary feeds.

description

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.

availability

Type: string

The current availability of the item. Must be written in U.S. English. Supported values:

in stock
out of stock

Items that are out of stock display as "sold out" in your shop. They don't display at all in your ads.

Example: in stock

condition

Type: string

The condition of the item. Supported values: new, refurbished, used.

Example: new

price

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: 9.99 USD, 7.99 EUR

link

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: http://www.jaspersmarket.com/products/shirt

image_link

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: http://www.jaspersmarket.com/products/shirt.jpg

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.

brand

Type: string

Max characters: 100

The brand name of the item.

Example: Jasper's Market

Additional Required Fields for Checkout on Facebook and Instagram (US Only)

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

Attribute and Type	Description
`quantity_to_sell_on_facebook` 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 `quantity_to_sell_on_facebook` must be `1` or higher and its `availability` must also be set to `in stock`. Example: `150` This field was previously called `inventory`. While we still support the old field name, we recommend that you use the new name.
`size` 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: `Medium` This field is supported by supplementary feeds.

quantity_to_sell_on_facebook

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 quantity_to_sell_on_facebook must be 1 or higher and its availability must also be set to in stock.

Example: 150

This field was previously called inventory. While we still support the old field name, we recommend that you use the new name.

size

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: Medium

This field is supported by supplementary feeds.

Optional Fields

You can also include many optional fields to share more product information with customers or control how items are displayed.

Attribute and Type Description

Attribute and Type	Description
`sale_price` Type: string	If the item is on sale, enter its discounted price. Use the same formatting as the `price` field. Example: `7.99 USD`
`sale_price_effective_date` 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 `sale_price` remain on sale until you remove their sale price. Use this format: `YYYY-MM-DDT23:59+00:00/YYYY-MM-DDT23:59+00:00` Enter the sale start date as `YYYY-MM-DD` followed by a "T". Enter the start time in 24-hour format (00:00 to 23:59) followed by the UTC time zone (-12:00 to +14:00). Enter a "/". Then, repeat the same format for the date and time when your sale ends. Example (using PST time zone -08:00): `2020-04-30T09:30-08:00/2020-05-30T23:59-08:00`
`item_group_id` 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: `Shirt_1`
`status` 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: `active`, `archived`. Items are active by default. Learn more about archiving items. Example: `active` Note: Some partner platforms such as Shopify may sync items to your catalog with a status called staging, which behaves the same as `archived`. This field was previously called `visibility`. While we still support the old field name, we recommend that you use the new name.
`additional_image_link` 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 `image_link`. Since this field takes a string, the entire list of URLs must be formatted with double quotes. For example: `"http://www.jaspersmarket.com/products/shirt2.jpg, http://www.jaspersmarket.com/products/shirt3.jpg"` To display additional images in your ads, see Dynamic Ads, Ad Template This field is supported by supplementary feeds.
`google_product_category` 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: `Apparel & Accessories > Clothing > Shirts & Tops` or `212` 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.
`fb_product_category` 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: `Clothing & Accessories > Clothing > Women's Clothing > Tops & T-Shirts` or `430` 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 (`google_product_category` or `fb_product_category`), we recommend that you add more fields that are specific to that category. This gives people more information to make a purchase decision. For example, for beauty products, you could provide ingredients. View the list of category-specific fields. This field is supported by supplementary feeds.
`color` Type: string	Max character limit: 200 The main color of the item. Describe the color in words, not a hex code. Example: `Royal Blue` This field is supported by supplementary feeds.
`gender` Type: string	The gender your item is targeted towards. Supported values: `female`, `male`, `unisex`. Example: `unisex` This field is supported by supplementary feeds.
`size` 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: `Medium` This field is supported by supplementary feeds.
`age_group` Type: string	The age group the item is targeted towards. Accepted values: `adult`, `all ages`, `teen`, `kids`, `toddler`, `infant`, `newborn`. Example: `adult` This field is supported by supplementary feeds.
`material` Type: string	Character limit: 200 The material the item is made from, such as cotton, polyester, denim or leather. Example: `Organic Cotton` This field is supported by supplementary feeds.
`pattern` Type: string	Max character limit: 100 The pattern or graphic print on the item. Example: `Flannel`, `Gingham`, `Polka dots`, `stripes` This field is supported by supplementary feeds.
`shipping` Type: string	This allows you to use a shipping-related overlay in your ads. Shipping details for the item, formatted as: `Country:Region:Service:Price` Enter the country as a 2-letter ISO 3166 country code. Enter the region, state or province. If shipping information is the same for an entire country, you can leave out the region but keep the :: as shown in the Philippines (PH) example below. Enter a description of the shipping service such as Ground or Air. Enter the price as a number followed by a space and then the 3-letter ISO 4217 currency code. Note: To use the "Free Shipping" overlay for ads, enter the price as 0.0. If you offer different shipping details by region or country, separate them with a comma (,) as shown in the example. Example: `US:NY:Ground:9.99 USD, PH::Air:300 PHP`
`shipping_weight` Type: string	Shipping weight of the item in `lb`, `oz`, `g`, or `kg`. Example: `10 kg`
`internal_label` 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 (`custom_label_0` to `custom_label_4`) for filtering product sets, switching to internal labels (`internal_label`) instead is recommended. Unlike custom labels, you can add or update internal labels as often as needed without sending items through policy review each time, which can impact ad delivery. This field was previously called `product_tags`. While we still support the old field name, we recommend that you use the new name.
`custom_label_0` `custom_label_1` `custom_label_2` `custom_label_3` `custom_label_4` 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: `Summer Sale` This field is supported by supplementary feeds.
`custom_number_0` `custom_number_1` `custom_number_2` `custom_number_3` `custom_number_4` 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: `2022`
`rich_text_description` Type: string	Max characters: 9999 The rich text (HTML) description for item. Note: If this field is provided, we use it instead of `description`; however, the `description` field is still required because it's a fallback. Supported tags include: `<form>`, `<fieldset>`, `<div>`, `<span>`, `<section>` All Header tags: `<header>`, `<h1>` thru `<h6>` Table tags: `<table>`, `<tbody>`, `<tfoot>`, `<thead>`, `<td>`, `<th>`, `<tr>` List tags: `<ul>`, `<li>`, `<ol>`, `<dl>`, `<dd>`, `<dt>` Other formatting tags: `<b>`, `<u>`, `<i>`, `<em>`, `<strong>`, `<title>`, `<small>`, `<br>`, `<p>`, `<div>`, `<sub>`, `<sup>`, `<pre>`, `<q>`, `<s>` Note: Any attributes of the html tags such as `<style>` will be stripped off from the field. 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.
`product_type` 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: `Home & Garden > Kitchen & Dining > Appliances > Refrigerators`
`video[0].url` `video[1].url` `video[2].url` `video[3].url` ... up to `video[19].url` 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.
`additional_variant_attribute` 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: `Scent:Fruity, Flavor:Strawberry` This field is supported by supplementary feeds.
`unit_price` 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 Currency: any supported currency Unit type: any of the following measurements: Centiliters: `cl` Centimeters: `cm` Count: `ct` Cubic Meters: `cbm` Feet: `ft` Fluid Ounces: `fl oz` Gallons: `gal` Grams: `g` Inches: `in` Kilograms: `kg` Liters: `l` Meters: `m` Milligrams: `mg` Milliliters: `ml` Ounces: `oz` Pints: `pt` Pounds: `lb` Quarts: `qt` Square Feet: `sqft` Square meters: `sqm` Yards: `yd` This information is uploaded via feed uploads in the `unit_price` field in a JSON format as follows: {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 `unit_price` to products.
`gtin` 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: UPC (North America / GTIN-12): 12-digit number. EAN (Europe / GTIN-13): 13-digit number. JAN (Japan / GTIN-13): 8 or 13-digit number. ISBN (for books / ISBN-13): 13-digit number. Convert any 10-digit ISBN-10 numbers to ISBN-13. ITF-14 (for multipacks / GTIN-14): 14-digit number. Example: `4011200296908` This field is supported by supplementary feeds.
`mpn` 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: `JAS12345PER`
`expiration_date` 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.
`return_policy_info` 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"}
`mobile_link` Type: string	Link to mobile-optimized page for item on the merchant's website.
`applink` 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: `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`. For Android, we require `applink.android_package` and url is optional. For other applinks, a valid url is required. Learn more about product deep links.
`disabled_capabilities`	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 `disabled_capabilities`.

sale_price

Type: string

If the item is on sale, enter its discounted price. Use the same formatting as the price field.

Example: 7.99 USD

sale_price_effective_date

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 sale_price remain on sale until you remove their sale price. Use this format:

YYYY-MM-DDT23:59+00:00/YYYY-MM-DDT23:59+00:00

Enter the sale start date as YYYY-MM-DD followed by a "T".
Enter the start time in 24-hour format (00:00 to 23:59) followed by the UTC time zone (-12:00 to +14:00).
Enter a "/". Then, repeat the same format for the date and time when your sale ends.

Example (using PST time zone -08:00):

2020-04-30T09:30-08:00/2020-05-30T23:59-08:00

item_group_id

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: Shirt_1

status

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: active, archived. Items are active by default. Learn more about archiving items.

Example: active

Note: Some partner platforms such as Shopify may sync items to your catalog with a status called staging, which behaves the same as archived.

This field was previously called visibility. While we still support the old field name, we recommend that you use the new name.

additional_image_link

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 image_link.

Since this field takes a string, the entire list of URLs must be formatted with double quotes. For example: "http://www.jaspersmarket.com/products/shirt2.jpg, http://www.jaspersmarket.com/products/shirt3.jpg"

To display additional images in your ads, see Dynamic Ads, Ad Template

This field is supported by supplementary feeds.

google_product_category

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: Apparel & Accessories > Clothing > Shirts & Tops or 212

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.

fb_product_category

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: Clothing & Accessories > Clothing > Women's Clothing > Tops & T-Shirts or 430

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 (google_product_category or fb_product_category), we recommend that you add more fields that are specific to that category. This gives people more information to make a purchase decision. For example, for beauty products, you could provide ingredients. View the list of category-specific fields.

This field is supported by supplementary feeds.

color

Type: string

Max character limit: 200

The main color of the item. Describe the color in words, not a hex code.

Example: Royal Blue

This field is supported by supplementary feeds.

gender

Type: string

The gender your item is targeted towards. Supported values: female, male, unisex.

Example: unisex

This field is supported by supplementary feeds.

size

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: Medium

This field is supported by supplementary feeds.

age_group

Type: string

The age group the item is targeted towards. Accepted values: adult, all ages, teen, kids, toddler, infant, newborn.

Example: adult

This field is supported by supplementary feeds.

material

Type: string

Character limit: 200
The material the item is made from, such as cotton, polyester, denim or leather.

Example: Organic Cotton

This field is supported by supplementary feeds.

pattern

Type: string

Max character limit: 100

The pattern or graphic print on the item.

Example: Flannel, Gingham, Polka dots, stripes

This field is supported by supplementary feeds.

shipping

Type: string

This allows you to use a shipping-related overlay in your ads.

Shipping details for the item, formatted as: Country:Region:Service:Price

Enter the country as a 2-letter ISO 3166 country code.
Enter the region, state or province. If shipping information is the same for an entire country, you can leave out the region but keep the :: as shown in the Philippines (PH) example below.
Enter a description of the shipping service such as Ground or Air.
Enter the price as a number followed by a space and then the 3-letter ISO 4217 currency code. Note: To use the "Free Shipping" overlay for ads, enter the price as 0.0.
If you offer different shipping details by region or country, separate them with a comma (,) as shown in the example.

Example: US:NY:Ground:9.99 USD, PH::Air:300 PHP

shipping_weight

Type: string

Shipping weight of the item in lb, oz, g, or kg.

Example: 10 kg

internal_label

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 (custom_label_0 to custom_label_4) for filtering product sets, switching to internal labels (internal_label) instead is recommended. Unlike custom labels, you can add or update internal labels as often as needed without sending items through policy review each time, which can impact ad delivery.

This field was previously called product_tags. While we still support the old field name, we recommend that you use the new name.

custom_label_0
custom_label_1
custom_label_2
custom_label_3
custom_label_4

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: Summer Sale

This field is supported by supplementary feeds.

custom_number_0
custom_number_1
custom_number_2
custom_number_3
custom_number_4

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: 2022

rich_text_description

Type: string

Max characters: 9999

The rich text (HTML) description for item. Note: If this field is provided, we use it instead of description; however, the description field is still required because it's a fallback.

Supported tags include:

<form>, <fieldset>, <div>, <span>, <section>
All Header tags: <header>, <h1> thru <h6>
Table tags: <table>, <tbody>, <tfoot>, <thead>, <td>, <th>, <tr>
List tags: <ul>, <li>, <ol>, <dl>, <dd>, <dt>
Other formatting tags: <b>, <u>, <i>, <em>, <strong>, <title>, <small>, <br>, <p>, <div>, <sub>, <sup>, <pre>, <q>, <s>

Note: Any attributes of the html tags such as <style> will be stripped off from the field.

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.

product_type

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: Home & Garden > Kitchen & Dining > Appliances > Refrigerators

video[0].url

video[1].url

video[2].url

video[3].url ... up to

video[19].url

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.

additional_variant_attribute

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: Scent:Fruity, Flavor:Strawberry

This field is supported by supplementary feeds.

unit_price

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
Currency: any supported currency
Unit type: any of the following measurements:

Centiliters: cl
Centimeters: cm
Count: ct
Cubic Meters: cbm
Feet: ft
Fluid Ounces: fl oz
Gallons: gal
Grams: g
Inches: in
Kilograms: kg
Liters: l
Meters: m
Milligrams: mg
Milliliters: ml
Ounces: oz
Pints: pt
Pounds: lb
Quarts: qt
Square Feet: sqft
Square meters: sqm
Yards: yd

This information is uploaded via feed uploads in the unit_price field in a JSON format as follows:

{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 unit_price to products.

gtin

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:

UPC (North America / GTIN-12): 12-digit number.
EAN (Europe / GTIN-13): 13-digit number.
JAN (Japan / GTIN-13): 8 or 13-digit number.
ISBN (for books / ISBN-13): 13-digit number. Convert any 10-digit ISBN-10 numbers to ISBN-13.
ITF-14 (for multipacks / GTIN-14): 14-digit number.

Example: 4011200296908

This field is supported by supplementary feeds.

mpn

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: JAS12345PER

expiration_date

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.

return_policy_info

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"}

mobile_link

Type: string

Link to mobile-optimized page for item on the merchant's website.

applink

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: 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.

For Android, we require applink.android_package and url is optional. For other applinks, a valid url is required.

Learn more about product deep links.

disabled_capabilities

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 disabled_capabilities.

Additional Required Fields for Selling in India

Attribute and Type	Description
`origin_country` Type: ISOCountryCode (2 letter country code)	The item's country of origin. Enter the two-letter ISO country code Example value: `US` This field is supported by supplementary feeds.
`importer_name` Type: string	If the country of origin is not India, provide the legal entity name of the item's importer Example value: `Jasper's Market Inc.` This field is supported by supplementary feeds.
`importer_address` Type: JSON structure	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: `street1` - string, required. The first line of the street address `street2` - string, optional. The second line of the street address. `city` - string, required. The city name. `region` - string, optional. The region, state or province. (In the US this is to be used for US State) `postal_code` - string, optional (in the US this is to be used for Zip Code) `country` - required. Enter the ISO Country code (2-letter country code) The overall address will be displayed to users in the following format: `street1`, `street2` (if present), `city`, `region` (if present) `postal_code` (if present), `country` (full name, localized for the user). 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.
`manufacturer_info` Type: string	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.
`wa_compliance_category` Type: string	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 (`origin_country`), importer name (`importer_name`) and importer address (`importer_address`). Supported values (case sensitive): `COUNTRY_ORIGIN_EXEMPT`: The item is exempt. `DEFAULT`: The item is not exempt. This is the default value if you leave the field blank.

지원되는 필드 — 현지화된 카탈로그

요구 사항

보조 데이터 피드 파일에 id 필드를 포함해야 합니다. 어드밴티지+ 카탈로그 광고를 게재하려면 각 품목의 ID가 원본 카탈로그 데이터 피드의 ID 및 픽셀의 콘텐츠 ID와 일치해야 합니다.
override 필드는 반드시 포함해야 합니다. 이 필드에는 현지화된 정보를 제공하려는 언어 또는 국가의 ISO 코드를 입력합니다. 이 필드에는 현지화된 정보를 제공하려는 언어 또는 국가의 ISO 코드를 입력합니다. override 열의 값은 지원되는 ISO 언어 코드이거나 지원되는 ISO 국가 번호여야 합니다. 지원되는 언어 코드 및 국가 번호에 대해 자세히 알아보세요.
price, sale_price, unit_price, base_price, status(가시성) 및 availability는 국가 피드에서만 제공해야 합니다. 이러한 필드는 언어 피드에서 제공할 수 없습니다. 이는 고객이 올바르게 현지화된 제품 데이터를 확인하는 데 도움이 됩니다.

id 및 override 필드에 대한 자세한 내용은 현지화된 인벤토리 정보로 데이터 피드 만들기, 2단계 및 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

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 필드를 현지화하려면 이들을 모두 제공해야 합니다. 제품 딥 링크에 대해 자세히 알아보세요.

참고 자료는 호텔용 필드의 주요 리스트를 참조하세요.

항공편

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 필드를 현지화하려면 이들을 모두 제공해야 합니다. 제품 딥 링크에 대해 자세히 알아보세요.

참고 자료는 항공편용 필드의 주요 리스트를 참조하세요.

목적지

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 필드를 현지화하려면 이들을 모두 제공해야 합니다. 제품 딥 링크에 대해 자세히 알아보세요.

참고 자료는 목적지용 필드의 주요 리스트를 참조하세요.

주택 매물 리스트

name
description
price
url
image[0].url, image[0].tag[0]

참고 자료는 주택 매물 리스트용 필드의 주요 리스트를 참조하세요.

차량

title
description
price
sale_price
url
image[0].url, image[0].tag[0]

참고 자료는 차량용 필드의 주요 리스트를 참조하세요.

OpenGraph 태그

각 필드는 최대 500자까지 입력할 수 있습니다.

기본 이미지 링크는 필수입니다. 그 외의 추가적인 이미지 링크는 선택 사항입니다.

이름	설명
`og:title`	필수 항목. 품목의 제목입니다. 픽셀 기반 카탈로그를 지원합니다.
`og:description`	필수 항목. 품목에 대한 설명입니다. 픽셀 기반 카탈로그를 지원합니다.
`og:url`	필수 항목. 제품 페이지의 전체 URL입니다. 픽셀 기반 카탈로그를 지원합니다.
`og:image`	기본 링크에 필수입니다. 추가적 이미지 링크에 선택 사항입니다. 제품 페이지에 사용된 이미지의 링크입니다. 기본 이미지 링크는 필수입니다. 그 외의 추가적인 이미지 링크는 선택 사항입니다. 픽셀 기반 카탈로그를 지원합니다.
`og:locale`	다국어 카탈로그를 사용하는 경우 필수 항목입니다. 제품이 어느 웹사이트 버전에서 제공되었는지 지정합니다(예: 영국 웹사이트의 경우 `en_GB`). 픽셀 기반 카탈로그를 지원합니다.
`og:price:amount`	필수 항목. 품목의 현재 가격입니다. 구분 기호는 ',' 대신 '.'를 사용하여 소수점을 표시합니다. 가격에 '$'와 같은 기호를 포함하지 마세요. 픽셀 기반 카탈로그를 지원합니다. 예: `1500.00`
`og:price:currency`	필수 항목. ISO 형식으로 표시한 가격의 통화입니다. 픽셀 기반 카탈로그를 지원합니다. 예: `USD`
`product:brand`	필수 항목. 품목의 브랜드 이름입니다. 픽셀 기반 카탈로그를 지원합니다.
`product:availability`	필수 항목. 품목의 현재 재고 여부: `in stock`, `out of stock`, `available for order`, `discontinued`. 픽셀 기반 카탈로그를 지원합니다.
`product:catalog_id`	선택 사항. 품목의 고유한 카탈로그 ID입니다. 제품의 에디션일 수 있습니다. 이는 제품을 가져온 후에 `retailer_id`로 매핑됩니다. `id` 필드는 픽셀의 콘텐츠 ID와 일치해야 합니다. 픽셀 기반 카탈로그를 지원합니다.
`product:category`	선택 사항. 최대 문자 수 한도는 250자입니다. 픽셀 기반 카탈로그를 지원합니다. 어드밴티지+ 카탈로그 광고의 경우 Google 제품 분류법에서 사전 정의된 값(열 또는 카테고리 ID)을 나타냅니다. 커머스의 경우 Google 제품 분류법에 따른 제품 카테고리를 나타냅니다. 커머스의 제품 카테고리에 대해 자세히 알아보세요. 카탈로그 항목에 대한 Google 제품 카테고리, 광고 지원 센터를 참조하세요.
`product:condition`	필수 항목. 품목의 현재 상태: `new`, `refurbished`, `used`. 픽셀 기반 카탈로그를 지원합니다.
`product:custom_label_[0-4]`	선택 사항. 최대 문자 수 한도는 100자입니다. 포함하려는 품목에 대한 추가 정보입니다. 픽셀 기반 카탈로그를 지원합니다.
`product:gender`	선택 사항. 치수에 대한 성별 결정: `Female`, `Male`, `Unisex`. 픽셀 기반 카탈로그를 지원합니다.
`product:item_group_id`	선택 사항. 어드밴티지+ 카탈로그 광고용 - 한 제품의 에디션인 품목입니다. 에디션인 모든 품목에 대해 동일한 item_group_id를 제공합니다. 예를 들어 빨간색 폴로 셔츠는 폴로 셔츠의 에디션입니다. Facebook에서는 비즈니스의 피드를 가져온 후에 이를 retailer_product_group_id에 매핑합니다. 어드밴티지+ 카탈로그 광고의 경우 Facebook은 픽셀이나 앱 이벤트에서 보낸 신호에 따라 그룹에서 한 개 품목만 선택합니다. 커머스의 경우 에디션인 모든 품목에 대해 동일한 product_group_id를 제공합니다. 예를 들어 빨간색 폴로 셔츠는 폴로 셔츠의 에디션입니다. Facebook은 비즈니스의 피드를 가져온 후에 이를 retailer_product_group_id에 매핑합니다. 제품 에디션에 대해 자세히 알아보세요. 픽셀 기반 카탈로그를 지원합니다. 예: `FB1234_shirts`
`product:gtin`	선택 사항. 제품의 국제 무역 품목 번호(GTIN)입니다. 대시 및 공백을 제외합니다. GTIN 유효성 검사 가이드에서 정의된 유효한 GTIN만 제출하세요. 지원되는 값은 `UPC`(북미, 12자리), `EAN`(유럽, 13자리), `JAN`(일본, 8자리 또는 13자리), `ISBN`(서적, 13자리)입니다. 픽셀 기반 카탈로그를 지원합니다. 예: `4011200296908`
`product:isbn`	선택 사항. 국제 표준 도서 번호입니다. ISBN은 13자리로 구성됩니다. 픽셀 기반 카탈로그를 지원합니다.
`product:mfr_part_no`	선택 사항. 품목에 대한 고유한 제조사 부품 번호입니다. 커머스에서 `mpn`이 제공되는 경우 일일 딜 인벤토리에 브랜드도 포함해야 합니다. 픽셀 기반 카탈로그를 지원합니다. 예: `100020003`
`material`	선택 사항. 품목의 소재입니다. 지원되는 값: `cotton`, `denim`, `leather`. 픽셀 기반 카탈로그를 지원합니다. 예: `cotton`
`product:locale`	다국어 카탈로그를 사용하는 경우 필수 항목입니다. 제품이 어느 웹사이트 버전에서 제공되었는지 지정합니다(예: 영국 웹사이트의 경우 `en_GB`). 픽셀 기반 카탈로그를 지원합니다.
`product:price:amount`	필수 항목. 품목의 현재 가격입니다. 구분 기호는 ',' 대신 '.'를 사용하여 소수점을 표시합니다. 가격에 '$'와 같은 기호를 포함하지 마세요. 픽셀 기반 카탈로그를 지원합니다. 예: `1500.00`
`product:price:currency`	필수 항목. ISO 형식으로 표시한 가격의 통화입니다. 픽셀 기반 카탈로그를 지원합니다. 예: `USD`
`product:retailer_item_id`	필수 항목. 품목 판매점의 ID입니다. 픽셀 기반 카탈로그를 지원합니다.
`product:sale_price:amount`	선택 사항. 품목이 세일 중인 경우 할인된 가격입니다. 할인 가격에서 '.'를 소수점으로 사용하세요. 할인된 가격에 오버레이를 사용하고자 하는 경우 할인 가격은 필수 항목입니다. 픽셀 기반 카탈로그를 지원합니다. 참고: 일반적으로 픽셀 기반 카탈로그에서는 메인 og:price:amount 태그를 사용하여 모든 가격 변동을 캡처하는 것이 좋습니다. 할인 가격 태그를 사용하는 경우 `product:sale_price_dates:start` 및 `product:sale_price_dates:end` 태그도 사용하여 세일이 시작되는 시점과 종료되는 시점을 표시하세요. 종료 날짜가 없는 경우 할인 가격이 무기한 표시될 수 있습니다. 예: `9.99`
`product:sale_price:currency`	선택 사항. 품목이 세일 중인 경우 3자리 ISO 통화 코드로 된 할인 가격의 통화입니다. 픽셀 기반 카탈로그를 지원합니다. 예: `USD`
`product:sale_price_dates:start`	선택 사항. `YYYY-MM-DDT0:00-23:59/YYYY-MM-DDT0:00-23:59` 형식으로 작성되고 슬래시로 구분된 해당 시간대의 세일 시작 날짜 및 시각입니다. 시작 날짜와 종료 날짜는 `YYYY-MM-DD` 형식으로 작성하세요. 시간은 24시간 형식(0:00~23:59)으로 작성하세요. 각 날짜 뒤에 'T'를 추가한 다음에 시각을 포함하세요. 여기에서 종료 시각은 시간대를 나타냅니다. 예를 들어 `03:00`은 시간대를 나타냅니다. 픽셀 기반 카탈로그를 지원합니다. 예: `2017-11-01T12:00-03:00/2017-12-01T00:00-03:00`
`product:sale_price_dates:end`	선택 사항. `YYYY-MM-DDT0:00-23:59/YYYY-MM-DDT0:00-23:59` 형식으로 작성되고 슬래시로 구분된 해당 시간대의 세일 종료 날짜 및 시각입니다. 시작 날짜와 종료 날짜는 `YYYY-MM-DD` 형식으로 작성하세요. 시간은 24시간 형식(0:00~23:59)으로 작성하세요. 각 날짜 뒤에 'T'를 추가한 다음에 시각을 포함하세요. 여기에서 종료 시각은 시간대를 나타냅니다. 예를 들어 `03:00`은 시간대를 나타냅니다. 픽셀 기반 카탈로그를 지원합니다. 예: `2017-11-01T12:00-03:00/2017-12-01T00:00-03:00`

Schema.org – 필수 태그

각 필드는 최대 500자까지 입력할 수 있습니다.

이름	설명
`name`	품목의 제목입니다.
`brand`	품목의 브랜드입니다.
`description`	품목에 대한 설명입니다.
`productID`	품목 판매점의 ID입니다.
`url`	제품 페이지의 전체 URL입니다.
`image`	제품 페이지에 사용된 이미지의 링크입니다.
`price`	품목의 현재 가격입니다. 가격에 '$'와 같은 기호를 포함하지 마세요. 이 항목을 '쿠폰'에 포함하세요. 통화는 숫자 뒤에 3자리 ISO 통화 코드(ISO 4217 표준)를 붙이고 비용과 통화 사이에 공백이 있도록 형식을 지정해야 합니다. 마침표('.')를 소수점으로 사용하세요. 고객이 광고 또는 커머스 채널에서 제품을 볼 때 여러 통화가 섞여서 표시되지 않도록 카탈로그에는 통화를 1개만 포함하는 것이 좋습니다. 다른 국가 또는 언어에 표시될 제품 정보와 가격을 추가하려면 대신 국가 피드 또는 언어 피드를 카탈로그에 업로드하세요.
`priceCurrency`	ISO 형식(예: `USD`)으로 된 가격 통화입니다. 이 항목을 '쿠폰'에 포함하세요. 구분 기호는 ',' 대신 '.'를 사용하여 소수점을 표시합니다. 가격에 '$'와 같은 기호를 포함하지 마세요. 예: 1500.00.
`availability`	품목의 현재 재고 여부: `in stock`, `out of stock`, `available for order`, `discontinued`. 이 항목을 '쿠폰'에 포함하세요.
`condition`	품목의 현재 상태: `new`, `refurbished` 또는 `used`. 이 항목을 '쿠폰'에 포함하세요.

Schema.org용 JSON-LD — 필수 태그

각 필드는 최대 500자까지 입력할 수 있습니다.

schema.org/Product에서 추출되었습니다.

이름	설명
`name`	품목의 제목입니다.
`brand`	품목의 브랜드입니다.
`description`	품목에 대한 설명입니다.
`productID`	품목 판매점의 ID입니다.
`url`	제품 페이지의 전체 URL입니다.
`offers`	유형이 `schema.org/Offer`인 개체의 배열입니다.
`image`	제품 페이지에 사용된 이미지의 링크입니다.

(제품 쿠폰의 일부로) schema.org/Offer에서 추출되었습니다.

이름	설명
`price`	품목의 현재 가격입니다. 가격에 '$'와 같은 기호를 포함하지 마세요. 이 항목을 '쿠폰'에 포함하세요.
`priceCurrency`	ISO 형식(예: `USD`)으로 된 가격 통화입니다. 이 항목을 '쿠폰'에 포함하세요.
`availability`	품목의 현재 재고 여부: `in stock`, `out of stock`, `available for order`, `discontinued`. 이 항목을 '쿠폰'에 포함하세요.
`condition`	품목의 현재 상태: `new`, `refurbished` 또는 `used`. 이 항목을 '쿠폰'에 포함하세요.

JSON Schema 내보내기

모든 카탈로그 주요 필드 및 카테고리 필드에 다음과 같이 JSON 스키마 다운로드를 제공했습니다.

이 JSON 스키마는 업로드 가능한 필드 형식이 아니라 Facebook 문서에 이미 존재하는 것 외의 피드 필드, 예시, 데이터 유형에 대한 대체 참고 자료로 제공됩니다. 이 스키마는 주로 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 값이 있습니다(그 외의 경우에는 모두 선택 사항임).

참고 자료 - 카탈로그

지원되는 피드 형식

Google 스프레드시트

더 알아보기

피드 예

CSV 피드 예 — 어드밴티지+ 카탈로그 광고

CSV 피드 예 — 커머스

XML 피드 예(Atom) — 커머스

피드 형식 — 데이터 피드 가져오기 예약

지원되는 카탈로그 필드

제품에 지원되는 필드

Required Fields (for Ads and Commerce)

Additional Required Fields for Checkout on Facebook and Instagram (US Only)

Optional Fields

Additional Required Fields for Selling in India

지원되는 필드 — 현지화된 카탈로그

요구 사항

제품

호텔

항공편

목적지

주택 매물 리스트

차량

OpenGraph 태그

Schema.org – 필수 태그

Schema.org용 JSON-LD — 필수 태그

schema.org/Product에서 추출되었습니다.

(제품 쿠폰의 일부로) schema.org/Offer에서 추출되었습니다.

JSON Schema 내보내기

더 알아보기

광고주 지원 센터

API 참고 자료

마케팅 API