Tài liệu Hotel feed của OpenAI đã bổ sung quy trình dùng Ads API công khai, từ truy vấn dữ liệu khách sạn đến tạo chiến dịch và xem trước quảng cáo. Tính năng vẫn thuộc beta giới hạn, chỉ dành cho nhà quảng cáo được duyệt tham gia thử nghiệm—chưa phải beta mở hay phát hành rộng rãi. Điểm hữu ích cho đội triển khai là quy trình kiểm tra rõ hơn, tránh nhầm một bản ghi truy vấn được với quảng cáo đã đủ điều kiện phân phối.

Có gì thay đổi, và giới hạn nào vẫn giữ nguyên?

GPTAd ghi nhận phần tài liệu bổ sung ngày 30/10/2026 khi đối chiếu với lần kiểm tra ngày 29/10. Đây là ngày chúng tôi phát hiện thay đổi, không phải ngày OpenAI công bố triển khai. Hướng dẫn Hotel bổ sung cách liệt kê nguồn dữ liệu, truy vấn bản ghi, lọc Hotel Set, tạo chiến dịch và xem trước mẫu quảng cáo; các tài liệu API liên quan cũng làm rõ giới hạn riêng của Hotel.

Hiện chiến dịch Hotel hỗ trợ mục tiêu Clicks, đặt giá thầu CPC thủ công và nhắm đối tượng trên toàn nước Mỹ. Chưa hỗ trợ khu vực hẹp hơn, loại trừ địa lý hay giới hạn nền tảng. Nếu không khai báo vị trí nhắm đối tượng, chiến dịch Hotel mặc định chọn Mỹ. Cập nhật này không xác nhận quảng cáo Hotel đã hỗ trợ tiếp cận người dùng tại Việt Nam.

Tách ba bước kiểm tra độc lập

1. Xử lý dữ liệu: truyền tệp thành công chưa chứng minh các dòng đã được chấp nhận. Cần kiểm tra Upload History và thông tin lỗi. Hotel dùng định dạng hotel_property_v1, mỗi dòng là một cơ sở lưu trú, không phải một phòng hay ưu đãi theo ngày. Phạm vi tài liệu là bản chụp dữ liệu đầy đủ, không bao gồm cập nhật Hotel qua Delta API hoặc tình trạng còn phòng theo ngày lưu trú.

2. Chọn cơ sở lưu trú: POST /v1/feeds/{feed_id}/items/query trả về bản ghi hiện hành đủ điều kiện dữ liệu quảng cáo và khớp bộ lọc, nhưng không yêu cầu đã được duyệt nội dung. Khi tạo nhóm quảng cáo, lưu cùng bộ lọc vào feed_set.filters. Bộ lọc này chọn khách sạn, không chọn vị trí người xem. Có bản ghi trong kết quả chưa có nghĩa bản ghi đó đủ điều kiện xem trước hoặc phân phối.

3. Xem trước: POST /v1/ads/{ad_id}/preview chọn một cơ sở lưu trú từ Hotel Set đã lưu. Cơ sở đó còn phải ở trạng thái hoạt động và đã được duyệt. Nếu không có bản ghi phù hợp, API có thể trả HTTP 422 dù truy vấn dữ liệu vẫn có kết quả. Yêu cầu xem trước không cho ghi đè ID khách sạn hay bộ lọc.

Không dùng lẫn cấu hình Hotel và Product

Chiến dịch chọn nguồn dữ liệu qua feed_selection, với inventory_type là hotel và schema_profile là hotel_property_v1; không gửi các trường cũ mode và product_feed_id. Nhóm quảng cáo dùng feed_set thay cho product_set, cùng fixed_bid và tính phí theo lượt nhấp. Mỗi nhóm có một quảng cáo dạng mẫu. Ảnh và trang đích lấy từ cơ sở lưu trú được chọn, thay vì khai báo riêng creative.file_id và creative.target_url.

Hồ sơ kiểm tra trước triển khai nên ghi lại feed ID, bộ lọc đã lưu, các item ID trả về, trạng thái duyệt và thời điểm tạo bản xem trước. Khi liệt kê feed hoặc lịch sử tải lên, cần gửi rõ inventory_type=hotel; bỏ qua tham số sẽ mặc định chọn Product. Khi truy vấn có nhiều trang, giữ nguyên bộ lọc và truyền last_id vào after nếu has_more là true.

Bản xem trước là bằng chứng tạm thời, cần giữ riêng tư

Phản hồi xem trước chứa mã HTML iframe trong data[0].body. Quảng cáo đã gửi lên nhưng đang tạm dừng có thể xem trước; bản nháp chưa gửi thì không. Đường dẫn có chữ ký cho phép mở mà không cần đăng nhập và hết hạn sau 24 giờ kể từ lúc tạo bản chụp. Gửi lại yêu cầu có thể dùng lại bản chụp cũ, không gia hạn thời gian. Vì vậy, cần giữ đường dẫn riêng tư và yêu cầu bản xem trước mới sau khi sửa dữ liệu hoặc quảng cáo.

Thẻ Hotel có thể hiển thị giá khởi điểm tĩnh và điểm đánh giá của khách. Những thông tin này không chứng minh còn phòng vào ngày cụ thể; hạng sao khách sạn cũng không phải điểm đánh giá của khách. Bản xem trước không bảo đảm quảng cáo sẽ được phân phối. Trạng thái active vẫn không bỏ qua điều kiện tài khoản, kiểm duyệt và các yêu cầu phân phối khác.

Khuyến nghị của GPTAd: coi xử lý dữ liệu, chọn bản ghi và xem trước là ba bước nghiệm thu riêng trước khi chạy thử. Đội chưa được duyệt quyền Hotel có thể chuẩn bị danh sách kiểm tra chất lượng dữ liệu, nhưng không nên hứa với khách hàng về quyền truy cập, phạm vi nhắm đối tượng hay ngày ra mắt.

Đọc thêm trên GPTAd: những điểm cần kiểm tra khi thay thế danh mục Product. Không nên mặc định các thiết lập Product này áp dụng cho Hotel.

GPTAd hoạt động độc lập với OpenAI. Bài viết phân tích tài liệu công khai, không xác nhận một tài khoản cụ thể đủ điều kiện tham gia.