Hệ thống gợi ý

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

Xây dựng các hệ thống gợi ý tùy chỉnh trong trò chơi của bạn để giới thiệu nội dung được chọn lọc như tài sản 2D và 3D, trò chơi nhỏ, các trò chơi khác và nhiều hơn nữa. Recommendation Service API cho phép bạn ghi lại hoạt động của người dùng, ghi lại ấn tượng và cung cấp kết quả cá nhân hóa cho hầu như bất kỳ loại tương tác nào.

Một số trường hợp sử dụng phổ biến cho hệ thống gợi ý bao gồm việc trình bày cho người dùng một giao diện gợi ý vào cuối vòng chơi, một menu lớp phủ trình bày các hành động cá nhân hóa, hoặc các triển khai khác trình bày một tập hợp các lựa chọn, tài sản, địa điểm hoặc trò chơi độc đáo cho người dùng.

Sử dụng các bước và thực hành tốt nhất sau đây để thiết lập hệ thống gợi ý của bạn:

Đăng ký nội dung của bạn

Để bổ sung nội dung mà hệ thống gợi ý của bạn có thể phục vụ cho người dùng, sử dụng RegisterItemAsync. Khi đăng ký một mục, cung cấp một referenceId, một chuỗi do nhà phát triển xác định mà xác định duy nhất mục đó trong cơ sở dữ liệu của riêng bạn. referenceId này thường được sử dụng để tra cứu siêu dữ liệu của một mục, chẳng hạn như tên, mô tả hoặc ID tài sản, từ kho dữ liệu của bạn để hiển thị trong UI.

Như một thực hành tốt nhất, hãy đăng ký các mục ngay khi chúng được tạo ra để đảm bảo rằng bể gợi ý luôn mới mẻ.

Ghi lại ấn tượng của người dùng

Khi dịch vụ biết về các mục của bạn và bắt đầu gợi ý chúng, hãy thông báo cho dịch vụ khi một người dùng thực sự xem các gợi ý bằng LogImpressionEvent.

Khi nào ghi lại

Giao diện kiểu carousel là một giao diện phổ biến để hiển thị nhiều tùy chọn có thể chơi cho người dùng. Sử dụng các thực hành tốt nhất sau đây để đảm bảo rằng việc ghi của bạn cung cấp dữ liệu có thể hành động:

  • Ghi lại một lần: Ghi lại ấn tượng chỉ một lần mỗi phiên cho một mục cụ thể.
    • Không ghi lại mỗi lần mục xuất hiện, vì điều này tạo ra thông tin lộn xộn có thể gây cản trở việc ghi của bạn.
  • Kích hoạt: Bạn có thể chọn ghi lại khi mục trở nên hoàn toàn hiển thị trong menu hoặc khi người dùng tương tác với mục, chẳng hạn như mở Trang Chi Tiết.

Thời gian

Thời gian theo dõi thời gian của ấn tượng. Bạn có thể nghĩ rằng đây là thời gian mà người dùng nhìn vào hình ảnh hoặc gợi ý.

Nếu bạn không sử dụng video, bạn có thể đặt giá trị Thời gian thành 1. Điều này đảm bảo rằng bạn có dữ liệu sạch, đồng nhất cho rằng "người dùng đã xem mục này", thường là việc ghi duy nhất bạn cần cho một thẻ tĩnh.

Ghi lại các hành động chất lượng

Khi một người dùng quyết định tương tác với một gợi ý, hãy sử dụng LogActionEvent. Trong ví dụ này, đơn giản chỉ cần nhấp vào "Chơi" trên gợi ý không đủ tín hiệu cho một hệ thống gợi ý chất lượng cao. Điều quan trọng là phân biệt giữa một cú nhấp chuột không cố ý và một phiên chơi thật sự.

Loại hành động yêu cầu

Khi bạn gọi LogActionEvent, bạn phải chỉ định loại hành động đang xảy ra. Để theo dõi các sự kiện hành động dẫn đến phiên chơi, hãy sử dụng Enum.RecommendationActionType.Play. Điều quan trọng là sử dụng enum chính xác để cho backend biết rằng một loại hành động cụ thể đang được kích hoạt. Đối với các gợi ý liên quan đến thời gian chơi, Enum.RecommendationActionType.Play là yêu cầu nghiêm ngặt để khớp với mẫu cấu hình Tối đa hóaSố lần chơi được sử dụng trong bước tiếp theo để lấy gợi ý. Nếu bạn sử dụng một enum khác, mô hình sẽ không ghi lại sự kiện chính xác cho các hành động liên quan đến chơi.

