Cột bắt buộc của tệp nguồn cấp dữ liệu
30/11/2019
Trước khi có thể quảng cáo các mặt hàng từ danh mục trong quảng cáo, đầu tiên bạn cần tải lên tệp có chứa thông tin về các mặt hàng mà bạn muốn đưa vào quảng cáo. Tệp này được gọi là nguồn cấp dữ liệu.
Khi tạo nguồn cấp dữ liệu, bạn sẽ thêm danh sách các mặt hàng vào định dạng tệp được hỗ trợ: CSV, TSV hoặc XML. Để đảm bảo rằng nguồn cấp dữ liệu được tải lên danh mục thành công, bạn cần thêm một loạt cột bắt buộc vào nguồn cấp dữ liệu. Loại nguồn cấp bạn tải lên sẽ xác định các cột bạn sử dụng. Nếu nguồn cấp dữ liệu không bao gồm một hoặc nhiều cột này, bạn có thể gặp lỗi khi tải nguồn cấp dữ liệu lên Facebook.
Cột bắt buộc
Hãy thêm các cột này vào nguồn cấp dữ liệu và tuân thủ nguyên tắc cho từng mục nhập để tải thành công nguồn cấp dữ liệu lên Facebook. Các cột bắt buộc này khác nhau tùy vào mặt hàng bạn đang quảng cáo.
Sản phẩm
Cần ví dụ? Hãy nhấp chuột phải và lưu một trong các liên kết sau vào máy tính để xem tệp nguồn cấp trông ra sao ở các định dạng khác nhau.
| Tên cột | Mô tả / Hướng dẫn | Ví dụ |
|---|---|---|
| id | Nhập một ID duy nhất cho mặt hàng, chẳng hạn như SKU. Nếu có nhiều trường hợp có chung ID, chúng sẽ bị bỏ qua.Số ký tự tối đa: 100 | FB_product_1234 |
| availability | Tình trạng hàng hiện tại của mặt hàng tại cửa hàng của bạn. Hãy đảm bảo cho biết tình trạng hàng của mặt hàng trên trang cửa hàng và luôn cập nhật thông tin này.Hỗ trợ: còn hàng, có sẵn để đặt, đặt trước, hết hàng, ngừng bán | còn hàng |
| condition | Điều kiện hiện tại của mặt hàng tại cửa hàng.Hỗ trợ: mới, đã được tân trang, đã sử dụng | mới |
| description | Mô tả ngắn về mặt hàng.Số ký tự tối đa: 5000 | Áo cổ tròn ấn tượng cho mọi hình dạng và kích cỡ. Làm từ 100% sợi bông. |
| image_link | URL của hình ảnh được sử dụng trong quảng cáo. Đối với tỷ lệ khung hình vuông (1: 1) trong định dạng quảng cáo quay vòng, kích thước hình ảnh phải là 600x600. Đối với quảng cáo một hình ảnh, kích thước hình ảnh tối thiểu phải là 1200x630. | https://www.facebook.com/t_shirt_image_001.jpg |
| link | URL đến trang web mà bạn có thể mua mặt hàng. | https://www.facebook.com/facebook_t_shirt |
| title | Tên mặt hàng.Số ký tự tối đa: 500 | Áo phông Facebook (Cả nam lẫn nữ) |
| price | Giá và đơn vị tiền tệ của mặt hàng. Giá là một số mà sau đó là mã đơn vị tiền tệ (chuẩn ISO 4217). | 9,99 USD |
| gtin* | Số nhận dạng thương mại toàn cầu của mặt hàng.Hỗ trợ: UPC (Bắc Mỹ - 12 chữ số), EAN (Châu Âu - 13 chữ số), JAN (Nhật Bản - 8 hoặc 13 chữ số), ISBN (sách - 13 chữ số)Số ký tự tối đa: 70 | 1234567891011 |
| mpn* | Số bộ phận của nhà sản xuất cho mặt hàng.Số ký tự tối đa: 70 | 100020003 |
| brand* | Tên thương hiệu của mặt hàng.Số ký tự tối đa: 70 |
*Nguồn cấp dữ liệu yêu cầu gtn, mpn hoặc brand.
Khách sạn
Cần ví dụ? Hãy nhấp chuột phải và lưu một trong các liên kết sau vào máy tính để xem tệp nguồn cấp trông ra sao ở các định dạng khác nhau.
| Tên cột | Mô tả / Hướng dẫn | Ví dụ |
|---|---|---|
| hotel_id | ID duy nhất của khách sạn. Số ký tự tối đa: 100 | FB_hotel_1234 |
| name | Tên của khách sạn. | Facebook Hotel |
| image[0].url | URL của hình ảnh được sử dụng trong quảng cáo. Đối với tỷ lệ khung hình vuông (1: 1) trong định dạng quảng cáo quay vòng, kích thước hình ảnh phải là 600x600. Đối với quảng cáo một hình ảnh, kích thước hình ảnh tối thiểu phải là 1200x630 pixel. Nếu bạn có nhiều hình ảnh, hãy thêm cột bổ sung cho mỗi loại và sử dụng cú pháp đường dẫn JSON trong mỗi tên cột để cho biết số lượng hình ảnh (ví dụ: image[0].url; image[1].url).Số lượng tối đa: 20 | https://www.facebook.com/facebook_hotel.jpg |
| url | URL của trang web nơi bạn có thể đặt phòng khách sạn. | https://www.facebook.com/hotel |
| address.addr1 | Địa chỉ đường của khách sạn. | 1 Hacker Way |
| address.city | Thành phố của khách sạn. | Menlo Park |
| address.region | Tiểu bang, hạt, tỉnh hoặc vùng của khách sạn. | California |
| address.postal_code | Mã bưu chính hoặc mã zip của khách sạn. Đây là thông tin không bắt buộc đối với các quốc gia không có hệ thống mã bưu chính. | 94025 |
| address.country | Quốc gia của khách sạn. | Hoa Kỳ |
neighborhood[0] | Hàng xóm của khách sạn. Nếu bạn có nhiều hàng xóm, hãy thêm cột bổ sung cho mỗi loại và sử dụng cú pháp đường dẫn JSON trong mỗi tên cột để cho biết số lượng hàng xóm (ví dụ: neighborhood[0]; neighborhood[1]).Số lượng hàng xóm tối đa cho phép: 20 | Belle Haven |
| latitude | Kinh độ của khách sạn. | 37.4841 |
| longitude | Vĩ độ của khách sạn. | -122.14825 |
| brand | Tên thương hiệu của chuỗi khách sạn. | |
| base_price | Chi phí cơ bản và đơn vị tiền tệ của khách sạn mỗi đêm. Giá là một số mà sau đó là mã đơn vị tiền tệ (chuẩn ISO 4217). | 199,00 USD |
| description | Mô tả về khách sạn.Số ký tự tối đa: 5000 | Chỉ cách San Francisco 30 phút |
Thông tin giá và phòng khách sạn
Nếu bạn muốn thêm thông tin giá và phòng khách sạn tùy chọn vào danh sách, hãy thêm các cột bắt buộc sau.
| Tên cột | Mô tả / Hướng dẫn | Ví dụ |
|---|---|---|
| room_id | ID duy nhất của loại phòng khách sạn.Số ký tự tối đa: 100 | FB_hotel_room_1234 |
| name | Tên loại phòng khách sạn. | 1 giường lớn, dãy buồng |
| description | Mô tả ngắn về loại phòng. | 1 giường lớn. 2 khách ngủ. Phòng nhìn ra vịnh. Diện tích tổng thể là 350 foot. |
| base_price | Giá gốc thấp nhất của phòng khách sạn mỗi đêm. Giá là một số mà sau đó là mã đơn vị tiền tệ (chuẩn ISO 4217). | 199,00 USD |
| url | URL của trang web nơi bạn có thể đặt phòng khách sạn. | https://www.facebook.com/hotel_booking |
| checkin_date | Ngày nhận phòng để lưu trú. Bạn có thể thêm tới 180 ngày kể từ ngày tải nguồn cấp lên. Sử dụng tiêu chuẩn ISO‑8601 (YYYY‑MM‑DD). | 2017-08-01 |
| length_of_stay | Số đêm lưu trú tại khách sạn.Số ngày tối đa được phép: 14 | 7 |
| price | Tổng chi phí lưu trú, dựa trên checkin_date và length_of_stay. | 1393,00 USD |
| tax | Thuế suất áp dụng cho giá. | 14 |
| fees | Phí áp dụng cho giá. | 253,00 USD |
Điểm đến
Cần ví dụ? Hãy nhấp chuột phải và lưu một trong các liên kết sau vào máy tính để xem tệp nguồn cấp trông ra sao ở các định dạng khác nhau.
| Tên cột | Mô tả / Hướng dẫn | Ví dụ |
|---|---|---|
| destination_id | ID duy nhất của điểm đến.Số ký tự tối đa: 100 | FB_destination_1234 |
| name | Tên của điểm đến | Khu vực vịnh Peninsula |
| address.city | Thành phố của điểm đến. | Menlo Park |
| address.region | Tiểu bang, hạt, tỉnh hoặc vùng của điểm đến. | California |
| address.country | Quốc gia của điểm đến. | Hoa Kỳ |
| address.postal_code | Mã bưu chính hoặc mã zip của điểm đến. Đây là thông tin không bắt buộc đối với các quốc gia không có hệ thống mã bưu chính. | 94025 |
| image[0].url | URL của hình ảnh được sử dụng trong quảng cáo. Đối với tỷ lệ khung hình vuông (1: 1) trong định dạng quảng cáo quay vòng, kích thước hình ảnh phải là 600x600. Đối với quảng cáo một hình ảnh, kích thước hình ảnh tối thiểu phải là 1200x630 pixel. Nếu bạn có nhiều hình ảnh, hãy thêm cột bổ sung cho mỗi loại và sử dụng cú pháp đường dẫn JSON trong mỗi tên cột để cho biết số lượng hình ảnh (ví dụ: image[0].url; image[1].url).Số lượng tối đa: 20 | https://www.facebook.com/image_001.jpg |
| type[0] | (Các) loại điểm đến (ví dụ: công viên hoặc bãi biển). Điểm đến có thể có nhiều loại. Nếu cần thêm nhiều loại, hãy thêm cột bổ sung cho mỗi loại và sử dụng cú pháp đường dẫn JSON trong mỗi tên cột để cho biết số loại (ví dụ: type[0], type[1]).Số lượng tối đa: 20 | thành phố |
| url | Liên kết đến trang web mà bạn có thể đặt điểm đến. | https://www.facebook.com/destination |
Chuyến bay
Cần ví dụ? Hãy nhấp chuột phải và lưu một trong các liên kết sau vào máy tính để xem tệp nguồn cấp trông ra sao ở các định dạng khác nhau.
| Tên cột | Mô tả / Hướng dẫn | Ví dụ |
|---|---|---|
| origin_airport | Sân bay xuất phát của chuyến bay. Sân bay xuất phát phải được viết dưới dạng mã IATA (ví dụ: SFO). | SFO |
| destination_airport | Sân bay đích của chuyến bay. Sân bay đích phải được viết dưới dạng mã IATA (ví dụ: JFK). | JFK |
| image[0].url | URL của hình ảnh được sử dụng trong quảng cáo. Đối với tỷ lệ khung hình vuông (1: 1) trong định dạng quảng cáo quay vòng, kích thước hình ảnh phải là 600x600. Đối với quảng cáo một hình ảnh, kích thước hình ảnh tối thiểu phải là 1200x630 pixel. Nếu bạn có nhiều hình ảnh, hãy thêm cột bổ sung cho mỗi loại và sử dụng cú pháp đường dẫn JSON trong mỗi tên cột để cho biết số lượng hình ảnh (ví dụ: image[0].url; image[1].url).Số lượng tối đa: 20 | https://www.facebook.com/image_001.jpg |
| description | Mô tả chuyến bay.Giới hạn ký tự tối đa: 5000 | Đặt vé từ SFO đến JFK |
| url | Liên kết đến trang web mà bạn có thể đặt chuyến bay. | https://www.facebook.com/flights |
Bất động sản
Cần ví dụ? Hãy nhấp chuột phải và lưu một trong các liên kết sau vào máy tính để xem tệp nguồn cấp trông ra sao ở các định dạng khác nhau.
| Tên cột | Mô tả / Hướng dẫn | Ví dụ |
|---|---|---|
| home_listing_id | ID duy nhất của danh sách nhà. | FB_home_1234 |
| name | Tên của danh sách nhà | 1 Hacker Way, Menlo Park, CA 94025 |
| image[0].url | URL của hình ảnh được sử dụng trong quảng cáo. Đối với tỷ lệ khung hình vuông (1: 1) trong định dạng quảng cáo quay vòng, kích thước hình ảnh phải là 600x600. Đối với quảng cáo một hình ảnh, kích thước hình ảnh tối thiểu phải là 1200x630 pixel. Nếu bạn có nhiều hình ảnh, hãy thêm cột bổ sung cho mỗi loại và sử dụng cú pháp đường dẫn JSON trong mỗi tên cột để cho biết số lượng hình ảnh (ví dụ: image[0].url; image[1].url).Số lượng tối đa: 20 | https://www.facebook.com/image_001.jpg |
| address.addr1 | Địa chỉ đường của danh sách. | 1 Hacker Way |
| address.city | Thành phố của danh sách. | Menlo Park |
| address.region | Tiểu bang, hạt, vùng hoặc tỉnh của danh sách. | California |
| address.country | Quốc gia của danh sách. | Hoa Kỳ |
| address.postal_code | Mã bưu chính hoặc mã zip của điểm đến. Đây là thông tin không bắt buộc đối với các quốc gia không có hệ thống mã bưu chính. | 94025 |
| neighborhood[0] | Hàng xóm của danh sách nhà. Nếu bạn có nhiều hàng xóm, hãy thêm cột bổ sung cho mỗi loại và sử dụng cú pháp đường dẫn JSON trong mỗi tên cột để cho biết số lượng hàng xóm (ví dụ: neighborhood[0]; neighborhood[1]).Số lượng hàng xóm tối đa cho phép: 20 | Belle Haven |
| latitude | Vĩ độ của danh sách. | 37.4845 |
| longitude | Kinh độ của danh sách. | -122.14789 |
| price | Giá và đơn vị tiền tệ của danh sách nhà. Giá là một số mà sau đó là mã đơn vị tiền tệ (chuẩn ISO 4217). | 125000000,00 USD |
| availability | Tình trạng nhà hiện tại của danh sách. Hỗ trợ: for_sale, for_rent, sale_pending, recently_sold, off_market, available_soon | for_sale |
| url | Liên kết đến trang web mà bạn có thể xem danh sách. | https://www.facebook.com/home_listing |
Ô tô
Cần ví dụ? Hãy nhấp chuột phải và lưu một trong các liên kết sau vào máy tính để xem hình thức của tệp nguồn cấp dữ liệu ở các định dạng khác nhau.
| Tên cột | Mô tả / Hướng dẫn | Ví dụ |
|---|---|---|
| vehicle_id | ID duy nhất của xe.Số ký tự tối đa: 100 | 2017 Facebook Selfie |
| vin | Số nhận dạng của xe. | 1FADP5AU6DL536022 |
| make | Hãng hoặc thương hiệu của xe. | |
| model | Mẫu xe | Selfie |
| transmission | Loại truyền động của xe.Giá trị được hỗ trợ: Tự động, Thủ công | Tự động |
| body_style | Kiểu thân xe.Giá trị được hỗ trợ: Convertible, Coupe, Hatchback, Minivan, Truck, SUV, Sedan, Van, Wagon, Crossover, Khác | Coupe |
| drivetrain | Hệ thống truyền động của xe. Giá trị được hỗ trợ: 4x2, 4x4, AWD, FWD, RWD, Khác | FWD |
| image[0].url | URL của hình ảnh được sử dụng trong quảng cáo. Đối với tỷ lệ khung hình vuông (1: 1) trong định dạng quảng cáo quay vòng, kích thước hình ảnh phải là 600x600. Đối với quảng cáo một hình ảnh, kích thước hình ảnh tối thiểu phải là 1200x630 pixel. | https://www.facebook.com/image001.jpg |
| mileage.value | Quãng đường đã đi của xe. Đối với xe đã qua sử dụng, đây là quãng đường đã đi của xe tính bằng kilômét (KM) hoặc dặm (MI). Đối với xe mới, hãy sử dụng "zero". | zero |
| mileage.unit | Đơn vị của quãng đường đã đi.Giá trị được hỗ trợ: MI, KM | MI |
| url | Liên kết tới trang web bên ngoài nơi bạn có thể xem xe. | https://www.facebook.com/vehicle |
| title | Tiêu đề của danh sách xe. | Hiện có: 2017 Facebook Selfie |
| price | Giá của chiếc xe. Giá là một số mà sau đó là mã đơn vị tiền tệ (chuẩn ISO 4217). | 32000,00 USD |
| state_of_vehicle | Trạng thái hiện tại của xe. Bạn có thể sử dụng mới, đã qua sử dụng hoặc xe cũ tân trang được chứng nhận (CPO).Giá trị được hỗ trợ: Mới, Đã qua sử dụng, CPO | Mới |
| exterior_color | Màu bên ngoài của xe. | Trắng |
| address.addr1 | Địa chỉ đường của đại lý. | 1 Hacker Way |
| address.city | Thành phố đặt đại lý. | Menlo Park |
| address.region | Tiểu bang, hạt, vùng hoặc tỉnh của đại lý. | CA |
| address.country | Quốc gia đặt đại lý. | Hoa Kỳ |
| latitude | Vĩ độ của đại lý. | 37,4845 |
| longitude | Kinh độ của đại lý. | -122,14789 |
Cột nguồn cấp dữ liệu tùy chọn
Nếu muốn thêm các chi tiết bổ sung về mặt hàng vào quảng cáo, bạn có thể thêm các cột tùy chọn vào tệp nguồn cấp dữ liệu. Bạn có thể tìm thấy danh sách các cột tùy chọn cho mặt hàng của mình tại đây:
* Nguồn: Facebook