Tổng quan

Kiến trúc vật lý

API báo cáo CitrusAd cho phép truy cập an toàn vào kho dữ liệu CitrusAd. Bản thân kho dữ liệu chứa dữ liệu và thông tin chi tiết có nguồn gốc từ nền tảng CitrusAd.

Kho dữ liệu CitrusAd là một mô hình phân tán. Một số dữ liệu được lưu giữ cục bộ trong các phiên bản nền tảng CitrusAd, dữ liệu khác trong kho dữ liệu toàn cầu, tập trung.

Sơ đồ sau đây cho thấy cấu trúc của mô hình dữ liệu.

LớpMô tả
Dữ liệu nền tảngDữ liệu nguồn từ nền tảng CitrusAd. Bản thân nền tảng này được phân phối trên nhiều phiên bản vật lý. Một phiên bản tồn tại cho mỗi nhà bán lẻ lớn, hoặc trong một số trường hợp, được chia sẻ an toàn giữa một số nhà bán lẻ nhỏ hơn.
Không được phép truy cập trực tiếp vào Dữ liệu nền tảng đối với các kết nối bên ngoài.
Dữ liệu theo giai đoạnDữ liệu nền tảng có liên quan được đưa vào kho dữ liệu gần như theo thời gian thực. Dữ liệu theo giai đoạn được duy trì trên mỗi phiên bản nền tảng ở cùng vị trí thực tế với Dữ liệu nền tảng.
Truy cập trực tiếp vào Dữ liệu theo giai đoạn thường không được phép truy cập vào các kết nối bên ngoài.
Tập dữ liệu cốt lõiHằng ngày, các quy trình hàng loạt lấy Dữ liệu theo giai đoạn và mô hình hóa nó thành một lược đồ bông tuyết đơn giản để sử dụng, gọi là Tập dữ liệu cốt lõi. Tập dữ liệu cốt lõi cũng được duy trì trên mỗi phiên bản nền tảng ở cùng vị trí thực tế với Dữ liệu theo giai đoạn và Dữ liệu nền tảng.
Mỗi dữ kiện về Tập dữ liệu cốt lõi đều có sẵn ở cả mức độ chi tiết của giao dịch riêng lẻ và tổng hợp.
Việc theo dõi các thay đổi cũng hiện diện trên nhiều khía cạnh.
Quyền truy cập trực tiếp vào Tập dữ liệu cốt lõi được cho phép (theo yêu cầu) đối với một số khách hàng nhất định, chủ yếu ở cấp nhà bán lẻ (phải được phê duyệt).
Tập dữ liệu cốt lõi tổng hợpSau khi các Tập dữ liệu lõi được cập nhật, các quy trình hàng loạt sẽ lấy các Tập dữ liệu lõi riêng lẻ và chuyển chúng đến một vị trí tập trung (kho dữ liệu toàn cầu). Sau đó, các Tập dữ liệu lõi riêng lẻ được hợp nhất thành một Tập dữ liệu lõi tổng hợp thống nhất.
Lưu ý, chỉ dữ liệu thực tế tổng hợp (không phải dữ liệu giao dịch) mới được lưu trữ trong kho dữ liệu toàn cầu.
Truy cập trực tiếp vào Tập dữ liệu lõi tổng hợp thường không được phép đối với các kết nối bên ngoài.
Báo cáo DatamartSau khi Tập dữ liệu cốt lõi tổng hợp được cập nhật, các quy trình hàng loạt hàng ngày sẽ tính toán một Datamart báo cáo tổng hợp và đơn giản hơn nữa.
Giống như Tập dữ liệu cốt lõi, Datamart báo cáo cũng là một lược đồ bông tuyết. Chỉ có các phiên bản kích thước hiện tại mới được cung cấp. Khách hàng phải duy trì lịch sử thay đổi cục bộ trong kho dữ liệu của riêng họ theo yêu cầu dựa trên ảnh chụp nhanh hàng ngày.
Dữ liệu báo cáo cũng chứa các chế độ xem trang trí một số thông tin nhất định và đơn giản hóa việc truy vấn cho khách hàng hơn nữa.
Quyền truy cập trực tiếp vào Datamart Báo cáo (theo yêu cầu) đối với nhiều khách hàng, cả nhà bán lẻ và nhà cung cấp (phải được phê duyệt).
Thông tin chi tiết
[sắp ra mắt]
Một loạt chế độ xem được xây dựng dựa trên Báo cáo Datamart cung cấp Thông tin chi tiết dựng sẵn thường được khách hàng yêu cầu. Ví dụ :
Hiệu quả của chiến dịch (Thống kê quảng cáo đã thực hiện, ví dụ như CTR/ROAS)
Tỷ lệ lấp đầy hàng tồn kho (% Yêu cầu được lấp đầy bằng quảng cáo trả phí)
Chia sẻ tiếng nói (Tỷ lệ hiển thị của nhà cung cấp theo danh mục/cụm từ tìm kiếm, v.v.)
Thanh toán (chi tiêu ví cho mỗi Chiến dịch trong mỗi khoảng thời gian)

