Skip to content

Tracking - Launcher ​

Tính năng này để làm gì ​

Launcher là nút nổi ở góc dưới website. Khách bấm vào là mở Panel: lời mời tham gia, điểm, ưu đãi và đăng nhập bằng Zalo. Bạn tự chỉnh chữ, icon, màu, vị trí và ẩn nút theo thiết bị hoặc theo trang, không phải sửa website.

Đường dẫn: Data Hub → Tracking → Website → mở project → tab Launcher

Bạn cũng vào được từ tab Tổng quan của project: thẻ Nút nổi Launcher → Cấu hình, hoặc bước Bật nút nổi Launcher trong mục Các bước cài đặt → Cấu hình Launcher. Thẻ Nút nổi Launcher cho biết trạng thái Đang bật hay Chưa bật.

Phải bấm Lưu ít nhất một lần

Form hiện sẵn giá trị mặc định, nhưng website chưa có nút cho tới khi bạn bấm Lưu lần đầu. Panel cũng vậy: nếu Panel chưa được lưu lần nào thì khách bấm nút sẽ không mở gì.

Bật Launcher ​

  1. Mở tab Launcher Mở project, chọn tab Launcher.
  2. Chỉnh nút Nhập chữ trên nút, chọn icon, kiểu dáng, màu và vị trí. Các trường được giải thích ở bảng bên dưới.
  3. Xem trước Cột bên phải có nút chuyển Desktop / Mobile, cập nhật ngay khi bạn sửa. Hình xem trước chỉ để minh hoạ, không đúng tỉ lệ thật và không mô phỏng phần ẩn theo trang.
  4. Lưu Bấm Lưu. Thấy thông báo Đã lưu cấu hình Launcher. là xong, không có bước Publish riêng.
  5. Kiểm tra trên website Khoảng 1 phút sau, mở website trong một tab ẩn danh để thấy nút mới.
Tab Launcher
Tab Launcher. Kéo xuống là các thẻ Hình dạng nút, Vị trí hiển thị, Màu sắc, Bố cục nội dung và các tuỳ chọn ẩn nút.
  1. Nội dung nút - chữ trên nút, nhập riêng cho Desktop và Mobile.
  2. Icon - chọn icon có sẵn hoặc Tải icon riêng.
  3. Xem trước - chuyển Desktop / Mobile, cập nhật ngay khi bạn sửa.
  4. Lưu - áp dụng cho website, không có bước Publish riêng.

Bao lâu khách thấy thay đổi

Lưu là áp dụng ngay, không cần sửa mã nhúng. Nhưng khách đang mở website có thể mất tới khoảng 6 phút mới thấy bản mới, vì máy chủ giữ cấu hình 1 phút và trình duyệt của khách giữ 5 phút. Website chỉ kiểm tra cấu hình mới khi khách tải lại trang.

Chuyển tab là mất thay đổi chưa lưu

Đang sửa mà chuyển sang tab khác thì các thay đổi chưa lưu sẽ mất, không có cảnh báo. Hãy bấm Lưu trước khi chuyển tab.

Các trường cấu hình ​

ThẻBạn chỉnh gìMặc địnhGiới hạn
Nội dung nútChữ trên nút, nhập riêng cho Desktop và MobileRewardsTối đa 30 ký tự
IconChọn một trong 5 icon có sẵn (Vương miện, Túi quà tặng, Nhãn giá, Ngôi sao, Hộp quà), hoặc Tải icon riêng từ kho mediaVương miệnChọn Tải icon riêng mà chưa chọn ảnh thì nút dùng icon có sẵn
Hình dạng nútKiểu dáng: Vuông, Vát góc, Bo góc, Bo trònBo tròn
Vị trí hiển thịĐặt riêng cho Desktop và Mobile: Bên trái hoặc Bên phải, Khoảng cách cạnh bên, Khoảng cách cạnh dưới (px)Desktop: bên phải, 20px, 20px. Mobile: bên phải, 16px, 16px0 đến 500px
Màu sắcMàu nền nút và Màu chữ / iconNền tím #6C5CE7, chữ trắng #FFFFFFMàu chữ / icon áp cho cả icon có sẵn; icon tự tải giữ màu gốc
Bố cục nội dungDesktop: Icon kèm chữ, Chỉ chữ hoặc Chỉ icon. Mobile: Chỉ chữ hoặc Chỉ iconDesktop: Icon kèm chữ. Mobile: Chỉ chữChọn Chỉ chữ mà để trống chữ sẽ ra nút rỗng
Hiển thị theo thiết bịPhạm vi hiển thị: Desktop và mobile, Chỉ desktop, Ẩn hoàn toànDesktop và mobileKhông có lựa chọn "chỉ mobile"
Hiển thị theo trangẨn trên trang chủ và danh sách Ẩn Launcher trên các URL chứaKhông ẩn trang nàoTối đa 50 điều kiện, mỗi điều kiện 1 đến 300 ký tự
Thứ tự hiển thị (z-index)Dùng z-index tuỳ chỉnh và Thêm quy tắc !importantTắtChỉ dùng khi nút bị một thành phần khác của website che mất

