Tạo và chạy báo cáo

Hướng dẫn này sẽ dạy bạn cách tạo và chạy báo cáo, cũng như cách xem kết quả.

Thuật ngữ chính: Truy vấn là văn bản SQL làm nền tảng cho một báo cáo. Báo cáo bao gồm nhiều thành phần, trong đó có truy vấn, chế độ cài đặt đầu vào và đầu ra, lịch biểu và thông tin chi tiết về việc thực thi.

Tạo báo cáo

Nhà phân tích và người dùng có đặc quyền có thể tạo và chỉnh sửa báo cáo. Tìm hiểu thêm về quyền kiểm soát truy cập trong Ads Data Hub.

Quan trọng: Để tránh mất các thay đổi, hãy nhấp vào Lưu sau khi thực hiện mọi nội dung cập nhật cho báo cáo, kể cả lịch biểu.

1. Trong Ads Data Hub, hãy mở trang Báo cáo.
2. Nhấp vào + Tạo báo cáo. Trang Tạo báo cáo mới sẽ mở ra.
   • Bạn có thể lọc mẫu bằng cách tìm kiếm, chọn biểu tượng sản phẩm và chọn các lựa chọn trong trình đơn thả xuống.
3. Chọn một mẫu rồi nhấp vào Sử dụng mẫu hoặc nhấp vào SQL để bắt đầu từ đầu.
   • Xem trước thông tin chi tiết về mẫu và SQL bằng cách nhấp vào biểu tượng expand_content Mở rộng.
4. Để chỉnh sửa báo cáo, hãy nhấp vào Chỉnh sửa truy vấn. Sử dụng trình chỉnh sửa truy vấn để:
   • Tuỳ chỉnh báo cáo bằng SQL tương thích với BigQuery.
   • Định cấu hình các thông số trong thẻ Properties (Thuộc tính).
   • Xem danh sách các bảng và trường có sẵn trong thẻ Bảng của Google.
   • Xem danh sách các bảng bên thứ nhất đã nhập và giản đồ của các bảng đó trong thẻ Bảng bên thứ nhất.
   • Chạy truy vấn SQL bằng cách nhấp vào Chạy. Xin lưu ý rằng các hoạt động thực thi được bắt đầu từ trình chỉnh sửa truy vấn SQL sẽ không được tính vào nhật ký thực thi của báo cáo và sẽ không xuất hiện trong mục Hoạt động gần đây của trang Trang chủ.
   • Nhấp vào Xong để xác nhận các thay đổi đối với truy vấn và quay lại trang thiết lập báo cáo.
5. Nhập tên cho báo cáo của bạn.
6. Nếu có thể, hãy đặt các giá trị tham số trong thẻ Thiết lập.
7. Định cấu hình đầu vào và đầu ra cho các công việc chạy trên báo cáo này:
   • Chọn một nguồn dữ liệu trong trường Dữ liệu quảng cáo từ. Đây phải là mã tài khoản Ads Data Hub được liên kết với dữ liệu quảng cáo mà bạn muốn truy vấn. (Nếu bạn muốn truy vấn dữ liệu hộp cát, hãy chọn Khách hàng hộp cát ADH.)
   • Nếu sử dụng bảng so khớp, hãy chọn bảng so khớp trong trường Tài khoản bảng so khớp.
   • Chọn phạm vi ngày và múi giờ cho báo cáo. Múi giờ của báo cáo phải khớp với múi giờ của tài khoản quảng cáo được liên kết, chẳng hạn như tài khoản Google Ads. Lưu ý: Phạm vi ngày tuỳ chỉnh để kiểm thử truy vấn chỉ được hỗ trợ khi bạn chạy truy vấn từ màn hình trình chỉnh sửa SQL.
   • Không bắt buộc: Thay đổi chế độ cài đặt quyền riêng tư và định cấu hình thông tin tóm tắt về hàng được lọc.
   • Chọn dự án, tập dữ liệu và bảng BigQuery nơi bạn muốn lưu kết quả báo cáo.
8. Không bắt buộc: Thiết lập để báo cáo của bạn chạy theo lịch.
9. Nhấp vào Lưu.

---

Thông số

Các thông số cho phép bạn chỉ định cách chạy một báo cáo nhất định. Khi sử dụng SQL để tạo báo cáo (hoặc khi chỉnh sửa SQL trong một mẫu báo cáo), các thông số cho phép bạn sử dụng lại cùng một mã SQL trên nhiều báo cáo và đặt các giá trị thông số khác nhau trên mỗi bản sao của báo cáo. Ví dụ: bạn có thể chạy 2 báo cáo dùng cùng một truy vấn hoặc mẫu SQL trên các nhóm mã chiến dịch khác nhau bằng cách định cấu hình một tham số và đặt giá trị của tham số đó trong mục Thiết lập của trang chi tiết báo cáo. Việc sử dụng các thông số giúp mã SQL của bạn gọn gàng, giảm khả năng bạn mắc lỗi khi chỉnh sửa và cho phép bạn sử dụng lại cùng một truy vấn SQL trên nhiều báo cáo mà không cần chỉnh sửa các giá trị trong chính SQL.

