📓Tổng Hợp

Nhớ lại trong phần Reporting Primer chúng ta đã học cách tạo một báo cáo tổng hợp và tải file mẫu báo cáo về.

Trong phần trước, chúng ta đã tạo ra một báo cáo các giao dịch cho tiền các chương trình gây quỹ ONEIRO_AF_CP. Báo cáo này lấy ra giao dịch của tất cả các chương trình gây quỹ từ tất cả các cộng tác viên.

Bấy giờ, bạn muốn tạo ra một báo cáo tổng quát hoạt động quảng bá cho một cộng tác viên cụ thể. Cộng tác viên được xác định duy nhất bằng địa chỉ ví của họ. Chúng ta sẽ dùng địa chỉ ví này: 0x78a02bb94b324bd2d671ba32f644530b55a0271e cho các phần thực hành tiếp theo.

KNOWINS hỗ trợ bộ lọc do người dùng nhập vào trước khi chạy báo cáo để làm điều này.

Bộ Lọc Của Người Dùng

Quay trở lại Lập Báo Cáo > Tổng Hợp, chọn ONEIRO_AF_CP và nhấn vào biểu tượng Xem.

Nhớ lại là bảng nhu liệu ONEIRO_AF_TXđược tạo trên bảng affiliate có cột address chính là địa chỉ ví của cộng tác viên. Kéo cột address trong bộ nhu liệu ONEIRO_AF_TX từ bên trái vào lưới bộ lọc phía trên bên tay phải, và dán địa chỉ ví 0x78a02bb94b324bd2d671ba32f644530b55a0271e vào ô tương ứng trong cột Giá Trị.

Lọc theo địa chỉ ví của cộng tác viên

Nếu bạn chọn giá trị cho cột Toán Tử của bộ lọc là Ví Tiền Số thì khi người dùng đăng nhập sử dụng ví tiền số, địa chỉ ví của họ sẽ được tự động gán cho bộ lọc.

Chạy báo cáo. Bạn sẽ có kết quả chỉ bao gồm các giao dịch quyên tiền xuất phát từ quảng bá của cộng tác viên có địa chỉ ví này, như sau:

Kết quả lọc theo địa chỉ ví cộng tác viên

Tương tự như vậy, bạn có thể kéo thêm nhiều cột khác vào lưới bộ lọc. Kết quả sẽ là bộ lọc tổng hợp của các cột đó.

Khi lọc theo nhiều cột thì logic AND sẽ luôn được áp dụng cho giá trị giữa các cột đó. Nếu một cột được lọc nhiều lần thì logic OR sẽ áp dụng cho bản thân giá trị của cột đó.

Ví dụ để lọc giao dịch theo cộng tác viên 0x78a02bb94b324bd2d671ba32f644530b55a0271e cho chương trình gây quỹ 0x66197d8e98028b60e2682b1c079c79583f4b1047 bạn có thể dùng bộ lọc như sau:

Lọc với logic AND: A VÀ B

Bộ lọc trên tương đương với logic sau:

address = 0x78a02bb94b324bd2d671ba32f644530b55a0271e
 AND 
contract_address = 0x66197d8e98028b60e2682b1c079c79583f4b1047

Hoặc nếu bạn muốn lọc các giao dịch của một trong hai chương trình gây quỹ trong năm 2023 bạn có thể dùng bộ lọc như sau:

Lọc với logic OR: A HOẶC B

Bộ lọc này tương đương với logic sau:

(
 contract_address = 0x66197d8e98028b60e2682b1c079c79583f4b1047 
  OR
 contract_address = 0x0641e11c87252b99a47e6f3f36be31081f362660
)
 AND 
(transactiondate >= 2022-01-01 AND transactiondate <= 2022-12-31)

Các Loại Bộ Lọc

KNOWINS cho phép chọn lựa nhiều loại bộ lọc khác nhau trong cột Toán Tử (operator) của lưới bộ lọc.

