Thêm tập lệnh tùy chỉnh

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến Tài liệu về Apigee X. thông tin

Cách thêm mã JavaScript tuỳ chỉnh hoặc nội dung HTML trước thẻ <body> trên mỗi trang trong cổng thông tin của bạn:

  1. Chọn Xuất bản > Cổng thông tin và chọn cổng của bạn.
  2. Nhấp vào phần Cài đặt trên trang đích. Hoặc bạn có thể chọn Cài đặt trong trình đơn thả xuống ở thanh điều hướng trên cùng.
  3. Nhấp vào thẻ Tập lệnh tuỳ chỉnh.

  4. Trong mục Tập lệnh tùy chỉnh, hãy nhập mã JavaScript tùy chỉnh vào hộp văn bản. Bạn có thể thêm nhiều tập lệnh.

  5. Nhấp vào Lưu.

Các phần sau đây cung cấp ví dụ về tập lệnh tuỳ chỉnh:

Xem thêm bài viết Định cấu hình hoạt động theo dõi số liệu phân tích.

Thực thi tập lệnh tuỳ chỉnh trong sự kiện JavaScript onLoad hoặc onUnload

Xác định tập lệnh tuỳ chỉnh sẽ được thực thi khi mỗi trang trong cổng thông tin của bạn:

  • Tải vào DOM bằng cách sử dụng sự kiện JavaScript onLoad.
  • Thoát khỏi quá trình sử dụng sự kiện JavaScript onUnload.

Hàm tuỳ chỉnh của bạn phải được định nghĩa là một phần của portal.pageEventListeners trong không gian tên chung (được khai báo trên biến window).

Cả hai sự kiện onLoad và onUnload đều nhận được đường dẫn hiện tại của trang dưới dạng tham số đầu tiên (ví dụ: /quickstart). Hàm onUnload nhận giá trị trả về từ lệnh gọi onLoad cho phép truyền ngữ cảnh giữa 2 sự kiện dưới dạng tham số thứ hai. Sử dụng onUnload để dọn dẹp trình nghe sự kiện không còn cần thiết và thực hiện các hoạt động dọn dẹp khác.

Ví dụ:

<script>
window.portal = {};
window.portal.pageEventListeners = {
  onLoad: (path) => {
    if (path === '/quickstart') {
      // Change text content of first <p> element to something
      // else. (DOM must be loaded when onLoad is called)
      document.getElementsByTagName('p')[0].textContent =
          'Welcome to the quick start! Be sure to send us your feedback.';
      // print a custom message to the console every second while user is on
      // quickstart page.
      const interval =
          window.setInterval(() => console.log('Hello'), 1000);
      return interval;
    }
    return undefined;
  },
  onUnload: (path, contextReturnedFromOnLoad) => {
    if (contextReturnedFromOnLoad != null) {
      // Stop printing custom message to console every second.
      window.clearInterval(contextReturnedFromOnLoad)

    }
  },
};
</script>

Bạn có thể dùng tập lệnh tuỳ chỉnh để triển khai một giải pháp yêu cầu sự đồng ý sử dụng cookie. Có một số tuỳ chọn nguồn mở phổ biến được triển khai trong JavaScript; hãy chọn một mục đáp ứng các yêu cầu tuân thủ cụ thể của bạn.

Ví dụ: tập lệnh sau sử dụng Cookie Info Script.

<script type="text/javascript" id="cookieinfo" src="//cookieinfoscript.com/js/cookieinfo.min.js">
</script>