Chiến lược "chơi chất lượng"

Tùy thuộc vào trò chơi của bạn, bạn có thể có các định nghĩa khác nhau về điều gì tạo nên "chơi chất lượng". Sử dụng các bước sau đây để giúp tinh chỉnh những gì khác biệt giữa chơi chất lượng trong tình huống của bạn.

  1. Theo dõi nội bộ: Khi một người dùng vào trò chơi nhỏ, theo dõi thời gian phiên của họ theo cách cục bộ trong script của bạn.
  2. Lọc: Định nghĩa một ngưỡng cho sự hài lòng, chẳng hạn như chơi hơn 60 giây.
  3. Ghi lại: Chỉ kích hoạt LogActionEvent nếu người dùng vượt qua ngưỡng này.

Lấy gợi ý

Để lấy gợi ý, hãy sử dụng GenerateItemListAsync. GenerateItemListAsync chấp nhận một từ điển bao gồm nhiều tùy chọn cho truy vấn danh sách gợi ý. Mặc dù nhiều cài đặt này là đơn giản, nhưng điều quan trọng là hiểu các tham số ConfigName được hỗ trợ để đảm bảo bạn cung cấp các gợi ý thành công.

ConfigName

Bạn có nhiều cấu hình có sẵn khi lấy gợi ý. Trong ví dụ hiện tại được thiết kế để tối đa hóa gợi ý dựa trên số lần chơi chất lượng, hãy sử dụng cấu hình MaximizePlays. Tùy thuộc vào trường hợp sử dụng, cấu hình MaximizePlays tốt hơn MaximizeTimeSpent vì nó cũng lập chỉ mục sự hài lòng của người dùng, chứ không chỉ thời gian đã dành. Điều này cho biết hệ thống để trả về các mục có khả năng tạo ra chơi chất lượng nhất.

Để biết thêm thông tin về từng cấu hình hỗ trợ, hãy kiểm tra GenerateItemListAsync.

Theo dõi phân tích

Khi bạn đã tích hợp dịch vụ, bạn có thể theo dõi hiệu suất của nó trực tiếp trong Creator Hub. Để truy cập phân tích gợi ý của bạn:

  1. Trong Creator Hub, điều hướng đến trang trò chơi của bạn.
  2. Trong thanh bên, điều hướng đến Tương tác > Dịch vụ Gợi ý.
Liên kết đến số liệu dịch vụ gợi ý trong Creator Hub

Các số liệu chính cần theo dõi:

  • Tổng số hành động theo thời gian: Người dùng thực sự có tương tác với các gợi ý không?
  • Tổng số người dùng duy nhất: Có bao nhiêu người đang sử dụng tính năng khám phá?
  • Số lượng mục ấn tượng trung bình trên mỗi người dùng: Người dùng có cuộn qua carousel không?
  • Thời gian trung bình mà mỗi người dùng đã dành: Chất lượng của các gợi ý có giữ họ lâu hơn trong trò chơi không?
    • Trong ví dụ được cung cấp, Thời gian được đặt thành 1, vì vậy số liệu cụ thể này không thực sự giá trị trong trường hợp sử dụng đó. Tuy nhiên, trong các ứng dụng khác, chẳng hạn như video, điều này có thể là chỉ số mạnh mẽ cho các ấn tượng của bạn.

Hãy nhớ các cài đặt và quy trình được sử dụng trong hệ thống gợi ý này nhằm tối đa hóa các phiên chơi chất lượng, đặc biệt sử dụng thời gian 1 giây cho các hình thu nhỏ, chỉ ghi lại các lần chơi chất lượng và quản lý nghiêm ngặt ID của bạn. Bằng cách giữ cho việc ghi và dữ liệu ấn tượng của bạn sạch sẽ, bạn có thể gợi ý và tinh chỉnh nội dung phù hợp nhất với những trải nghiệm độc đáo của người dùng của bạn.

Trong khi quy trình này đề cập đến quá trình cho một hệ thống gợi ý nhằm tối đa hóa thời gian chơi, bạn có thể sử dụng một thứ tự hoạt động tương tự và các khái niệm cơ bản để xây dựng một dịch vụ gợi ý phù hợp với nhu cầu của trò chơi của bạn.

©2026 Roblox Corporation. Roblox, logo Roblox và Powering Imagination là các nhãn hiệu đã đăng ký và chưa đăng ký của chúng tôi tại Hoa Kỳ và các quốc gia khác.