Tạo và Quản Lý 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 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 đ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 điểm, xác định cách thức và thời điểm điểm được cấp cho khách hàng:

   • Phát đ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 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 đ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 . Để biết chi tiết về các tham số API, ví dụ yêu cầu và hướng dẫn triển khai, vui lòng tham khảo "tài liệu API customRulesPointGrant".
     • Đ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 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 một nhiệm vụ hoặc quy trình bên ngoài) hay chưa. Khi điều kiện được đáp ứng, bạn có thể gọi API customRulesPointGrant để phát điểm.
     • API customRulesPointGrant sẽ thực thi giới hạn phát điểm đượ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 điểm cho phép, các lần gọi API bổ sung sẽ không phát sinh điểm.

   Lưu ý: Bạn chỉ cần hoàn thành các phần "Kích hoạt phát điểm tùy chỉnh" và "Tạo mã truy cập khách hàng" nếu bạn chọn Phát điểm sau khi hoàn thành hành động được chỉ định làm Thời điểm phát điểm. Các bước này cần thiết để gọi API customRulesPointGrant và phát điểm cho khách hàng. Nếu bạn chọn Phát điểm ngay khi nhấn nút, các cấu hình bổ sung này không cần thiết.

    

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. Trong quản trị SHOPLINE của bạn, vào Ứng dụng và nhấp vào Phát triển Ứng dụng.

   

2. Nhấp vào Tạo Ứng dụng.

   

3. Đ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ấp Tạo.

4. Sau khi tạo, nhấp 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, vào 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ấp 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ữ an toàn 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.

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 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

});