Quyền truy cập vào lớp Thông tin chi tiết được phép (theo yêu cầu) đối với nhiều khách hàng, cả nhà bán lẻ và nhà cung cấp (phải được phê duyệt).
Tài liệu này cũng chia sẻ mã SQL được sử dụng để xây dựng lớp Thông tin chi tiết để khách hàng sao chép Báo cáo Datamart vào kho dữ liệu của họ có thể hiểu cách dễ dàng sao chép logic.
Trực quan hóa
[bản phát hành giới hạn]
Một loạt chế độ xem được xây dựng trên lớp Thông tin chi tiết và Báo cáo Datamart cung cấp dữ liệu tương đương như được thấy trong nền tảng BI cũ.
Quyền truy cập vào lớp Trực quan hóa hiện được cho phép (theo yêu cầu) đối với khách hàng, cả nhà bán lẻ và nhà cung cấp, những người yêu cầu quyền truy cập vào dữ liệu chính xác như được trình bày trong nền tảng BI cũ của chúng tôi (phải được phê duyệt).
LƯU Ý: Trừ khi cần phải đối chiếu chính xác với nền tảng BI cũ, bạn nên sử dụng các lớp Báo cáo Datamart hoặc Thông tin chi tiết để thay thế. Chúng cũng chứa nhiều dữ liệu chi tiết hơn trong các khung thời gian dài hơn.

Mô hình Dữ liệu Lô-gic

Tùy thuộc vào loại quyền truy cập của bạn, dữ liệu có sẵn bao gồm nhiều lĩnh vực chủ đề nền tảng CitrusAd thường được yêu cầu, chẳng hạn như:

(vui lòng tham khảo Bảng thuật ngữ để biết thêm định nghĩa)

  • Dữ liệu theo chiều
    • Chiến dịch
    • Danh mục sản phẩm
    • Sản phẩm
    • Nhóm
      • Nhà bán lẻ
      • Nhà cung cấp
    • Cụm từ tìm kiếm
    • Danh mục
    • Vị trí
  • Dữ liệu thực tế
    • Thống kê yêu cầu quảng cáo (Số lượng yêu cầu theo Cụm từ tìm kiếm hoặc Danh mục, v.v.)
    • Thống kê quảng cáo đã thực hiện (Số lần hiển thị/Số nhấp chuột/Chi tiêu quảng cáo theo Cụm từ tìm kiếm hoặc Danh mục, v.v.)
    • Thống kê phân bổ nâng cao (chỉ ở nơi được định cấu hình - thông qua lượt xem hiển thị, phân bổ nhấp chuột lan tỏa, v.v.)
    • Thống kê Chi tiêu Chiến dịch FTA
    • Tóm tắt giao dịch sổ cái (thông tin thanh toán, nạp tiền vào ví, v.v.)
    • Thống kê đơn hàng

