Each data feed is different depending on the type of items you want to show in your dynamic ads. Follow the instructions below to create your data feed. If you need help, download the examples to see what your data feed should look like, or take a look at our data feed setup guide.

To begin creating your data feed:

1. Open a supported data feed file format: CSV, TSV or XML.
   Note: If you want to upload property listings to a data feed, you can only use XML.
2. Add the required fields below to your data feed. Enter them exactly as they appear here for your file to upload correctly.
   Note: While you can use non-English data in each field of the feed, the column names need to be in US English only.

   Required columns (click or tap to expand)

   Products

   Need examples? Right-click and save either of the following links to your computer to see how the feed file looks in different formats.

   • Download CSV example
   • Download TSV example
   • Download XML example

   Column name	Description/Guidelines	Example
   id	Enter a unique ID for the item, such as an SKU. If there are multiple instances of the same ID, these will be ignored. Max. characters: 100	FB_product_1234
   availability	The current availability of the item in your shop. Make sure that you indicate the availability of the item on your shop page and keep it up to date. Supported: in stock, available for order, pre-order, out of stock, discontinued	in stock
   condition	The current condition of the item in your shop. Supported: new, refurbished, used	new
   description	A short description of the item. Max. characters: 5000	A vibrant crewneck for all shapes and sizes. Made from 100% cotton.
   image_link	The URL for the image used in your ad. For square (1:1) aspect ratios in the carousel ad format, your image should be 600x600. For single image ads, your image should be at least 1200x630.	https://www.facebook.com/t_shirt_image_001.jpg
   link	The URL of the website where you can buy the item.	https://www.facebook.com/facebook_t_shirt
   title	The title of the item. Max. characters: 500	Facebook T-shirt (Unisex)
   price	The cost and currency of the item. The price is a number followed by the currency code (ISO 4217 standards).	9.99 USD
   gtin*	The Global Trade Identification Number for the item. Supported: UPC (North America – 12 digits), EAN (Europe – 13 digits), JAN (Japan – 8 or 13 digits), ISBN (books – 13 digits) Max. characters: 70	1234567891011
   mpn*	The Manufacturer Part Number for the item. Max. characters: 70	100020003
   brand*	The brand name of the item. Max. characters: 70	Facebook

   *Either gtn, mpn or brand is required for the data feed.

   Hotels

   Need examples? Right-click and save either of the following links to your computer to see how the feed file looks in different formats.

   • Download CSV example
   • Download TSV example
   • Download XML example

   Column name	Description/Guidelines	Example
   hotel_id	The unique ID for the hotel. Max. characters: 100	FB_hotel_1234
   name	The name of the hotel.	Facebook Hotel
   image[0].url	The URL for the image used in your ad. For square (1:1) aspect ratios in the carousel ad format, your image should be 600x600. For single image ads, your image should be at least 1200x630 pixels. If you have more than one image, add additional columns for each type and use JSON-path syntax in each column name to indicate the number of images (for example: image[0].url; image[1].url). Max. items: 20	https://www.facebook.com/facebook_hotel.jpg
   url	The URL of the website where you can book a hotel room.	https://www.facebook.com/hotel
   address.addr1	The street address of the hotel.	1 Hacker Way
   address.city	The city the hotel is in.	Menlo Park
   address.region	The state, county, province or region of the hotel.	California
   address.postal_code	The postcode or ZIP code for the hotel. This is not required for countries without a postal code system.	94025
   address.country	The country the hotel is in.	United States
   neighborhood[0]	The neighbourhood of the hotel. If you have more than one neighbourhood, add additional columns for each type and use JSON-path syntax in each column name to indicate the number of neighbourhoods (for example: neighborhood[0]; neighborhood[1]). Max. neighbourhoods allowed: 20	Belle Haven
   latitude	The latitude of the hotel.	37.4841
   longitude	The longitude of the hotel.	-122.14825
   brand	The brand name of the hotel chain.	Facebook
   base_price	The base cost and currency of your hotel per night. The price is a number followed by the currency code (ISO 4217 standards).	199.00 USD
   description	A description of the hotel. Max. characters: 5000	Only 30 minutes away from San Francisco

   Hotel room and pricing information

   If you want to add optional hotel room and pricing information to your listing, add these required columns.

   Column name	Description/Guidelines	Example
   room_id	The unique ID for the hotel room type. Max. characters: 100	FB_hotel_room_1234
   name	The name of the hotel room type.	1 King-size bed, Suite
   description	A short description of the room type.	1 king-size bed. Sleeps 2 guests. Room overlooks the bay. Total floor space of 350 sq. feet.
   base_price	The lowest base price of the hotel room per night. The price is a number followed by the currency code (ISO 4217 standards).	199.00 USD
   url	The URL of the website where you can book a hotel room.	https://www.facebook.com/hotel_booking
   checkin_date	The check-in date for the stay. You can add up to 180 days from the date the feed is uploaded. Uses ISO‑8601 standard (YYYY‑MM‑DD).	2017-08-01
   length_of_stay	The number of nights of the stay in the hotel. Max. number of days allowed: 14	7
   price	The total price of the stay, based on checkin_date and length_of_stay.	1393.00 USD
   tax	The applicable tax rate for the price.	14
   fees	The applicable fees for the price.	253.00 USD

   Destinations

   Need examples? Right-click and save either of the following links to your computer to see how the feed file looks in different formats.

   • Download CSV example
   • Download TSV example
   • Download XML example

   Column name	Description/Guidelines	Example
   destination_id	The unique ID for the destination. Max. characters: 100	FB_destination_1234
   name	The name of the destination.	Bay Area Peninsula
   address.city	The destination city.	Menlo Park
   address.region	The destination state, county, province or region.	California
   address.country	The destination country.	United States
   address.postal_code	Postcode or ZIP code for the destination. This is not required for countries without a postal code system.	94025
   image[0].url	The URL for the image used in your ad. For square (1:1) aspect ratios in the carousel ad format, your image should be 600x600. For single image ads, your image should be at least 1200x630 pixels. If you have more than one image, add additional columns for each type and use JSON-path syntax in each column name to indicate the number of images (for example: image[0].url; image[1].url). Max. items: 20	https://www.facebook.com/image_001.jpg
   type[0]	The type(s) of destination (for example, park or beach). A destination can have multiple types. If you have more than one type to add, add additional columns for each type and use JSON-path syntax in each column name to indicate the number of types (for example: type[0], type[1]). Max. items: 20	city
   url	A link to the website where you can book the destination.	https://www.facebook.com/destination

   Flights

   Need examples? Right-click and save either of the following links to your computer to see how the feed file looks in different formats.

   • Download CSV example
   • Download TSV example
   • Download XML example

   Column name	Description/Guidelines	Example
   departure_airport	The origin airport for the flight. The origin airport should be written as an IATA code (for example, SFO).	SFO
   destination_airport	The destination airport for the flight. The destination airport should be written as an IATA code (for example, JFK).	JFK
   image[0].url	The URL for the image used in your ad. For square (1:1) aspect ratios in the carousel ad format, your image should be 600x600. For single image ads, your image should be at least 1200x630 pixels. If you have more than one image, add additional columns for each type and use JSON-path syntax in each column name to indicate the number of images (for example: image[0].url; image[1].url). Max. items: 20	https://www.facebook.com/image_001.jpg
   description	A description of the flight. Max. character limit: 5000	Book your ticket for SFO to JFK
   url	A link to the website where you can book the flight.	https://www.facebook.com/flights

   Property

   Need examples? Right-click and save either of the following links to your computer to see how the feed file looks in different formats.

   • Download XML example

   Column name	Description/Guidelines	Example
   home_listing_id	The unique ID for the home listing.	FB_home_1234
   name	The name of the home listing	1 Hacker Way, Menlo Park, CA 94025, USA
   image[0].url	The URL for the image used in your ad. For square (1:1) aspect ratios in the carousel ad format, your image should be 600x600. For single image ads, your image should be at least 1200x630 pixels. If you have more than one image, add additional columns for each type and use JSON-path syntax in each column name to indicate the number of images (for example: image[0].url; image[1].url). Max. items: 20	https://www.facebook.com/image_001.jpg
   address.addr1	The street address for the listing.	1 Hacker Way
   address.city	The city for the listing.	Menlo Park
   address.region	The state, county, region or province of the listing.	California
   address.country	The country for the listing.	United States
   address.postal_code	Postcode or ZIP code for the destination. This is not required for countries without a postal code system.	94025
   neighborhood[0]	The neighbourhood for the home listing. If you have more than one neighbourhood, add additional columns for each type and use JSON-path syntax in each column name to indicate the number of neighbourhoods (for example: neighborhood[0]; neighborhood[1]). Max. neighbourhoods allowed: 20	Belle Haven
   latitude	The latitude of the listing.	37.4845
   longitude	The longitude of the listing.	-122.14789
   price	The cost and currency of the home listing. The price is a number followed by the currency code (ISO 4217 standards).	125000000.00 USD
   availability	The current availability of the listing. Supported: for_sale, for_rent, sale_pending, recently_sold, off_market, available_soon	for_sale
   url	A link to the website where you can view the listing.	https://www.facebook.com/home_listing

You now have a data feed set up.

* Nguồn: Facebook