Hướng dẫn tích hợp Plugin

Chuẩn bị

Trước khi bắt đầu, bạn cần chuẩn bị các thông tin sau:

• Mã nguồn website của bạn, bao gồm:
  • Trang chứa phần Đặt vé (bắt buộc), ví dụ: /flight hoặc https://yourdomain.com/flight
• Mã đại lý: Được Datacom cung cấp, hoặc tự đăng ký tại đây.

Bước 1: Xây dựng form Tìm kiếm

• Loại hành trình.
• Điểm đi.
• Điểm đến.
• Ngày đi.
• Ngày về.
• Số lượng khách.
• Các tùy chọn khác.

Đội ngũ chuyên viên của Datacom sẵn sàng tư vấn và hỗ trợ lập trình viên của đại lý xây dựng form Tìm kiếm.

Bước 2: Tạo tham số tìm kiếm chuyến bay

Sau khi xây dựng xong form Tìm kiếm. Bạn cần lấy thông tin khách hàng đã nhập trên form, ghép thành chuỗi tham số (URL params) để chuyển hướng sang trang Đặt vé. Cách thực hiện như sau:

Nếu bạn muốn tìm kiếm chuyến bay Một chiều từ Hà Nội tới Tp. Hồ Chí Minh vào ngày 12/03/2025 cho 2 người lớn, 1 trẻ em, 1 trẻ sơ sinh. Cấu trúc đường link để tìm kiếm sẽ là:

dtcr=HANSGN12032025&dtcp=211

Trong đó:

• dtcr: Hành trình muốn tìm kiếm:
  • Thực hiện ghép các thông tin các chặng bay theo cú pháp: [Điểm đi][Điểm đến][Ngày đi]
  • Điểm đi, điểm đến: Là mã sân bay theo chuẩn IATA.
  • Ngày đi: Định dạng ddMMyyyy (ngày tháng năm).
  • Để tìm kiếm khứ hồi hoặc đa chặng, nối các chặng bay bằng dấu gạch ngang "-", ví dụ:
    • Tìm kiếm khứ hồi: HANSGN12032025-SGNHAN15032025
    • Tìm kiếm đa chặng: HANSGN12032025-SGNDAD15032025-DADPQC20032025
• dtcp: Số lượng khách:
  • Được ghép từ số lượng của từng đối tượng hành khách muốn đặt chỗ, theo thứ tự: Người lớn > Trẻ em > Trẻ sơ sinh.
  • Ví dụ:
    • Chỉ có 1 người lớn: 100
    • Có 2 người lớn, 1 trẻ em: 210
    • Có 2 người lớn, 2 trẻ em, 1 trẻ sơ sinh: 221
  • Tổng số lượng hành khách không được lớn hơn 9.
  • Số lượng trẻ sơ sinh phải ít hơn hoặc bằng số lượng người lớn.

Sau khi xây dựng được các tham số, bạn chỉ cần ghép với đường dẫn trang chứa phần Đặt vé, ví dụ:

/flight?dtcr=HANSGN12032025&dtcp=211

Xử lý sự kiện bấm vào nút Tìm kiếm trên from > Chuyển hướng sang trang Đặt vé, Plugin sẽ tự động đọc các tham số và tìm kiếm chuyến bay theo thông tin đã chọn.

Bước 3: Tích hợp trang Đặt vé

Sao chép và dán đoạn mã dưới đây vào mã nguồn (HTML) website của bạn, tại vị trí muốn hiển thị phần Đặt vé:

Lưu ý : Thay DC120386 trong đoạn mã thành Mã đại lý mà bạn đã được cấp.

<div id="dtc-plugin" data-key="DC120386"></div>
<script type="text/javascript">
(function () {
    var dtcScript = document.createElement('script');
    dtcScript.src = 'https://plg.datacom.vn/js/plugin.js';
    dtcScript.setAttribute('asp-append-version', 'true');
    document.head.appendChild(dtcScript);
})();
</script>

Nhập giá trị các tham số ở thẻ  <div id="dtc-plugin"></div>

Sau khi tích hợp, phần hiển thị Kết quả tìm kiếm chuyến bay và Đặt vé sẽ xuất hiện như minh họa dưới đây: