Để quảng cáo danh sách cung ứng khách sạn trên Facebook, bạn phải chia sẻ thông tin về khách sạn của mình với Facebook. Bạn có thể thực hiện việc này bằng cách tạo một danh mục khách sạn rồi điền thông tin khách sạn vào danh mục đó. Bạn có thể điền và cập nhật danh mục theo 2 cách dưới đây:
Bạn có thể tạo và quản lý danh mục khách sạn trong Công cụ quản lý thương mại.
Cách sử dụng API để quản lý danh mục:
Nguồn cấp dữ liệu khách sạn là một file có danh sách cung ứng khách sạn. Mỗi dòng hoặc mục trong file này biểu thị một khách sạn. Bạn có thể sử dụng một hoặc nhiều nguồn cấp dữ liệu khách sạn, miễn là tất cả nguồn cấp dữ liệu cộng lại chứa toàn bộ danh sách cung ứng khách sạn của bạn.
Mẫu CSV | Mẫu TSV (đã làm phẳng) | Mẫu TSV (kiểu JSON)
"
dấu ngoặc kép"
. address
, neighborhood
hoặc image
, bạn có thể biểu thị bằng các giá trị mã hóa JSON hoặc bằng một tập hợp các cột văn bản thuần túy "đã làm phẳng" được gắn nhãn theo cú pháp đường dẫn JSON như address.city
, neighborhood[0]
, image[0].url
, image[0].tag[0]
, image[0].tag[1]
. Bạn có thể sử dụng cả hai quy ước thay cho nhau trong cùng một file.<listings>
gốc chứa một tập hợp nút <listing>
, mỗi nút biểu thị một khách sạn.<?xml
hợp lệ. Trình phân tích cú pháp nguồn cấp tự động phát hiện mã hóa văn bản UTF8
, UTF16
hoặc UTF32
và mặc định là LATIN1
nếu gặp trình tự byte không mong muốn. Bạn có thể cung cấp văn bản trong các giá trị trường bằng ngôn ngữ bất kỳ, tuy nhiên tên trường phải được cung cấp chính xác như dưới đây, bằng tiếng Anh.
Dưới đây là các trường thông tin được hỗ trợ dành cho những mặt hàng bạn thêm vào danh mục sản phẩm của mình.
Đối với danh mục được bản địa hóa, hãy xem phần trường thông tin được hỗ trợ cho quảng cáo khách sạn.
Trường thông tin và loại | Mô tả |
---|---|
loại: string | Bắt buộc. Độ dài tối đa: 100 Thông tin nhận dạng duy nhất cho khách sạn trong danh mục. Hệ thống sẽ khớp ID này với bất kỳ Ví dụ: |
loại: string | Bắt buộc nếu thêm thông tin phòng khách sạn. Nhập ID duy nhất cho loại phòng khách sạn. Số ký tự tối đa: 100 Ví dụ: |
loại: string | Bắt buộc. Tên phổ biến nhất của khách sạn. Ví dụ: |
loại: string | Bắt buộc. Kích thước tối đa: 5000 Phần mô tả tóm tắt về khách sạn. Ví dụ: |
loại: string | Bắt buộc nếu thêm thông tin phòng khách sạn. Ngày nhận phòng khi lưu trú ở khách sạn. Bạn có thể thêm tối đa 180 ngày từ ngày tải nguồn cấp dữ liệu lên. Hãy sử dụng tiêu chuẩn ISO-8601 ( Ví dụ: |
loại: string | Bắt buộc nếu thêm thông tin phòng khách sạn. Số đêm lưu trú ở khách sạn. Ví dụ: |
loại: string | Bắt buộc nếu thêm thông tin phòng khách sạn. Giá cơ bản mỗi đêm của phòng khách sạn. Hãy nhớ thêm loại đơn vị tiền tệ cho giá (ví dụ: USD cho đô la Mỹ). Hãy đặt định dạng giá như sau: chi phí rồi đến dấu cách, tiếp đó là mã đơn vị tiền tệ theo tiêu chuẩn ISO. Ví dụ: |
loại: string | Bắt buộc nếu thêm thông tin phòng khách sạn. Tổng giá khi lưu trú ở khách sạn, dựa vào Ví dụ: |
loại: string | Bắt buộc nếu thêm thông tin phòng khách sạn. Thuế suất áp dụng cho giá. Hãy đặt định dạng giá như sau: chi phí rồi đến dấu cách, tiếp đó là mã đơn vị tiền tệ theo tiêu chuẩn ISO. Ví dụ: |
loại: string | Bắt buộc nếu thêm thông tin phòng khách sạn. Phí áp dụng cho giá. Hãy đặt định dạng giá như sau: chi phí rồi đến dấu cách, tiếp đó là mã đơn vị tiền tệ theo tiêu chuẩn ISO. Ví dụ: |
loại: string | Bắt buộc. Liên kết đến trang web bên ngoài để đặt phòng khách sạn. Bạn cũng có thể chỉ định URL ở cấp độ quảng cáo bằng cách sử dụng Ví dụ: |
loại: object | Hãy xem phần Thông số đối tượng hình ảnh. |
loại: object | Hãy xem phần Thông số đối tượng hình ảnh. |
loại: string | Bắt buộc. Tên thương hiệu của chuỗi khách sạn. Ví dụ: |
loại: object | Hãy xem phần Thông số đối tượng địa chỉ. |
loại: string | Bắt buộc. Số lượng khu vực tối đa cho phép: 20 Khu vực nơi khách sạn tọa lạc. Nếu có nhiều khu vực, hãy thêm cột bổ sung cho từng khu vực và sử dụng cú pháp đường dẫn JSON trong từng tên cột để biểu thị số lượng khu vực. Ví dụ: |
loại: float | Bắt buộc. Vĩ độ của khách sạn. Ví dụ: |
loại: float | Bắt buộc. Kinh độ của khách sạn. Ví dụ: |
loại: string | Không bắt buộc. Giá ưu đãi mỗi đêm khi lưu trú ở khách sạn, dựa vào Ví dụ: |
loại: object | Hãy xem phần Thông số đối tượng xếp hạng của khách. |
loại: object | Hãy xem phần Thông số đối tượng xếp hạng của khách. |
loại: float | Hãy xem phần Thông số đối tượng xếp hạng của khách. |
loại: string | Không bắt buộc. Chương trình khách hàng thân thiết mà bạn dùng để kiếm điểm khi lưu trú ở khách sạn. Ví dụ: |
loại: integer | Không bắt buộc. Chỉ báo về khả năng sinh lợi của khách sạn, có giá trị từ 1 đến 10. Ví dụ: |
loại: string | Không bắt buộc. Số điện thoại chính của khách sạn. Ví dụ: |
loại: object | Không bắt buộc. Liên kết sâu thẳng đến trang chi tiết về khách sạn trong ứng dụng di động bằng cách sử dụng Liên kết ứng dụng. Bạn có thể chỉ định liên kết sâu theo thứ tự ưu tiên, từ cao nhất đến thấp nhất:
Tìm hiểu thêm về liên kết sâu sản phẩm. |
loại: integer | Không bắt buộc. Chỉ báo về mức độ ưu tiên của khách sạn, có giá trị từ 0 (mức ưu tiên thấp nhất) đến 5 (mức ưu tiên cao nhất). Ví dụ: |
loại: string | Không bắt buộc. Loại thuộc tính. Hạng mục có thể là bất kỳ loại nội dung mô tả nội bộ nào mà bạn muốn. Ví dụ: |
loại: integer | Không bắt buộc. Tổng số phòng/căn hộ trong bài niêm yết khách sạn này. Ví dụ: |
Loại: string | Kiểm soát việc trạng thái của mặt hàng là đang hoạt động hay đã lưu trữ trong danh mục. Mọi người chỉ có thể xem những mặt hàng đang hoạt động trong quảng cáo, cửa hàng hoặc bất kỳ kênh nào khác. Giá trị được hỗ trợ: Ví dụ: Lưu ý: Một số nền tảng đối tác như Shopify có thể đồng bộ mặt hàng với danh mục ở trạng thái đang thiết lập. Trạng thái này có ý nghĩa tương tự như Trước đây, trường này có tên là |
Loại: string | Số ký tự tối đa: 100 Tối đa 5 trường tùy chỉnh cho bất kỳ thông tin bổ sung nào mà bạn muốn dùng để lọc mặt hàng khi tạo nhóm. Ví dụ: bạn có thể dùng một trường tùy chỉnh để cho biết tất cả những phòng nằm trong đợt giảm giá mùa hè, rồi lọc những mặt hàng đó thành một nhóm. Trường này hỗ trợ bất kỳ giá trị văn bản nào, kể cả số. Ví dụ: Nguồn cấp dữ liệu bổ sung hỗ trợ trường này. |
Loại: int | Tối đa 5 trường tùy chỉnh cho bất kỳ thông tin bổ sung nào liên quan đến số mà bạn muốn dùng để lọc mặt hàng khi tạo nhóm. Với trường này, bạn có thể lọc theo phạm vi số (lớn hơn và nhỏ hơn) khi tạo nhóm. Ví dụ: bạn có thể dùng trường này để cho biết năm khai trương khách sạn, rồi lọc khoảng năm nhất định thành một nhóm. Trường này hỗ trợ số nguyên trong khoảng từ 0 đến 4.294.967.295. Trường này không hỗ trợ số âm, số thập phân hoặc dấu phẩy, chẳng hạn như -2, 5,5 hoặc 10.000. Ví dụ: |
Tên và loại trường | Mô tả |
---|---|
loại: string | Bắt buộc. Số mục tối đa: 20. Liên kết URL đến hình ảnh của mặt hàng sẽ xuất hiện trong quảng cáo. Hãy tuân thủ các quy cách hình ảnh sau đây:
Ví dụ: Ví dụ: |
loại: string | Không bắt buộc. Thẻ được thêm vào hình ảnh để cho biết nội dung trong hình ảnh. Một hình ảnh có thể liên kết với nhiều thẻ. Ví dụ:
|
Đối với những trường lồng nhau hoặc có nhiều giá trị như address
, bạn có thể biểu thị bằng các giá trị mã hóa JSON hoặc bằng một tập hợp các cột văn bản thuần túy "đã làm phẳng" được gắn nhãn theo cú pháp đường dẫn JSON (ví dụ: address.region
). Bạn có thể sử dụng cả hai quy ước thay cho nhau trong cùng một file.
Tên và loại trường | Mô tả |
---|---|
loại: object | Bắt buộc. Địa chỉ đường chính của khách sạn. Ví dụ: |
loại: object | Không bắt buộc. Địa chỉ đường thứ hai của khách sạn. Ví dụ: |
loại: object | Không bắt buộc. Địa chỉ đường thứ ba của khách sạn. Ví dụ: |
loại: string | Không bắt buộc. Giá trị để sử dụng trong URL liên kết sâu ( Ví dụ: |
loại: string | Bắt buộc. Thành phố nơi khách sạn tọa lạc. Ví dụ: |
loại: string | Bắt buộc. Tiểu bang, hạt hoặc tỉnh nơi khách sạn tọa lạc. Ví dụ: |
loại: string | Bắt buộc. Quốc gia nơi khách sạn tọa lạc. Ví dụ: |
loại: string | Bắt buộc đối với các quốc gia không có hệ thống mã bưu chính. Mã bưu chính hoặc mã zip của khách sạn. Ví dụ: |
Tên và loại trường | Mô tả |
---|---|
loại: object | Không bắt buộc. Tổng số người đã đánh giá khách sạn của bạn. Nếu trường này được chỉ định, bạn cũng phải cung cấp Ví dụ: |
| Không bắt buộc. Tổng số người đã xếp hạng khách sạn này. Ví dụ: |
loại: string | Không bắt buộc. Hệ thống bạn sử dụng cho bài đánh giá của khách. Ví dụ: |
loại: int | Bắt buộc. Giá trị tối đa của điểm xếp hạng khách sạn. Phải lớn hơn hoặc bằng 0 và nhỏ hơn hoặc bằng 100. Ví dụ: |
Bạn có thể sử dụng API Khách sạn để thêm, chỉnh sửa và gỡ trực tiếp khách sạn trong danh mục. Hãy sử dụng Tài liệu tham khảo về API Khách sạn để biết thêm thông tin về cách quản lý khách sạn bằng API.
Các phần sau chỉ phù hợp để quản lý danh mục bằng API này.
Danh mục khách sạn là vùng chứa danh sách cung ứng khách sạn. Để sử dụng API danh mục, hãy đảm bảo bạn có Cấp độ truy cập API Marketing thích hợp và bạn đã chấp nhận Điều khoản dịch vụ bằng cách tạo danh mục đầu tiên thông qua Trình quản lý kinh doanh.
Để tạo danh mục khách sạn cho quảng cáo khách sạn, hãy đặt vertical
thành destinations
:
curl -X POST \ -F 'name="Test Hotel Catalog"' \ -F 'vertical="hotels"' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v10.0/BUSINESS_ID/owned_product_catalogs
Sau khi tạo danh mục, bạn phải tải nguồn cấp dữ liệu khách sạn lên Facebook. Hãy sử dụng API này để tạo đối tượng nguồn cấp dữ liệu cho mọi nguồn cấp dữ liệu mà bạn muốn tải lên. Chúng tôi hỗ trợ tải lên theo lịch và tải lên trực tiếp.
Nhóm khách sạn là tập hợp con của danh mục. Để thiết lập quảng cáo khách sạn, bạn cần có nhóm khách sạn. Do đó, bạn cần tạo ít nhất một nhóm khách sạn.
Nhóm khách sạn được xác định bằng cách áp dụng bộ lọc cho danh mục khách sạn. Ví dụ: bạn có thể tạo một nhóm khách sạn chứa tất cả các khách sạn có star_rating
lớn hơn 3. Lưu ý: Bạn cũng có thể tạo nhóm khách sạn mà không có bộ lọc nào. Trong trường hợp đó, nhóm khách sạn sẽ chứa tất cả khách sạn trong danh mục của bạn.
Để tạo nhóm khách sạn chứa tất cả các khách sạn có "thương hiệu mẫu" được đề cập trong trường brand
:
curl -X POST \
-F 'name="Test Hotel Set"' \
-F 'filter={
"brand": {
"i_contains": "sample brand"
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<PRODUCT_CATALOG_ID>/product_sets
Thông số filter
được tạo thành từ các toán tử và dữ liệu sau:
Toán tử | Loại bộ lọc |
---|---|
| Chứa chuỗi con. Toán tử có phân biệt chữ hoa chữ thường. |
| Không chứa chuỗi con. Toán tử có phân biệt chữ hoa chữ thường. |
| Chứa chuỗi con. Toán tử có phân biệt chữ hoa chữ thường. |
| Không chứa chuỗi con. Toán tử có phân biệt chữ hoa chữ thường. |
| Bằng. Toán tử có phân biệt chữ hoa chữ thường. |
| Không bằng. Toán tử có phân biệt chữ hoa chữ thường. |
| Nhỏ hơn. Chỉ dành cho các trường số. |
| Nhỏ hơn hoặc bằng. Chỉ dành cho các trường số. |
| Lớn hơn. Chỉ dành cho các trường số. |
| Lớn hơn hoặc bằng. Chỉ dành cho các trường số. |
Dữ liệu | Dữ liệu được lọc. |
---|---|
| Thông tin nhận dạng duy nhất cho khách sạn trong danh mục. |
| Thương hiệu của chuỗi khách sạn. |
| Giá cơ bản mỗi đêm của khách sạn này. Giá tính bằng cent (4.999 có nghĩa là $49,99). |
| Giá ưu đãi mỗi đêm của khách sạn này. Giá tính bằng cent (4.999 có nghĩa là $49,99). |
| Đơn vị tiền tệ |
| Thành phố nơi khách sạn tọa lạc. |
| Quốc gia của khách sạn. |
| Tên phổ biến nhất của khách sạn. |
| Xếp hạng sao của khách sạn. Giá trị hợp lệ là từ 1 đến 5 và phải là bội số của 0,5. |