Trong ví dụ sau, báo cáo chứa một tham số có tên là campaign_ids, chấp nhận một array gồm int64 mã chiến dịch:

  /* Parameters:
   *   @campaign_ids (ARRAY of INT64):
   *   A list of campaign IDs to analyze
   */

  WITH user_reach AS (
  SELECT
    user_id,
    count(*) AS num_views
  FROM
    adh.google_ads_impressions
  WHERE
    campaign_id in UNNEST(@campaign_ids)
  GROUP BY
    user_id
  )
  SELECT
  COUNT(*) AS unique_users,
  COUNTIF(num_views = 1) AS one_view,
  COUNTIF(num_views > 1 AND num_views <= 5) AS less_or_equal_five_views,
  COUNTIF(num_views > 5) AS more_than_five_views
  FROM
    user_reach

Các loại thông số

Bạn được phép sử dụng các loại tham số sau:

• int64
• float64
• bool
• string
• date
• timestamp
• array (thuộc bất kỳ loại nào được phép)

Thêm một tham số vào báo cáo

1. Mở một báo cáo đã lưu hoặc tạo một báo cáo mới.
2. Nhấp vào Chỉnh sửa truy vấn.
3. Trong mục Thuộc tính, hãy nhấp vào Thêm tham số.
4. Nhập tên vào trường Tên. Bạn sẽ dùng tên này để tham chiếu đến tham số trong văn bản báo cáo.
5. Sử dụng trình đơn thả xuống để chọn loại thông số.
   • Nếu bạn chọn loại mảng, một trình đơn thả xuống khác sẽ xuất hiện. Chọn loại mảng trong trình đơn thả xuống này.
6. Trong truy vấn SQL, hãy thêm tham số bằng cách sử dụng định dạng tham số SQL tiêu chuẩn: @PARAMETER_NAME. Hãy xem ví dụ sau các bước này.
7. Nhấp vào Xong rồi nhấp vào Lưu.

Sử dụng một tham số

1. Mở một báo cáo đã được định cấu hình các thông số.
2. Trong ngăn Thiết lập, hãy nhập giá trị cho từng thông số mà bạn đã xác định
3. Nhấp vào Lưu để giữ lại các giá trị tham số.

Xoá một tham số

1. Mở một báo cáo đã được định cấu hình các thông số.
2. Nhấp vào Chỉnh sửa truy vấn để mở trình chỉnh sửa SQL.
3. Trong mục Thuộc tính, hãy nhấp vào biểu tượng xoá Xoá bên cạnh thông số mà bạn muốn xoá.
4. Nhấp vào Xong rồi nhấp vào Lưu.

Tham số dành riêng

Bảng sau đây liệt kê các tham số do Ads Data Hub đặt trước. Bạn có thể sử dụng các thông số này trong báo cáo, nhưng không thể tạo thông số có cùng tên với thông số dành riêng.

start_date	date Ngày bắt đầu (bao gồm cả ngày này) của lệnh báo cáo. Một thông số do người dùng xác định có tên này sẽ bị bỏ qua và được thay thế bằng các giá trị được đặt trong hộp thoại Công việc mới.
end_date	date Ngày kết thúc (bao gồm cả ngày này) của lệnh báo cáo. Một thông số do người dùng xác định có tên này sẽ bị bỏ qua và được thay thế bằng các giá trị được đặt trong hộp thoại Công việc mới.
time_zone	string Múi giờ cho tác vụ báo cáo. Một tham số do người dùng xác định có tên này sẽ bị bỏ qua và được thay thế bằng các giá trị được đặt trong hộp thoại New job (Công việc mới). Lưu ý: Để tránh sự khác biệt khi sử dụng múi giờ trong báo cáo, chẳng hạn như trong các mệnh đề WHERE, bạn có thể sử dụng time_zone để khớp với múi giờ được đặt trong Công việc mới. Bạn cũng cần sử dụng cùng múi giờ với nguồn dữ liệu.
params	string Không gian tên để đặt tên cho các bảng được xuất. Sử dụng định dạng sau để tạo một phần giữ chỗ trong truy vấn, sau đó cung cấp tên bảng khi bạn chạy báo cáo: params.TABLE_NAME (không sử dụng @ ở đầu do các tham số khác sử dụng). Để biết thêm thông tin và ví dụ về cách sử dụng tham số này, hãy xem phần Xuất nhiều bảng bằng một truy vấn.

