Đặ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ó.

Important

Việc đổi tên màn hình là một phần của skill flow-generator, vì vậy không cần cài đặt thêm gì — hãy làm theo các bước cài đặt flow-generator là bạn đã có sẵn. Skill này lưu các thay đổi vào flow trên dashboard của bạn, vì vậy hãy chạy thử với bản nháp trước và xem lại kết quả trong Flow Builder trước khi xuất bản.

Mục đích sử dụng

Một funnel mà cả team đều đọc được: Chuỗi welcome → signup → paywall nói lên điều đã xảy ra. Ba đoạn code được tạo tự động thì không làm được vậy.
Một bộ từ vựng thống nhất trên toàn bộ công cụ của bạn: Mỗi sự kiện mà app của bạn gửi đi đều đặt tên màn hình theo cùng một cách, giúp funnel, cohort và bộ lọc dashboard đồng nhất mà không cần bảng tra cứu.
Câu trả lời bạn có thể truy vấn: Một lựa chọn quiz có tên beginner là một giá trị mà analyst có thể lọc. Còn ID được tạo tự động thì phải giải mã trước mới dùng đượ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ử.

Tham số sự kiện	Nội dung	Nơi thiết lập
`instanceId`	ID của màn hình	Skill tạo flow
`element_id`	Element ID của một input, hoặc Group ID của một nhóm có thể chọn	Flow Builder
`item_ids`	Element ID của các tùy chọn được chọn	Flow Builder

Đặ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.

Skill flow-generator sẽ tự đặt tên cho bạn trên mọi flow nó tạo ra. Skill 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: skill 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 hoạt động: Các sự kiện đã thu thập vẫn giữ ID cũ. Một funnel trải dài qua thời điểm thay đổi sẽ hiển thị hai màn hình chỉ điền một nửa, và đổi tên lại cũng không gộp chúng. Chỉ số flow của Adapty cũng bị chia tách tương tự, vì nó nhóm các hàng màn hình theo ID — màn hình được đổi tên sẽ xuất hiện thành một hàng thứ hai, cùng nhãn với hàng đầu tiên.
Mỗi tùy chọn trong một nhóm phải 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 được dùng lại ở màn hình khác, toàn bộ nhóm sẽ không báo cáo gì cả — không chỉ riêng tùy chọn đó. Builder không có cảnh báo nào về điều này, 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 viết nhất quán, chẳng hạn plan_selection hoặc planSelection, và dùng xuyên suốt flow. Kiểu viết hỗn hợp khó query hơn nhiều so với mã được tạo tự động.

Hạn chế

ID màn hình chỉ được đổi tên qua skill: Không có trường nào cho chúng trong Flow Builder.
Chỉ số flow của Adapty sẽ không hiển thị các tên này: Chỉ số flow gán nhãn màn hình theo dạng <position>. <caption> từ phiên bản đã xuất bản của flow, nên sẽ hiển thị là 9. Paywall A bất kể ID của màn hình là gì. Các ID ở đây chỉ đến được analytics của bạn.
Đổ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ờ ghi nhận. Đặt tên cho những phần tử này chỉ ảnh hưởng đến flow, không ảnh hưởng đến analytics của bạn.