Trợ giúp
Đăng nhập

Tiện ích mở rộng và hàm của ứng dụng

Một số ứng dụng thêm tính năng vào cửa hàng bằng các tiện ích mở rộng và hàm. Các tiện ích mở rộng và hàm do nhà phát triển ứng dụng thiết lập và sẽ khả dụng khi bạn cài đặt và kích hoạt ứng dụng.

Tiện ích mở rộng cho phép ứng dụng thêm chức năng vào các khu vực như Cửa hàng trực tuyến, trang thanh toán, tài khoản khách hàng hoặc Điểm bán hàng. Ví dụ: ứng dụng có thể thêm trường tùy chỉnh vào trang thanh toán, mở bot trò chuyện trên cửa hàng trực tuyến hoặc hiển thị điểm khách hàng thân thiết trong tài khoản khách hàng.

Functions cho phép ứng dụng tùy chỉnh logic hệ thống phụ trợ (backend) của cửa hàng. Ví dụ: ứng dụng có thể dùng một Function để tạo loại giảm giá tùy chỉnh, điều chỉnh tùy chọn vận chuyển khi thanh toán hoặc áp dụng quy tắc thanh toán cụ thể. Functions chạy tự động như một phần hoạt động của cửa hàng sau khi bạn thiết lập ứng dụng.

Có thể xem và quản lý các tiện ích mở rộng và hàm của ứng dụng đã cài đặt tại Cài đặt > Ứng dụng trong bảng điều khiển quản trị Shopify. Trên trang giới thiệu ứng dụng, các thẻ Tiện ích mở rộng và Functions hiển thị số lượng đang hoạt động và những khu vực trong cửa hàng có thể sử dụng chúng. Di chuột lên tên các khu vực để xem nơi chúng đang hoạt động, chẳng hạn như Trang thanh toán, Tài khoản khách hàng, Cửa hàng trực tuyến hoặc Điểm bán hàng đối với tiện ích mở rộng; Trang thanh toán, Giảm giá, Thanh toán hoặc Vận chuyển và giao hàng đối với hàm.

Nhấp vào Tiện ích mở rộng hoặc Functions để xem danh sách đầy đủ của ứng dụng đó. Trên trang Tiện ích mở rộng hoặc Functions, có thể chuyển giữa các tab Đang hoạt động và Không hoạt động để xem những tiện ích mở rộng hoặc hàm nào đang chạy. Nhấp vào tiện ích mở rộng hoặc hàm để mở. Tùy từng tiện ích mở rộng, thao tác này sẽ đưa đến khu vực trong cửa hàng nơi có thể kích hoạt hoặc quản lý tiện ích đó, hoặc đến trang chi tiết về tình trạng hoạt động của tiện ích.

Nếu là nhà phát triển ứng dụng, hãy tham khảo dev docs của Shopify về tiện ích mở rộng và dev docs của Shopify về Functions để xem tài liệu kỹ thuật.

Trên trang này

Kích hoạt tiện ích mở rộng và Functions

Bạn có thể kích hoạt và hủy kích hoạt tiện ích mở rộng cùng Functions trong khu vực sử dụng chúng trên bảng điều khiển quản trị Shopify. Từ trang Tiện ích mở rộng hoặc Functions trong phần cài đặt ứng dụng, nhấp vào tên tiện ích mở rộng hoặc Function để chuyển đến khu vực quản lý. Sau khi kích hoạt, tiện ích mở rộng hoặc Function sẽ hiển thị trạng thái hoạt động trên trang giới thiệu ứng dụng.

Nếu có quyền xem chi tiết về tình trạng hoạt động của tiện ích mở rộng, khi nhấp vào tiện ích mở rộng cho trang thanh toán hoặc tài khoản khách hàng, trang chi tiết về tình trạng hoạt động sẽ mở ra thay vì trình chỉnh sửa. Để mở trình chỉnh sửa cho một trong các tiện ích này, di chuột lên hàng của tiện ích mở rộng, rồi nhấp vào biểu tượng Mở trong trình chỉnh sửa.

Tiện ích mở rộng

Có thể kích hoạt tiện ích mở rộng trong các khu vực sau trên bảng điều khiển quản trị Shopify:

Functions

Có thể kích hoạt Functions trong các khu vực sau trên bảng điều khiển quản trị Shopify:

Sự kiện ứng dụng từ tiện ích mở rộng

Ứng dụng có thể sử dụng tiện ích mở rộng trang thanh toán và tài khoản khách hàng để gửi sự kiện ứng dụng cho Shopify. Sự kiện ứng dụng ghi lại một hành động trong tiện ích mở rộng, chẳng hạn như khi khách hàng xem ưu đãi. Shopify sử dụng sự kiện ứng dụng để hiển thị cách khách hàng dùng ứng dụng trong mục phân tích cửa hàng. Nhà phát triển ứng dụng cũng có thể xem các sự kiện để theo dõi và hỗ trợ ứng dụng của họ, bao gồm cả cho mục đích phân tích riêng.

Sự kiện ứng dụng trên trang thanh toán và tài khoản khách hàng chỉ được gửi sau khi khách hàng cho phép phân tích trong cài đặt quyền riêng tư của khách hàng. Shopify có thể trả về cho thương nhân thông tin tổng hợp liên quan đến ID khách truy cập và ID phiên, đính kèm với sự kiện ứng dụng của nhà phát triển, nhằm phục vụ mục đích phân tích của thương nhân. Nếu không muốn ứng dụng gửi sự kiện ứng dụng trên cửa hàng trực tuyến, hãy gỡ cài đặt ứng dụng.