API báo cáo thường được sử dụng để chia sẻ các lược đồ trong Tập dữ liệu cốt lõi và/hoặc Báo cáo Datamart. Cả hai lược đồ này đều bao gồm các lĩnh vực chủ đề đã nói ở trên, chỉ ở các cấp độ tổng hợp khác nhau (Tập dữ liệu cốt lõi cung cấp chi tiết cấp độ giao dịch cho các dữ kiện cũng như tổng hợp).

Sơ đồ Không gian tên

Loại người dùng

Các lĩnh vực chủ đề bạn có thể xem sẽ bị hạn chế tùy theo những gì tổ chức của bạn có quyền xem. Có 4 loại quyền truy cập tổ chức:

  • Cấp độ không gian tên: Một khách hàng kiểm soát toàn bộ mạng lưới các nhóm (cả nhóm nhà cung cấp và nhà bán lẻ). Quyền truy cập ở cấp không gian tên cho phép hiển thị tất cả dữ liệu đối với việc triển khai CitrusAd nhất định.
  • Cấp độ nhà bán lẻ : Khách hàng chỉ là một nhóm nhà bán lẻ cụ thể (hoặc nhóm các nhóm nhà bán lẻ).
  • Cấp độ nhà cung cấp : Khách hàng chỉ là một nhóm nhà cung cấp cụ thể (hoặc nhóm các nhóm nhà cung cấp).
    • Cấp độ Người hợp nhất: Mở rộng cấp độ Nhà cung cấp, ngoại trừ việc họ có toàn quyền truy cập vào một số đối tượng cấp Nhà bán lẻ nhất định (chỉ theo quyết định của Nhà bán lẻ).

Đây là những lĩnh vực chủ đề chính được đề cập và cách chúng áp dụng cho 3 loại quyền truy cập.

