Quy Tắc Tích Điểm Tùy Chỉnh trong Hệ Thống Thành Viên

Bạn hiện có thể tạo quy tắc điểm tùy chỉnh trong Hệ thống Thành viên để thưởng điểm cho khách hàng dựa trên các hành động cụ thể. Hướng dẫn này sẽ dẫn bạn qua toàn bộ quy trình: từ việc tạo ứng dụng riêng tư đến phát hành điểm qua API Cửa hàng, giúp bạn xây dựng trải nghiệm thưởng điểm thành viên cá nhân hóa.

Để tìm hiểu thêm về các tính năng cấu hình quy tắc điểm khác, vui lòng tham khảo bài viết này: Thiết Lập và Quản Lý Chương Trình Điểm Thành Viên.

Tạo Quy Tắc Điểm Tùy Chỉnh

1. Đi tới Hệ Thống Thành Viên > Điểm > Quy Tắc Điểm > Thêm quy tắc.
2. Nhấp vào Quy tắc điểm tùy chỉnh và xác định logic kiếm điểm của bạn.

3. Sau khi lưu, hệ thống sẽ tạo ra một ID Quy Tắc, cần thiết khi gọi API phát hành điểm tùy chỉnh.

Trong mỗi quy tắc tùy chỉnh, bạn cũng có thể cấu hình Thời điểm Phát Hành Điểm, xác định cách và thời điểm điểm được cấp cho khách hàng:

• Phát hành điểm ngay khi nhấn nút
  • Nếu bạn chọn tùy chọn này, điểm sẽ được cấp tự động khi khách hàng nhấn nút hành động của quy tắc trong Bảng Điều Khiển Thành Viên, Trung Tâm Thành Viên hoặc Trang Đích Thành Viên.
  • Không cần phát triển mã bổ sung.
• Phát hành điểm sau khi hoàn thành hành động được chỉ định
  • Nếu bạn chọn tùy chọn này, hệ thống sẽ tạo ra một đoạn mã chứa ID Quy Tắc. Đoạn mã này được sử dụng cùng với API customRulesPointGrant (Sắp ra mắt).
  • Đoạn mã thông báo cho hệ thống của bạn biết rằng khách hàng đã nhấn nút hành động của quy tắc trong Bảng Điều Khiển Thành Viên, Trung Tâm Thành Viên hoặc Trang Đích Thành Viên. Bạn chịu trách nhiệm xác định xem khách hàng đã hoàn thành hành động được chỉ định (ví dụ: hoàn thành nhiệm vụ hoặc quy trình làm việc bên ngoài) hay chưa. Khi điều kiện được đáp ứng, bạn có thể gọi API customRulesPointGrant (Sắp ra mắt) để phát hành điểm.
  • API customRulesPointGrant (Sắp ra mắt) sẽ thực thi giới hạn phát hành được định nghĩa trong cấu hình quy tắc. Nếu khách hàng vượt quá số lần phát hành điểm cho phép, các lần gọi API bổ sung sẽ không phát hành thêm điểm.
     

Kích Hoạt Phát Hành Điểm Tùy Chỉnh

Phát hành điểm tùy chỉnh yêu cầu một ứng dụng riêng tư và quyền API phù hợp.

Bước 1: Tạo Ứng Dụng Riêng Tư

1. Đi tới Quản trị SHOPLINE > Ứng dụng > Phát triển Ứng dụng > Tạo Ứng dụng.
   
   

   

2. Điền thông tin ứng dụng (ví dụ: Phát Hành Quy Tắc Điểm Tùy Chỉnh) và nhấn Tạo.
3. Sau khi tạo, nhấn Chỉnh sửa để quản lý ứng dụng.
   
   

Bước 2: Cấu Hình Quyền API

1. Trong trình chỉnh sửa ứng dụng, đi tới Cấu hình quyền > Tích hợp API Storefront > Cấu hình.
   
2. Bật các mục sau:
   • Khách hàng: Cho phép tạo Token Truy cập Khách hàng để xác định người dùng.
     
     
3. Nhấn Lưu.
    

Bước 3: Lấy Token Truy Cập Storefront

1. Chuyển sang Chứng chỉ API > Token Truy cập > Cài đặt Ứng dụng.
   

2. Sao chép Token Truy cập Storefront được tạo. Giữ bảo mật vì nó xác thực tất cả các yêu cầu API.

   

Tạo Token Truy Cập Khách Hàng

Trước khi phát hành điểm, cần xác minh danh tính khách hàng. Bạn có thể lấy Token Truy cập Khách hàng bằng cách sử dụng tài liệu sau:

• customer-access-token-create
• customer-access-token-create-with-social-login
• customer-activate-by-verification
• customer-access-token-create-with-multipass

Ví dụ Gọi API (Node.js)

Dưới đây là ví dụ sử dụng Node.js để gọi customRulesPointGrant nhằm cấp điểm tùy chỉnh. Bạn có thể sử dụng bất kỳ ngôn ngữ lập trình nào theo nhu cầu.

const STORE_DOMAIN = 'your-store-domain.myshopline.com';

const STORE_FRONT_TOKEN = 'your-storefront-token'

const STORE_FRONT_VERSION = 'v20251201'

const CUSTOMER_ACCESS_TOKEN = '#A01#SID0xxxxxxxxxxxxxxxxxxxxxxxxxxx';

const EARN_ID = 'BACxxxxxxxxxxxxxxxxxxxx';

const graphqlMutation = `

  mutation customRulesPointGrant($customerAccessToken: String!, $earnId: String!) {

    customRulesPointGrant(customerAccessToken: $customerAccessToken, earnId: $earnId) {

      memberUserErrors { code }

    }

  }

`;

fetch(`https://${STORE_DOMAIN}/storefront/graph/${STORE_FRONT_VERSION}/graphql.json`, {

  method: 'POST',

  headers: {

    'Content-Type': 'application/json',

    'Authorization': `Bearer ${STORE_FRONT_TOKEN}`

  },

  body: JSON.stringify({

    query: graphqlMutation,

    variables: {

      customerAccessToken: CUSTOMER_ACCESS_TOKEN,

      earnId: EARN_ID

    }

  })

})

Nếu API được gọi thành công và không trả về lỗi, khách hàng sẽ nhận được điểm đã cấp.

Phương pháp triển khai

Phương pháp 1: Mã chủ đề tùy chỉnh

• Thêm các yếu tố tương tác như nút kích hoạt vào trang chủ đề của bạn.
• Liên kết sự kiện nhấp để gọi API customRulesPointGrant (Sắp ra mắt).

Phương pháp 2: Trình nghe sự kiện hệ thống thành viên (Chủ đề 3.0 trở lên)

• Lắng nghe sự kiện membersystem:custom-point-earn.
• Gọi customRulesPointGrant (Sắp ra mắt) trong hàm gọi lại sự kiện.

window.themeEventCenter.addListener('membersystem:custom-point-earn', function(event) {

  const { earnId } = event.detail;

  // Gọi API Storefront để cấp điểm

});