Toán Tử	Tiếng Việt	Giải thích
=	so sánh bằng	Bằng với cột Giá Trị
>, >=	so sánh lớn hơn	Lớn hơn cột Giá Trị
<, <=	so sánh nhỏ hơn	Nhỏ hơn hơn cột Giá Trị
<>	so sánh khác	Khác cột Giá Trị
-	so sánh	Bằng với cột Giá Trị hoặc, nếu có nhập Đến Giá Trị: lớn hơn cột Giá Trị và nhỏ hơn cột Đến Giá Trị
begin	bắt đầu	bắt đầu với giá trị trong cột Giá Trị
end	kết thúc	kết thúc với giá trị trong cột Giá Trị
like	giống như, chứa	tương tự với giá trị trong cột Giá Trị
cross	giao
between	giữa	lớn hơn cột Giá Trị và nhỏ hơn cột Đến Giá Trị. Ví dụ: amount BETWEEN 20 AND 100
in	trong	Một trong số các giá trị trong cột Giá Trị. Lưu ý: các giá trị được liệt kê cách nhau bởi dấu phẩy. Ví dụ: block_number IN 5111,5112,5113
exists	tồn tại	phải có tồn tại giá trị của cột này
wallet address	ví tiền crypto	Tự động lấy địa chỉ của ví crypto nếu bạn dùng ví để đăng nhập

Cột Phủ Định (Is Not) cho phép logic NOT trên bộ lọc.

Hàm Tính Gộp

Trong bảng tính Excel có một tính năng được sử dụng rất rộng rãi là lọc dữ liệu theo giá trị của một cột nào đó và sau đó lấy tổng giá trị của một cột khác trong dữ liệu đã được lọc.

Bạn có thể làm y hệt như vậy trong KNOWINS. Ví dụ để cộng tổng số tiền quyên góp được theo ngày, cho chương trình gây quỹ 0x66197d8e98028b60e2682b1c079c79583f4b1047, bạn có thể làm như sau:

1. Kéo cột số tiền (amount) bên tay trái vào lưới kết xuất bên tay phải.

2. Chọn hàm tính gộp: TỔNG

3. Kéo cột ngày giao dịch (transactiondate) vào lưới kết xuất.

4. Kéo cốt địa chỉ ví của chương trình gây quỹ (contract_address) vào lưới bộ lọc phía trên và nhập giá trị 0x66197d8e98028b60e2682b1c079c79583f4b1047 vào ô trong cột giá trị.

Khi chạy, báo cáo sẽ lọc dữ liệu chỉ lấy các giao dịch quyên góp cho chương trình tại địa chỉ ví là 0x661..., sau đó nó sẽ nhóm các giao dịch này thành từng nhóm theo ngày giao dịch và lấy tổng số tiền cho từng nhóm, cuối cùng nó kết xuất dữ liệu bao gồm hai cột: ngày giao dịch và tổng số tiền trong từng ngày.

Tính tổng số tiền theo từng ngày

Chạy báo cáo. Bạn sẽ có kết quả như sau (nhấn biểu tượng kết xuất ra Excel nếu bạn không nhìn thấy định dạng đầy đủ của cột transaction_date):

Kết quả tính tổng số tiền theo ngày

Lấy Giá Trị Bộ Lọc Trong báo Cáo

Bạn có thể lấy các giá trị do người dùng nhập vào trong bộ lọc khi chạy báo cáo bằng cách dùng thẻ hàm <#Lookup>.

Khi chạy, các giá trị trong bộ lọc được truyền vào mẫu báo cáo trong một bảng có tên mặc định là Filters, có cấu trúc như sau:

Name	Is_Not	Operator	ValueFrom	ValueTo
address	Y/N	-	0x78a0...
transaction_date			2023-01-01	2023-12-31

Nhấn biểu tượng Download để tải mẫu báo cáo ONEIRO_AF_CP về. Mở file mẫu báo cáo bằng Excel, sau đó đi vào bảng <#Config> và nhập vào ô N17 công thức bên dưới:

<#Lookup(Filters;Name;address;ValueFrom)>

Công thức này sẽ tìm trong cột Name của bảng Filters hàng đầu tiên có giá trị là address và lấy ra giá trị ở trong cột ValueFrom của bảng này, chính là 0x78a02bb94b324bd2d671ba32f644530b55a0271e.

Dùng thẻ hàm Lookup để lấy giá trị bộ lọc

Lưu file mẫu báo cáo mới sửa đổi lại.

Quay trở lại Lập Báo Cáo > Tổng Hợp, chọn ONEIRO_AF_CP, nhấn biểu tượng Sửa và sau đó Upload để tải mẫu báo cáo mới lên.

Chạy lại báo cáo. Bạn sẽ thấy thẻ tên TagName được thay thế bằng giá trị của địa chỉ ví address truyền vào trong bộ lọc.

Giá trị TagName đã bị thay thế

Thay đổi giá trị cho bộ lộc address và chạy lại báo cáo để thấy sự thay đổi.