Đặt tên ID mà analytics của bạn nhìn thấy

SDK của Adapty báo cáo mọi lượt xem màn hình và mọi câu trả lời về ứng dụng của bạn. Mỗi sự kiện đều chứa ID của màn hình hoặc phần tử phát sinh ra nó, và chính những ID đó là thứ hiển thị trong analytics của bạn. Theo mặc định, ID của một màn hình trông như thế này: scr_oAPBHPa7, nên một funnel trong Amplitude hay Mixpanel sẽ chỉ là một cột mã code, và ai đó phải tự tay duy trì bảng ánh xạ từ code sang tên.

Bạn có thể tự đặt tên cho các ID này. Các input và nhóm có thể chọn được đặt tên trong Flow Builder. ID màn hình được thiết lập thông qua flow-generator skill, giúp đổi tên một màn hình ở mọi nơi mà flow tham chiếu đến nó.

Dùng để làm gì

• Một phễu mà cả team đều đọc được: Chuỗi welcome → signup → paywall cho thấy ngay điều đã xảy ra. Ba mã tự động sinh ra thì không.
• Một từ vựng thống nhất trên tất cả công cụ: Tên bạn đặt cho một màn hình chính là tên xuất hiện trong chỉ số flow của Adapty và trong analytics của bạn, nên hai bên khớp nhau mà không cần bảng tra cứu.
• Câu trả lời có thể truy vấn: Một lựa chọn trong quiz đặt tên là beginner là giá trị mà analyst có thể lọc trực tiếp. Còn một ID tự động sinh ra thì phải giải mã trước.

Các ID mà analytics của bạn nhận được

Hai sự kiện mang theo ID. flow_screen_showed kích hoạt khi người dùng mở một màn hình, và flow_user_input kích hoạt khi người dùng điền thông tin, chọn câu trả lời quiz, hoặc bật/tắt một toggle. Mỗi hướng dẫn đều ghi lại đầy đủ các tham số của sự kiện tương ứng. Bảng này chỉ bao gồm các tham số dùng để xác định màn hình hoặc phần tử.

Đặt tên cho input và các lựa chọn trong quiz

Các input và nhóm có thể chọn đều có trường ID trong builder. Element ID của một input nằm trong Input settings, và đây cũng chính là ID bạn dùng để tham chiếu giá trị đó ở các nơi khác trong flow — xem Inputs và forms. Group ID của một nhóm nằm trong Screen settings > Selectable groups, và mỗi lựa chọn bên trong nhóm có Element ID riêng.

Hãy đặt tên có ý nghĩa cho tất cả chúng, vì đó là chuỗi sẽ hiển thị trong analytics của bạn. birthday hay beginner thì tự nói lên được ý nghĩa. Còn el_024F thì cần phải có bảng tra cứu.

Hãy đặt ID ngay khi thêm phần tử, đừng để sau. Các điều kiện và biến văn bản trỏ tới Element ID, và việc thay đổi ID đó sẽ không cập nhật chúng — chúng sẽ ngừng hoạt động mà không có thông báo lỗi. Nếu cần đổi tên trên một flow đang chạy, hãy cập nhật mọi điều kiện và biến đang dùng ID đó. Xem Conditions và variables bị hỏng sau khi thay đổi Element ID.

Kỹ năng flow-generator sẽ tự đặt tên cho bạn trên mọi flow nó tạo ra. Kỹ năng flow-audit sẽ báo cáo những phần tử còn thiếu ID.

Đổi tên màn hình

Flow Builder không có trường nhập ID cho màn hình, vì vậy hãy hỏi skill:

Give the screens in my onboarding flow readable IDs.

Skill sẽ đề xuất tên cho từng màn hình, rồi đổi tên nó ở mọi nơi trong flow có tham chiếu đến — bản thân màn hình đó, mọi hành động điều hướng dẫn đến nó, và các sản phẩm được gắn với nó. Tất cả được đổi tên cùng lúc, vì nếu đổi tên ở một chỗ mà bỏ sót chỗ khác thì flow sẽ không thể publish được.

Nó cho bạn biết những tên nào đã thay đổi và bao nhiêu tham chiếu đã được di chuyển, đồng thời sẽ không thực hiện đổi tên nếu trùng với một màn hình đã tồn tại. Có thể đổi tên Screen ID một cách an toàn trên một flow đang hoạt động, còn Element ID thì không: kỹ năng sẽ di chuyển mọi tham chiếu theo nó.

Những gì cần kiểm tra

• Đổi tên trước khi flow chạy: Các sự kiện đã thu thập sẽ giữ ID cũ trong chỉ số flow của Adapty và trong hệ thống analytics của bạn. Một funnel trải dài qua thời điểm đổi tên sẽ hiển thị hai màn hình điền dở, và đổi tên lại cũng không gộp chúng được.
• Mỗi tùy chọn trong một nhóm cần có Element ID riêng: Nếu một tùy chọn thiếu ID, nếu hai tùy chọn dùng chung một ID, hoặc nếu Group ID bị dùng lại ở màn hình khác, toàn bộ nhóm sẽ không ghi nhận dữ liệu — không chỉ tùy chọn đó. Builder không cảnh báo gì, vì vậy hãy kiểm tra lại nhóm sau khi thêm tùy chọn vào.
• ID được gửi đến analytics chính xác như khi bạn nhập: Chọn một kiểu định danh, ví dụ plan_selection hoặc planSelection, và dùng nhất quán trong toàn bộ flow. Kiểu viết hỗn hợp sẽ khó truy vấn hơn các mã được tạo tự động.

Hạn chế

• Screen ID chỉ đổi tên được qua skill: Không có trường nào dành cho chúng trong Flow Builder.
• Đổi tên không migrate lịch sử: Các sự kiện cũ vẫn giữ ID cũ.
• Một số phần tử không gửi sự kiện input: Các trường mật khẩu, lựa chọn sản phẩm và chuyển tab không bao giờ báo cáo. Đặt tên cho chúng ảnh hưởng đến flow, không phải analytics của bạn.