Ẩn hoặc tắt nút theo thiết bị ​

Launcher phân biệt điện thoại và máy tính theo bề rộng màn hình, không theo loại máy: màn rộng từ 768px trở xuống là mobile. Vì vậy cửa sổ máy tính kéo hẹp lại sẽ hiện kiểu mobile, còn máy tính bảng xoay ngang rộng hơn 768px hiện kiểu desktop. Khi khách xoay máy hoặc đổi cỡ cửa sổ, nút tự đổi theo.

Không có công tắc bật/tắt riêng. Muốn tắt Launcher, chọn Ẩn hoàn toàn ở thẻ Hiển thị theo thiết bị rồi bấm Lưu.

Ẩn nút trên một số trang ​

  • Ẩn trên trang chủ: chỉ ẩn khi đường dẫn đúng là /, kể cả khi có tham số như /?utm_source=zalo. Các trang như /index.html hay /vi/ không được tính là trang chủ.
  • Ẩn Launcher trên các URL chứa: bấm Thêm điều kiện và nhập một đoạn đường dẫn. Nút bị ẩn ở mọi trang có đường dẫn chứa đoạn đó. Hệ thống so với phần sau tên miền, gồm đường dẫn và tham số (ví dụ /checkout?step=2), không gồm tên miền và phần sau dấu #. Có phân biệt chữ hoa, chữ thường.
Điều kiệnẨn ởVẫn hiện ở
/checkout/checkout, /checkout/success, /en/checkout, cả /checkout-guide/cart, /san-pham/ao-thun
/cart/cart, cả /cart-items/checkout
?ref=abc/san-pham?ref=abc/san-pham

Những lỗi hay gặp khi nhập điều kiện

  • Điều kiện chỉ có dấu / sẽ ẩn nút trên mọi trang, vì đường dẫn nào cũng chứa /.
  • Dán cả địa chỉ như https://shop.vn/checkout sẽ không bao giờ khớp. Chỉ nhập phần sau tên miền: /checkout.
  • Không có ký tự đại diện: dấu * được hiểu đúng là ký tự *.
  • Nên dùng đường dẫn không dấu. Đường dẫn có dấu tiếng Việt bị trình duyệt mã hoá (dạng %C3%A1) nên điều kiện gõ có dấu khó khớp.
  • Website dùng đường dẫn dạng #/trang không lọc được theo trang, vì phần sau # không được so.
  • Không để dòng điều kiện trống và không thêm khoảng trắng thừa ở đầu, cuối.

Khách thấy gì trên website ​

  • Nút nằm cố định ở góc dưới, mặc định bên phải. Giao diện của website không làm vỡ được nút.
  • Bấm nút mở Panel ngay phía trên nút, cùng phía với nút. Khi Panel đang mở, nút chỉ còn dấu ×.
  • Khách đóng Panel bằng dấu × trên Panel, bấm lại nút hoặc nhấn phím Esc. Bấm ra ngoài Panel thì Panel không đóng.
  • Nút không hiện số điểm hay số ưu đãi. Khách đã đăng nhập vẫn thấy nút như cũ, chỉ nội dung Panel thay đổi.
  • Với website dạng SPA, nút tự kiểm tra lại điều kiện ẩn mỗi lần khách chuyển trang.

Lỗi thường gặp ​

Hiện tượngNguyên nhân thường gặpCách xử lý
Website chưa có nútChưa bấm Lưu lần nào, đang chọn Ẩn hoàn toàn, domain chưa được khai trong project, hoặc mã nhúng chưa chạyBấm Lưu ở tab Launcher; kiểm tra Các bước cài đặt ở tab Tổng quan
Vừa sửa mà website chưa đổiMáy chủ và trình duyệt còn giữ cấu hình cũ, tới khoảng 6 phútMở website trong tab ẩn danh sau khoảng 1 phút
Bấm nút không mở gìPanel chưa được lưu lần nàoVào tab Panel, chỉnh nội dung rồi bấm Lưu
Nút ẩn trên mọi trangCó điều kiện chỉ là /Xoá điều kiện đó
Nút bị một thành phần của website cheThành phần đó nằm lớp trênBật Dùng z-index tuỳ chỉnh, nếu vẫn bị che thì bật thêm Thêm quy tắc !important
Lưu báo lỗiKhoảng cách lớn hơn 500px, có dòng điều kiện trống, hoặc quá 50 điều kiệnSửa lại trường bị báo rồi Lưu
Nút không có chữChọn Chỉ chữ nhưng để trống Nội dung nútNhập chữ, hoặc đổi sang Chỉ icon

Bước tiếp theo ​

Tài liệu hướng dẫn sử dụng nền tảng CNV CDP