---

Nội dung tóm tắt về hàng đã lọc

Lưu ý: Bạn không cần sử dụng bản tóm tắt hàng được lọc khi dùng chế độ nhiễu. Tìm hiểu về lợi ích của việc sử dụng nhiễu thay vì kiểm tra sự khác biệt.

Bản tóm tắt hàng đã lọc sẽ tính tổng dữ liệu đã được lọc do kiểm tra sai biệt. Dữ liệu từ các hàng đã lọc sẽ được cộng lại và thêm vào một hàng chung. Mặc dù không thể phân tích thêm dữ liệu đã lọc, nhưng dữ liệu này cung cấp thông tin tóm tắt về lượng dữ liệu đã được lọc khỏi kết quả. Đối với những truy vấn sử dụng chế độ kiểm tra chênh lệch để đảm bảo quyền riêng tư, Ads Data Hub sẽ tự động bật và định cấu hình một bản tóm tắt hàng được lọc. Khi bạn chỉnh sửa truy vấn, Ads Data Hub sẽ tự động điều chỉnh cấu hình dựa trên các cột đã chọn. Để tìm hiểu thêm về nội dung tóm tắt về hàng đã lọc hoặc để định cấu hình nội dung tóm tắt theo cách thủ công, hãy xem bài viết Nội dung tóm tắt về hàng đã lọc.

---

Chỉnh sửa báo cáo

1. Trong Ads Data Hub, hãy mở trang Báo cáo.
2. Nhấp vào tên của báo cáo mà bạn muốn chỉnh sửa.
3. Chỉnh sửa báo cáo. Ví dụ: chỉnh sửa SQL, quản lý các giá trị tham số hoặc đặt lịch biểu.
4. Nhấp vào Lưu.

---

Chạy báo cáo

Lưu ý quan trọng: Bạn có thể kiểm thử các truy vấn SQL bằng hộp cát trước khi chạy các truy vấn đó trên dữ liệu thực. Tìm hiểu thêm về các phương pháp hay nhất để viết truy vấn trong Ads Data Hub

Trước khi chạy báo cáo, hãy đảm bảo rằng bạn đã cấp cho tài khoản dịch vụ dataEditor quyền truy cập vào tập dữ liệu sẽ chứa đầu ra của các thao tác kết hợp. Tìm hiểu thêm về chế độ kiểm soát quyền truy cập trong BigQuery.

1. Trong Ads Data Hub, hãy mở trang Báo cáo.
2. Nhấp vào tên của báo cáo mà bạn muốn chạy.
3. Nhấp vào Chạy.

Chạy báo cáo theo lịch

1. Trong Ads Data Hub, hãy mở trang Báo cáo.
2. Nhấp vào tên của báo cáo mà bạn muốn đặt lịch gửi.
   • Để đặt lịch biểu cho một báo cáo mới, hãy tạo báo cáo đó rồi nhấp vào Lưu.
3. Nhấp vào + Đặt lịch biểu.
4. Trong ngăn Lịch biểu, hãy nhấp vào nút bật/tắt Lên lịch chạy báo cáo này với thông tin chi tiết bên dưới để chuyển sang vị trí bật.
5. Trong mục Tần suất, hãy chọn một khoảng thời gian và thời gian trong ngày, rồi nhập múi giờ.
   • Để sử dụng biểu thức cron, hãy nhấp vào nút bật/tắt Đặt lịch biểu bằng biểu thức cron để chuyển sang vị trí bật, rồi nhập biểu thức vào hộp.
6. Nhấp vào Xong.
7. Nhấp vào Lưu để lưu các thay đổi vào báo cáo.

Để xem các công việc định kỳ trên trang Trang chủ, hãy chọn Mọi người trong danh sách bộ lọc Chủ sở hữu.

---

Xem kết quả

Sau khi báo cáo chạy xong, bạn có thể xem trước kết quả trong trang chi tiết báo cáo. Để xem kết quả vào lúc khác, hãy mở báo cáo trên trang Trang chủ. Bạn cũng có thể khám phá dữ liệu trong BigQuery, Trang tính hoặc Data Studio.

Xem trước

Nhấp vào Xem trước trong công việc đã hoàn thành. 20 kết quả đầu tiên sẽ xuất hiện bên dưới công việc.

BigQuery

Theo mặc định, kết quả của bạn sẽ được xuất sang BigQuery. Nhấp vào Xem bảng để mở BigQuery trong một cửa sổ mới.

Trang tính và Data Studio

Mở trình đơn thả xuống Khám phá rồi chọn Khám phá bằng Trang tính hoặc Khám phá bằng Data Studio trong số các lựa chọn. Thao tác này sẽ mở dữ liệu trong một cửa sổ mới.