Lĩnh vực chủ đềKhông gian tênNhà bán lẻNhà cung cấpNgười hợp nhất
Chiến dịchTất cả dữ liệuLiên quan đến (các) Nhóm Nhà bán lẻLiên quan đến (các) Nhóm Nhà cung cấpLiên quan đến (các) Nhóm Nhà cung cấp
Danh mục sản phẩmTất cả dữ liệuLiên quan đến (các) Nhóm Nhà bán lẻKhông có dữ liệuLiên quan đến (các) Nhóm Nhà bán lẻ đã cấp phê duyệt cho Người hợp nhất
Sản phẩmTất cả dữ liệuLiên quan đến (các) Nhóm Nhà bán lẻChỉ dành cho Sản phẩm xuất hiện trong bảng Thống kê quảng cáo đã thực hiện bởi nhà cung cấp_sản phẩmLiên quan đến (các) Nhóm Nhà bán lẻ đã cấp phê duyệt cho Người hợp nhất
NhómTất cả dữ liệuLiên quan đến (các) Nhóm Nhà bán lẻLiên quan đến (các) Nhóm Nhà cung cấpLiên quan đến (các) Nhóm Nhà cung cấp
Nhà bán lẻTất cả dữ liệuLiên quan đến (các) Nhóm Nhà bán lẻChỉ dành cho Nhà bán lẻ xuất hiện trong bảng Thống kê quảng cáo đã thực hiện bởi nhà cung cấp_nhà bán lẻChỉ dành cho Nhà bán lẻ xuất hiện trong Thống kê quảng cáo đã thực hiện
Nhà cung cấpTất cả dữ liệuChỉ dành cho Nhà cung cấp xuất hiện trong bảng Thống kê quảng cáo đã thực hiện của nhà bán lẻ_nhà cung cấpLiên quan đến (các) Nhóm Nhà cung cấpLiên quan đến (các) Nhóm Nhà cung cấp
Tất cả dữ liệuChỉ ví của nhóm nhà bán lẻChỉ ví của (các) nhóm nhà cung cấpChỉ ví của (các) nhóm nhà cung cấp
Cụm từ tìm kiếmTất cả dữ liệuLiên quan đến (các) Nhóm Nhà bán lẻChỉ dành cho Cụm từ tìm kiếm xuất hiện trong Thống kê quảng cáo đã thực hiện (chỉ xuất hiện dưới dạng trong bảng dữ liệu)Chỉ dành cho Cụm từ tìm kiếm xuất hiện trong Thống kê quảng cáo đã thực hiện (chỉ xuất hiện dưới dạng trong bảng dữ liệu)
Danh mụcTất cả dữ liệuLiên quan đến (các) Nhóm Nhà bán lẻChỉ dành cho Danh mục xuất hiện trong Thống kê quảng cáo đã thực hiện (chỉ xuất hiện dưới dạng trong bảng dữ liệu)Chỉ dành cho Danh mục xuất hiện trong Thống kê quảng cáo đã thực hiện (chỉ xuất hiện dưới dạng trong bảng dữ liệu)
Thống kê yêu cầu quảng cáoTất cả dữ liệuLiên quan đến (các) Nhóm Nhà bán lẻKhông có dữ liệuKhông có dữ liệu
Thống kê phân bổ nâng caoTất cả dữ liệuLiên quan đến (các) Nhóm Nhà bán lẻLiên quan đến (các) Nhóm Nhà cung cấpLiên quan đến (các) Nhóm Nhà cung cấp
Thống kê Chi tiêu Chiến dịch FTATất cả dữ liệuLiên quan đến (các) Nhóm Nhà bán lẻLiên quan đến (các) Nhóm Nhà cung cấpLiên quan đến (các) Nhóm Nhà cung cấp
Tóm tắt giao dịch sổ cáiTất cả dữ liệuChỉ ví của nhóm nhà bán lẻChỉ ví của (các) nhóm nhà cung cấpChỉ ví của (các) nhóm nhà cung cấp
Thống kê đơn hàngTất cả dữ liệuLiên quan đến (các) Nhóm Nhà bán lẻKhông có dữ liệuKhông có dữ liệu
Thống kê quảng cáo đã thực hiện (Số lần hiển thị / Số nhấp chuột Chi tiêu quảng cáo, v.v.)Tất cả dữ liệuLiên quan đến (các) Nhóm Nhà bán lẻLiên quan đến (các) Nhóm Nhà cung cấpLiên quan đến (các) Nhóm Nhà cung cấp
Vị tríTất cả dữ liệuLiên quan đến (các) Nhóm Nhà bán lẻChỉ dành cho các Vị trí xuất hiện trong Yêu cầu quảng cáo và Thống kê quảng cáo đã thực hiện.Liên quan đến (các) Nhóm Nhà bán lẻ đã cấp phê duyệt cho Người hợp nhất

Phương thức truy cập của người dùng

Có hai loại phương thức truy cập, tùy thuộc vào nền tảng đám mây bạn sử dụng.

Loại người dùngPhương thức truy cập
Người dùng Google Cloud Platform (GCP) gốcTruy cập trực tiếp Vì kho dữ liệu của chúng tôi được triển khai trong BigQuery (dịch vụ kho dữ liệu của GCP), nên những khách hàng trong GCP sẽ có thể truy cập trực tiếp các tập dữ liệu. Điều này sẽ cho phép bạn xem các đối tượng và truy vấn chúng thông qua giao diện người dùng BigQuery trong dự án GCP của riêng bạn. Bạn chỉ cần cung cấp cho chúng tôi địa chỉ email từ dự án GCP của bạn và chúng tôi sẽ cấp các đặc quyền tương ứng (đang chờ phê duyệt). Lưu ý, người dùng Truy cập trực tiếp cũng có thể thực hiện lệnh gọi tới API BigQuery thông qua tập lệnh, v.v. (ngoài việc sử dụng API BigQuery).
Người dùng khác (không phải GCP)API Nếu bạn không ở trong GCP (ví dụ: Azure hoặc AWS), thì CitrusAd sẽ tạo tài khoản cho bạn (tài khoản dịch vụ) và cung cấp thông tin xác thực (đang chờ phê duyệt). Tài khoản này sẽ chỉ cấp cho bạn quyền truy cập cấp API BigQuery (bạn sẽ không thể truy cập bảng điều khiển đám mây).

Phiên bản: f34ea10