Tổng quan về báo cáo

Campaign Manager 360 API cung cấp một số cách để truy xuất dữ liệu cho quảng cáo được phân phối thông qua Campaign Manager 360.

Dịch vụ báo cáo

Việc tạo báo cáo bằng dịch vụ Reports bao gồm quy trình nhiều bước để định cấu hình, tạo và truy xuất tệp báo cáo (chẳng hạn như định dạng CSV hoặc Excel). Đây là đường dẫn báo cáo tiêu chuẩn cho Campaign Manager 360 API và phù hợp với các tập dữ liệu lớn, tập lệnh định kỳ tự động hoặc các ứng dụng hạ nguồn sử dụng tệp.

Quy trình này thường bao gồm các bước sau:

  1. Xác định hoặc định vị một tài nguyên Report (chỉ định phương diện, chỉ số, phạm vi ngày và bộ lọc) được lưu bằng một mã báo cáo riêng biệt. Xem phần Tạo và cập nhật báo cáo.
  2. Chạy quá trình tạo báo cáo bằng cách gọi phương thức reports.run. Thao tác này sẽ đưa báo cáo vào hàng đợi để chạy và trả về một tài nguyên File trình giữ chỗ. Xem phần Tìm và chạy báo cáo.
  3. Định kỳ kiểm tra trạng thái của tài nguyên File. Vì quy trình này chạy không đồng bộ, nên trạng thái của tệp sẽ bắt đầu là PROCESSING và chuyển sang REPORT_AVAILABLE khi hoàn tất. Xem phần Tìm và chạy báo cáo.
  4. Tìm nạp nội dung tệp (CSV hoặc Excel) sau khi quá trình tạo báo cáo hoàn tất. Xem phần Tải báo cáo xuống.

Chạy báo cáo đồng bộ

Nếu cần tạo tệp báo cáo (CSV hoặc Excel) cho một lượng nhỏ dữ liệu, bạn có thể chạy báo cáo đồng bộ bằng cách gọi phương thức reports.run với tham số synchronous được đặt thành true. API cố gắng tạo báo cáo trong một khoảng thời gian chờ ngắn. Nếu quá trình thực thi mất nhiều thời gian hơn, thì báo cáo sẽ tự động chuyển về hàng đợi không đồng bộ.

Để biết thêm thông tin, hãy xem phần Báo cáo đồng bộ.

Truy vấn dữ liệu báo cáo

Sử dụng phương thức reportData.query để truy vấn trực tiếp dữ liệu báo cáo thay vì tạo tệp báo cáo.

  • Thay vì tạo và lưu tài nguyên Report, bạn chỉ định phương diện, chỉ số và các tiêu chí lọc hoặc sắp xếp khác ngay trong yêu cầu.
  • Phản hồi chứa dữ liệu báo cáo có cấu trúc, giúp bạn không cần phải thăm dò và tải tệp đã tạo xuống.
  • Yêu cầu thực thi đồng bộ với giới hạn 60 giây.

Để biết thêm thông tin, hãy xem bài viết Truy vấn dữ liệu báo cáo JSON.