Ghi và chạy truy vấn

Tạo truy vấn

  1. Chuyển đến thẻ Cụm từ tìm kiếm trong Ads Data Hub.
  2. Nhấp vào + Tạo truy vấn. Trang Mẫu truy vấn phân tích sẽ mở ra.
  3. Không bắt buộc: Xem trước SQL mẫu bằng cách nhấp vào Mở rộng.
  4. Chọn mẫu bạn muốn sử dụng bằng cách nhấp vào Sử dụng mẫu hoặc nhấp vào Trống để tạo từ đầu.
  5. Nhập tên cho báo cáo của bạn.
  6. Viết hoặc chỉnh sửa truy vấn bằng cách sử dụng SQL tương thích với BigQuery. Bạn có thể tìm thấy các bảng và trường có sẵn rồi chèn các bảng và trường đó vào SQL thông qua thẻ Google Tables.
  7. Không bắt buộc: Định cấu hình thông số.
  8. Không bắt buộc: Định cấu hình phần tóm tắt hàng được lọc.
  9. Nhấp vào Lưu.

Tham số

Các tham số giúp truy vấn linh hoạt hơn. Ví dụ: bạn có thể muốn chạy cùng một truy vấn trên nhiều chiến dịch. Thay vì tạo các truy vấn trùng lặp hoặc mã hoá cứng mã chiến dịch trước mỗi lần thực thi, bạn có thể định cấu hình một tham số chấp nhận một hoặc nhiều mã chiến dịch được nhập từ thẻ Chạy khi bạn chạy một truy vấn. Việc sử dụng các tham số sẽ giúp mã của bạn sạch sẽ, giảm khả năng gây ra lỗi thông qua việc chỉnh sửa và giúp truy vấn của bạn có thể được sử dụng lại mà không cần chỉnh sửa. Các tham số nằm trong phạm vi truy vấn nơi chúng được tạo, vì vậy, bạn có thể sử dụng lại tên tham số trong một truy vấn khác.

Loại thông số

Các loại thông số sau được phép:

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

Tạo thông số

  1. Mở truy vấn đã lưu hoặc tạo truy vấn mới.
  2. Nhấp vào Thuộc tính > Tham số > Thêm thông số.
  3. Nhập tên vào trường Name (Tên). Bạn sẽ sử dụng tên này để tham chiếu tham số trong văn bản truy vấn.
  4. Sử dụng trình đơn thả xuống để chọn loại thông số.
    • Nếu bạn chọn mảng, một trình đơn thả xuống bổ sung sẽ xuất hiện. Chọn loại mảng trong trình đơn thả xuống.
  5. Không bắt buộc: Lặp lại các bước từ 2 đến 4 cho đến khi bạn thêm xong tất cả thông số mà bạn muốn.
  6. Nhấp vào Lưu

Sử dụng thông số

Trong văn bản truy vấn, hãy sử dụng định dạng tham số SQL chuẩn, lấy @ vào trước tên tham số. Trong ví dụ sau, truy vấn chứa tham số có tên là @campaign_ids:

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

  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

Khi bạn chạy truy vấn, hộp thoại Công việc mới sẽ chứa trường Thông số. Nhập giá trị cho mỗi thông số mà bạn đã xác định.

Xoá thông số

  1. Mở truy vấn có tham số mà bạn muốn xoá.
  2. Mở thẻ Properties (Thuộc tính).
  3. Trong thẻ Thông số, hãy nhấp vào xoá Xoá bên cạnh thông số bạn muốn xoá.
  4. Nhấp vào Lưu.

Thông số đặt trước

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

start_date date

Ngày bắt đầu (bao gồm cả ngày này) của công việc truy vấn. Thông số do người dùng xác định có tên này sẽ bị bỏ qua và 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 công việc truy vấn. Thông số do người dùng xác định có tên này sẽ bị bỏ qua và 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 công việc truy vấn. Thông số do người dùng xác định có tên này sẽ bị bỏ qua và thay thế bằng các giá trị được đặt trong hộp thoại Công việc mới.

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

Dữ liệu kiểm đếm tóm tắt hàng đã lọc đã được lọc do kiểm tra quyền riêng tư. Dữ liệu từ các hàng đã lọc được tính tổng và thêm vào một hàng nhận toàn bộ. 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ả.

Chỉnh sửa truy vấn

  1. Chuyển đến thẻ Cụm từ tìm kiếm trong Ads Data Hub.
  2. Nhấp vào tên truy vấn bạn muốn chỉnh sửa.
  3. Chỉnh sửa truy vấn.
  4. Nhấp vào Lưu.

Chạy truy vấn

Trước khi chạy một truy vấn, 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 chứa kết quả của các lần tham gia. Tìm hiểu thêm về tính năng kiểm soát quyền truy cập trong BigQuery.

  1. Chuyển đến thẻ Cụm từ tìm kiếm trong Ads Data Hub.
  2. Nhấp vào tên truy vấn bạn muốn chạy.
  3. Nhấp vào Run (Chạy).
    • Số byte dự kiến mà truy vấn sẽ sử dụng sẽ hiển thị ở đầu trang.
  4. Chọn một mã trong trường Dữ liệu quảng cáo từ. Đây phải là mã tài khoản đượ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 ADH Sandbox Customer.)
  5. Nếu sử dụng bảng so khớp, hãy chọn bảng so khớp trong trường Bảng so khớp từ.
  6. Chọn chế độ quyền riêng tư. Tìm hiểu thêm về các chế độ quyền riêng tư.
  7. Chỉ định vị trí lưu kết quả truy vấn trong trường Bảng đích.
  8. Nhập ngày bắt đầu và ngày kết thúc để xác định phạm vi ngày của truy vấn.
  9. Nhập một múi giờ. Múi giờ này phải khớp với múi giờ của cửa mua.
  10. Không bắt buộc: Nhập giá trị cho mọi thông số.
  11. Nhấp vào Chạy.

Xem kết quả

Sau khi truy vấn của bạn chạy xong, bạn có thể xem trước kết quả trên trang "Việc làm". 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 lệnh đã hoàn tất. 20 kết quả đầu tiên sẽ xuất hiện bên dưới việc làm.

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 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á với Trang tính hoặc Khám phá với 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.