Tìm hiểu về tình trạng hoạt động của tiện ích mở rộng

Tình trạng hoạt động của tiện ích mở rộng cho biết mức độ ổn định khi tải các tiện ích mở rộng của ứng dụng trên trang thanh toán hoặc tài khoản khách hàng. Khi tiện ích mở rộng ứng dụng không tải được, khách hàng không thể sử dụng tính năng mà tiện ích đó bổ sung vào trang thanh toán hoặc tài khoản khách hàng, chẳng hạn như trường tùy chỉnh hoặc điểm thưởng.

Lưu ý về tình trạng hoạt động của tiện ích mở rộng

Trước khi xem tình trạng hoạt động của tiện ích mở rộng ứng dụng, hãy xem các lưu ý sau:

  • Tình trạng hoạt động chỉ được đo lường đối với các tiện ích mở rộng đang hoạt động trên trang thanh toán và tài khoản khách hàng.
  • Tình trạng hoạt động không được đo lường đối với các tiện ích mở rộng ở những khu vực khác, như Cửa hàng trực tuyến hoặc Điểm bán hàng, cũng như đối với các hàm.
  • Tỷ lệ tải không thành công được ước tính thận trọng, nên tiện ích mở rộng có ít lượt tải sẽ ít có khả năng bị gắn cờ chỉ vì một vài lần tải không thành công.

Cách hiển thị tình trạng hoạt động của tiện ích mở rộng

Mỗi tiện ích mở rộng cho trang thanh toán và tài khoản khách hàng hiển thị một trong các trạng thái hoạt động sau:

  • Tốt: Không phát hiện lỗi tải kéo dài ở tiện ích mở rộng.
  • Cảnh báo: Hơn 5% lượt tải tiện ích mở rộng trong 7 ngày qua không thành công và tỷ lệ tải không thành công duy trì trên 5% trong 72 giờ.
  • Nghiêm trọng: Hơn 50% lượt tải tiện ích mở rộng trong 7 ngày qua không thành công và tỷ lệ tải không thành công duy trì trên 50% trong 48 giờ.
  • Chưa đủ dữ liệu: Chưa đủ dữ liệu để đo lường tình trạng hoạt động của tiện ích mở rộng. Trạng thái này hiển thị khi tiện ích mở rộng có ít hơn 10 lượt tải trong 7 ngày qua hoặc khi phiên bản hiện tại chưa có đủ lịch sử hoạt động. Tình trạng hoạt động được đo lường riêng cho từng phiên bản của tiện ích mở rộng. Vì vậy, tiện ích mở rộng mới cập nhật có thể mang trạng thái này cho đến khi phiên bản mới hoạt động được ít nhất 7 ngày, ngay cả khi được tải thường xuyên.

Các tiện ích mở rộng cũng có trang chi tiết hiển thị trạng thái hoạt động và các số liệu sau trong 7 ngày qua:

  • Tỷ lệ tải không thành công: Tỷ lệ lượt tải không thành công trên tổng số lượt tải tiện ích mở rộng.
  • Số lần tải không thành công: Số lần tiện ích mở rộng không tải được do sự cố ứng dụng.
  • Lượt tải tiện ích mở rộng: Số lần tiện ích mở rộng được tải.

Xem tình trạng hoạt động của tiện ích mở rộng

  1. Trong bảng điều khiển quản trị Shopify, vào Cài đặt > Ứng dụng.

  2. Nhấp vào ứng dụng cần xem.

  3. Nhấp vào Tiện ích mở rộng.

  4. Trong tab Đang hoạt động, xem cột Tình trạng hoạt động của từng tiện ích mở rộng cho trang thanh toán và tài khoản khách hàng.

  5. Không bắt buộc: Để xem thêm chi tiết, nhấp vào tên tiện ích mở rộng.

Xử lý lỗi tải tiện ích mở rộng

Nếu tiện ích mở rộng có trạng thái Cảnh báo hoặc Nghiêm trọng, biểu ngữ trên trang chi tiết tiện ích mở rộng sẽ cho biết lỗi xuất phát từ ứng dụng và nhà phát triển ứng dụng đã được thông báo. Để mở tiện ích mở rộng trong trình chỉnh sửa, nhấp vào Mở trong trang thanh toán hoặc Mở trong tài khoản khách hàng. Để được hỗ trợ về tiện ích mở rộng, liên hệ với nhà phát triển ứng dụng.

Nếu trạng thái của tiện ích mở rộng chuyển thành Nghiêm trọng, nhân viên có quyền xem tình trạng hoạt động của tiện ích mở rộng sẽ nhận được cảnh báo trong bảng tin Cảnh báo của cửa hàng. Nhấp vào cảnh báo để mở trang chi tiết tiện ích mở rộng.

Khắc phục sự cố lỗi Function

Nếu Function gặp lỗi, cảnh báo sẽ hiển thị trên thẻ Functions ở trang giới thiệu ứng dụng và trên trang Functions. Thẻ này hiển thị Lỗi ở [number] khu vực thay vì số khu vực khả dụng thông thường, và cảnh báo cho biết thời điểm phát hiện các lỗi gần nhất.

Trên trang Hàm, các hàm có lỗi sẽ được đánh dấu bằng biểu tượng Cảnh báo. Nếu hàm có lỗi, hãy liên hệ với nhà phát triển ứng dụng để được trợ giúp. Trong một số trường hợp, lỗi có thể đã được giải quyết. Bạn cũng có thể chia sẻ nhật ký hàm để giúp nhà phát triển khắc phục sự cố.